Django drf：分页器详解

一、简单分页（查看第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