geared_pagination

传统分页方案大多数使用固定的页面大小。第 1 页返回与第 2 页相同数量的元素。但当您需要尽可能快速处理初始请求时，这种方式通常并不是最合理的方法来分页大型记录集。在使用分页方案与无限滚动 UI 结合时，这种情况尤其明显。

带齿轮分页允许您定义不同的比例。默认情况下,我们会在第 1 页返回 15 个元素,第 2 页返回 30 个元素,第 3 页返回 50 个元素,第 4 页及之后返回 100 个元素。这已经被证明是 Basecamp UI 中大部分情况下非常合理的比例设置。当然,您可以调整比例,使用更少的比例,甚至完全不使用,如果某个页面需要固定比例的方案。对于设置页面的 JSON 操作,我们还会自动为 API 设置 Link 和 X-Total-Count 头部,以便进行记录集分页。

默认情况下,带齿分页使用 基于偏移的分页: page 查询参数包含页面编号。每个页面的记录通过包含 OFFSET 子句的查询来定位,如下所示:

SELECT *
FROM messages
WHERE (created_at = '2019-01-24T12:35:26.381Z' AND id 

``` 光标用于编码 Geared Pagination 需要查询的相应页面记录的信息:选择页面大小的页面编号,以及每个有序属性( `created_at` 和 `id` )的值。