第 6 篇：分页接口

做者：HelloGitHub-追梦人物

若是没有设置分页，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 复制代码

这样，PostViewSet 视图集将返回 limit offset 分页形式的文章列表，而其余视图或者视图集仍将使用全局的分页配置。

请求文章 api，返回结果以下：

对返回结果的解释：

count：总资源数目

next：下一页资源的连接

previous：上一页资源的连接

results：当前页的资源列表

---

关注公众号加入交流群