DRF url控制 解析器 响应器 版本控制 分页(常规分页,偏移分页,cursor游标分页)

Posted lakei

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了DRF url控制 解析器 响应器 版本控制 分页(常规分页,偏移分页,cursor游标分页)相关的知识,希望对你有一定的参考价值。

url控制

第二种写法(只要继承了ViewSetMixin)

     url(r^pub/$,views.Pub.as_view(get:list,post:create)), #获取所有记得路由后面加$结束符  #pub/?format=json
     url(r^pub\\.(?P<format>\\w+)$,views.Pub.as_view(get:list,post:create)),       #pub.json
     url(r^pub/(?P<pk>\\d+)$,views.Pub.as_view(get:retrieve,put:update,delete:destroy)),   #获取一条

第三种(自动生成路由,必须继承ModelViewSet)

from django.conf.urls import url,include

  SimpleRouter 自动生成两条路由

from rest_framework.routers import SimpleRouter,DefaultRouter #路由控制

router = SimpleRouter()
router.register(pub,views.Pub)

urlpatterns = [
    url(r^admin/, admin.site.urls),
    #其他路由

    url(r‘‘,include(router.urls)),]

  DefaultRouter自动生成四条路由

from rest_framework.routers import SimpleRouter,DefaultRouter #路由控制

router = DefaultRouter()
router.register(pub,views.Pub)

urlpatterns = [
    url(r^admin/, admin.site.urls),
    #其他路由
    url(r‘‘,include(router.urls)),]

 

解析器(一般不需要动,项目最开始全局配置一下就可以了)

作用:控制视图类能够解析前端传过来的格式是什么样的 (默认配置三种都有) 有application/json,x-www-form-urlencoded,form-data等格式

全局使用:在settings中配置:

REST_FRAMEWORK = 
                    "DEFAULT_PARSER_CLASSES":[
                        rest_framework.parsers.JSONParser,]

局部使用:

from rest_framework.parsers import JSONParser,FormParser,MultiPartParser,FileUploadParser
                                    #json字典 urlencoded  form-data       文件

  在视图类中

parser_classes=[JSONParser,]

源码流程

  当调用request.data的时候去执行解析方法

技术图片

-->根据传过来的编码方式选择一个解析器对象

技术图片

--->调用解析器对象的parser方法完成解析

 

技术图片

 

技术图片
在调用request.data时,才进行解析,由此入手
    @property
    def data(self):
        if not _hasattr(self, _full_data):
            self._load_data_and_files()
        return self._full_data
查看self._load_data_and_files()方法---->self._data, self._files = self._parse()

        def _parse(self):
            #用户请求头里content_type的值
            media_type = self.content_type

            #self.parsers 就是用户配置的parser_classes = [FileUploadParser,FormParser ]
            #self里就有content_type,传入此函数
            parser = self.negotiator.select_parser(self, self.parsers)
查看self.negotiator.select_parser(self, self.parsers)
     def select_parser(self, request, parsers):
        #同过media_type和request.content_type比较,来返回解析器,然后调用解析器的解析方法
        #每个解析器都有media_type = ‘multipart/form-data‘属性
        for parser in parsers:
            if media_type_matches(parser.media_type, request.content_type):
                return parser
        return None
最终调用parser的解析方法来解析parsed = parser.parse(stream, media_type, self.parser_context)
源码注释
技术图片
Request实例化,parsers=self.get_parsers()
    Request(
                request,
                parsers=self.get_parsers(),
                authenticators=self.get_authenticators(),
                negotiator=self.get_content_negotiator(),
                parser_context=parser_context
            )
get_parsers方法,循环实例化出self.parser_classes中类对象
    def get_parsers(self):
        return [parser() for parser in self.parser_classes]            
self.parser_classes 先从类本身找,找不到去父类找即APIVIew 中的
    parser_classes = api_settings.DEFAULT_PARSER_CLASSES
api_settings是一个对象,对象里找DEFAULT_PARSER_CLASSES属性,找不到,会到getattr方法
        def __getattr__(self, attr):
            if attr not in self.defaults:
                raise AttributeError("Invalid API setting: ‘%s‘" % attr)

            try:
                #调用self.user_settings方法,返回一个字典,字典再取attr属性
                val = self.user_settings[attr]
            except KeyError:
                # Fall back to defaults
                val = self.defaults[attr]

            # Coerce import strings into classes
            if attr in self.import_strings:
                val = perform_import(val, attr)

            # Cache the result
            self._cached_attrs.add(attr)
            setattr(self, attr, val)
            return val
