官方文档[这里]
用于分页的模块: Pagination
Django REST framework 有内置 Pagination 模块，无需额外安装, 只需做简单的配置.
配置什么呢"color: #ff0000">2种配置途径:
1.settings.py 文件里做全局的配置
2.单独为每个需要分页的 view 分配自定义分页器.
途径1是为所有继承ListViewAPI的接口做默认配置, 途径2对单独一个接口做个性化配置.
需要注意的是: 途径1做了全局的配置, 所有继承 ListAPIView 的接口,默认都会有分页. 这会影响到现有接口返回数据的结构. 除了这一点, 途径1还是相当不错的.
我比较喜欢仅使用途径2, 我可以自定义了一个通用型的分页器, 只为有需要分页的view分配分页器, 也是挺方便的.
途径1: settings.py文件里做全局配置
REST_FRAMEWORK = {
# ...
'DEFAULT_PAGINATION_CLASS': 'rest_framework.pagination.PageNumberPagination',
'PAGE_SIZE': 100
}
DEFAULT_PAGINATION_CLASS: 默认分页器(BasePagination的子类). Django提供了3个类型: PageNumberPagination、LimitOffsetPagination、CursorPagination. 不同类型返回的分页信息不同. 也可以是你自定义的分页器.
PAGE_SIZE: 分页大小.
途径2: 自定义分页器
这里将示例使用自定义分页器的流程.
新建一个 paginations.py 用于写分页器:
我们在 paginations.py 文件里写一个通用的分页器:
class StandarPagination(PageNumberPagination):
page_size = 20 # 默认每页显示条数配置
page_query_param = 'page' # “页数”的请求参数名称, 默认是page
page_size_query_param = 'page_size' # “分页大小”的请求参数名称
# 进入父类 PageNumberPagination 可看响应体返回字段.
# def get_paginated_response(self, data):
# return Response(OrderedDict([
# ('count', self.page.paginator.count),
# ('next', self.get_next_link()),
# ('previous', self.get_previous_link()),
# ('results', data)
# ]))
# 觉得不适用, 那就拷贝出来,重载函数, 自己多加几个字段.
# (可通过官方文档或直接调试得知从哪些属性获取正确的值.)
def get_paginated_response(self, data):
return Response(OrderedDict([
('count', self.page.paginator.count),
('next', self.get_next_link()),
('previous', self.get_previous_link()),
('page', self.page.number),
('total_page', self.page.paginator.num_pages),
('page_size', self.page.paginator.per_page),
('results', data)
]))
(更多的属性介绍请查看文档)
为接口分配分页器, 为属性 pagination_class 赋值即可.
from rest_framework.pagination import PageNumberPagination class MyListAPI(ListAPIView): queryset = TestModel.objects.filter() serializer_class = TestModelSerializer pagination_class = StandarPagination # 新增
完成!
假如该接口请求地址是 http://api/test/
看客户端是如何请求接口的:
http://api/test/ : 返回第一页, 分页大小是20.
http://api/test/?page=2&page_size=10: 返回第二页,分页大小是10.
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。
免责声明：本站文章均来自网站采集或用户投稿，网站不提供任何软件下载或自行开发的软件！ 如有用户或公司发现本站内容信息存在侵权行为，请邮件告知！ 858582#qq.com
《魔兽世界》大逃杀！60人新游玩模式《强袭风暴》3月21日上线
暴雪近日发布了《魔兽世界》10.2.6 更新内容，新游玩模式《强袭风暴》即将于3月21 日在亚服上线，届时玩家将前往阿拉希高地展开一场 60 人大逃杀对战。
艾泽拉斯的冒险者已经征服了艾泽拉斯的大地及遥远的彼岸。他们在对抗世界上最致命的敌人时展现出过人的手腕，并且成功阻止终结宇宙等级的威胁。当他们在为即将于《魔兽世界》资料片《地心之战》中来袭的萨拉塔斯势力做战斗准备时，他们还需要在熟悉的阿拉希高地面对一个全新的敌人──那就是彼此。在《巨龙崛起》10.2.6 更新的《强袭风暴》中，玩家将会进入一个全新的海盗主题大逃杀式限时活动，其中包含极高的风险和史诗级的奖励。
《强袭风暴》不是普通的战场，作为一个独立于主游戏之外的活动，玩家可以用大逃杀的风格来体验《魔兽世界》，不分职业、不分装备（除了你在赛局中捡到的），光是技巧和战略的强弱之分就能决定出谁才是能坚持到最后的赢家。本次活动将会开放单人和双人模式，玩家在加入海盗主题的预赛大厅区域前，可以从强袭风暴角色画面新增好友。游玩游戏将可以累计名望轨迹，《巨龙崛起》和《魔兽世界：巫妖王之怒 经典版》的玩家都可以获得奖励。