drf复习

序列化器:

  作用:

    1.序列化:把模型类对象转化成字典,经过response之后变成json字符串

    2.反序列化:把字典转化成模型类对象(客户端发送过来的数据,经过request之后变成字典)

    3.完成数据校验功能(反序列化)

序列化:

  定义好Serializer类后,就可以创建Serializer对象

   Serializer(instance=None, data=empty, **kwarg) 

  1.用于序列化的时候,将模型类对象传入instance参数(xxx.data获取序列化后的字典)

  2.用于反序列化时,将要被反序列化的数据传入data参数

  3.除了instance和data参数外,在构造Serializer对象时,还可通过context参数额外添加数据,如 serializer = AccountSerializer(account, context={'request': request}) 通过context参数附加的数据,可以通过Serializer对象的context属性获取

  4.如果序列化的不是单个模型类对象,而是查询集QuerySet,则使用many=True说明,例 serializer = StudentSerializer(instance=student_list,many=True) 

反序列化:

  (xxx代表序实例化的列化器对象)

  1.在获取反序列化的数据之前,必须调用is_valid()方法进行验证,成功返回True,失败False(通过xxx.errors获取错误信息)(还可以在失败时抛出异常,传递raise_exception=True参数开启,例 xxx.is_valid(raise_exception=True )

  2.验证成功,使用xxx.validated_data属性获取数据

  3.定义序列化器时,指明每个字段的序列号类型和选项参数,本身就是一种验证行为,还有三种验证方法

  验证方法:

    验证完成以后务必要返回传入的数据,失败 raise serializers.ValidationError("原因") 

    1.def validate_<字段名>(用户提交的字段数据):

    2.def validate(实例化序列化器类时的data参数):

    3.在序列化类外面定义方法,在字段里直接使用 validators=[定义的方法] 

  序列化器实现了create跟update方法,如果创建序列化器对象的时候,没有传递instance实例,则调用save()方法的时候,create()被调用,相反,如果传递了instance实例,则调用save()方法的时候,update()被调用。

  说明:

    1.在对序列化器进行save()保存时,可以额外传递数据,这些数据可以在create()和update()中的validated_data参数获取到 serializer.save(owner=request.user) 

    2.默认序列化器必须传递所有required的字段,否则会抛出验证异常。但是我们可以使用partial参数来允许部分字段更新 serializer = StudentSerializer(instance=instance, data=data, partial=True) 

模型类序列化器

ModelSerializer与常规的Serializer相同,但提供了:

  1.基于模型类自动生成一系列字段

  2.基于模型类自动为Serializer生成validators,比如unique_together

  3.包含默认的create()和update()的实现

from rest_framework import serializers
from students.models import Student
class StudentModelSerializer(serializers.ModelSerializer):

    # 如果模型类序列化器,必须声明本次调用是哪个模型,模型里面的哪些字段
    class Meta:
        model = Student
        fields = ["id","name","age","description","sex"]
        # fields = "__all__" # 表示操作模型中的所有字段

      exclude = ['sex']
      # 使用exclude可以明确排除掉哪些字段

        read_only_fields = ('id')
        # 可以通过read_only_fields指明只读字段,即仅用于序列化输出的字段

        # 添加额外的验证选项
        extra_kwargs = {
            "sex":{"write_only":True,},
            "id":{"read_only":True,}
        }      

视图

请求与响应

request:REST framework 提供了Parser解析器,在接收到请求后会自动根据Content-Type指明的请求数据类型(如JSON、表单等)将请求数据进行parse解析,解析为类字典[QueryDict]对象保存到Request对象中。

常用属性:

  1.request.data返回解析之后的请求体数据,类似django中标准的request.POST

    特性:

      1.包含了解析之后的文件和非文件数据

      2.包含了对POST、PUT、PATCH请求方式解析后的数据

      3.利用了REST framework的parsers解析器,不仅支持表单类型数据,也支持JSON数据

  2.request.query_params与Django标准的request.GET相同,只是更换了更正确的名称而已

response:REST framework提供了一个响应类Response,使用该类构造响应对象时,响应的具体数据内容会被转换(render渲染)成符合前端需求的类型。

REST framework提供了Renderer 渲染器,用来根据请求头中的Accept(接收数据类型声明)来自动转换响应数据到对应格式。

两个基类视图

APIView:传入的是改动后的request

GenericAPIView:继承自APIVIew主要增加了操作序列化器和数据库查询的方法,作用是为下面Mixin扩展类的执行提供方法支持。通常在使用时,可搭配一个或多个Mixin扩展类。

  属性:

    Serializer_class:指明视图使用的序列化器

    queryset: 指明使用的数据查询集

  方法:

    1.get_serializer_class(self),返回序列化器类,默认返回serializer_class,可以重写(多个序列化器的时候)

     2.get_serializer(self,args,*kwargs),返回序列化器对象

     

    1.get_queryset(self),返回视图使用的查询集,主要用来提供给Mixin扩展类使用,是列表视图与详情视图获取数据的基础,默认返回queryset属性,可以重写

    2.get_object(self),返回详情视图所需的模型类数据对象,主要用来提供给Mixin扩展类使用。

五个视图扩展类

作用:

  提供了几种后端视图(对数据资源进行曾删改查)处理流程的实现,如果需要编写的视图属于这五种,则视图可以通过继承相应的扩展类来复用代码,减少自己编写的代码量。

这五个扩展类需要搭配GenericAPIView父类,因为五个扩展类的实现需要调用GenericAPIView提供的序列化器与数据库查询的方法。

使用:定义好get、post等方法,将视图扩展类提供的函数作为返回值

ListModelMixin

  列表视图扩展类,提供list(request, *args, **kwargs)方法快速实现列表视图,返回200状态码。

  使用:

from rest_framework.mixins import ListModelMixin

class BookListView(ListModelMixin, GenericAPIView):
    queryset = BookInfo.objects.all()
    serializer_class = BookInfoSerializer

    def get(self, request):
        return self.list(request)

CreateModelMixin

  提供create(request, *args, **kwargs)方法快速实现创建资源的视图,成功返回201状态码。

如果序列化器对前端发送的数据验证失败,返回400错误。

RetrieveModelMixin

  提供retrieve(request, *args, **kwargs)方法,可以快速实现返回一个存在的数据对象。

如果存在,返回200, 否则返回404。

UpdateModelMixin

  提供update(request, *args, **kwargs)方法,可以快速实现更新一个存在的数据对象。

成功返回200,序列化器校验数据失败时,返回400错误。

  同时也提供partial_update(request, *args, **kwargs)方法,可以实现局部更新。

 

 

DestroyModelMixin

  提供destroy(request, *args, **kwargs)方法,可以快速实现删除一个存在的数据对象。

成功返回204,不存在返回404。

 

GenericAPIView的视图子类

1)CreateAPIView

