Trong Django REST Framework, viewset gom logic cho một tập các endpoint API liên quan (các thao tác CRUD cho một tài nguyên) vào một class duy nhất, và router tự động sinh routing URL cho chúng. Cùng nhau, chúng giảm đáng kể boilerplate cho việc xây dựng RESTful API.
rest_framework viewsets
(viewsets.ModelViewSet):
queryset = Article.objects.()
serializer_class = ArticleSerializer
Một ModelViewSet tự động cung cấp bộ endpoint CRUD RESTful hoàn chỉnh cho một model — liệt kê, tạo, lấy, cập nhật, cập nhật một phần, và xóa — chỉ từ một queryset và serializer. Không cần viết từng view riêng.
from rest_framework.routers import DefaultRouter
router = DefaultRouter()
router.register(r"articles", ArticleViewSet) # đăng ký viewset
urlpatterns = router.urls
# tự động tạo các URL RESTful:
# GET /articles/ → list
# POST /articles/ → create
# GET /articles/{id}/ → retrieve
# PUT /articles/{id}/ → update
# PATCH /articles/{id}/ → cập nhật một phần
# DELETE /articles/{id}/ → destroy
Một router ánh xạ một viewset tới một bộ URL RESTful chuẩn đầy đủ một cách tự động — đăng ký một viewset sinh ra tất cả các endpoint quy ước với phương thức HTTP đúng, loại bỏ cấu hình URL thủ công.
class ArticleViewSet(viewsets.ModelViewSet):
serializer_class = ArticleSerializer
permission_classes = [IsAuthenticated] # phân quyền
def get_queryset(self): # tùy biến dữ liệu theo từng request
return Article.objects.filter(author=self.request.user)
# thêm endpoint TÙY BIẾN ngoài CRUD với @action
@action(detail=True, methods=["post"])
def publish(self, request, pk=None): # POST /articles/{id}/publish/
article = self.get_object()
article.published = True
article.save()
return Response({"status": "published"})
Viewset được tùy biến bằng cách ghi đè phương thức (get_queryset, perform_create), đặt quyền, và thêm action tùy biến (@action) cho các endpoint ngoài CRUD chuẩn.
ModelViewSet → TẤT CẢ CRUD trong một class + router → ít mã nhất cho tài nguyên REST chuẩn
Generic view (ListCreateAPIView, v.v.) → rõ ràng hơn, một class cho mỗi nhóm endpoint
APIView → kiểm soát thủ công đầy đủ cho endpoint phi chuẩn/tùy biến
→ Dùng viewset+router cho tài nguyên REST quy ước; generic/APIView cho nhu cầu tùy biến.
Viewset và router là một tính năng DRF mạnh mẽ để xây dựng RESTful API hiệu quả — chúng đại diện cho mức trừu tượng cao nhất cho trường hợp cực kỳ phổ biến là phơi bày một model thành một tài nguyên REST đầy đủ, và hiểu chúng có giá trị cho phát triển API năng suất.
Lợi ích then chốt là giảm boilerplate đáng kể: một ModelViewSet cộng một router cho bạn một REST API hoàn chỉnh, quy ước cho một tài nguyên (tất cả endpoint CRUD với phương thức HTTP và URL đúng) chỉ từ một queryset và serializer — thay thế cho cái mà nếu không sẽ là nhiều view riêng và pattern URL thủ công.
Điều này khiến việc xây dựng REST API chuẩn trở nên cực nhanh trong khi đảm bảo các quy ước RESTful (cấu trúc URL nhất quán và ngữ nghĩa phương thức HTTP) được tuân theo tự động.
Viewset vẫn linh hoạt — bạn tùy biến chúng bằng cách ghi đè phương thức (lọc queryset theo từng user, kiểm soát quyền, móc vào tạo/cập nhật) và thêm action tùy biến (@action) cho các endpoint ngoài CRUD cơ bản.
Hiểu viewset và router, cách chúng sinh endpoint, cách tùy biến chúng, và khi nào dùng chúng (tài nguyên REST quy ước) so với generic view rõ ràng hơn hoặc APIView (endpoint tùy biến/phi chuẩn) là kiến thức thực tế quan trọng cho phát triển DRF.
Vì xây dựng REST API là một mục đích sử dụng chính của Django ngày nay, và viewset+router là cách idiomatic, năng suất nhất để làm điều đó cho tài nguyên chuẩn, chúng là một phần thường dùng, quan trọng của bộ công cụ DRF cho phép lập trình viên xây dựng các API mạnh mẽ với mã tối thiểu trong khi giữ sự linh hoạt để xử lý các yêu cầu tùy biến.