在 Web 開發(fā)中，處理大量數(shù)據(jù)是非常常見的。但是，如果一次性返回所有數(shù)據(jù)，不僅會(huì)增加服務(wù)器的負(fù)擔(dān)，而且還會(huì)影響客戶端的響應(yīng)時(shí)間。為了解決這個(gè)問題，分頁被廣泛應(yīng)用于 Web 應(yīng)用程序中，特別是在 RESTful API 中。

在 Django REST Framework 中，分頁器是一種允許我們將查詢結(jié)果劃分為多個(gè)頁面，并將每個(gè)頁面的數(shù)據(jù)返回給客戶端的工具。

基于頁碼的分頁器

基于頁碼的分頁器將查詢結(jié)果劃分為多個(gè)頁面，并使用頁碼來標(biāo)識(shí)每個(gè)頁面?？蛻舳丝梢栽诓樵儏?shù)中指定要請(qǐng)求的頁面數(shù)，以及每個(gè)頁面返回的對(duì)象數(shù)量。Django REST Framework 中內(nèi)置了兩種基于頁碼的分頁器：PageNumberPagination和 LimitOffsetPagination。

(資料圖片)

PageNumberPagination

PageNumberPagination分頁器是基于頁碼的分頁器，允許客戶端使用頁碼和每頁返回的對(duì)象數(shù)量來請(qǐng)求不同的數(shù)據(jù)范圍。以下是一個(gè)簡單的使用 PageNumberPagination分頁器的示例：

from rest_framework.pagination import PageNumberPaginationclass BookPagination(PageNumberPagination):    page_size = 10    page_query_param = "page"    max_page_size = 100class BookViewSet(viewsets.ModelViewSet):    queryset = Book.objects.all()    serializer_class = BookSerializer    pagination_class = BookPagination

在這個(gè)例子中，我們創(chuàng)建了一個(gè)名為 BookPagination的分頁器類，并指定了默認(rèn)的頁面大小為 10，并將 page_query_param屬性設(shè)置為 page，以便使用 page參數(shù)作為頁碼參數(shù)。我們還為客戶端指定了可以在查詢參數(shù)中使用的 page和 page_size參數(shù)，并設(shè)置了最大頁面大小為 100。最后，我們將 BookPagination分頁器類添加到 BookViewSet視圖集合中。

現(xiàn)在，當(dāng)客戶端發(fā)起請(qǐng)求時(shí)，我們的 BookViewSet視圖集合將使用 BookPagination分頁器將查詢結(jié)果劃分為多個(gè)頁面，并將每個(gè)頁面的數(shù)據(jù)返回給客戶端。客戶端可以在查詢參數(shù)中指定 page和 page_size參數(shù)來請(qǐng)求不同的數(shù)據(jù)范圍。

LimitOffsetPagination

LimitOffsetPagination分頁器也是一種基于頁碼的分頁器，但與 PageNumberPagination不同的是，它允許客戶端指定一個(gè)偏移量和每頁返回的對(duì)象數(shù)量來請(qǐng)求數(shù)據(jù)。以下是一個(gè)簡單的使用 LimitOffsetPagination分頁器的示例：

from rest_framework.pagination import LimitOffsetPaginationclass BookPagination(LimitOffsetPagination):    default_limit = 10    limit_query_param = "limit"    offset_query_param = "offset"    max_limit = 100class BookViewSet(viewsets.ModelViewSet):    queryset = Book.objects.all()    serializer_class = BookSerializer    pagination_class = BookPagination

在這個(gè)例子中，我們創(chuàng)建了一個(gè)名為 BookPagination的分頁器類，并指定了默認(rèn)的頁面大小為 10，并將 limit_query_param和 offset_query_param分別設(shè)置為 limit和 offset，以便客戶端可以使用 limit和 offset參數(shù)來請(qǐng)求數(shù)據(jù)。我們還指定了最大限制為 100，并將 BookPagination分頁器類添加到 BookViewSet視圖集合中。

現(xiàn)在，當(dāng)客戶端發(fā)起請(qǐng)求時(shí)，我們的 BookViewSet視圖集合將使用 LimitOffsetPagination分頁器將查詢結(jié)果劃分為多個(gè)頁面，并將每個(gè)頁面的數(shù)據(jù)返回給客戶端?？蛻舳丝梢栽诓樵儏?shù)中指定 limit和 offset參數(shù)來請(qǐng)求不同的數(shù)據(jù)范圍。

基于游標(biāo)的分頁器

基于游標(biāo)的分頁器與基于頁碼的分頁器不同，它使用一個(gè)游標(biāo)來標(biāo)識(shí)要返回的數(shù)據(jù)范圍。在客戶端發(fā)送第一次請(qǐng)求時(shí)，服務(wù)器返回一組數(shù)據(jù)和一個(gè)游標(biāo)?？蛻舳耸褂眠@個(gè)游標(biāo)來請(qǐng)求下一組數(shù)據(jù)。以下是一個(gè)簡單的使用 CursorPagination分頁器的示例：

from rest_framework.pagination import CursorPaginationclass BookPagination(CursorPagination):    page_size = 10    ordering = "title"class BookViewSet(viewsets.ModelViewSet):    queryset = Book.objects.all()    serializer_class = BookSerializer    pagination_class = BookPagination

在這個(gè)例子中，我們創(chuàng)建了一個(gè)名為 BookPagination的分頁器類，并指定了默認(rèn)的頁面大小為 10，并將 ordering屬性設(shè)置為 title，以便按標(biāo)題排序。最后，我們將 BookPagination分頁器類添加到 BookViewSet視圖集合中。

現(xiàn)在，當(dāng)客戶端發(fā)起請(qǐng)求時(shí)，我們的 BookViewSet視圖集合將使用 CursorPagination分頁器將查詢結(jié)果劃分為多個(gè)頁面，并將每個(gè)頁面的數(shù)據(jù)返回給客戶端?？蛻舳丝梢允褂?next和 previous參數(shù)來請(qǐng)求下一頁和上一頁。

在 Django REST Framework 中，分頁器是一種將查詢結(jié)果劃分為多個(gè)頁面并將每個(gè)頁面的數(shù)據(jù)返回給客戶端的工具。Django REST Framework 中內(nèi)置了兩種分頁器，即基于頁碼的分頁器和基于游標(biāo)的分頁器。在使用分頁器時(shí)，我們可以指定默認(rèn)的頁面大小、頁面參數(shù)和最大頁面大小等屬性，以及按特定的字段排序等選項(xiàng)。