drf框架（五）DRFM模块

摘要：

摘要1.整体修改和局部修改#Serialized get（将参数传递到前端）#Query ser_ Obj=ModelSerializer（model_Obj）#只传递一个参数，默认情况下为实例参数。查询数据#反序列化postsave（）=&gt；Create（）（数据保存在数据库中）#添加ser_ Obj=ModelSerializer（data=model_data）#传递数据参数，保存数据#反序列化putsa

总结

1.整体修改与局部修改

# 序列化get （给前端传递参数）  #查询
ser_obj = ModelSerializer(model_obj)   #只传递一个参数，默认是instance的参数，查询数据
# 反序列化post  save() => create()（数据保存到数据库中）  #添加
ser_obj = ModelSerializer(data=model_data)  #传递data参数，保存数据
#反序列化put save() => update()  #修改（需要传入instance和data参数）
ser_obj = ModelSerializer(instance=model_obj,data=model_data)  #默认partial参数是False,整体修改
#反序列化patch partial=True => 匹配字段required=True校验条件
ser_obj = ModelSerializer(instance=model_obj,data=model_data,partial=True)  #局部修改

2.群改ListSerializer

ser_obj = ModelSerializer(instance=model_obj,data=model_data,partial=True,many=True)
    
    # 实现群改功能，反序列化情况下的create、update就不再调用ModelSerializer的
    # 而是调用 ModelSerializer.Meta.list_serializer_class 指向的 ListSerializer 类的create、update
    # ListSerializer默认只实现了群增的create，要实现群改，必须重写update
    
　　#自定义序列化类，重写update方法
    class MyListSerializer(ListSerializer):
        def update(self, instance, validated_data):
            # print(instance)  # 要更新的对象们: [obj1, obj2, ...]
            # print(validated_data)  # 更新的对象对应的数据们: [{}, {}, ...]
            # print(self.child)  # 服务的模型序列化类 - V2BookModelSerializer
            for index, obj in enumerate(instance):
                self.child.update(obj, validated_data[index])
            return instance
            
     class MyModelSerializer(ModelSerializer):
         class Meta:
             # ...
             list_serializer_class = MyListSerializer
     
     将两者类建立关联，在MyListSerializer中就可以用self.child拿到MyModelSerializer，进而使用MyModelSerializer中封装好的方法
     cls.Meta.list_serializer_class.child = cls

**视图类views.py传递参数给序列化类serializers.py,使用context **

1）在视图类中实例化序列化对象时，可以设置context内容
2）在序列化类中的局部钩子、全局钩子、create、update方法中，都可以用self.context访问视图类传递过来的内容
需求：
# 1) 在视图类views中，可以通过request得到登陆用户request.user
# 2) 在序列化类中，要完成数据库数据的校验与入库操作，可能会需要知道当前的登陆用户，但序列化类无法访问request
# 3) 在视图类中实例化序列化对象时，将request对象传递进去

视图层:views.py (使用context传递参数到序列化层)

class Book(APIView):
    def post(self, request, *args, **kwargs):
        book_ser = serializers.BookModelSerializer(data=request_data,context={'request':request})
        book_ser.is_valid(raise_exception=True)
        book_result = book_ser.save()
        return Response({
            'status': 0,
            'msg': 'ok',
            'results': serializers.BookModelSerializer(book_result).data
        })

序列化层：serializers.py

class BookModelSerializer(ModelSerializer):
    class Meta:
        model = models.Book
        fields = ('name', 'price')
    def validate_name(self, value):
        print(self.context.get('request').method)  #POST
        return value

视图家族

views：视图
generics：工具视图
mixins：视图工具集
viewsets：视图集


学习曲线
APIView => GenericAPIView => mixins的五大工具类 => generics中的工具视图 => viewsets中的视图集

两个视图基类 APIView和GenericAPIView

1.APIView

from rest_framework.views import APIView

APIView是REST framework 提供的所有视图的基类，继承自Django的View父类
APIView与View的不同之处在于：
1.传入到视图方法中的是REST framework 的Requset对象，而不是Django的HttpRequest对象；
2.视图方法可以返回REST framework 的Response对象，视图会为响应数据设置(render)符合前端要求的格式；
3.任何APIException异常都会被捕获到，并且处理成合适的响应信息；
4.在进行dispatch()分发前，会对请求进行身份认证、权限检查、流量控制

