美文网首页
DRF使用记录(三) - 视图

DRF使用记录(三) - 视图

作者: 憧憬001 | 来源:发表于2020-01-11 17:52 被阅读0次

    drf使用记录(三) - 视图

    视图之前还忘记了点啥

    模型类序列化器

    DRF为我们提供了ModelSerializer模型类序列化器来帮助我们快速创建一个Serializer

    ModelSerializer与常规的Serializer基本相同,但有所封装

    • 基于模型类自动生成一系列字段
    • 基于模型类自动为Serializer生成validators,比如unique_together
    • 包含默认的create()update()的实现

    sers应用中的serializers.py创建一个UserModelSerializer

    class UserModelSerializer(serializers.ModelSerializer):
        """用户数据序列化器"""
        #  继承ModelSerializer可以不用声明字段
    
        class Meta:
            model = User
            fields = '__all__'
    
    • model :参照哪个模型类
    • fields :为模型类的哪些字段生成
    字段的指定
    • fields来明确字段,__all__表名包含所有字段,也可以写明具体哪些字段,如
    class UserModelSerializer(serializers.ModelSerializer):
        """用户数据序列化器"""
    
        class Meta:
            model = User
            # fields = '__all__'  # 所有字段
            fields = ('name','age','sex')
    
    • exclude排除掉哪些字段
    class UserModelSerializer(serializers.ModelSerializer):
        """用户数据序列化器"""
    
        class Meta:
            model = User
           exclude = ('phone','addr')
    
    • read_only_fields指明只读字段,即仅用于序列化输出的字段
    class UserModelSerializer(serializers.ModelSerializer):
        """用户数据序列化器"""
    
        class Meta:
            model = User
            fields = '__all__'
            read_only_fields = ('phone',)
    
    • extra_kwargsModelSerializer添加或修改原有的选项参数
    class UserModelSerializer(serializers.ModelSerializer):
        """用户数据序列化器"""
    
        class Meta:
            model = User
            fields = '__all__'
            extra_kwargs = {
                'age':{'max_value':200,'required':True},
                ...
            }
    

    视图相关

    drf除了在数据序列化部分简写代码以外,还在视图中提供了简写操作。在原有的django.views.View类基础上,封装了多个子类

    请求Request
    • REST framework 传入视图的request对象不再是Django默认的HttpRequest对象,而是REST framework提供的扩展了HttpRequest类的Request类的对象
    • EST framework 提供了Parser解析器,在接收到请求后会自动根据Content-Type指明的请求数据类型(如JSON、表单等)将请求数据进行parse解析,解析为类字典[QueryDict]对象保存到Request对象中
    • Request对象的数据是自动根据前端发送数据的格式进行解析之后的结果
    常用属性
    data

    request.data 返回解析之后的请求体数据。类似于Django中标准的request.POSTrequest.FILES属性,但提供如下特性

    • 包含了解析之后的文件和非文件数据
    • 包含了对POSTPUTPATCH请求方式解析后的数据
    • 利用了REST framework的parsers解析器,不仅支持表单类型数据,也支持JSON数据
    状态码

    REST framewrok在rest_framework.status模块中提供了常用状态码常量。

    1)信息告知 - 1xx
    HTTP_100_CONTINUE
    HTTP_101_SWITCHING_PROTOCOLS
    
    2)成功 - 2xx
    HTTP_200_OK
    HTTP_201_CREATED
    HTTP_202_ACCEPTED
    HTTP_203_NON_AUTHORITATIVE_INFORMATION
    HTTP_204_NO_CONTENT
    HTTP_205_RESET_CONTENT
    HTTP_206_PARTIAL_CONTENT
    HTTP_207_MULTI_STATUS
    
    3)重定向 - 3xx
    HTTP_300_MULTIPLE_CHOICES
    HTTP_301_MOVED_PERMANENTLY
    HTTP_302_FOUND
    HTTP_303_SEE_OTHER
    HTTP_304_NOT_MODIFIED
    HTTP_305_USE_PROXY
    HTTP_306_RESERVED
    HTTP_307_TEMPORARY_REDIRECT
    
    4)客户端错误 - 4xx
    HTTP_400_BAD_REQUEST
    HTTP_401_UNAUTHORIZED
    HTTP_402_PAYMENT_REQUIRED
    HTTP_403_FORBIDDEN
    HTTP_404_NOT_FOUND
    HTTP_405_METHOD_NOT_ALLOWED
    HTTP_406_NOT_ACCEPTABLE
    HTTP_407_PROXY_AUTHENTICATION_REQUIRED
    HTTP_408_REQUEST_TIMEOUT
    HTTP_409_CONFLICT
    HTTP_410_GONE
    HTTP_411_LENGTH_REQUIRED
    HTTP_412_PRECONDITION_FAILED
    HTTP_413_REQUEST_ENTITY_TOO_LARGE
    HTTP_414_REQUEST_URI_TOO_LONG
    HTTP_415_UNSUPPORTED_MEDIA_TYPE
    HTTP_416_REQUESTED_RANGE_NOT_SATISFIABLE
    HTTP_417_EXPECTATION_FAILED
    HTTP_422_UNPROCESSABLE_ENTITY
    HTTP_423_LOCKED
    HTTP_424_FAILED_DEPENDENCY
    HTTP_428_PRECONDITION_REQUIRED
    HTTP_429_TOO_MANY_REQUESTS
    HTTP_431_REQUEST_HEADER_FIELDS_TOO_LARGE
    HTTP_451_UNAVAILABLE_FOR_LEGAL_REASONS
    
    5)服务器错误 - 5xx
    HTTP_500_INTERNAL_SERVER_ERROR
    HTTP_501_NOT_IMPLEMENTED
    HTTP_502_BAD_GATEWAY
    HTTP_503_SERVICE_UNAVAILABLE
    HTTP_504_GATEWAY_TIMEOUT
    HTTP_505_HTTP_VERSION_NOT_SUPPORTED
    HTTP_507_INSUFFICIENT_STORAGE
    HTTP_511_NETWORK_AUTHENTICATION_REQUIRED
    

    视图

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

    • 控制序列化器的执行(检验、保存、转换数据)
    • 控制数据库查询的执行

    视图基类

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

    • 新建一个应用req
    python manage.py startapp req
    
    1.APIView

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

    rest_framework.views.APIView
    

    req应用中的views.py

    • View
    from django.views import View
    from django.http import HttpResponse, JsonResponse
    
    
    class UserViews(View):
        """用户View类"""
    
        def get(self, request):
            print(request)
            """打印效果:
            <WSGIRequest: GET '/req/users/'>  # 这是django原生提供的HttpRequest类
            """
    
            return HttpResponse('ok')
    
    tips

    引入了drf

    • FBVCBV都可能会出现Django 'WSGIRequest' object has no attribute 'data'这个报错

    解决办法

    FBV模式需要从rest_framework.decorators导入api_view这个装饰器

    from rest_framework.decorators import api_view
    @api_view
    def your_views_func(request):
        ...
    

    CBV则不能继承django的中View

    需要继承drf中封装的视图,例如:APIView

    from rest_framework.views import APIView
    
    class YourViewsClass(APIView):
    
        def get(self, request):
            ...
    
    • APIView
    使用APIview提供用户信息的5个API接口
    GET    /req/users/               获取全部数据
    POST   /req/users/               添加数据
    
    GET    /req/users/(?P<pk>\d+)    # 获取一条数据
    PUT    /req/users/(?P<pk>\d+)    # 更新一条数据
    DELETE /req/users/(?P<pk>\d+)    # 删除一条数据
    
    from django.views import View
    from django.http import HttpResponse, JsonResponse
    
    
    class UserViews(View):
        """用户View类"""
    
        def get(self, request):
            print(request)
            print(request.GET)
            """打印效果:
            <WSGIRequest: GET '/req/users/'>  # 这是django原生提供的HttpRequest类
            """
    
            return HttpResponse('ok')
    
    
    from rest_framework.views import APIView
    from rest_framework.response import Response
    from rest_framework.status import *
    from sers.serializers import UserModelSerializer
    from user.models import User
    
    
    class UserApiviews1(APIView):
        """用户APIView类,用于查询单个、更新、删除"""
    
        def get(self, request, pk):
            # 获取单个数据
            user = User.objects.get(pk=pk)
            # 数据转换[序列化过程]
            serializer = UserModelSerializer(instance=user)
            # 响应数据
            return Response(serializer.data, HTTP_200_OK)
    
        def put(self, request, pk):
            """在更新中调用序列化器完成数据的更新操作"""
            user_obj = User.objects.get(pk=pk)
            # 实例化序列化器
            serializer = UserModelSerializer(instance=user_obj, data=request.data)
    
            serializer.is_valid(raise_exception=True)
    
            instance = serializer.save()
            print(f'update {instance}')
    
            return JsonResponse({'code': 200, 'msg': 'update success'})
    
        def delete(self,request,pk):
            """在更新中调用序列化器完成数据的删除操作"""
            user = User.objects.filter(id=pk).first()
            user.delete()
            print(f'删除{user}用户成功')
            return JsonResponse({'code': 200, 'msg': 'del success'})
    
    
    class UserApiviews2(APIView):
        """用户APIView类,用于新增、查询全部"""
    
        def get(self, request):
            """新增用户"""
            print(request)
            """
            控制台:<rest_framework.request.Request object at 0x7efc8a7f7128>
            """
            data_list = User.objects.all()
            serializer = UserModelSerializer(instance=data_list, many=True)
            return Response(serializer.data)
    
        def post(self, request):
            """添加数据"""
            # 接受post请求数据
            data_dict = request.data
            # 调用序列化器
            serializer = UserModelSerializer(data=data_dict)
            # 验证
            serializer.is_valid(raise_exception=True)
    
            # 反序列化,保存数据
            serializer.save()
    
            # 响应数据
            return Response(serializer.data, HTTP_200_OK)
    
    
    • GET /req/users/:查询所有数据
    在这里插入图片描述
    • POST /req/users/:新增数据

      在这里插入图片描述
    • GET /req/users/8/: 查询单个

    在这里插入图片描述
    • PUT /req/users/8/: 更新id=8的用户信息
    在这里插入图片描述
    • DELETE /req/users/8/: 删除id=8的用户
    在这里插入图片描述
    2.GenericAPIView[通用视图类]
    rest_framework.generics.GenericAPIView
    

    继承自APIVIew主要增加了操作序列化器和数据库查询的方法,作用是为下面Mixin扩展类的执行提供方法支持。通常在使用时,可搭配一个或多个Mixin扩展类。

    提供的关于序列化器使用的属性与方法

    • 属性:

      • serializer_class指明视图使用的序列化器
    • 方法:

      • get_serializer_class(self)

        当出现一个视图类中调用多个序列化器时,那么可以通过条件判断在get_serializer_class方法中通过返回不同的序列化器类名就可以让视图方法执行不同的序列化器对象了。

        返回序列化器类,默认返回serializer_class,可以重写,例如:

        def get_serializer_class(self):
            if  条件 :
                return Serializer1
            return Serializer2
        
      • get_serializer(self, *args, \**kwargs)

        返回序列化器对象,主要用来提供给Mixin扩展类使用,如果我们在视图中想要获取序列化器对象,也可以直接调用此方法。

        注意,该方法在提供序列化器对象的时候,会向序列化器对象的context属性补充三个数据:request、format、view,这三个数据对象可以在定义序列化器时使用。

        • request 当前视图的请求对象
        • view 当前请求的类视图对象
        • format 当前请求期望返回的数据格式

    提供的关于数据库查询的属性与方法

    • 属性:

      • queryset 指明使用的数据查询集
    • 方法:

      • get_queryset(self)

        返回视图使用的查询集,主要用来提供给Mixin扩展类使用,是列表视图与详情视图获取数据的基础,默认返回queryset属性,可以重写,例如:

        def get_queryset(self):
            user = self.request.user
            ...
            return # 你的自定义对象
        
      • get_object(self)

        返回详情视图所需的模型类数据对象,主要用来提供给Mixin扩展类使用。

        在试图中可以调用该方法获取详情信息的模型类对象。

        若详情访问的模型类对象不存在,会返回404。

        该方法会默认使用APIView提供的check_object_permissions方法检查当前对象是否有权限被访问。

    其他可以设置的属性

    • pagination_class指明分页控制类
    • filter_backends 指明过滤控制后端

    还是以增删改查的形式

    from rest_framework.generics import GenericAPIView
    
    
    class UserGenericAPIView2(GenericAPIView):
        queryset = User.objects.all()  # 当前视图类中操作的公共数据,先从数据库查询出来
        serializer_class = UserModelSerializer  # 设置类视图中所有方法共有调用的视图类
    
        def get(self, request):
            """获取所有数据"""
            # 获取模型数据
            user_list = self.get_queryset()
            # 调用序列化器
            serializer = self.get_serializer(instance=user_list, many=True)
    
            return Response(serializer.data, HTTP_200_OK)
    
        def post(self, request):
            """添加数据"""
            # 获取客户端提交的数据
            serializer = self.get_serializer(data=request.data)
            # 使用序列化器进行验证
            serializer.is_valid(raise_exception=True)
            # 反序列化
            serializer.save()
            # 返回结果
            return JsonResponse({'code': 200, 'msg': 'add success'})
    
    
    class UserGenericAPIView1(GenericAPIView):
        queryset = User.objects.all()
        serializer_class = UserModelSerializer
    
        def get(self, request, pk):  # 这里的参数名必须叫pk,否则要配置另一个名称如果不配置,则报错!
            # 报错信息:  get() got an unexpected keyword argument 'pk'
            instance = self.get_object()
            serializer = self.get_serializer(instance=instance)
            return Response(serializer.data)
    
        def put(self, request, pk):
            instance = self.get_object()
            # 获取客户端提交数据
            data = request.data
            # 实例化序列化器期
            serializer = self.get_serializer(instance=instance, data=data)
            # 验证
            serializer.is_valid(raise_exception=True)
            # 反序列化
            serializer.save()
            # 返回响应
            return Response(serializer.data)
    
        def delete(self, request, pk):
            user = User.objects.filter(id=pk).first()
            user.delete()
            print(f'删除{user}用户成功')
            return JsonResponse({'code': 200, 'msg': 'del success'})
    
    

    测试略

    视图扩展类

    • 提供了几种后端视图(对数据资源进行增删改查)处理流程的实现,如果需要编写的视图属于这五种,则视图可以通过继承相应的扩展类来复用代码,减少自己编写的代码量
    • 这五个扩展类需要搭配GenericAPIView父类,因为五个扩展类的实现需要调用GenericAPIView提供的序列化器与数据库查询的方法
    1)ListModelMixin
    • 列表视图扩展类,提供list(request, *args, **kwargs)方法快速实现列表视图,返回200状态码。

    • Mixin的list方法会对数据进行过滤和分页。

    源代码:

    class ListModelMixin(object):
        """
        List a queryset.
        """
        def list(self, request, *args, **kwargs):
            # 过滤
            queryset = self.filter_queryset(self.get_queryset())
            # 分页
            page = self.paginate_queryset(queryset)
            if page is not None:
                serializer = self.get_serializer(page, many=True)
                return self.get_paginated_response(serializer.data)
            # 序列化
            serializer = self.get_serializer(queryset, many=True)
            return Response(serializer.data)
    
    

    举例:

    from rest_framework.mixins import ListModelMixin
    
    class BookListView(ListModelMixin, GenericAPIView):
        queryset = BookInfo.objects.all()
        serializer_class = BookInfoSerializer
    
        def get(self, request):
            return self.list(request)
    
    
    2)CreateModelMixin
    • 创建视图扩展类,提供create(request, *args, **kwargs)方法快速实现创建资源的视图,成功返回201状态码。

    • 如果序列化器对前端发送的数据验证失败,返回400错误。

    源代码:

    class CreateModelMixin(object):
        """
        Create a model instance.
        """
        def create(self, request, *args, **kwargs):
            # 获取序列化器
            serializer = self.get_serializer(data=request.data)
            # 验证
            serializer.is_valid(raise_exception=True)
            # 保存
            self.perform_create(serializer)
            headers = self.get_success_headers(serializer.data)
            return Response(serializer.data, status=status.HTTP_201_CREATED, headers=headers)
    
        def perform_create(self, serializer):
            serializer.save()
    
        def get_success_headers(self, data):
            try:
                return {'Location': str(data[api_settings.URL_FIELD_NAME])}
            except (TypeError, KeyError):
                return {}
    
    
    3)RetrieveModelMixin
    • 详情视图扩展类,提供retrieve(request, *args, **kwargs)方法,可以快速实现返回一个存在的数据对象。

    • 如果存在,返回200, 否则返回404。

    源代码:

    class RetrieveModelMixin(object):
        """
        Retrieve a model instance.
        """
        def retrieve(self, request, *args, **kwargs):
            # 获取对象,会检查对象的权限
            instance = self.get_object()
            # 序列化
            serializer = self.get_serializer(instance)
            return Response(serializer.data)
    
    

    举例:

    class BookDetailView(RetrieveModelMixin, GenericAPIView):
        queryset = BookInfo.objects.all()
        serializer_class = BookInfoSerializer
    
        def get(self, request, pk):
            return self.retrieve(request)
    
    
    4)UpdateModelMixin
    • 更新视图扩展类,提供update(request, *args, **kwargs)方法,可以快速实现更新一个存在的数据对象

    • 同时也提供partial_update(request, *args, **kwargs)方法,可以实现局部更新

    • 成功返回200,序列化器校验数据失败时,返回400错误

    源代码:

    class UpdateModelMixin(object):
        """
        Update a model instance.
        """
        def update(self, request, *args, **kwargs):
            partial = kwargs.pop('partial', False)
            instance = self.get_object()
            serializer = self.get_serializer(instance, data=request.data, partial=partial)
            serializer.is_valid(raise_exception=True)
            self.perform_update(serializer)
    
            if getattr(instance, '_prefetched_objects_cache', None):
                # If 'prefetch_related' has been applied to a queryset, we need to
                # forcibly invalidate the prefetch cache on the instance.
                instance._prefetched_objects_cache = {}
    
            return Response(serializer.data)
    
        def perform_update(self, serializer):
            serializer.save()
    
        def partial_update(self, request, *args, **kwargs):
            kwargs['partial'] = True
            return self.update(request, *args, **kwargs)
    
    
    5)DestroyModelMixin
    • 删除视图扩展类,提供destroy(request, *args, **kwargs)方法,可以快速实现删除一个存在的数据对象。

    • 成功返回204,不存在返回404。

    源代码:

    class DestroyModelMixin(object):
        """
        Destroy a model instance.
        """
        def destroy(self, request, *args, **kwargs):
            instance = self.get_object()
            self.perform_destroy(instance)
            return Response(status=status.HTTP_204_NO_CONTENT)
    
        def perform_destroy(self, instance):
            instance.delete()
    
    
    视图代码:
    
    """GenericAPIView结合视图扩展类实现api接口"""
    from rest_framework.mixins import ListModelMixin, CreateModelMixin
    
    
    # 声明分页的配置类
    from rest_framework.pagination import PageNumberPagination
    class UserPageNumberPagination(PageNumberPagination):
        # 默认每一页显示的数据量
        page_size = 2
        # 允许客户端通过get参数来控制每一页的数据量
        page_size_query_param = "size"
        max_page_size = 10
        # 自定义页码的参数名
        page_query_param = "page"
    
    class UserMiXinGenericAPIView2(GenericAPIView, ListModelMixin, CreateModelMixin):
        # 本次视图类中要操作的数据   [必填]
        queryset = User.objects.all()
        # 本次视图类中要调用的默认序列化器  [必填]
        serializer_class = UserModelSerializer
        # 分页器
        pagination_class = UserPageNumberPagination
    
        def get(self, request):
            """获取多个用户信息"""
            return self.list(request)
    
        def post(self, request):
            """添加用户信息"""
            return self.create(request)
    
    
    from rest_framework.mixins import RetrieveModelMixin, UpdateModelMixin, DestroyModelMixin
    
    
    class UserMiXinGenericAPIView1(GenericAPIView, RetrieveModelMixin, UpdateModelMixin, DestroyModelMixin):
        queryset = User.objects.all()
    
        serializer_class = UserModelSerializer
    
        # 在使用GenericAPIView视图获取或操作单个数据时,视图方法中的代表主键的参数最好是pk
        def get(self, request, pk):
            """获取一条数据"""
            return self.retrieve(request, pk)
    
        def put(self, request, pk):
            """更新一条数据"""
            return self.update(request, pk)
    
        def delete(self, request, pk):
            """删除一条数据"""
            return self.destroy(request, pk)
    
    
    • 测试

    分页

    在这里插入图片描述
    越来越easy
    • drf内置了一些同时继承了GenericAPIViewMixins扩展类的视图子类,我们可以直接继承这些子类九可以生成对应的API接口
    • 下面8行代码实现数据的CRUD

    ListAPIView 获取所有数据
    CreateAPIView 添加数据

    from rest_framework.generics import ListAPIView, CreateAPIView
    
    class LCUserGenericAPIView(ListAPIView, CreateAPIView):
        queryset = User.objects.all()
        serializer_class = UserModelSerializer
    

    RetrieveAPIView 获取一条数据

    UpdateAPIView 更新一条数据

    DestorAPIView 删除一条数据

    • RetrieveUpdateDestoryAPIView 上面三个的缩写
    from rest_framework.generics import RetrieveUpdateDestroyAPIView
    
    class UserRetrieveUpdateDestroyAPIView(RetrieveUpdateDestroyAPIView):
        queryset = User.objects.all()
        serializer_class = UserModelSerializer
    

    是不是发现了什么

    当然
    • 8行代码,一半重复
    • 查询所有数据、添加数据是不需要声明pk逐渐的,而其他的接口需要[路由冲突了]
    • 查询所有数据和查询一条数据,都是属于get请求[请求方法冲突了]
    from rest_framework.mixins import CreateModelMixin, ListModelMixin, RetrieveModelMixin, UpdateModelMixin,  DestroyModelMixin
    from rest_framework.viewsets import GenericViewSet
    
    class UserModelViewSet1(GenericViewSet, CreateModelMixin, ListModelMixin, RetrieveModelMixin, UpdateModelMixin,  DestroyModelMixin):
        queryset = User.objects.all()
        serializer_class = UserModelSerializer
    

    或者这样,和记录(一)中的一样

    # 4行代码
    from rest_framework.viewsets import ModelViewSet
    
    class UserModelViewSet1(ModelViewSet):
        queryset = User.objects.all()
        serializer_class = UserModelSerializer
    

    路由除了记录一那种方式,还可以这样

    urlpatterns = [
        ...
        path("users/", views.UserModelViewSet1.as_view({"get": "list", "post": "create"})),
        re_path("users/(?P<pk>\d+)/",
                views.UserModelViewSet1.as_view({"get": "retrieve", "put": "update", "delete": "destroy"}))
    ]
    
    
    测试

    相关文章

      网友评论

          本文标题:DRF使用记录(三) - 视图

          本文链接:https://www.haomeiwen.com/subject/hilbactx.html