user_settings方法 ,通过反射去setting配置文件里找REST_FRAMEWORK属性,找不到,返回空字典
    @property
    def user_settings(self):
        if not hasattr(self, _user_settings):
            self._user_settings = getattr(settings, REST_FRAMEWORK, )
        return self._user_settings
源码注释2

 

 

响应器

 解析成字符串 还是一个浏览器页面

from rest_framework.renderers import JSONRenderer,BrowsableAPIRenderer  #解析成字符串 还是浏览器样式的
# 不用动,就用全局配置即可默认配置中两个都有

全局使用

  在settings中配置 settings默认配置中两个都有

REST_FRAMEWORK = 
    DEFAULT_PARSER_CLASSES:[
        rest_framework.parsers.JSONParser,
    ],
    # 响应器 默认配置两个都由 这个是全局使用
# ‘DEFAULT_PARSER_CLASSES‘:[ ‘rest_framework.renderers.JSONRenderer‘,
#         ‘rest_framework.renderers.BrowsableAPIRenderer‘,]
    

局部使用

  在试图类中配置

renderer_classes = [JSONRenderer, BrowsableAPIRenderer]    

 

版本控制

 作用用于控制版本    视图中 版本问题需要接受版本传过来的参数 注意是单个没有复数

内置版本控制

from rest_framework.versioning import QueryParameterVersioning,AcceptHeaderVersioning,NamespaceVersioning,URLPathVersioning

#基于url的get传参方式:QueryParameterVersioning------>如:/users?version=v1
#基于url的正则方式:URLPathVersioning------>/v1/users/
#基于 accept 请求头方式:AcceptHeaderVersioning------>Accept: application/json; version=1.0
#基于主机名方法:HostNameVersioning------>v1.example.com
#基于django路由系统的namespace:NamespaceVersioning------>example.com/v1/users/

局部使用

#在CBV类中加入
versioning_class = URLPathVersioning
 

全局使用

  在settings中配置

REST_FRAMEWORK = 
    "DEFAULT_PARSER_CLASSES":[
        rest_framework.parsers.JSONParser,
    ],
    DEFAULT_VERSIONING_CLASS:rest_framework.versioning.URLPathVersioning,
    DEFAULT_VERSION: v1,  # 默认版本(从request对象里取不到,显示的默认值)
    ALLOWED_VERSIONS: [v1, v2],  # 允许的版本
    VERSION_PARAM: version,  # URL中获取值的key

路由需要修改

url(r^(?P<version>[v1|v2]+)/test/,views.Test.as_view())

在试图类中就可以通过,request.vesrsion取出当前访问哪个版本,相应的去执行相应版本的代码

 

示例

基于正则的方式

技术图片
from django.conf.urls import url, include
from web.views import TestView

urlpatterns = [
    url(r^(?P<version>[v1|v2]+)/test/, TestView.as_view(), name=test),
]

url
View Code
技术图片
from rest_framework.views import APIView
from rest_framework.response import Response
from rest_framework.versioning import URLPathVersioning


class TestView(APIView):
    versioning_class = URLPathVersioning

    def get(self, request, *args, **kwargs):
        # 获取版本
        print(request.version)
        # 获取版本管理的类
        print(request.versioning_scheme)

        # 反向生成URL
        reverse_url = request.versioning_scheme.reverse(test, request=request)
        print(reverse_url)

        return Response(GET请求,响应内容)

views.py
View.py
技术图片
        # 基于django内置,反向生成url
        from django.urls import reverse
        url2=reverse(viewname=ttt,kwargs=version:v2)
        print(url2)
View Code

 

源码分析

#执行determine_version,返回两个值,放到request对象里
version, scheme = self.determine_version(request, *args, **kwargs)
request.version, request.versioning_scheme = version, scheme

def determine_version(self, request, *args, **kwargs):
        #当配置上版本类之后,就会实例化
        if self.versioning_class is None:
            return (None, None)
        scheme = self.versioning_class()
        return (scheme.determine_version(request, *args, **kwargs), scheme)

 

