5.DRF视图

Django REST framwork 提供的视图的主要作用：

• 控制序列化器的执行(检验,保存,转换数据）
• 控制数据库查询的执行[数据库的删除/查询代码写在视图中,更新和添加写在序列化器]

1. 视图

REST framework 提供了众多的通用视图基类与扩展类,以简化视图的编写

2. 两个视图基类

1. APIView

rest_framework.views.APIView

APIView是REST framework提供的所有视图的基类,在继承自Django的View父类

新增以下的内容

新增内容
1.传入到视图方法中的是REST framework的Request对象，而不是Django的HttpRequeset对象；
2.视图方法可以返回REST framework的Response对象,视图会为响应数据设置(renderer)符合前端要求的格式；
3.任何APIException异常都会被捕获到,并且处理成合适的响应信息
4.重写了as_view(),在进行dispatch()路由分发前,会对http请求进行身份认证,权限检查,访问流量控制

支持定义的类属性

类属性名
1.authentication_classes 列表或元组,身份认证类
2.permissoin_classes 列表或元组，权限检查类
3.throttle_classes 列表或元祖，流量控制类

在APIView中仍以常规的类视图定义方法来实现get() ,post() 或者其他请求方式的方法.举例：

"""
APIView是drf里面提供的所有视图类的父类,APIView提供的功能/属性/方法是最少的,所以使用APIView基本类似我们使用django的View
GET   /students/ 获取多个学生信息
POST  /students/ 添加一个学生信息
GET    /students/<pk>/  获取一个学生信息 
PUT    /students/<pk>/  修改一个学生信息
DELETE /students/<pk>/  删除一个学生信息
"""

# Create your views here.
from rest_framework.views import APIView
from students.models import Student
from .serializers import StudentModelSerializer
from rest_framework.response import Response
from rest_framework import status

class Student1APIView(APIView):
    def get(self,request):
        """获取所有学生信息"""
        # 1. 获取学生信息的数据模型
        student_list = Student.objects.all()
        # 2. 调用序列化器
        serializer = StudentModelSerializer(instance=student_list, many=True)
        # 3. 返回数据
        return Response(serializer.data)

    def post(self,request):
        """添加一个学生信息"""
        # 1. 调用序列化器对用户提交的数据进行验证
        serializer = StudentModelSerializer(data=request.data)
        serializer.is_valid(raise_exception=True)

        # 2. 调用序列化器进行数据库操作
        instance = serializer.save() # save()方法返回的是添加成功以后的模型对象

        serializer = StudentModelSerializer(instance=instance)

        # 3. 返回新增数据
        return Response(serializer.data, status=status.HTTP_201_CREATED)


class Student2APIView(APIView):
    def get(self,request,pk):
        """获取一个学生信息"""
        # 1. 根据pk获取模型对象
        student = Student.objects.get(pk=pk)
        # 2. 序列化器转换数据
        serializer = StudentModelSerializer(instance=student)
        # 3. 响应数据
        return Response(serializer.data)

    def put(self,request,pk):
        """修改一个学生信息"""
        # 1. 通过pk查询学生信息
        student = Student.objects.get(pk=pk)

        # 3. 调用序列化器对客户端发送过来的数据进行验证
        serializer = StudentModelSerializer(instance=student, data=request.data)
        serializer.is_valid(raise_exception=True)
        # 4. 保存数据
        instance = serializer.save() #?这里实际上调用的序列化器里面的update方法

        serializer = StudentModelSerializer(instance=instance)

        # 5. 返回结果
        return Response(serializer.data, status=status.HTTP_201_CREATED)

    def delete(self, request, pk):
        # 1. 通过pk查询学生信息
        Student.objects.get(pk=pk).delete()
        return Response({"message":"ok"}, status=status.HTTP_204_NO_CONTENT)

2 GenericAPIView

GenericAPIView视图类继承自APIView,主要增加了操作序列化器和数据库查询的方法,作用是为下面Mixin扩展类的执行提供方法支持.

rest_framework.generics.GenericAPIView

属性

属性名	含义
serializer_class	指明视图使用的序列化器
queryset	指明使用的数据查询集
pagination_class	指明分页控制类
filter_backends	指明过滤控制后端

方法

方法名	含义
get_serializer_class(self)	重写此方法可以满足同一个视图类中需要调用多个序列器的要求
get_serializer(self, *args, **kwargs)	返回序列化器对象, 注意:该方法在提供序列化器对象的时候，会向序列化器对象的context属性补充三个数据：request、format、view，这三个数据对象可以在定义序列化器时使用 request 当前视图的请求对象 view 当前请求的类视图对象 format 当前请求期望返回的数据格式
get_queryset(self)	返回视图使用的查询集
get_object(self)	返回单个视图模型类对象 该方法会默认使用APIView提供的check_object_permissions方法检查当前对象是否有权限被访问

视图类

from rest_framework.generics import GenericAPIView
from students.models import Student
from .serializers import StudentModelSerializer, StudentModel2Serializer
from rest_framework.response import Response

class StudentsGenericAPIView(GenericAPIView):
    # 本次视图类中要操作的数据[必填]
    queryset = Student.objects.all()
    # 本次视图类中要调用的默认序列化器[选填]
    serializer_class = StudentModelSerializer

    def get(self, request):
        """获取所有学生信息self.queryset().all()"""
        serializer = self.get_serializer(instance=self.get_queryset(), many=True)
        return Response(serializer.data)

    def post(self,request):
        data = request.data
        serializer = self.get_serializer(data=data)
        serializer.is_valid(raise_exception=True)
        instance = serializer.save()
        serializer = self.get_serializer(instance=instance)
        return Response(serializer.data)


class StudentGenericAPIView(GenericAPIView):
    queryset = Student.objects.all()
    serializer_class = StudentModelSerializer

    def get_serializer_class(self):
        """重写获取序列化器类的方法"""
        if self.request.method == "GET":
            return StudentModel2Serializer
        else:
            return StudentModelSerializer

    # 在使用GenericAPIView视图获取或操作单个数据时,视图方法中的代表主键的参数最好是pk
    def get(self,request,pk):
        """获取一条数据"""
        serializer = self.get_serializer(instance=self.get_object())
        return Response(serializer.data)

    def put(self,request,pk):

        data = request.data
        serializer = self.get_serializer(instance=self.get_object(),data=data)
        serializer.is_valid(raise_exception=True)
        serializer.save()
        serializer = self.get_serializer(instance=self.get_object())
        return Response(serializer.data)

序列化器类：

class StudentModel2Serializer(serializers.ModelSerializer):
    class Meta:
        model = Student
        fields = ("id", "name", "sex", "age", "class_num")
        read_only_fields = ('id',)
        extra_kwargs = {
            "id": { "required": True},
            "name": {"required": True},
            "age": {"max_value": 60, "required": True}
        }


class StudentModelSerializer(serializers.ModelSerializer):
    class Meta:
        model = Student
        fields = "__all__"