Viewsets

django-rest-framework-russian-documentation
Search…
Viewsets
ViewSets
Для запроса определяется контролер, и он отвечает за обработку запроса и выдает нужный результат.
Django REST framework позволяет комбинировать логику для набора связанных представлений в одном классе, который назвается ViewSet. В других фреймворках вы также можете встретить похожие концепции под названием 'Resources' или 'Controllers'.
Класс ViewSet это просто представление-класс, которое не используеи никаких методов обработки, как .get() или .post(), а вместо этого включает действия .list() и .create().
Обработчики метода для ViewSet связаны только для соответствующих действий на моменте окончательной обработке представления, используя метод .as_view().
Как правило, вместо того, чтобы подробно регистрировать представления в viewset в urlconf, вы регистрируете viewset в классе маршрутизатора, который автоматически определяет для вас urlconf.
Пример
Давайте определим простой viewset, который может быть использован для перечисления или поиска всех пользователей в системе.
1
from django.contrib.auth.models import User
2
from django.shortcuts import get_object_or_404
3
from myapps.serializers import UserSerializer
4
from rest_framework import viewsets
5
from rest_framework.response import Response
6
​
7
class UserViewSet(viewsets.ViewSet):
8
    """
9
    A simple ViewSet for listing or retrieving users.
10
    """
11
    def list(self, request):
12
        queryset = User.objects.all()
13
        serializer = UserSerializer(queryset, many=True)
14
        return Response(serializer.data)
15
​
16
    def retrieve(self, request, pk=None):
17
        queryset = User.objects.all()
18
        user = get_object_or_404(queryset, pk=pk)
19
        serializer = UserSerializer(user)
20
        return Response(serializer.data)
Copied!
В случае необходимости мы можем связать этот viewset с двумя отдельными представлениями:
1
user_list = UserViewSet.as_view({'get': 'list'})
2
user_detail = UserViewSet.as_view({'get': 'retrieve'})
Copied!
Как правило, вместо этого мы регистрируем viewset в маршрутизаторе и разрешаем автоматическое создание urlconf.
1
from myapp.views import UserViewSet
2
from rest_framework.routers import DefaultRouter
3
​
4
router = DefaultRouter()
5
router.register(r'users', UserViewSet, base_name='user')
6
urlpatterns = router.urls
Copied!
Вместо того, чтобы писать собственные viewset'ы, чаще рациональнее использовать существующие базовые классы, которые описывают стандартное поведение. Например:
1
class UserViewSet(viewsets.ModelViewSet):
2
    """
3
    A viewset for viewing and editing user instances.
4
    """
5
    serializer_class = UserSerializer
6
    queryset = User.objects.all()
Copied!
Класс ViewSet дает два главных преимущества перед классом View.
Можно заключить неоднократно повторяющуюся логику в один класс. Выше нам потребовалось лишь один раз уточнить queryset, и после этого он будет использоваться во множестве представлений.
Используя маршрутизаторы нам больше не нужно самим писать URL conf.
Однако эти плюсы несут свои компромиссы. Использование обычных представлений и URL confs более очевидно и предоставляет больше контроля. ViewSets полезны если вы хотите, чтобы все заработало как можно быстрее, или когда у вас большой API, и вам требуется обеспечить равномерную конфигурацию URL во всем проекте.
Дополнительные действия для маршрутизации
Средства REST framework предоставляют маршрутизаторы для стандартных операций create/retrieve/update/destroy, как показано ниже:
1
class UserViewSet(viewsets.ViewSet):
2
    """
3
    Example empty viewset demonstrating the standard
4
    actions that will be handled by a router class.
5
​
6
    If you're using format suffixes, make sure to also include
7
    the `format=None` keyword argument for each action.
8
    """
9
​
10
    def list(self, request):
11
        pass
12
​
13
    def create(self, request):
14
        pass
15
​
16
    def retrieve(self, request, pk=None):
17
        pass
18
​
19
    def update(self, request, pk=None):
20
        pass
21
​
22
    def partial_update(self, request, pk=None):
23
        pass
24
​
25
    def destroy(self, request, pk=None):
26
        pass
Copied!
Если у вас есть специальные методы ad-hoc, вы можете отметить их как требующими маршрутизации, используя декораторы @detail_route или @list_route.
Декоратор @detail_route содержит pk в своем URL паттерне и предназначается для методов, которые требуют один экземпляр. Декоратор @list_route предназначен для методов, которые взаимодейстуют со списками объектов.
Например:
1
from django.contrib.auth.models import User
2
from rest_framework import status
3
from rest_framework import viewsets
4
from rest_framework.decorators import detail_route, list_route
5
from rest_framework.response import Response
6
from myapp.serializers import UserSerializer, PasswordSerializer
7
​
8
class UserViewSet(viewsets.ModelViewSet):
9
    """
10
    A viewset that provides the standard actions
11
    """
12
    queryset = User.objects.all()
13
    serializer_class = UserSerializer
14
​
15
    @detail_route(methods=['post'])
16
    def set_password(self, request, pk=None):
17
        user = self.get_object()
18
        serializer = PasswordSerializer(data=request.data)
19
        if serializer.is_valid():
20
            user.set_password(serializer.data['password'])
21
            user.save()
22
            return Response({'status': 'password set'})
23
        else:
24
            return Response(serializer.errors,
25
                            status=status.HTTP_400_BAD_REQUEST)
26
​
27
    @list_route()
28
    def recent_users(self, request):