分页

 

 常规分页   查看第n页 每页显示多少条

#分页                                 #常规分页                   偏移分页        cursor游标分页
from rest_framework.pagination import PageNumberPagination,LimitOffsetPagination,CursorPagination

class PublishView(APIView):
    versioning_class = URLPathVersioning
    parser_classes = [JSONRenderer,]    #解析器

    def get(self,request,*args,**kwargs):
        #第一种方法,普通分页
        ‘‘‘
        查询出所有数据
        实例化产生一个普通分页对象
        每页显示多少条
        查询指定查询那一页的key值
        ‘‘‘
        ret= models.Publish.objects.all()
        page = PageNumberPagination()
        page.page_size = 3 #每页显示多少条 
        page.page_query_param = page  #按照page名词显示那一页

        # 前端控制每页显示多少条的查看key值必然要size=9,表示一页显示9条
        page.page_size_query_param = size
        #控制每页最大显示多少,size如果传100,最多也是显示10
        page.max_page_size = 10
        ret_page = page.paginate_queryset(ret,request,self)
        #序列化
        pub_ser = PublishSerlizers(ret_page,many=True)
        #去settings中配置每页显示多少条    这个是全局配置的话 局部配置全局可以不配置

        return Response(pub_ser.data)

settings中配置

REST_FRAMEWORK = 
    # 每页显示两条
    PAGE_SIZE:2

路由

  url(r^(?P<version>[v1|v2]+)/publish/,views.PublishView.as_view())

serializer

from rest_framework.serializers import  ModelSerializer
from app01 import models
class PublishSerlizers(ModelSerializer):
    class Meta:
        model = models.Publish
        fields = __all__

 

偏移分页   在第n个位置向前向后查询第n个位置

#分页                                 #常规分页                   偏移分页        cursor游标分页
from rest_framework.pagination import PageNumberPagination,LimitOffsetPagination,CursorPagination

class PublishView(APIView):
    versioning_class = URLPathVersioning
    parser_classes = [JSONRenderer,]    #解析器

    def get(self,request,*args,**kwargs):   #偏移分页
        ret = models.Publish.objects.all()
        #实例化产生一个偏移分页对象
        page= LimitOffsetPagination()
        # 四个参数:
        # 从标杆位置往后取几个,默认取3个,可以指定
        page.default_limit = 3
        # 每条取得条数
        page.limit_query_param =limit
        # 标杆值,现象偏移到那个位置,如果offset=6, 表示当前在第6条位置上,往后取
        page.offset_query_param = offset
        # 最大取10条
        page.max_limit = 10

        ret_page = page.paginate_queryset(ret,request,self)
        #序列化
        pub_ser= PublishSerlizers(ret_page,many=True)
        #取settings中配置每页显示多少条
        return page.get_paginated_response(pub_ser.data)

 

 cursor游标分页

from rest_framework.pagination import PageNumberPagination,LimitOffsetPagination,CursorPagination
class PublishView(APIView):
    versioning_class = URLPathVersioning
    parser_classes=[JSONParser,]
    
    def get(self, request, *args, **kwargs):
        ret = models.Publish.objects.all()
        # 实例化产生一个偏移分页对象
        page = CursorPagination()
        #三个参数:
        #每页显示的大小
        page.page_size=3
        #查询的key值
        page.cursor_query_param=cursor
        # 按什么排序
        page.ordering=id

        ret_page = page.paginate_queryset(ret, request, self)
        # 序列化
        pub_ser = serializer.PublishSerializers(ret_page, many=True)
        # 去setting中配置每页显示多少条
        return page.get_paginated_response(pub_ser.data)

 

以上是关于DRF url控制 解析器 响应器 版本控制 分页(常规分页,偏移分页,cursor游标分页)的主要内容,如果未能解决你的问题,请参考以下文章

路由控制,版本控制,解析器,响应器

url,解释器,响应器,版本控制,分页

解析器,路由控制,响应器

(了解)rest_framework之版本控制, 响应器, url控制器

DjangoRestFramework学习三之认证组件权限组件频率组件url注册器响应器分页组件

DRF 版本认证权限限制解析器和渲染器