A page size sets the maximum number of results requested for one page of a paginated query. Smaller pages keep long result lists manageable while still allowing clients to request more data when needed. section 6.2 section 7.2.2
Configuring an order-list page
An order controller can request the first page with a default page size of 20 by calling PageRequest.of(0, pageSize). Annotating the controller with @ConfigurationProperties(prefix="taco.orders") lets configuration replace that default: taco.orders.pageSize: 10 in application.yml or TACO_ORDERS_PAGESIZE=10 as an environment variable. Changing the value avoids rebuilding and redeploying the application. section 6.2
Pagination requests use the page size together with page and sorting controls:
- Spring Data combines a Pageable with a repository query to select a page and its maximum result count. section 6.2
- REST collection resources accept size in the request URL; page numbers are zero-based, so page=1 requests the second page. section 7.2.2
- Sorting can accompany the size, such as requesting 12 newest tacos with sort=createdAt,desc&page=0&size=12. section 7.2.2