29
        recent_users = User.objects.all().order('-last_login')
30
​
31
        page = self.paginate_queryset(recent_users)
32
        if page is not None:
33
            serializer = self.get_serializer(page, many=True)
34
            return self.get_paginated_response(serializer.data)
35
​
36
        serializer = self.get_serializer(recent_users, many=True)
37
        return Response(serializer.data)
Copied!
К тому же декораторы могут принимать дополнительные аргументы, которые будут указываться только для маршрутизированных представлений. Например...
1
    @detail_route(methods=['post'], permission_classes=[IsAdminOrIsSelf])
2
    def set_password(self, request, pk=None):
3
       ...
Copied!
Эти декораторы будут маршутизировать GET запросы по умолчанию, но также могут принимать другие методы HTTP с помощью методов аргрумента. Например:
1
    @detail_route(methods=['post', 'delete'])
2
    def unset_password(self, request, pk=None):
3
       ...
Copied!
Два новых действия будут доступны по urls ^users/{pk}/set_password/$ и ^users/{pk}/unset_password/$
Обращение к API
ViewSet
Класс ViewSet наследуется от APIView. Вы можете использовать любой из стандартных атрибутов, такие как permission_classes, authentication_classes, чтобы контролировать поведение API в viewset.
Класс ViewSetне реализует действия. Для того чтобы воспользоваться классом ViewSet нужно переписать класс и расписать действия.
GenericViewSet
Класс GenericViewSet наследуется от GenericAPIView и предоставляет стандартный набо методов get_object, get_queryset и другие общие механизмы поведения педставления, но при этом не реализует их.
Для того, чтобы использовать GenericViewSet вам нужно переписать класс и, либо создать миксины требуемых классов, либо явно определить реализацию действий.
ModelViewSet
Класс ModelViewSet наследуется от GenericAPIView и реализует различные действия, совмещая функционал различных классов миксинов.
Класс ModelViewSet предоставляет следующие действия .list(), .retrieve(), .create(), .update(), .partial_update(), и .destroy().
Пример
Так как ModelViewSetрасширяет GenericAPIView вам по меньшей мере нужно предоставить по крайней мере queryset и атрибуты serializer_class. Например:
1
class AccountViewSet(viewsets.ModelViewSet):
2
    """
3
    A simple ViewSet for viewing and editing accounts.
4
    """
5
    queryset = Account.objects.all()
6
    serializer_class = AccountSerializer
7
    permission_classes = [IsAccountAdminOrReadOnly]
Copied!
Вы можете использовать стандартные атрибуты или подменять методы, предоставленные GenericAPIView. Например, чтобы использовать ViewSet, который динамически определяет queryset, вы можете сделать следующее:
1
class AccountViewSet(viewsets.ModelViewSet):
2
    """
3
    Простой ViewSet для просмотра и редактирования
4
    аккаунтов, привязанных к пользователю
5
    """
6
    serializer_class = AccountSerializer
7
    permission_classes = [IsAccountAdminOrReadOnly]
8
​
9
    def get_queryset(self):
10
        return self.request.user.accounts.all()
Copied!
Однако заметьте, что при удалении свойства queryset из вышего ViewSet любой связанный маршрутизатор не сможет автоматически выделить base_name вашей модели, таким образом вам придется указать kwarg для base_name при регистрации роутера.
Также заметьте, что хоть этот класс и реализует по умолчанию полный набор действий create/list/retrieve/update/destroy, вы можете ограничить доступный функционал, используя стандартные разрешающие классы.
ReadOnlyModelViewSet
Класс ReadOnlyModelViewSet также наследуется от GenericAPIView. Как и в случае с ModelViewSet он также реализует различные действия, но в отличие от ModelViewSet ограничивается лишь функционалом 'только для чтения' .list() и .retrieve().
Пример
Как и при использовании ModelViewSet, вам как минимум нужно предоставить queryset и атрибуты serializer_class
Например:
1
class AccountViewSet(viewsets.ReadOnlyModelViewSet):
2
    """
3
    Простой ViewSet для просмотра аккунтов.
4
    """
5
    queryset = Account.objects.all()
6
    serializer_class = AccountSerializer
Copied!
Как и в случае с ModelViewSet вы можете использовать стандартне атрибуты и замены методов, доступные в GenericAPIView.
Кастомые базовые классы ViewSet
Возможно вам понадобится использоваться кастомными классами, которые не реализуют весь набор действий ModelViewSet, или каким-то образом изменяют поведение.
Пример
Чтобы создать базовый класс viewset, который реализует действия create, list и retrieve, наследуется от GenericViewSet и создает миксины для требуемых действий:
1
from rest_framework import mixins
2
​
3
class CreateListRetrieveViewSet(mixins.CreateModelMixin,
4
                                mixins.ListModelMixin,
5
                                mixins.RetrieveModelMixin,
6
                                viewsets.GenericViewSet):
7
    """
8
    A viewset that provides `retrieve`, `create`, and `list` actions.
9
​
10
    To use it, override the class and set the `.queryset` and
11
    `.serializer_class` attributes.
12
    """
13
    pass
Copied!
Создавая собственные базовые классы ViewSet, вы можете реализовать общее поведение, которое может быть повторно использовано в вашем API.
Общие представления
Маршрутизаторы
Last modified 1yr ago
Copy link
Contents
ViewSets
Пример
Дополнительные действия для маршрутизации
Кастомые базовые классы ViewSet