视图家族

视图家族

一、概述

​ drf提供了一系列视图及工具：

from rest_framework import views, generics, mixins, viewsets

​ 1、views：视图类

​ 2、mixins：视图工具类

​ 3、generics：工具视图类

​ 4、viewsets：视图集

二、分类

​ 两大视图类：

from rest_reamework.views import APIView
from rest_framework.generics import GenericAPIView

​ 六大视图工具类：

from rest_framework.mixins import RetrieveModelMixin, ListModelMixin, CreateModelMixin, UpdateModelMixin, DestroyModelMixin

​ 九大工具视图类

from rest_framework import generics

​ generics中有CreateAPIView、ListAPIView、RetrieveAPIView、DestroyAPIView、UpdateAPIView、ListCreateAPIView、RetrieveUpdateAPIView、RetrieveDestroyAPIView、RetrieveUpdateDestroyAPIView。

三、两大视图集基类

​ 两大视图集的基类分别是ViewSet、GenericViewSet，分别继承自View的APIView和GenericAPIView。

​ 1、view：将请求方式和视图类的同名方法见了映射，完成请求响应

​ 2、APIView：继承自Django的View，其具备View的功能。写了as_view，禁用了csrf认证。重写了dispatch：请求、响应、渲染、异常、解析、三大认证。并且添加了一堆类属性，可以完成视图类的局部配置。

​ 再APIView中仍以常规的类视图定义方法来实现get()、post()或其他请求方式方法。

from rest_framework.views import APIView
from rest_framework.response import Respones

#    url(r'^v1/students/$', views.StudentAPIView.as_view()),
#    url(r'^v1/students/(?P<pk>d+)/$', views.StudentAPIView.as_view()),

class StudentAPIView(APIView):
    def get(self, request, *args, **kwargs):
        stu_query = models.Student.objects.all()
        stu_ser = serializers.StudentModelSerializer(stu_query, many=Ture)
        return Response(stu_ser.data)

​ 3、GenericAPIView：具备了APView的所有功能。具备了三个方法get_object()、get_queryset()、get_serializer()。具备了三个属性queryset、serializer_class、lookup_url_kwarg。

from rest_framework.generics import GenericAPIView

class StudentGenericAPIView(GenericAPIView):
    queryset = models.Student.objects.all()
    serializer_class = serializers.StudentModelSerializer
    
    def get(self, request, *args, **kwargs):
        stu_query = slef.get_queryset()
        stu_ser = self.get_serializer(stu_query, many=Ture)
        return Response(stu_ser.data)

四、视图工具类

​ mixins包提供了五大工具类和六大工具方法。

​ 五大工具类：RetrieveModelMixin, ListModelMixin, CreateModelMixin, UpdateModelMixin, DestroyModelMixin。

​ 六大工具方法：retrieve、list、create、update、partial_update、destroy。

from rest_framework import mixins
class StudentMixGenericAPIView(mixins.ListModelMixin, mixins.CreateModelMixin, GenericAPIView):
    queryset = models.Student.objects.all()
    serializer_class = serializers.StudentModelSerializer
    def get(self, request, *args, **kwargs):
        return self.list(request,*args, **kwargs)
    
    def post(self, request, *args, **kwargs):
        return self.create(request,*args, **kwargs)

五、工具视图类

​ 工具视图类提供七个子类视图

​ 1、CreateAPIView：提供post方法

​ 2、ListAPIView：提供get方法

​ 3、RetrieveAPIView：提供get方法

​ 4、RetrieveUpdateAPIView：提供get、put、patch方法

​ 5、UpdateAPIView：提供put和patch方法

​ 6、DestroyAPIView：提供delete方法

​ 7、RetrieveUpdateDestroyAPIView：提供get、put、patch、delete方法

from rest_framework.generics import CreateAPIView, RetrieveAPIView, ListAPIView, UpdateAPIView, DestroyAPIView
class StudentMixinAPIView(CreateAPIView, RetrieveAPIView, ListAPIView, UpdateAPIView, DestroyAPIView):

	queryset = models.Student.objects.all()
    serializer_class = serializers.StudentModelSerializer
    # url中单查，不一定必须提供主键，提供一切唯一键的字段名均可
	lookup_url_kwarg = 'id'
    
    # 有删除需求的接口继承DestroyAPIView，重写destroy完成字段删除
    def destroy(self, request, *args, **kwargs):
        pass

六、视图集

​ 使用视图集ViewSet，可以将一系列逻辑相关的动作放到一个类中：
​ 1、list() 提供一组数据
​ 2、retrieve() 提供单个数据
​ 3、create() 创建数据
​ 4、update() 保存数据
​ 5、destory() 删除数据
​ ViewSet视图集类不再实现get()、post()等方法，而是实现动作 action 如 list() 、create()
等。
​ 视图集只在使用as_view()方法的时候，才会将action动作与具体请求方式对应上。

​ urls.py:

# 将所有 请求方式 与 响应方法名 的映射关系交给用户自己配置
url(r'^v5/students/$', views.StudentModelViewSet.as_view({
        'get': 'list',
        'post': 'my_post'
    })),
    url(r'^v5/students/(?P<pk>d+)/$', views.StudentModelViewSet.as_view({
        'get': 'retrieve',
        'put': 'update',
        'patch': 'partial_update',
        'delete': 'destroy'
    })),

​ views.py:

from rest_framework.viewsets import ModelViewSet
class StudentModelViewSet(ModelViewSet):
    queryset = models.Student.objects.all()
    serializer_class = serializers.StudentModelSerializer
    
    def my_post(self, request, *args, **kwargs):
        return Response('mt post ok')