python Django Rest_Framework框架 视图集与路由Routers详解（图文并茂版）

视图集

ViewSet视图集

继承自APIView与ViewSetMixin，作用也与APIView基本类似，提供了身份认证、权限校验、流量管理等

ViewSet主要通过继承ViewSetMixin来实现在调用as_view()时传入字典{“http请求”：“视图方法名称”}的映射处理请求，如{‘get’:‘list’}

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

使用视图集ViewSet，可以将一系列视图方法相关的操作和相关的http请求动作封装到一个类中：

• list() 提供一组数据
• retrieve() 根据传入pk值，提供一个数据
• create() 创建数据
• update() 更新数据
• destory() 删除数据

ViewSet视图集类不再限制视图方法名只允许get()、post()等这样的方法名，而是实现允许开发者根据自己的需求自定义方法名，例如 list() 、create() 等，然后在路由中将这些视图方法名与http请求进行绑定，调用

代码实现

• 创建一个新的子应用方便操作，并将此子应用进行注册：

python manage.py startapp viewset

• 模型类还是使用前面博客中的学生模型
  views.py文件：

from rest_framework import serializers
from rest_framework import status
from rest_framework.response import Response
from rest_framework.viewsets import ViewSet

from .models import Students


# 定义模型序列化器
class StudentSerializers(serializers.ModelSerializer):
    class Meta:
        model = Students
        fields = '__all__'


# viewset视图集
class StudentsViewSet(ViewSet):

    # 获取一组数据
    def get_all_student(self, request):
        student = Students.objects.all()
        ser = StudentSerializers(instance=student, many=True)
        return Response(ser.data, status=status.HTTP_200_OK)

    # 创建数据
    def create_student(self, request):
        ser = StudentSerializers(data=request.data)
        if not ser.is_valid():
            return Response(ser.errors, status=status.HTTP_404_NOT_FOUND)
        ser.save()
        return Response(ser.data, status=status.HTTP_201_CREATED)

    # 获取单个数据
    def get_one_student(self, request, pk):
        student = Students.objects.get(pk=pk)
        ser = StudentSerializers(instance=student)
        return Response(ser.data, status=status.HTTP_200_OK)

    # 修改数据
    def update_student(self, request, pk):
        student = Students.objects.get(pk=pk)
        ser = StudentSerializers(instance=student, data=request.data)
        if not ser.is_valid():
            return Response(ser.errors, status=status.HTTP_404_NOT_FOUND)
        ser.save()
        return Response(ser.data, status=status.HTTP_201_CREATED)

    # 删除数据
    def delete_student(self, reqeust, pk):
        Students.objects.get(pk=pk).delete()
        return Response(status=status.HTTP_204_NO_CONTENT)

• 查看一组数据：
  
• 添加一条数据：
  
• 查看是否添加成功：
  
• 查看单个学生数据信息：
  
• 修改单个学生信息：
• 查看是否修改成功：
  
• 删除单个学生信息：
  
• 查看是否删除成功：
  

GenericViewSet视图集

继承自GenericAPIView和ViewSetMixin，作用让视图集的视图代码变得更加通用，抽取独特代码，作为视图类的类属性

前面我们使用ViewSet通常并不方便，因为list、retrieve、create、update、destory等方法都需要自己编写，而这些方法与前面讲过的Mixin扩展类提供的方法同名，所以我们可以通过继承Mixin扩展类来复用这些方法而无需自己编写。但是Mixin扩展类依赖于GenericAPIView，所以还需要继承GenericAPIView

GenericViewSet就帮助我们完成了这样的继承工作，继承自GenericAPIView与ViewSetMixin，在实现了调用as_view()时传入字典（如{‘get’:‘list’}）的映射处理工作的同时，还提供了GenericAPIView提供的基础方法，可以直接搭配Mixin扩展类使用

代码实现

• 结合我们前面博客讲解的模型扩展类，实现操作：

from rest_framework import serializers
from rest_framework.mixins import ListModelMixin, CreateModelMixin, RetrieveModelMixin, UpdateModelMixin, \
    DestroyModelMixin
