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

Posted 2023-02-22 温柔且上进c

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了python Django Rest_Framework框架视图集与路由Routers详解（图文并茂版）相关的知识，希望对你有一定的参考价值。

视图集与路由Routers详解

视图集
路由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

使用方法

创建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 # 单个数据操作

添加路由
两种方法：

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