官方文档[这里]
用于分页的模块: 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.
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。
免责声明:本站资源来自互联网收集,仅供用于学习和交流,请遵循相关法律法规,本站一切资源不代表本站立场,如有侵权、后门、不妥请联系本站删除!
更新日志
- 凤飞飞《我们的主题曲》飞跃制作[正版原抓WAV+CUE]
- 刘嘉亮《亮情歌2》[WAV+CUE][1G]
- 红馆40·谭咏麟《歌者恋歌浓情30年演唱会》3CD[低速原抓WAV+CUE][1.8G]
- 刘纬武《睡眠宝宝竖琴童谣 吉卜力工作室 白噪音安抚》[320K/MP3][193.25MB]
- 【轻音乐】曼托凡尼乐团《精选辑》2CD.1998[FLAC+CUE整轨]
- 邝美云《心中有爱》1989年香港DMIJP版1MTO东芝首版[WAV+CUE]
- 群星《情叹-发烧女声DSD》天籁女声发烧碟[WAV+CUE]
- 刘纬武《睡眠宝宝竖琴童谣 吉卜力工作室 白噪音安抚》[FLAC/分轨][748.03MB]
- 理想混蛋《Origin Sessions》[320K/MP3][37.47MB]
- 公馆青少年《我其实一点都不酷》[320K/MP3][78.78MB]
- 群星《情叹-发烧男声DSD》最值得珍藏的完美男声[WAV+CUE]
- 群星《国韵飘香·贵妃醉酒HQCD黑胶王》2CD[WAV]
- 卫兰《DAUGHTER》【低速原抓WAV+CUE】
- 公馆青少年《我其实一点都不酷》[FLAC/分轨][398.22MB]
- ZWEI《迟暮的花 (Explicit)》[320K/MP3][57.16MB]