如果没有设置分页,django-rest-framework 会将所有资源类表序列化后返回,如果资源很多,就会对网站性能造成影响。为此,我们来给博客文章列表 API 添加分页功能。
django-rest-framework 为分页功能提供了多个辅助类,常用的有:
PageNumberPagination
将资源分为第 1 页、第 2 页…第 n 页,使用页码号请求分页结果。
LimitOffsetPagination
通过 limit
和 offset
两个参数来控制请求的资源。例如通过发送 API 请求:/posts/?offset=20&limit=5,将获取文章资源列表第 20 篇后的 5 篇文章。如果 offset 以等差数列递增,limit 保持不变,则等价于按页码分页。但 offset 和 limit 可以为任意值,因此这种分页比 PageNumberPagination
更加灵活。
要使用分页功能非常简单,只需在项目的配置文件中配置好分页选项,即可全局启用分页功能。打开 settings.py配置文件,写入如下的分页配置:
REST_FRAMEWORK = {
# 设置DEFAULT_PAGINATION_CLASS 后将全局启动分页,所有List接口(继承了ListAPIView的类视图会)返