提供 post 方法

继承自: GenericAPIView、CreateModelMixin

2)ListAPIView

提供 get 方法

继承自:GenericAPIView、ListModelMixin

3)RetrieveAPIView

提供 get 方法

继承自: GenericAPIView、RetrieveModelMixin

4)DestoryAPIView

提供 delete 方法

继承自:GenericAPIView、DestoryModelMixin

5)UpdateAPIView

提供 put 和 patch 方法

继承自:GenericAPIView、UpdateModelMixin

6)RetrieveUpdateAPIView

提供 get、put、patch方法

继承自: GenericAPIView、RetrieveModelMixin、UpdateModelMixin

7)RetrieveUpdateDestoryAPIView

提供 get、put、patch、delete方法

继承自:GenericAPIView、RetrieveModelMixin、UpdateModelMixin、DestoryModelMixin

视图集

ViewSet视图集类不再实现get()、post()等方法,而是实现动作 action 如 list() 、create() 等。

视图集只在使用as_view()方法的时候,才会将action动作与具体请求方式对应上。如:

class BookInfoViewSet(viewsets.ViewSet):

    def list(self, request):
        books = BookInfo.objects.all()
        serializer = BookInfoSerializer(books, many=True)
        return Response(serializer.data)

    def retrieve(self, request, pk=None):
        try:
            books = BookInfo.objects.get(id=pk)
        except BookInfo.DoesNotExist:
            return Response(status=status.HTTP_404_NOT_FOUND)
        serializer = BookInfoSerializer(books)
        return Response(serializer.data)

在设置路由时,我们可以如下操作

urlpatterns = [
    url(r'^books/$', BookInfoViewSet.as_view({'get':'list'}),
    url(r'^books/(?P<pk>d+)/$', BookInfoViewSet.as_view({'get': 'retrieve'})
]

在ViewSet中,没有提供任何动作action方法,需要我们自己实现action方法。

原文地址:https://www.cnblogs.com/yijue-lu/p/11208588.html