Django Academy · 课时

ModelViewSet 与路由器

自动生成 CRUD 路由

ModelViewSet 与路由器 是 CoddyKit 上的免费 Django Academy 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Django Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Django Academy 课程共包含 4 节课。

本课时的部分内容尚未翻译，以英文显示。

The CRUD Repetition Problem

Writing list, create, retrieve, update, and delete by hand means a lot of near-identical code. A ViewSet bundles all of it into one tidy class.

Meet ModelViewSet

The ModelViewSet gives you full CRUD for a model with almost no code. Point it at a queryset and a serializer, and it handles the rest.

from rest_framework import viewsets

class BookViewSet(viewsets.ModelViewSet):
    queryset = Book.objects.all()
    serializer_class = BookSerializer

Two Attributes Do the Work

Those two lines carry the whole class. queryset says which rows are in play, and serializer_class says how to turn them into JSON. 📦

The Actions You Get Free

A ModelViewSet provides five actions: list, create, retrieve, update, partial_update, and destroy. You wrote none of them by hand.

Why Routers Exist

A ViewSet groups actions, but URLs still need wiring. A router reads your ViewSet and generates every URL pattern automatically.

Registering with DefaultRouter

Create a DefaultRouter, register your ViewSet under a prefix, and it builds the full URL set for you.

from rest_framework.routers import DefaultRouter

router = DefaultRouter()
router.register(r'books', BookViewSet)

Plugging Router URLs In

The router exposes router.urls, a ready list of patterns. Add it to your urlpatterns and the endpoints go live instantly.

urlpatterns = [
    path('api/', include(router.urls)),
]

The URLs You Just Created

Registering one ViewSet gives you /books/ for the list and create, plus /books/{id}/ for retrieve, update, and delete. 🚀

HTTP Verbs Map to Actions

The router maps verbs to actions: GET lists, POST creates, GET on an id retrieves, PUT or PATCH updates, and DELETE destroys. One ViewSet, six behaviors.

DefaultRouter vs SimpleRouter

DefaultRouter adds a handy API root view that lists your endpoints. SimpleRouter skips it when you want a leaner URL set.

Adding a Custom Action

Need an extra endpoint? The @action decorator adds a custom route to a ViewSet without leaving the class.

from rest_framework.decorators import action

@action(detail=True, methods=['post'])
def favorite(self, request, pk=None):
    ...

Quick Check

Time to lock in how ViewSets and routers fit together.

Recap: CRUD in a Few Lines

You learned that a ModelViewSet plus a router turns two short classes into a complete CRUD API, with clean URLs generated for you. Nicely done! 🎉

常见问题解答

「ModelViewSet 与路由器」课时是免费的吗？

是的 — 「ModelViewSet 与路由器」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Django Academy 课程的其余内容，请升级到 CoddyKit PRO。 Django Academy 课程共包含 4 节课。

「ModelViewSet 与路由器」这节课中我会学到什么？

自动生成 CRUD 路由你通过在浏览器中直接运行的动手代码来练习 Django Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Django Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Django Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「ModelViewSet 与路由器」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Django Academy 课中编写并运行代码吗？

能。每节 Django Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Django Academy