from rest_framework.viewsets import GenericViewSet

from .models import Students


# 定义模型序列化器
class StudentSerializers(serializers.ModelSerializer):
    class Meta:
        model = Students
        fields = '__all__'


# 将模型扩展类与GenericViewSet视图集结合高效使用
class StudentsGenericViewSet(GenericViewSet, ListModelMixin, CreateModelMixin, RetrieveModelMixin, UpdateModelMixin,
                             DestroyModelMixin):
    queryset = Students.objects
    serializer_class = StudentSerializers

• 实现的结果与上面viewset效果相同！！！
  

ModelViewSet视图集

• 上述完成的模型类继承了很多的扩展类，书写不方便，可以将这么多扩展类简写为：ModelViewSet
• ModelViewSet继承自GenericViewSet，同时包括了ListModelMixin、RetrieveModelMixin、CreateModelMixin、UpdateModelMixin、DestoryModelMixin这些扩展类

ReadOnlyModelViewSet视图集

• ReadOnlyModelViewSet承自GenericViewSet，同时包括了ListModelMixin、RetrieveModelMixin

路由Routers

对于视图集ViewSet，我们除了可以自己手动指明请求方式与动作action之间的对应关系外，还可以使用路由Routers来帮助我们快速实现路由信息绑定、调用

REST framework提供了两个router类

• SimpleRouter
• DefaultRouter

使用方法

1. 创建router对象，并注册视图集

from rest_framework import routers

router = routers.DefaultRouter()
router.register('students/', StudnetsView, basename='students')

注册视图集参数如下：
register(prefix, viewset, base_name)

• prefix 该视图集的子路由前缀
• viewset 视图集
• base_name 路由别名的前缀，可用书路由的重定向
  生成路由如下：

^studnets/$    name: stduents-list # 全部数据操作
^studnets/{pk}/$   name: studnets-detail # 单个数据操作

2. 添加路由
   两种方法：

urlpatterns = [
    ...
]
urlpatterns += router.urls

或者：

urlpatterns = [
    ...
    path('^', include(router.urls))
]

具体实现操作

from rest_framework.routers import DefaultRouter

from . import views

# 实例化路由类
router = DefaultRouter()

# 注册视图集
router.register('students', views.StudentsGenericViewSet)

# 将生成的路由集添加到urlpatterns中
urlpatterns = []
urlpatterns += router.urls

• 上述的操作，会将StudentsGenericViewSet的路由更换为自动生成的路由集，与不使用路由routers的实现效果相同
  
  

视图集中附加action的声明

在视图集中，如果想要让Router自动生成我们自定义动作的路由信息，需要使用rest_framework.decorators.action装饰器

以action装饰器装饰的方法名会作为action动作名，与list、retrieve等同

action装饰器可以接收两个参数：

• methods: 声明该action对应的请求方式，列表

• detail: 声明该action的路径是否与单一资源对应，True：单个数据操作，False：多个数据操作

路由生成如下：

• 路由前缀/< pk >/action方法名/

• True 表示路径格式是xxx/< pk >/action方法名/

• False 表示路径格式是xxx/action方法名/

url_path：声明该action的路由尾缀

简单举例如下：

from rest_framework import serializers
from rest_framework.decorators import action
from rest_framework.response import Response
from rest_framework.viewsets import ModelViewSet

from .models import Students


# 定义模型序列化器
class StudentSerializers(serializers.ModelSerializer):
    class Meta:
        model = Students
        fields = '__all__'


class StudentsModelView(ModelViewSet):
    queryset = Students.objects
    serializer_class = StudentSerializers

    @action(methods=['get'], detail=False, url_path='login')
    def login(self, request):
        """登录"""
        return Response({'message': '成功！！'})

路由文件如下：

from rest_framework.routers import DefaultRouter

from . import views

# 实例化路由类
router = DefaultRouter()

# 注册视图集
router.register('students', views.StudentsModelView)

# 将生成的路由集添加到urlpatterns中
urlpatterns = []
urlpatterns += router.urls