rest-framework解析器,url控制，分页,响应器,渲染器,版本控制

解析器

1.json解析器

发一个json格式的post请求。
后台打印：
request_data---> {'title': '北京折叠'}
request.POST---> <QueryDict: {}>

2.urlencode解析器

request_data---> <QueryDict: {'title': ['北京'], 'price': ['']}>
request.POST---> <QueryDict: {'title': ['北京'], 'price': ['']}>

rest-framework默认支持的有3种解析器，json，form,文件上传。而Django原生只支持form的解析，不支持json的解析。

源码：

JSON解析器类：

class JSONParser(BaseParser):
    """
    Parses JSON-serialized data.
    """
    media_type = 'application/json'
    renderer_class = renderers.JSONRenderer
    strict = api_settings.STRICT_JSON

    def parse(self, stream, media_type=None, parser_context=None):
        """
        Parses the incoming bytestream as JSON and returns the resulting data.
        """
        parser_context = parser_context or {}
        encoding = parser_context.get('encoding', settings.DEFAULT_CHARSET)

        try:
            decoded_stream = codecs.getreader(encoding)(stream)
            parse_constant = json.strict_constant if self.strict else None
            return json.load(decoded_stream, parse_constant=parse_constant)
        except ValueError as exc:
            raise ParseError('JSON parse error - %s' % six.text_type(exc))

form解析器类：

class FormParser(BaseParser):
    """
    Parser for form data.
    """
    media_type = 'application/x-www-form-urlencoded'

    def parse(self, stream, media_type=None, parser_context=None):
        """
        Parses the incoming bytestream as a URL encoded form,
        and returns the resulting QueryDict.
        """
        parser_context = parser_context or {}
        encoding = parser_context.get('encoding', settings.DEFAULT_CHARSET)
        data = QueryDict(stream.read(), encoding=encoding)
        return data
        

文件上传类：

class MultiPartParser(BaseParser):
    """
    Parser for multipart form data, which may include file data.
    """
    media_type = 'multipart/form-data'

    def parse(self, stream, media_type=None, parser_context=None):
        """
        Parses the incoming bytestream as a multipart encoded form,
        and returns a DataAndFiles object.

        `.data` will be a `QueryDict` containing all the form parameters.
        `.files` will be a `QueryDict` containing all the form files.
        """
        parser_context = parser_context or {}
        request = parser_context['request']
        encoding = parser_context.get('encoding', settings.DEFAULT_CHARSET)
        meta = request.META.copy()
        meta['CONTENT_TYPE'] = media_type
        upload_handlers = request.upload_handlers

        try:
            parser = DjangoMultiPartParser(meta, stream, upload_handlers, encoding)
            data, files = parser.parse()
            return DataAndFiles(data, files)
        except MultiPartParserError as exc:
            raise ParseError('Multipart form parse error - %s' % six.text_type(exc))

URL控制

1.因为每次url都需要写下面的2条线，导致代码冗余。

 # url(r'authors/$', views.AuthorModelView.as_view({"get":"list","post":"create"}),name="authors"),
 # url(r'authors/(?P<pk>\d+)/$', views.AuthorModelView.as_view({"get":"retrieve","put":"update","delete":"destroy"}),name="authordetail"),

2.使用rest-framework提供的：

from django.conf.urls import url,include
from app01 import views

from rest_framework import routers
routers=routers.DefaultRouter()
routers.register("authors",views.AuthorModelView)

url中需要加这一句即可：

url(r'',include(routers.urls)),

以后每一个表，注册一下即可，前面的是url的前缀，后面是对应的视图类。

测试结果以及自动生成的url路径如下图：（可以直接.json取到结果）

生成的URL：

分页

1.基本分页器:

from rest_framework.pagination import PageNumberPagination
#自己写一个继承分页器，然后自己设置
class MyPageNumberPagination(PageNumberPagination):
    page_size = 2                    #每个页面显示多少数据
    page_query_param = "page"        #？page  的名字，默认"page",可以改其他
    page_size_query_param = "size"   #临时的一个分页数目，虽然最多2条，但是可以临时扩大每页显示的数据数量
    max_page_size = 3                #虽然临时的可以调，但不能无限大，做一个最大临时限制。

