Django rest framework分页接口实现原理解析_Python

Django rest framework分页接口实现原理解析

2020-08-22 00:08削微寒 Python

这篇文章主要介绍了Django rest framework分页接口实现原理解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下

如果没有设置分页，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 更加灵活。

要使用分页功能非常简单，只需在项目的配置文件中配置好分页选项，即可全局启用分页功能。打开 config/common.py 配置文件，写入如下的分页配置：

									REST_FRAMEWORK = {

									  # 设置 DEFAULT_PAGINATION_CLASS 后，将全局启用分页，所有 List 接口的返回结果都会被分页。

									  # 如果想单独控制每个接口的分页情况，可不设置这个选项，而是在视图函数中进行配置

									  "DEFAULT_PAGINATION_CLASS": "rest_framework.pagination.PageNumberPagination",

									  # 这个选项控制分页后每页的资源个数

									  "PAGE_SIZE": 10,

									}

配置完成之后，所有通用视图函数或者视图集生成的资源列表 API，返回的资源列表都会被分页。配置文件中的分页设置将作用于全局，如果某个视图函数或者视图集不想使用全局配置怎么办呢？可以在视图函数或者视图集中设置 pagination_class 属性，指定需要使用的分页辅助类即可。例如将博客文章列表分页替换为 limit offset 的分页方式，可以这样设置：

									from rest_framewrok.pagination import PageNumberPagination

									class PostViewSet(viewsets.GenericViewSet):

									  pagination_class = LimitOffsetPagination