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

解析器

1.json解析器

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

2.urlencode解析器

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

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如果输入其他会报错。

这就是版本控制。








原文地址:https://www.cnblogs.com/geogre123/p/9750057.html