class BookView(APIView):
    # authentication_classes = [TokenAuth]
    def get(self,request):
        print(request.user)   #token_obj.user.name
        print(request.auth)   #token_obj.token
        book_list=Book.objects.all()
        #加入分页
        pnp=MyPageNumberPagination()   #分页器实例对象
        books_page=pnp.paginate_queryset(book_list,request,self)    #传入数据

        bs2=BookModelSerializers(books_page,many=True,context={'request': request}) #将分好的数据进行序列化并展示
        return Response(bs2.data)

2.偏移分页器（很少用到）：

from rest_framework.pagination import LimitOffsetPagination

和上面一模一样，只是加了一个offset的偏移参数。

3.对于高度封装的视图类怎么使用分页器：

from rest_framework import viewsets
class AuthorModelView(viewsets.ModelViewSet):
    queryset=Author.objects.all()
    serializer_class=AuthorModelSerializers
    pagination_class = MyPageNumberPagination

因为这个作者的视图进行了高度的封装，显然重写list方法并且进行分页展示非常的麻烦，那么使用一个

pagination_class =你自己继承分页器并且定制好的分页器类即可完成分页。

4.全局配置分页数目：

settings中进行配置。

REST_FRAMEWORK={
    # "DEFAULT_AUTHENTICATION_CLASSES":["app01.utils.TokenAuth",],
    # "DEFAULT_PERMISSION_CLASSES":["app01.utils.SVIPPermission",],
    "PAGE_SIZE":3,
}

响应器

from rest_framework.response import Response

针对rest-frarmwork返回的数据进行各种操作，如果使用浏览器，那么响应器会渲染一个页面出来提供各种操作，如果使用postman,只返回一堆数据。

具体如下图：

postman:

浏览器上：

这个页面可进行option,delete,put操作。

针对所有数据，下面可以进行get和post请求。

                             渲染器

---

这里可以使用Json的渲染器

---

也可以是这种页面形式的（用的少）

---

全局配置渲染器：

版本控制

1.先导入

from rest_framework.versioning import QueryParameterVersioning,URLPathVersioning

2.在APIView中

3.局部配置

4.全局配置

settings中配置：

REST_FRAMEWORK={
    # "DEFAULT_AUTHENTICATION_CLASSES":["app01.utils.TokenAuth",],
    # "DEFAULT_PERMISSION_CLASSES":["app01.utils.SVIPPermission",],
    "PAGE_SIZE":1,
    # 配置全局渲染器（Json格式的，和那种页面形式的）
    # 'DEFAULT_RENDERER_CLASSES':['rest_framework.renderers.JSONRenderer',]
    'DEFAULT_VERSION_CLASS':'rest_framework.versioning.QueryParameterVersioning',#使用哪种版本控制
    'ALLOWED_VERSIONS':['v1','v2'],  #允许的版本
    'VERSION_PARAM':'version',       #参数
    'DEFAULT_VERSION':'v1',           #默认版本

}

5.对于两种不同的配置要说的是。

（1）对于QueryParameterVersioning这种

在url后缀加上版本。

后端通过request.version就可以拿到这个版本

（2）对于URLPathVersioning（推荐使用）

这个实在URL里面直接写。

首先要在url做一个配置。

 url(r'^(?P<version>\w+)/books/$', views.BookView.as_view(),name="books"),

get请求参数拿到这个version。

    def get(self,request,*args,**kwargs):
        print("version",request.version)
        #print(request.user)   #token_obj.user.name
        #print(request.auth)   #token_obj.token
        book_list=Book.objects.all()
        #加入分页
        pnp=MyPageNumberPagination()
        books_page=pnp.paginate_queryset(book_list,request,self)

        # bs=BookSerializers(book_list,many=True)
        bs2=BookModelSerializers(books_page,many=True,context={'request': request})
        # return Response(bs.data)
        return Response(bs2.data)

前端页面的URL是

因为在全局做了允许配置，所以只能是v1,v2如果输入其他会报错。

这就是版本控制。