django的基于光标的分页
django-cursor-pagination的Python项目详细描述
django光标分页
django的基于光标的分页系统。而不是指具体的 根据页数,我们根据查询集 排序值。然后我们通过询问记录来询问后续记录 after我们当前拥有的最后一个项目的光标。同样,我们可以要求 在第一个要通过 列表。
与传统分页相比,这种方法有两个主要优点。首先,它 确保在将新数据写入表时,不能移动记录 下一页。其次,查询数据库要快得多 因为我们没有使用很大的偏移值。
与“传统”分页相比,有一些明显的缺点。数据 必须按所有记录中唯一的数据库字段排序。 典型的用例是按创建时间戳和id排序的。 也更难得到数据可能的页面范围。
这个项目的灵感主要来自大卫的this post。 cramer和Relay GraphQL的连接规范。大部分 实现的灵感来自Django rest framework's Cursor pagination.。 DISPS方法和这里使用的方法的主要区别在于 我们要求排序是完全确定的,而不是使用偏移量。
安装
pip install django-cursor-pagination
用法
fromcursor_paginationimportCursorPaginatorfrommyapp.modelsimportPostdefposts_api(request,after=None):qs=Post.objects.all()page_size=10paginator=CursorPaginator(qs,ordering=('-created','-id'))page=paginator.page(first=page_size,after=after)data={'objects':[serialize_page(p)forpinpage],'has_next_page':page.has_next,'last_cursor':paginator.cursor(page[-1])}returndata
使用last
和before
参数可以实现反向分页。
到paginator.page
。
注意事项
- 指定的排序必须唯一标识对象。
- 如果有多个排序字段,则它们都必须具有相同的 方向
- 不支持sqlite中的多个排序字段,因为它不支持 元组比较。
- 如果给定了一个游标,但它没有引用有效的对象,则
has_previous
(对于after
)或has_next
(对于before
)将始终返回True
。