Django_rest_framework_渲染器/解析器/路由控制/分页

目录

渲染器

解析器

路由控制

分页

渲染器

简介

什么是渲染器

根据 用户请求URL 或 用户可接受的类型，筛选出合适的 渲染组件。

渲染器的做用

序列化、友好的展现数据

渲染器配置

首先要在settins.py中将rest_framework组件加进去

 

局部配置渲染器

引入渲染器类，而后将他们做为一个列表的元素赋值给renderer_classes 配置属性，以下：

1 2 3 4 5 6

from  rest_framework.renderers  import  JSONRenderer,BrowsableAPIRenderer   class  BookViewSet(APIView):      renderer_classes  =  [JSONRenderer,BrowsableAPIRenderer]      def  get( self ,request):          return  Response( '...' )

BrowsableAPIRenderer的渲染效果以下

 

1	JSONRenderer类的就是只渲染数据，以下：

 

能够看到，只是简单的数据展现

全局配置渲染器

在setting.py文件中加入以下配置：

1 2 3 4 5

REST_FRAMEWORK  =  {      'DEFAULT_RENDERER_CLASSES' :[ 'rest_framework.renderers.JSONRenderer' , 'rest_framework.renderers.BrowsableAPIRenderer' ,],   ... }

 

解析器

咱们都知道，网络传输数据只能传输字符串格式的，若是是列表、字典等数据类型，须要转换以后才能使用

可是咱们以前的rest_framework例子都没有转换就直接可使用了，这是由于rest_framework有一套解析器，

默认他会帮咱们转换3种类型的数据，分别是,JSONParser,FormParser,MultiPartParser

局部解析器

若是咱们须要转换其余数据，须要在视图类里配置parser_classes参数，以下：

1 2	from  rest_framework.parsers  import  JSONParser,FormParser,MultiPartParser,FileUploadParser parser_classes  =  [JSONParser,FormParser,FileUploadParser]

全局解析器

REST_FRAMEWORK={
    "DEFAULT_PARSER_CLASSES":['rest_framework.parsers.FormParser',]
}

路由控制

咱们以前在写例子的时候，视图类已经封装到最精简版本了，可是url变的比以前复杂了，以下：

1 2	url(r '^publishes/$' , views.PublishViewSet.as_view({ 'get' : 'list' , 'post' : 'create' })), url(r '^publishes/(?P<pk>\d+)/$' , views.PublishViewSet.as_view({ 'get' : 'retrieve' , 'put' : 'update' , 'delete' : 'destroy' , 'patch' : 'partial_update' })),

　　上面只是一个视图类对应的url，若是项目作的很大，那么url会变的很是臃肿，

而rest_framework给咱们封装了一种自动注册url的功能，格式以下：

1 2 3 4 5 6 7 8 9 10 11

from  django.conf.urls  import  url from  django.contrib  import  admin from  app01  import  views   from  django.conf.urls  import  include from  rest_framework  import  routers   # 实例化一个routers对象 routers  =  routers.DefaultRouter() # 往对象里注册（添加）url routers.register( 'publishes' ,views.PublishViewSet)

　　而后，在urlpatterns中添加已经注册的url(在routers.urls里)，以下：

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

　　完整版的urlpatterns配置

1 2 3 4 5 6 7 8 9 10 11

urlpatterns  =  [      url(r '^admin/' , admin.site.urls),        url(r '^login/' , views.Login.as_view()),        url(r '^authors/$' , views.AuthorsView.as_view()),      url(r '^authors/(\d+)/$' , views.AuthorsDetailView.as_view()),          url(r'',include(routers.urls)) ]

　　这个时候，rest_framework会帮咱们自动添加了4个url，以下图:

 示例

from django.contrib import admin
from django.urls import path,re_path,include

urlpatterns = [
    re_path("testrestfulframework/",include("testrestfulframework.urls")),
]



####### testrestfulframework.urls.py ###########
from django.urls import path,re_path,include
from testrestfulframework import views
from rest_framework import routers

# 实例化一个routers对象
routers = routers.DefaultRouter()
# 往对象里注册（添加）url
routers.register('books', views.BookViewSet)
routers.register('publish', views.PublishViewSet)


urlpatterns = [
    # re_path(r"login/$",views.LoginViewSet.as_view()),
    # re_path(r"books/$",views.BookViewSet.as_view()),
    # re_path(r"books/(?P<pk>\d+)$",views.BookDetailViewSet.as_view()),
    re_path(r'',include(routers.urls)),
]

urls.py

urls.py

from django.db import models


class Book(models.Model):
    title=models.CharField(max_length=32)
    price=models.IntegerField()
    pub_date=models.DateField()
    publish=models.ForeignKey("Publish",on_delete=models.CASCADE)
    authors=models.ManyToManyField("Author")
    def __str__(self):
        return self.title

class Publish(models.Model):
    name=models.CharField(max_length=32)
    email=models.EmailField()
    def __str__(self):
        return self.name

