77-drf视图家族及路由层补充
Posted bowendown
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了77-drf视图家族及路由层补充相关的知识,希望对你有一定的参考价值。
目录
视图家族
一、views视图类
1、APIView类
功能:
- 拥有view的所有属性和方法;
- 重写as_view,禁用csrf;
- 重写dispatch,分发任务,五大模块对数据进行二次封装;
- 设定了一系列类属性。
2、GenericAPIView类(generics中)
特点:
- 继承APIView,所以拥有APIView的所有属性和方法;
- get_queryset方法,配置queryset类属性,提供视图类相关的Models;
- 在第二条的基础上,get_object方法,配置look_url_kwarg类属性,提供视图类的具体Model;
- get_serializer方法,配置serializer_class类属性,提供视图类相关的序列化对象。
分析:
class GenericAPIView(views.APIView):
def get_queryset(self):
获取自定义类中设定的queryset对象。
def get_serializer(self):
调用get_serializer_class方法;
获取自定义类中设定的serializer_class序列化类
def get_object(self):
首先通过get_queryset获取自定义类中给定的queryset对象;
然后获取自定义类中设定的lookup_url_kwarg过滤参数;
如果没有就使用默认的 lookup_field='pk' 过滤参数;
使用过滤参数对queryset对象进行过滤;
因此,在继承GenericAPIView来自定义类时,需要定义queryset、serializer_class及lookup_url_kwarg(非必要)
目的:
视图中的增删改查逻辑相似,但操作的资源不一致,操作资源包括:[操作单个资源对象]、[操作多个资源对象]以及[资源相关的序列化类],将这三者形成配置,那操作逻辑就一致,就可以进行封装。
总结:
GenericAPIView就是在APIView基础上额外提供了三个方法,三个类属性,如果不配合视图工具类,体现不出优势。
二、mixins类:视图辅助工具
特点:
- 需要配合GenericAPIView类使用;
- 将单查、群查、单增、群增、单整体改,单局部改所对应的六个接口写成retrieve、list、create、update、partial_update、destroy六个方法,封装到五个类中;
- 以上六个方法中需要用到GenericAPIView提供的三大方法,因此需要GenericAPIView类的配合;
- 默认返回的只有序列化后的对象包含的内容。
1、RetrieveModelMixin
单查
class RetrieveModelMixin:
def retrieve(self, request, *args, **kwargs):
实现单查。
如果可以检索对象,则返回 200 OK 响应;
将该对象的序列化表示作为响应的主体。
否则将返回 404 Not Found。
2、ListModelMixin
群查
class ListModelMixin:
def list(self, request, *args, **kwargs):
实现群查;
如果查询集被填充了数据,则返回 200 OK 响应;
将查询集的序列化表示作为响应的主体。
相应数据可以任意分页。
3、CreateModelMixin
单增
class CreateModelMixin:
def create(self, request, *args, **kwargs):
实现单增。
如果创建了一个对象,将返回一个 201 Created 响应;
将该对象的序列化表示作为响应的主体。
如果为创建对象提供的请求数据无效,将返回 400 Bad Request;
其中错误详细信息作为响应的正文。
4、UpdateModelMixin
单整体改和单局部改
class UpdateModelMixin:
def update(self, request, *args, **kwargs):
完成单整体改;
def partial_update(self, request, *args, **kwargs):
完成单局部改;
如果更新成功,将返回一个 200 OK 响应;
将对象的序列化表示作为响应的主体。
如果更新失败,将返回一个 400 Bad Request 响应;
错误详细信息作为响应的正文。
5、DestroyModelMixin
单删
class DestroyModelMixin:
def destroy(self, request, *args, **kwargs):
完成单删;
如果删除对象,则返回 204 No Content 响应;
否则返回 404 Not Found。
三、generics类:包含辅助工具的通用视图类
九个通用视图。
这通常是你真正用到的那些,除非你需要深度定制的行为。
这些视图类可以从 rest_framework.generics
导入。
class RetrieveAPIView(mixins.RetrieveModelMixin,
GenericAPIView):
完成单查
def get(self, request, *args, **kwargs):
return self.retrieve(request, *args, **kwargs)
class ListAPIView(mixins.ListModelMixin,
GenericAPIView):
完成群查
def get(self, request, *args, **kwargs):
return self.list(request, *args, **kwargs)
class CreateAPIView(mixins.CreateModelMixin,
GenericAPIView):
完成单增
def post(self, request, *args, **kwargs):
return self.create(request, *args, **kwargs)
class UpdateAPIView(mixins.UpdateModelMixin,
GenericAPIView):
单整体改
def put(self, request, *args, **kwargs):
return self.update(request, *args, **kwargs)
单局部改
def patch(self, request, *args, **kwargs):
return self.partial_update(request, *args, **kwargs)
class DestroyAPIView(mixins.DestroyModelMixin,
GenericAPIView):
完成单删
def delete(self, request, *args, **kwargs):
return self.destroy(request, *args, **kwargs)
class ListCreateAPIView(mixins.ListModelMixin,
mixins.CreateModelMixin,
GenericAPIView):
群查
def get(self, request, *args, **kwargs):
return self.list(request, *args, **kwargs)
单增
def post(self, request, *args, **kwargs):
return self.create(request, *args, **kwargs)
class RetrieveUpdateAPIView(mixins.RetrieveModelMixin,
mixins.UpdateModelMixin,
GenericAPIView):
单查
def get(self, request, *args, **kwargs):
return self.retrieve(request, *args, **kwargs)
单整体改
def put(self, request, *args, **kwargs):
return self.update(request, *args, **kwargs)
单局部改
def patch(self, request, *args, **kwargs):
return self.partial_update(request, *args, **kwargs)
class RetrieveDestroyAPIView(mixins.RetrieveModelMixin,
mixins.DestroyModelMixin,
GenericAPIView):
单查
def get(self, request, *args, **kwargs):
return self.retrieve(request, *args, **kwargs)
单删
def delete(self, request, *args, **kwargs):
return self.destroy(request, *args, **kwargs)
class RetrieveUpdateDestroyAPIView(mixins.RetrieveModelMixin,
mixins.UpdateModelMixin,
mixins.DestroyModelMixin,
GenericAPIView):
单查
def get(self, request, *args, **kwargs):
return self.retrieve(request, *args, **kwargs)
单整体改
def put(self, request, *args, **kwargs):
return self.update(request, *args, **kwargs)
单局部改
def patch(self, request, *args, **kwargs):
return self.partial_update(request, *args, **kwargs)
单删
def delete(self, request, *args, **kwargs):
return self.destroy(request, *args, **kwargs)
四、viewsets视图集
包含:
一个工具类、两个视图集基类、两个视图集子类
1、作用
其中一个工具类重写了as_view方法,将自己定义的群查和单查方法的函数地址赋给get方法,这样就可以在路由来调用时,主动识别调用单查还是群查。
2、如何使用
路由中:as_view({‘get‘:‘list‘}) 传入的{‘get‘:‘list‘}就被actions接收,原理是将get请求映射给视图类的list函数进行处理。
class ViewSetMixin:
视图集都继承了ViewSetMixin类,该类重写了as_view方法,相比APIView的as_view方法,额外多出了一个参数:actions。
@classonlymethod
def as_view(cls, actions=None, **initkwargs):
class ViewSet(ViewSetMixin, views.APIView):
pass
class GenericViewSet(ViewSetMixin, generics.GenericAPIView):
pass
class ReadOnlyModelViewSet(mixins.RetrieveModelMixin,
mixins.ListModelMixin,
GenericViewSet):
pass
class ModelViewSet(mixins.CreateModelMixin,
mixins.RetrieveModelMixin,
mixins.UpdateModelMixin,
mixins.DestroyModelMixin,
mixins.ListModelMixin,
GenericViewSet):
pass
- GenericViewSet和ViewSet两个基类有什么区别:
- GenericViewSet(ViewSetMixin,GenericAPIView):该分支严格满足资源接口
- ViewSet(ViewSetMixin,APIView):该分支满足的接口与资源Model类关系不是特别密切(登录接口、短信验证码接口)
- ReadOnlyModelViewSet,ModelViewSet两个视图集子类,就是做个一堆mixin与GenericViewSet相结合,自己在urls文件中配置as_view的action分发。
3、ModelViewSet的不合理之处及解决方法
不合理之处:
- 没有群增,群整体改,群局部改,群删四个接口
- 删除操作视图集默认走的destroy方法是将资源从数据库中删除,通常一个做字段is_delete字段修改表示删除
- 响应的结果只有数据,没有数据状态码和状态信息
解决方法:
群整体改,群局部改,全删三个接口可以独立成三个方法
def many_update(self, request, *args, **kwargs): pass def many_partial_update(self, request, *args, **kwargs): pass def many_destroy(self, request, *args, **kwargs): pass
- 群增与单增必须公用一个接口,都要走create方法 - 重写create方法,用逻辑进行拆分
def create(self, request, *args, **kwargs): request_data = request.data if isinstance(request_data, list): car_ser = self.get_serializer(data=request_data, many=True) car_ser.is_valid(raise_exception=True) car_obj = car_ser.save() return APIResponse(msg='群增成功', results=self.get_serializer(car_obj, many=True).data) return super().create(request, *args, **kwargs)
destroy方法是完成is_delete字段值修改 - 重写destroy方法,自定义实现体
def destroy(self, request, *args, **kwargs): car_obj = self.get_object() car_obj.is_delete = True car_obj.save() return APIResponse(msg='删除成功')
让群查有状态码和状态信息 - 重写list方法
def list(self, request, *args, **kwargs): response = super().list(request, *args, **kwargs) return APIResponse(results=response.data)
路由层补充
路由的其他写法:SimpleRouter
会遇到,看到了要认识:
# urls.py
from rest_framework.routers import SimpleRouter
router = SimpleRouter()
router.register('v2/cars', views.CarModelViewSet, basename='car')
urlpatterns = [
url(r'^v1/cars/$', views.CarAPIView.as_view()),
url(r'', include(router.urls))
]
/
urlpatterns += router.urls
/
urlpatterns = router.urls
以上是关于77-drf视图家族及路由层补充的主要内容,如果未能解决你的问题,请参考以下文章