其他分享
首页 > 其他分享> > 视图集ViewSet

视图集ViewSet

作者:互联网

视图集

使用视图集ViewSet,可以将一系列逻辑相关的动作放到一个类中:

ViewSet视图集类不再实现get()、post()等方法,而是实现动作 action 如 list() 、create() 等。

使用django按照restful开发接口,一个实体类的借口至少需要做两个视图,因为django是按照请求名称小写后去映射处理的方法,导致无法放入一个视图中。

视图集只在使用as_view()方法的时候,才会将action动作与具体请求方式对应上。

class BookViewSet(viewsets.ViewSet):

    def list(self, request): # 获取所有图书
        books = Book.objects.all()
        serializer = BookSerializer(books, many=True)
        return Response(serializer.data)

    def retrieve(self, request, pk=None): # 获取指定某个图书
        try:
            books = Book.objects.get(id=pk)
        except Book.DoesNotExist:
            return Response(status=status.HTTP_404_NOT_FOUND)
        serializer = BookSerializer(books)
        return Response(serializer.data)

在设置路由时,可以如下操作:

urlpatterns = [
    url(r'^books/$', BookViewSet.as_view({'get':'list'}), # get方法映射list
    url(r'^books/(?P<pk>\d+)/$', BookViewSet.as_view({'get': 'retrieve'}) # get方法映射retrieve
]

使用ViewSet需要手动指定映射的方法,而且list、retrieve、create、update、destory等方法都需要自己编写。

常用的视图集类

ViewSet

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

ViewSet主要通过继承ViewSetMixin来实现在调用as_view()时传入字典(如{'get':'list'})的映射处理工作。

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

class ViewSet(ViewSetMixin, views.APIView):
    """
    The base ViewSet class does not provide any actions by default.
    """
    pass

GenericViewSet

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

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

例如:

from rest_framework import mixins
from rest_framework.viewsets import GenericViewSet
from rest_framework.decorators import action

class BookViewSet(mixins.ListModelMixin, mixins.RetrieveModelMixin, GenericViewSet):
    queryset = Book.objects.all()
    serializer_class = BookSerializer
    # 无需手动再写list、retrieve方法,因为继承的ListModelMixin和RetrieveModelMixin已实现

url的定义:

urlpatterns = [
    url(r'^books/$', views.BookViewSet.as_view({'get': 'list'})),
    url(r'^books/(?P<pk>\d+)/$', views.BookViewSet.as_view({'get': 'retrieve'})),
]

ModelViewSet

继承自GenericViewSet,同时包括了ListModelMixin、RetrieveModelMixin、CreateModelMixin、UpdateModelMixin、DestoryModelMixin。

class ModelViewSet(mixins.CreateModelMixin,
                   mixins.RetrieveModelMixin,
                   mixins.UpdateModelMixin,
                   mixins.DestroyModelMixin,
                   mixins.ListModelMixin,
                   GenericViewSet):
    """
    A viewset that provides default `create()`, `retrieve()`, `update()`,
    `partial_update()`, `destroy()` and `list()` actions.
    """
    pass

ReadOnlyModelViewSet

继承RetrieveModelMixin、ListModelMixin、GenericViewSet

class ReadOnlyModelViewSet(mixins.RetrieveModelMixin,
                           mixins.ListModelMixin,
                           GenericViewSet):
    """
    A viewset that provides default `list()` and `retrieve()` actions.
    """
    pass

 

视图集中定义附加action动作

在视图集中,除了上述默认的方法动作外,还可以添加自定义动作。

from rest_framework import mixins
from rest_framework.viewsets import GenericViewSet
from rest_framework.decorators import action

class BookViewSet(mixins.ListModelMixin, mixins.RetrieveModelMixin, GenericViewSet):
    queryset = Book.objects.all()
    serializer_class = BookSerializer

    def latest(self, request):
        """
        查询id最大的图书信息
        """
        book = Book.objects.latest('id')
        serializer = self.get_serializer(book)
        return Response(serializer.data)

    def price(self, request, pk):
        """
        只修改图书价格
        """
        book = self.get_object()
        book.price = request.data.get('price')
        book.save()
        serializer = self.get_serializer(book)
        return Response(serializer.data)

url的定义:

urlpatterns = [
    url(r'^books/$', views.BookViewSet.as_view({'get': 'list'})),
    url(r'^books/latest/$', views.BookViewSet.as_view({'get': 'latest'})),
    url(r'^books/(?P<pk>\d+)/$', views.BookViewSet.as_view({'get': 'retrieve'})),
    url(r'^books/(?P<pk>\d+)/price/$', views.BookViewSet.as_view({'put': 'price'})),
]

视图集继承关系

 

标签:get,list,mixins,books,serializer,ViewSet,图集,view
来源: https://www.cnblogs.com/longan-wang/p/15175674.html