全局介绍设置分页风格

要为整个项目设置分页样式,需要在项目设置中设置 DEFAULT_PAGINATION_CLASSPAGE_SIZE

为此,请转到 settings.py 并在 REST_FRAMEWORK 变量上添加以下内容:

REST_FRAMEWORK = {
    'DEFAULT_PAGINATION_CLASS': 
        'rest_framework.pagination.DESIRED_PAGINATION_STYLE',
    'PAGE_SIZE': 100
}

取代 DESIRED_PAGINATION_STYLE 必须放置下列之一:

  • PageNumberPagination:在请求查询参数中接受单个 page 号码。

    http://your_api_url/a_table/?page=2
    
  • LimitOffsetPagination:接受 limit 参数,该参数指示将返回的最大项目数,以及 offset 参数,该参数指示查询相对于数据集的起始位置。PAGE_SIZE 不需要为这种风格设置。

    http://your_api_url/a_table/?limit=50&offset=100
    
  • CursorPagination:基于游标的分页比上述样式更复杂。它要求数据集呈现固定排序,并且不允许客户端导航到数据集的任意位置。

  • 可以定义自定义分页样式来代替上述内容。