一：简单分页
简单分页就是查看第n页，每页显示n条数据
使用方法： -1 导入PageNumberPagination类 -2 实例化产生一个对象 -page_pagination = PageNumberPagination() -3 需要配置四个参数:page_size,page_query_param,page_size_query_param,max_page_size -page_size必须指定:在setting中指定或者直接赋值 -4 调用下面的方法,返回ret数据 ret = page_pagination.paginate_queryset(book_list, request, self) -5 再序列化,就是序列化返回的数据,也就是ret
-类中需要掌握的几个属性 -page_size:控制每页显示条数 -page_query_param:控制查询第几页的查询参数, -比如page_query_param='xx' -http://127.0.0.1:8000/books/?xx=2 表示查询第二页的数据 -page_size_query_param:控制每页最大显示的条数 -比如page_pagination.page_size_query_param='max' -http://127.0.0.1:8000/books/?xx=2&max=6 表示查询第二页的数据,每页显示6条 -max_page_size:控制每页最大显示的条数 -比如:page_pagination.max_page_size=7 -http://127.0.0.1:8000/books/?max=1000 最多显示7条
使用配置文件
在settings.py中配置
REST_FRAMEWORK = { # 每页显示两条 'PAGE_SIZE':2 }
views.py
from rest_framework.pagination import PageNumberPagination class BooksView(APIView): def get(self,request): book_list = models.Book.objects.all() page_pagination = PageNumberPagination() page_list = page_pagination.paginate_queryset(book_list,request,view=self) ser = BookSerializer(instance=page_list,many=True) print(ser.data) return Response(ser.data)
自定义四个参数
from rest_framework.pagination import PageNumberPagination class BooksView(APIView): def get(self,request): #使用方法 #1.导入PageNumberPagination类 #2.实例化产生一个对象 #-page_pagination = PageNumberPagination() #3.需要配置四个参数: page_size, page_query_param, page_size_query_param, max_page_size #-page_size必须指定: 在setting中指定或者直接赋值 #4.调用下面的方法, 返回ret数据 #-ret = page_pagination.paginate_queryset(book_list, request, self) # 5.再序列化,就是序列化返回的数据,也就是ret book_list = models.Book.objects.all() page_pagination = PageNumberPagination() #四个参数 page_pagination.page_size = 4 #每页的条数 page_pagination.page_query_param = 'ccc' #控制查询第几页的查询参数, page_pagination.page_size_query_param = 'max' #用户控制每页显示的条数 page_pagination.max_page_size = 6 #每页显示的最大条数，防止用户自定义的条数太大 page_list = page_pagination.paginate_queryset(book_list,request,view=self) ser = BookSerializer(instance=page_list,many=True) print(ser.data) return Response(ser.data)
二：偏移分页
from rest_framework.pagination import PageNumberPagination,LimitOffsetPagination class BooksView(APIView): def get(self,request): #使用方法：同简单分页 book_list = models.Book.objects.all() page_pagination = LimitOffsetPagination() page_pagination.default_limit = 5 #默认显示的每页数量，默认偏移的数量 page_pagination.limit_query_param = 'xx' #往后偏移多少条,默认是limit,也可以自定义 page_pagination.offset_query_param = 'ee' #标杆值，默认是offser，也可以自定义 # limit_query_param + offset_query_param联合起来用: # -访问: http://127.0.0.1:8000/books/?limit=1&offset=5 表示: 以数据的第5条作为标杆, 往后偏移1条 page_list = page_pagination.paginate_queryset(book_list,request,view=self) ser = BookSerializer(instance=page_list,many=True) print(ser.data) return Response(ser.data)
三：CursorPagination（加密分页，只能看上一页和下一页，速度快）
from rest_framework.pagination import PageNumberPagination,LimitOffsetPagination,CursorPagination class BooksView(APIView): def get(self,request): #使用方法：同简单分页 #重点参数: #page_size: 每页显示的条数 #cursor_query_param: 不需要动 #ordering: 按什么排序 #通过get_paginated_response返回结果中带上一页和下一页的链接地址 #page_pagination.get_paginated_response(book_ser.data) #方法的用法 book_list = models.Book.objects.all() page_pagination = CursorPagination() page_pagination.ordering = 'id' page_list = page_pagination.paginate_queryset(book_list,request,view=self) ser = BookSerializer(instance=page_list,many=True) print(ser.data) return page_pagination.get_paginated_response(ser.data)
四：响应器（不需要改）
响应回去的页面，数据格式是不同的
局部使用：在视图类中配置
renderer_classes = [JSONRenderer,BrowsableAPIRenderer]
全局使用：在settings中配置
'DEFAULT_RENDERER_CLASSES':( 'rest_framework.renderers.JSONRenderer', 'rest_framework.renderers.BrowsableAPIRenderer', ),
五：url控制器
自动生成路由：
在url.py中：
from rest_framework import routers #生成一个router对象 router=routers.DefaultRouter() # 两个参数，一个是匹配的路由，一个是视图中写的CBV的类 router.register('books',views.BooksView) urlpatterns = [ url(r'',include(router.urls)) ]
六：解析器
解析器的作用：能够解析前端传递的数据格式：urlencode,formdata,json格式
默认情况下解析所有格式内置了三种解析器
from rest_framework.parsers import JSONParser from rest_framework.parsers import FormParser from rest_framework.parsers import MultiPartParser
解析器的局部使用：
在视图类中配置：parser_classes=[JSONParser]
全局使用：在settings.py中配置：
'DEFAULT_PARSER_CLASSES': ( 'rest_framework.parsers.JSONParser', 'rest_framework.parsers.FormParser', 'rest_framework.parsers.MultiPartParser' )