一、简单分页(查看第n页,每页显示N条)
二、偏移分页(在第n个位置,向后查看n条数据)
三、CursorPagination(加密分页,只能看上一页和下一页,速度快)
一、简单分页(查看第n页,每页显示N条)
from rest_framework.pagination import PageNumberPagination # 一 基本使用:url=url=http://127.0.0.1:8000/pager/?page=2&size=3,size无效 class Pager(APIView): def get(self,request,*args,**kwargs): # 获取所有数据 ret=models.Book.objects.all() # 创建分页对象 page=PageNumberPagination() # 在数据库中获取分页的数据 page_list=page.paginate_queryset(ret,request,view=self) # 对分页进行序列化 ser=BookSerializer1(instance=page_list,many=True) return Response(ser.data) # 二 自定制 url=http://127.0.0.1:8000/pager/?page=2&size=3 # size=30,无效,最多5条 class Mypage(PageNumberPagination): page_size = 2 page_query_param = 'page' # 定制传参 page_size_query_param = 'size' # 最大一页的数据 max_page_size = 5 class Pager(APIView): def get(self,request,*args,**kwargs): # 获取所有数据 ret=models.Book.objects.all() # 创建分页对象 page=Mypage() # 在数据库中获取分页的数据 page_list=page.paginate_queryset(ret,request,view=self) # 对分页进行序列化 ser=BookSerializer1(instance=page_list,many=True) # return Response(ser.data) # 这个也是返回Response对象,但是比基本的多了上一页,下一页,和总数据条数(了解即可) return page.get_paginated_response(ser.data)
# setting文件中
REST_FRAMEWORK = { # 每页显示两条 'PAGE_SIZE':2 }
# 路由
url(r'^pager/$', views.Pager.as_view()),
# Serilizers
class BookSerializer1(serializers.ModelSerializer): class Meta: model=models.Book # fields="__all__" exclude=('authors',)class BookSerializer1(serializers.ModelSerializer): class Meta: model=models.Book # fields="__all__" exclude=('authors',)
二、偏移分页(在第n个位置,向后查看n条数据)
# http://127.0.0.1:8000/pager/?offset=4&limit=3 from rest_framework.pagination import LimitOffsetPagination # 也可以自定制,同简单分页 class Pager(APIView): def get(self,request,*args,**kwargs): # 获取所有数据 ret=models.Book.objects.all() # 创建分页对象 page=LimitOffsetPagination() # 在数据库中获取分页的数据 page_list=page.paginate_queryset(ret,request,view=self) # 对分页进行序列化 ser=BookSerializer1(instance=page_list,many=True) # return page.get_paginated_response(ser.data) return Response(ser.data)
三、CursorPagination(加密分页,只能看上一页和下一页,速度快)
思考:不重写类,修改属性?
from rest_framework.pagination import CursorPagination # 看源码,是通过sql查询,大于id和小于id class Pager(APIView): def get(self,request,*args,**kwargs): # 获取所有数据 ret=models.Book.objects.all() # 创建分页对象 page=CursorPagination() page.ordering='nid' # 在数据库中获取分页的数据 page_list=page.paginate_queryset(ret,request,view=self) # 对分页进行序列化 ser=BookSerializer1(instance=page_list,many=True) # 可以避免页码被猜到 return page.get_paginated_response(ser.data)
小结:
-简单分页
- page_size = api_settings.PAGE_SIZE :每页显示条数
page_query_param = 'page' :查询的页码数
page_size_query_param = None :每页最大显示条数
-如果我要的数据是第一页显示10条: http://127.0.0.1:8000/books/?ccc=10&page=1
-如果我要的是第二页显示5条: http://127.0.0.1:8000/books/?ccc=5&page=2
max_page_size = 8 :控制最大显示多少条
如果我想第一页显示10000条,这种不合理,通过这个参数控制,最大显示8条
-使用:
page_sipmle=PageNumberPagination()
page_sipmle.page_size=4
# page_sipmle.page_query_param='aaa'
page_sipmle.page_size_query_param='ccc'
page_sipmle.max_page_size=8
book_list = models.Book.objects.all()
page_list = page_sipmle.paginate_queryset(book_list,request,self)
book_ser = BookSerializer(instance=page_list, many=True)
-偏移分页
- default_limit = api_settings.PAGE_SIZE :默认偏移的条数 5
limit_query_param = 'limit' :偏移的条数
offset_query_param = 'offset' :是标杆
max_limit = None :最大偏移的条数
-举例
-http://127.0.0.1:8000/books/ 结果是:从1到5
-http://127.0.0.1:8000/books/?limit=7 结果是:从1到7
-http://127.0.0.1:8000/books/?limit=2&offset=6 结果是:从7到8,两条
-http://127.0.0.1:8000/books/?offset=6 结果是:从7到11,5条
-游标分页:原理:速度最快,但是只能往前走和往后走
- cursor_query_param = 'cursor'
page_size = api_settings.PAGE_SIZE :默认每页显示的条数
ordering = 'id' :按谁排序
4 5 6 10