支持自定义的属性：
authentication_classes 列表或元组，身份认证类
permission_classes 列表或元组，权限检查类
throttle_classes 列表或元组，流量控制类

在APIView中仍有get()、post()等其他请求方式的方法

from rest_framework.views import APIView
from rest_framework.response import Response

# url(r'^books/$', views.BookListView.as_view()),
class BookListView(APIView):
    def get(self, *args, **kwargs):
		book_list_obj = models.Book.objects.all()
        serializer_data = serializers.BookSerializer(book_list_obj, many=True).data
        return Response(serializre_data)

2.GenericAPIView通用视图类

GenericAPIView是继承APIView的，使用完全兼容APIView,主要增加了操作序列化器和数据库查询的方法，作用是为下面Mixin扩展类的执行提供方法支持。通常在使用时，可以配合一个或多个Mixin扩展类
重点：GenericAPIView在APIView基础上完成了哪些事
	1.get_queryset():从类属性queryset中获得model的queryset数据
	2.get_object():从类属性queryset中获取model的queryset数据，再通过有名分组pk确定唯一操作对象
	3.get_serializer():从类属性serializer_class中获得serializer的序列化类

支持的属性：

列表视图与详情视图通过：（重点）

queryset指明视图需要的数据（model查询数据）

serializer_class 指明视图使用的序列化器

列表视图使用：

1. pagination_class 分页控制类　
2. filter_backends 过滤控制后端

详情页视图使用：
1.lookup_field 自定义主键；有名分组的查询，默认是'pk'
2.lookup_url_kwarg 查询单一数据时，url中的参数关键字名称，默认与look_field相同

提供的方法：

　　1.get_queryset() 从类属性queryset中获得model的queryset数据　　

　　2.get_object() 从类属性queryset中获得model的queryset数据，再通过有名分组pk参数来过滤queryset,获取视图所需的模型类对象

　　3.get_serializer() 从类属性serializer_class中获得serializer的序列化类，主要用来提供给Mixin扩展类使用。

举例：

视图层：views.py

from rest_framework.generics import GenericAPIView
class BookGenericAPIView(GenericAPIView):
    queryset = models.Book.objects.filter(is_delete=False)
    serializer_class = serializers.BookModelSerializer
    # 自定义主键的 有名分组 名
    lookup_field = 'pk'    #先定义好，单查可以使用
    # 群取
    def get(self, request, *args, **kwargs):
        book_query = self.get_queryset()  #获取queryset数据（model查询数据）
        book_ser = self.get_serializer(book_query, many=True)
        book_data = book_ser.data
        return APIResponse(results=book_data)

    # 单取
    def get(self, request, *args, **kwargs):
        book_query = self.get_object()
        book_ser = self.get_serializer(book_query)
        book_data = book_ser.data
        return APIResponse(results=book_data)

路由层：urls.py

urlpatterns = [
    url(r'^/books/$', views.BookGenericAPIView.as_view()),
    url(r'^/books/(?P<pk>.*)/$', views.BookGenericAPIView.as_view()),
]

五个视图扩展类 mixins视图工具集-辅助GenericAPIView

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

1）mixins有五个工具类文件，一共提供了五个工具类，六个工具方法：单查、群查、单增、单删、单整体改、单局部改
2）继承工具类可以简化请求函数的实现体，但是必须继承GenericAPIView，需要GenericAPIView类提供序列化器与数据库查询的方法(见上方GenericAPIView基类知识点)
3）工具类的工具方法返回值都是Response类型对象，如果要格式化数据格式再返回给前台，可以通过 response.data 拿到工具方法返回的Response类型对象的响应数据

五个工具类：CreateModelMixin（增加）,DestroyModelMixin（删除）,ListModelMixin（查询,查queryset）,RetrieveModelMixin（查询，查对象，针对于存在"pk"）,UpdateModelMixin（修改）

1.ListModelMixin（群查）

列表视图扩展类，提供 list 方法快速实现查询视图，返回200状态码。除了查询，该list方法会对数据进行过滤和分页**
**

2.CreateModelMixin（创建）

创建视图扩展类，提供create方法快速创建资源的视图，成功返回201的状态码

