1. 程式人生 > >Django - DRF - 分頁器

Django - DRF - 分頁器

目錄

一、簡單分頁 - 檢視第n頁,每頁顯示m條

1-1 基本使用

1-2 自定義傳統分頁類 - 重寫 PageNumberPagination內屬性

二、偏移分頁 - 在n位置,向後檢視m條資料

三、加密分頁 - 加密分頁,速度快,只能上下頁

四、區域性配置和全域性配置

4-1 原始碼分析

4-2 全域性配置

4-3 區域性配置


一、簡單分頁 - 檢視第n頁,每頁顯示m條

注意:

  • 必須配置每頁顯示條數:page.page_size 
  • page.page_query_param:配置get提交資料名
  • 序列化需傳入分頁後資料物件
  • return page.get_paginated_response(ser.data) - 返回資料帶著上下連結和資料總條數 

1-1 基本使用

# DRF 傳統分頁
from rest_framework.pagination import PageNumberPagination
from rest_framework.views import APIView
from rest_framework.response import Response
from app01 import MySerializers


# DRF 基本使用 - 預設配置
# http://127.0.0.1:8000/index/?page=2&size=3,size無效
class Index(APIView):
    def get(self, request, *arges, **kwargs):
        book_list = models.Book.objects.all()
        page = PageNumberPagination()
        # 每頁顯示條數
        page.page_size = 2
        # http://127.0.0.1:8000/index/?test=2
        # page_query_param修改get提交資料名
        page.page_query_param='test'
        # 引數:分頁物件,request物件,當前檢視物件
        page_list = page.paginate_queryset(book_list, request, view=self)
        ser = MySerializers.BookSerializers(instance=page_list, many=True)
        return Response(ser.data)
        # return page.get_paginated_response(ser.data)
        # return render(request, 'drf_index.html', locals())

1-2 自定義傳統分頁類 - 重寫 PageNumberPagination內屬性

注意:

 

  • 每頁顯示資料的優先順序:前臺提交(page_size_query_param = 'size' >page_size)
# DRF 自定義傳統分頁類,重寫屬性
class MyPageNumberPagination(PageNumberPagination):
    # 每頁顯示資料
    page_size = 3

    #  http://127.0.0.1:8000/index/?data=2&size=2
    # get資料提交名
    page_query_param = 'data'
    # ?後size傳輸每頁顯示條數
    page_size_query_param = 'size'
    # 每頁最多顯示4條,若page_size大於max_page_size則優先後者
    max_page_size = 5


class Index(APIView):
    def get(self, request, *arges, **kwargs):
        book_list = models.Book.objects.all()
        page = MyPageNumberPagination()
        # 引數:分頁物件,request物件,當前檢視物件
        page_list = page.paginate_queryset(book_list, request, view=self)
        ser = MySerializers.BookSerializers(instance=page_list, many=True)
        # return Response(ser.data)
        return page.get_paginated_response(ser.data)

二、偏移分頁 - 在n位置,向後檢視m條資料

注意:

# -----------DRF 偏移分頁-------------
from rest_framework.pagination import LimitOffsetPagination


# DRF 自定義偏移分頁類,重寫屬性
class MyLimitOffsetPagination(LimitOffsetPagination):
    default_limit = 3
    max_limit = 5
    # 返回資料從 (offset,limit} 左開右閉
    # 資料最大值(id最大)
    limit_query_param = 'limit'
    # 資料最小值(id下線)
    offset_query_param = 'offset'


class Index(APIView):
    def get(self, request, *arges, **kwargs):
        book_list = models.Book.objects.all()
        page = MyLimitOffsetPagination()
        # 引數:分頁物件,request物件,當前檢視物件
        page_list = page.paginate_queryset(book_list, request, view=self)
        ser = MySerializers.BookSerializers(instance=page_list, many=True)
        # return Response(ser.data)
        return page.get_paginated_response(ser.data)

三、加密分頁 - 加密分頁,速度快,只能上下頁

注意:

from rest_framework.pagination import CursorPagination


# DRF 自定義偏移分頁類,重寫屬性
class MyCursorPagination(CursorPagination):
    page_size = 1
    page_size_query_param = 'size'
    max_page_size = 5

    # 當前頁的加密key
    # "next": "http://127.0.0.1:8000/index/?cursor=cD01&size=6",
    cursor_query_param = 'cursor'
    # 排序方式
    ordering = 'id'


class Index(APIView):
    def get(self, request, *arges, **kwargs):
        book_list = models.Book.objects.all()
        page = MyCursorPagination()
        # 引數:分頁物件,request物件,當前檢視物件
        page_list = page.paginate_queryset(book_list, request, view=self)
        ser = MySerializers.BookSerializers(instance=page_list, many=True)
        # return Response(ser.data)
        return page.get_paginated_response(ser.data)

四、區域性配置和全域性配置

4-1 原始碼分析

4-2 全域性配置

REST_FRAMEWORK = {
    # 每頁顯示兩條
    'PAGE_SIZE':2,
}

4-3 區域性配置