ModelViewSet и маршрутизаторы
Автоматически создавайте маршруты CRUD
«ModelViewSet и маршрутизаторы» — бесплатный урок Django Academy на CoddyKit. Это урок 1 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Django Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Django Academy содержит 4 уроков всего.
Проблема повторения CRUD
Если вручную писать получение списка, создание, получение объекта, обновление и удаление, получится много почти одинакового кода. ViewSet объединяет всё это в одном аккуратном классе.
Знакомьтесь: ModelViewSet
ModelViewSet предоставляет полный CRUD для модели почти без кода. Укажите набор запросов и сериализатор — остальное он сделает сам.
from rest_framework import viewsets
class BookViewSet(viewsets.ModelViewSet):
queryset = Book.objects.all()
serializer_class = BookSerializerДва атрибута выполняют всю работу
Эти две строки содержат всё необходимое для класса. queryset указывает, какие строки используются, а serializer_class — как преобразовать их в JSON. 📦
Действия, доступные бесплатно
ModelViewSet предоставляет пять действий: получение списка, создание, получение объекта, обновление, частичное обновление и удаление. Вам не пришлось писать ни одно из них вручную.
Зачем нужны маршрутизаторы
ViewSet объединяет действия, но URL всё ещё нужно связать с ними. Маршрутизатор читает Ваш ViewSet и автоматически создаёт все шаблоны URL.
Регистрация с помощью DefaultRouter
Создайте DefaultRouter, зарегистрируйте в нём ViewSet с префиксом — и он построит полный набор URL.
from rest_framework.routers import DefaultRouter
router = DefaultRouter()
router.register(r'books', BookViewSet)Подключение URL маршрутизатора
Маршрутизатор предоставляет router.urls — готовый список шаблонов. Добавьте его в urlpatterns, и конечные точки сразу станут доступными.
urlpatterns = [
path('api/', include(router.urls)),
]Созданные Вами URL
Регистрация одного ViewSet предоставляет /books/ для списка и создания, а также /books/{id}/ для получения, обновления и удаления. 🚀
HTTP-глаголы соответствуют действиям
Маршрутизатор связывает глаголы с действиями: GET получает список, POST создаёт объект, GET с идентификатором получает объект, PUT или PATCH обновляет его, а DELETE удаляет. Один ViewSet, шесть вариантов поведения.
DefaultRouter и SimpleRouter
DefaultRouter добавляет удобное представление корня API со списком конечных точек. SimpleRouter не добавляет его, если Вам нужен более компактный набор URL.
Добавление пользовательского действия
Нужна дополнительная конечная точка? Декоратор @action добавит пользовательский маршрут в ViewSet, не заставляя Вас покидать класс.
from rest_framework.decorators import action
@action(detail=True, methods=['post'])
def favorite(self, request, pk=None):
...Быстрая проверка
Пора закрепить, как связаны ViewSet и маршрутизаторы.
Итоги: CRUD в нескольких строках
Вы узнали, что ModelViewSet вместе с маршрутизатором превращает два коротких класса в полноценный CRUD API с автоматически созданными понятными URL. Отличная работа! 🎉
Изучай Python с ИИ-репетитором — бесплатно
Пиши и запускай код прямо в браузере, получай мгновенную помощь от ИИ-репетитора 24/7 и продолжи учиться на сайте или в приложении.
- Курсы
- 30
- Уроки
- 120
Часто задаваемые вопросы
Урок «ModelViewSet и маршрутизаторы» бесплатный?
Да — полный текст урока «ModelViewSet и маршрутизаторы» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Django Academy, подпишись на CoddyKit PRO. Курс Django Academy содержит 4 уроков всего.
Чему я научусь в уроке «ModelViewSet и маршрутизаторы»?
Автоматически создавайте маршруты CRUD Ты практикуешь Django Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать Django Academy?
Предыдущий опыт не требуется. Django Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 1 из 4.
Сколько времени занимает урок «ModelViewSet и маршрутизаторы»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке Django Academy?
Да. Каждый урок Django Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- ModelViewSet и маршрутизаторы
- Разрешения и ограничение частоты запросов
- Аутентификация по токенам и JWT
- Фильтрация, поиск и разбиение на страницы