class Author(models.Model):
    name=models.CharField(max_length=32)
    age=models.IntegerField()
    def __str__(self):
        return self.name


class User(models.Model):
    username = models.CharField(max_length=16)
    password = models.CharField(max_length=64)
    role = models.IntegerField(default=1)


class Token(models.Model):
    token = models.CharField(max_length=128)
    user = models.ForeignKey(to=User,on_delete=models.CASCADE)

models.py

# -*- coding:utf-8 -*-
from rest_framework import serializers
from testrestfulframework import models


class BookSerializers(serializers.ModelSerializer):
    # publish = serializers.HyperlinkedIdentityField(
    #     view_name='publish_detail',
    #     lookup_field="publish_id",
    #     lookup_url_kwarg="pk")


    class Meta:
        model = models.Book
        fields = "__all__"
        # depth=1


class PublshSerializers(serializers.ModelSerializer):
    class Meta:
        model = models.Publish
        fields = "__all__"
        # depth = 1

class AuthorSerializers(serializers.ModelSerializer):

    class Meta:
        model = models.Author
        fields = "__all__"
        # depth = 1

serializers.py

from rest_framework import viewsets
from testrestfulframework import models
from testrestfulframework import serializers

class BookViewSet(viewsets.ModelViewSet):
    queryset = models.Book.objects.all()
    serializer_class = serializers.BookSerializers


class PublishViewSet(viewsets.ModelViewSet):
    queryset = models.Publish.objects.all()
    serializer_class = serializers.PublshSerializers

views.py

 

 

 

 

分页

分页种类

# service/pagination.py

from rest_framework.pagination import PageNumberPagination,LimitOffsetPagination,CursorPagination

class MyPageNumberPagination(PageNumberPagination):
    # 定义一个PageNumberPagination的子类
    # 如需改变参数，重写其属性便可
    page_size = 2       #每页显示条数
    page_query_param = 'page'   # url中的参数的key
    page_size_query_param="size"    # 能够在url中使用size参数临时改变当页显示的数目
    max_page_size=10 # 能够在url中使用size参数临时改变当页显示的数目，可是最大只能显示10条。格式：url?size=20


class MyLimitOffsetPagination(LimitOffsetPagination):
    default_limit =10#一页默认几个
    limit_query_param = 'limit' #关键字后面跟的是一页显示几个
    offset_query_param = 'offset'#这个后面跟的是从哪里显示
    max_limit = 50 #能够在url中使用limit参数临时改变当页显示的数目，可是最大只能显示50条。格式：url?limit=20


class MyCursorPagination(CursorPagination):
    cursor_query_param = 'cursor'#关键字，c
    page_size =5 #每页默认的数量
    ordering = 'price'#按照id排列
    page_size_query_param ='page_size'#每页显示的数量

继承APIView类的视图中添加分页

class AuthorsView(APIView):
    def get(self,request):
        '''分页展现做者列表'''
        author_list = models.Author.objects.all()
        # 分页
        # 实例化一个本身定义的MyPageNumberPagination对象
        pnp = MyPageNumberPagination()
        # 调用paginate_queryset方法来生成新的author_list
        # 参数分别为，author_list，request以及当前的视图
        page_author_list = pnp.paginate_queryset(author_list,request,self)
        # 在将新生成的page_author_list序列化
        auts = serializer.AuthorModelSerializers(page_author_list,many=True)
        return Response(auts.data)

class BaseResponse(object):
    def __init__(self,code=1000,data=None,error=None):
        self.code=code
        self.data=data
        self.error=error


class IndexView(APIView):
    def get(self,request,*args,**kwargs):
        ret=BaseResponse()
        try:
            user_list=models.UserInfo.objects.all()#找到全部的数据项
            p1 = P1()#实例化分页器，
            page_user_list=p1.paginate_queryset(queryset=user_list,request=request,view=self)#把数据放在分页器上面
            ser=IndexSerializer(instance=page_user_list,many=True)#序列化数据
            ret.data=ser.data
            ret.next=p1.get_next_link()
        except Exception as e:
            ret.code=1001
            ret.error='xxxx错误'

另外一个例子

继承ModelViewSet类的视图中添加分页

若是咱们的视图继承了ModelViewSet类，那么如需分页的时候，只须要在视图类中加入配置参数便可，以下：

1	pagination_class  =  MyPageNumberPagination

　　注意：

　　　　一、MyPageNumberPagination类是咱们本身定义的类，见上面一个示例。

　　　　二、pagination_class后面直接跟上类名便可，无需加列表（由于分页不想其余组件，分页只可能有一个）

全局配置分页属性

只须要在REST_FRAMEWORK配置中加入 配置属性的键值对便可，以下：

1 2 3 4

REST_FRAMEWORK  =  {      .....      "PAGE_SIZE" : 1 }

示例

以上多种方式均实现了3中分页方式PageNumberPagination,LimitOffsetPagination,CursorPagination，过程略。

 

参考or转发

http://www.javashuo.com/article/p-kukrfqbc-en.html

http://www.cnblogs.com/fu-yong/p/9067690.html