Django REST framwork-04-分页

Django提供了一些类来帮助您管理分页数据 - 即分布在多个页面上的数据，使用 “上一页/下一页” 进行跳转链接。

DRF 配置项的设置位置

所有关于 DRF 的设置，都必须在 settings.py 文件中的 REST_FRAMEWORK 设置, 如下：

# settings.py
REST_FRAMEWORK = {
    ...
}

如何设置分页

注意： 只有在使用通用视图(generics.GenericAPIView)或视图集时(viewsets.GenericViewSet) ，才会自动执行分页。如果使用常规 APIView，则需要自己编写分页逻辑， 以确保返回含有分页的响应。

1 使用 Django 自带的默认分页类和页面大小

默认这两者都是 None

REST_FRAMEWORK = {
    'DEFAULT_PAGINATION_CLASS': 'rest_framework.pagination.LimitOffsetPagination',
    'PAGE_SIZE': 10
}

2 编写自定义的分页类

from rest_framework.pagination import PageNumberPagination
class StandardResultsSetPagination(PageNumberPagination):
    page_size = 2  # 每页 2 条数据
    page_size_query_param = 'page_size'
    page_query_param = 'p'  # 请求页码的参数名
    max_page_size = 2  

page_size_query_param= 'page_size'
客户端可以使用参数 page_size 自定义每页包含多少条数据（默认使用 page_size 的值）。

max_page_size = 2
表示即便是客户端使用 page_size 参数自定义每页包含多少条数据时，也不能超过 max_page_size 设置的值。
例如上例中设置的 max_page_size = 2, 那么客户端使用 page_size 定义每页包含3 条数据，实际上只会返回每页 2 条数据
示例:

3. 如何设置并使用

3.1 全局使用

在 setting.py 中设置即可

REST_FRAMEWORK = {
    'DEFAULT_PAGINATION_CLASS': 'api.page.StandardResultsSetPagination',
}

3.2 给某个视图使用

可以给不同的视图编写不同的分页样式，之后在视图中指定即可

from api.page import StandardResultsSetPagination
class ServerViewSet(viewsets.ModelViewSet):
    """
    viewsets 实现服务器列表
    """
    queryset = Server.objects.all()
    serializer_class = ServerSerializer
    
    # 指定此视图要使用的分页类
    pagination_class = StandardResultsSetPagination

3.3 URL 配置

from rest_framework import routers
from . import views
router = routers.DefaultRouter()

router.register(r'serverset', views.ServerViewSet)

urlpatterns = [
    path('', include(router.urls)),
]

3.4 效果图