一、使用方法
1.添加引擎
在全局配置settings.py模块的REST_FRAMEWORK字段中配置引擎和指定每页显示的数据条数
REST_FRAMEWORK = {'DEFAULT_PAGINATION_CLASS': 'rest_framework.pagination.PageNumberPagination','PAGE_SIZE': 5}
2.引入方式
使用self.paginate_queryset()方法进行分页,它需要传一个查询集对象参数,如果没有进行分页,则会返回None,因此需要做一个if判断,并使用self.get_paginated_response()序列化输出分页后的数据,该方法接收一个序列化器对象.data参数
from rest_framework.response import Responsefrom rest_framework import statusfrom rest_framework.generics import GenericAPIViewfrom .models import Projectsfrom .serializers import ProjectsModelSerializerclass ProjectsPage(GenericAPIView):'''类视图'''queryset = Projects.objects.all()serializer_class = ProjectsModelSerializerdef get(self, request):qs = self.filter_queryset(self.get_queryset())page = self.paginate_queryset(qs)if page:serializer_obj = self.get_serializer(instance=page, many=True)return self.get_paginated_response({'code': 0, 'res': "success", 'msg': serializer_obj.data})serializer_obj = self.get_serializer(instance=qs, many=True)return Response({'code': 0, 'res': "success", 'msg': serializer_obj.data}, status=status.HTTP_200_OK)
3.指定页展示指定的数据条数
在PageNumberPagination类中,我们可以对一些字段值进行重写,先看看源码
1.重写PageNumberPagination
我们直接新建一个pagination.py模块,在该模块中创建一个类PageNumberPagination父类,并重写类属性,并且自定义的属性优先级最高,如果全局配置中也有相关配置,则直接会被覆盖
from rest_framework.pagination import PageNumberPaginationclass NewPagination(PageNumberPagination):page_size = 5max_page_size = 50page_size_query_param = 'size'
2.配置引擎
将新建的NewPagination的引用地址,配置到全局配置settings.py模块的REST_FRAMEWORK字段中,并将原先的注释掉
REST_FRAMEWORK = {# 'DEFAULT_PAGINATION_CLASS': 'rest_framework.pagination.PageNumberPagination',# 'PAGE_SIZE': 5,'DEFAULT_PAGINATION_CLASS': 'utils.pagination.NewPagination'}
4.在视图中指定分页引擎类
在上面我们的分页引擎都是配置到全局中的,如果不希望所有的查询接口都支持该功能,我们可以只指定当前接口所属的视图,这时就不需要在全局配置中配置分页引擎,直接在视图中使用pagination_class类属性指定分页引擎
from django.db import connectionfrom django.http import Http404from rest_framework.response import Responsefrom rest_framework import statusfrom rest_framework.generics import GenericAPIViewfrom utils.pagination import NewPaginationfrom .models import Projectsfrom .serializers import ProjectsModelSerializerclass ProjectsPage(GenericAPIView):'''类视图'''queryset = Projects.objects.all()serializer_class = ProjectsModelSerializerpagination_class = NewPaginationdef get(self, request):qs = self.filter_queryset(self.get_queryset())page = self.paginate_queryset(qs)if page:serializer_obj = self.get_serializer(instance=page, many=True)return self.get_paginated_response({'code': 0, 'res': "success", 'msg': serializer_obj.data})serializer_obj = self.get_serializer(instance=qs, many=True)return Response({'code': 0, 'res': "success", 'msg': serializer_obj.data}, status=status.HTTP_200_OK)
