[WIP] java: pagination

[dcb6]

No description provided.

[dcb6]

Example block for offset pagination (from hume, includes handling a response that's an Optional<List< ... >>)

                FilePage parsedResponse = ObjectMappers.JSON_MAPPER.readValue(responseBody.string(), FilePage.class);
                Integer newPageNumber = request.getPageNumber().map(page -> page + 1).orElse(1);
                FilesListFilesRequest nextRequest = FilesListFilesRequest.builder()
                        .from(request)
                        .pageNumber(newPageNumber)
                        .build();
                return new SyncPagingIterable<>(
                        true, parsedResponse.getContent(), () -> listFiles(nextRequest, requestOptions));

[dcb6]

made this extra constructor to handle an Optional items for 2 reasons:

1. this basically delegates some extra logic to this class instead of the client method. imo feels most important to keep client methods clean over core classes; i'd imagine people spend more time looking at clients
2. a bit easier to implement this way!

[dcb6]

In addition to the itererator, should we have a way to get all of the values in a list or stream easily? like a toList()?

my vote: make a ticket and consider adding this in the future