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

url中需要写

 url(r'(?P<version>[v1|v2])/register/$',views.Register.as_view()),
 url(r'(?P<version>[v1|v2])/register\.(?P<format>\w+)$',views.Register.as_view()),
 url(r'(?P<version>[v1|v2])/register/(?P<pk>\d+)$',views.Register.as_view()),

写访问路由的的时候要写上版本

全局使用

　　在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'register/$',views.Register.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

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)

源码分析

#执行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)