Package com.shri.restinpeace.annotation.pagination
package com.shri.restinpeace.annotation.pagination
-
ClassDescriptionDeclares that a method's response is paginated - following a next-page pointer automatically, extracting each page's items into a
Page<T>, instead of leaving the fetch-extract-repeat loop to hand-written code.How the client advances to the next page on its own, whenpointerSource = NONE(no server-given pointer at all) - offset or page-number arithmetic instead of following an extracted value.Marks a parameter - already annotated@QueryParam/@PathParam/@HeaderParam/@Body- as the carrier a@Paginatedfetch re-populates with the freshly extracted next-page pointer before every subsequent call.Where one particular@Paginatedsignal comes from - reused acrosspointerSource,hasMoreSource,totalSource, andtotalPagesSource(one enum, four uses, not four renamed near-duplicates) perdocs/design/pagination-helper.mdยง6.1.Whether a@Paginatedmethod's extracted next-page pointer is a complete URL to follow verbatim, or a bare value to re-inject into the next request via a@PaginationCursorcarrier.