3.RetrieveModelMixin(单查)

详情视图扩展类，提供retrieve方法，可以快速实现返回一个存在的数据对象。

4.UpdateModelMixin(更新，修改)

更新视图扩展类，提供update方法，可以快速实现更新一个存在的数据对象，同时也提供partial_update方法，可以实现局部更新。

5.DestoryModelMixin(删除) 一般不怎么用到

删除视图扩展类，提供destory方法，可以快速实现删除一个存在数据对象。

代码示例：

视图层：views.py

from rest_framework.mixins import ListModelMixin, CreateModelMixin, RetrieveModelMixin, UpdateModelMixin
class BookMixinGenericAPIView(ListModelMixin, CreateModelMixin, RetrieveModelMixin, UpdateModelMixin, GenericAPIView):
　　#GenericAPIView提供的序列化器和查询的数据
    queryset = models.Book.objects.filter(is_delete=False)  
    serializer_class = serializers.BookModelSerializer
　　
　　#单查和群查
    def get(self, request, *args, **kwargs):
        if 'pk' in kwargs:
            response = self.retrieve(request, *args, **kwargs)   #单查  RetrieveModelMixin方法
        else:
            # mixins提供的list方法的响应对象是Response，想将该对象格式化为APIResponse
            response = self.list(request, *args, **kwargs)   #群查 ListModelMixin
        # response的数据都存放在response.data中
        return APIResponse(results=response.data)    
　　#增加
    def post(self, request, *args, **kwargs):
        response = self.create(request, *args, **kwargs)   #CreateModelMixin方法
        return APIResponse(results=response.data)
　　#整体修改
    def put(self, request, *args, **kwargs):
        response = self.update(request, *args, **kwargs)   #UpdateModelMixin
        return APIResponse(results=response.data)
　　#局部修改
    def patch(self, request, *args, **kwargs):
        response = self.partial_update(request, *args, **kwargs)
        return APIResponse(results=response.data)

路由层：urls.py

urlpatterns = [
       url(r'^v3/books/$', views.BookMixinGenericAPIView.as_view()),
    url(r'^v3/books/(?P<pk>.*)/$', views.BookMixinGenericAPIView.as_view()),
]

常用功能子类视图—— 工具视图(继承了GenericAPIView和各种Mixins工具类)

 1）工具视图都是GenericAPIView的子类，且不同的子类继承了不听的工具类，重写了请求方法
 2）工具视图的功能可以满足需求，只需要继承工具视图，并且提供queryset与serializer_class即可

视图	作用	方法	父类
ListAPIView	查询多条数据	get	GenericAPIView ListModelMixin
CreateAPIView	新增一条数据	post	GenericAPIView CreateModelMixin
RetrieveAPIView	查询一条数据	get	GenericAPIView RetrieveModelMixin
UpdateAPIView	修改一条数据	put，patch	GenericAPIView UpdateModelMixin
DestroyAPIView	删除一条数据	delete	GenericAPIView DestroyModelMixin
RetrieveUpdateAPIView	查询，更新一条数据	get，put，patch	GenericAPIView RetrieveModelMixin UpdateModelMixin
RetrieveUpdateDestroyAPIView	获取，更新，删除一条数据	get，put，patch，delete	GenericAPIView RetrieveModelMixin UpdateModelMixin DestroyModelMixin

视图层：views.py

from rest_framework.generics import ListCreateAPIView, UpdateAPIView
class BookListCreatePIView(ListCreateAPIView, UpdateAPIView):
    queryset = models.Book.objects.filter(is_delete=False)
    serializer_class = serializers.BookModelSerializer

路由层：urls.py

urlpatterns = [
       url(r'^v4/books/$', views.BookListCreatePIView.as_view()),
    url(r'^v4/books/(?P<pk>.*)/$', views.BookListCreatePIView.as_view()),
]

视图集 viewsetmixin （注意路由设置）

1.常用视图集父类
　　ViewSet
　　继承自APIView和ViewSetMixin,没有提供任何方法，需要自己写
　　GenericViewSet
　　继承GenericAPIView和ViewSetMixin,其中GenericAPIView提供了基础方法，可以直接搭配Mixin扩展类使用，所以我们选这个
　　ModelViewSet　　
　　继承GenericViewset,但同时也包括ListModelMixin、CreateModelMixin等mixin扩展类
1）视图集都是默认优先继承ViewSetMixin类，再继承一个视图类（GenericAPIView或APIView） 
 2）ViewSetMixin提供了重写的as_view()方法，继承视图集的视图类，配置路由时调用as_view()必须传入 请求名-函数名 映射关系字典
       eg: url(r'^v5/books/$', views.BookGenericViewSet.as_view({'get': 'my_get_list'})),
       表示get请求会交给my_get_list视图函数处理

路由层：urls.py

urlpatterns = [
       # View的as_view()：将get请求映射到视图类的get方法
    # ViewSet的as_view({'get': 'my_get_list'})：将get请求映射到视图类的my_get_list方法
    url(r'^v5/books/$', views.BookGenericViewSet.as_view({'get': 'my_get_list'})),
    url(r'^v5/books/(?P<pk>.*)/$', views.BookGenericViewSet.as_view({'get': 'my_get_obj'})),
]

视图层：views.py

from rest_framework.viewsets import GenericViewSet
from rest_framework import mixins  #工具集 可以使用list,retrieve等方法
class BookGenericViewSet(mixins.RetrieveModelMixin, mixins.ListModelMixin, GenericViewSet):
    queryset = models.Book.objects.filter(is_delete=False)
    serializer_class = serializers.BookModelSerializer

    def my_get_list(self, request, *args, **kwargs):
        return self.list(request, *args, **kwargs)

    def my_get_obj(self, request, *args, **kwargs):
        return self.retrieve(request, *args, **kwargs)

GenericAPIView与APIView两大继承视图的区别

1）GenericViewSet和ViewSet都继承了ViewSetMixin，as_view都可以配置 请求-函数 映射
2）GenericViewSet继承的是GenericAPIView视图类，用来完成标准的 model 类操作接口
3）ViewSet继承的是APIView视图类，用来完成不需要 model 类参与，或是非标准的 model 类操作接口
      post请求在标准的 model 类操作下就是新增接口，登陆的post不满足
      post请求验证码的接口，不需要 model 类的参与
案例：登陆的post请求，并不是完成数据的新增，只是用post提交数据，得到的结果也不是登陆的用户信息，而是登陆的认证信息

工具视图集 （工具集和视图集的混合使用）

路由层：urls.py

urlpatterns = [
       url(r'^v6/books/$', views.BookModelViewSet.as_view({'get': 'list', 'post': 'create'})),
    url(r'^v6/books/(?P<pk>.*)/$', views.BookModelViewSet.as_view({'get': 'retrieve', 'put': 'update', 'patch': 'partial_update', 'delete': 'destroy'})),
]

视图层：views.py

from rest_framework.viewsets import ModelViewSet
class BookModelViewSet(ModelViewSet):
    queryset = models.Book.objects.filter(is_delete=False)
    serializer_class = serializers.BookModelSerializer

    # 删不是数据库，而是该记录中的删除字段
    def destroy(self, request, *args, **kwargs):
        instance = self.get_object()  # type: models.Book
        if not instance:
            return APIResponse(1, '删除失败')  # 实际操作，在此之前就做了判断
        instance.is_delete = True
        instance.save()
        return APIResponse(0, '删除成功')

路由组件（了解）

from django.conf.urls import include
from rest_framework.routers import SimpleRouter
router = SimpleRouter()
# 所有路由与ViewSet视图类的都可以注册，会产生 '^v6/books/$' 和 '^v6/books/(?P<pk>[^/.]+)/$'
router.register('v6/books', views.BookModelViewSet)

urlpatterns = [
    # 第一种添加子列表方式
    url(r'^', include(router.urls)),
]
# 第二种添加子列表方式
# urlpatterns.extend(router.urls)

免责声明：文章转载自《drf框架（五）》仅用于学习参考。如对内容有疑问，请及时联系本站处理。

drf框架（五）

相关文章

多表更新：update，join

ABAP 数据库操作

Hibernate实体对象状态和操作

DICOM文件添加私有Tag(DCMTK Private Tag)

DB2 错误码解析

Newtonsoft.Json 的基本用法

最新文章

随机推荐

思享工具箱导航

JSON工具

格式化转换

加解密编码

文本数字

网络

站长

计算

其他

对照列表