DRF viewsets र routers के हुन्?

Question

Accepted Answer

Django REST Framework मा, **viewsets** ले सम्बन्धित API endpoints को सेटको लागि तर्क (resource को CRUD operations) एक एकल क्लासमा समूहबद्ध गर्छ, र **routers** ले तिनीहरूको लागि URL routing स्वचालित रूपमा उत्पन्न गर्छ। सँगै तिनीहरूले RESTful APIs निर्माणको लागि boilerplate नाटकीय रूपमा कम गर्छन्।

## ModelViewSet — केही लाइनमा पूर्ण CRUD

```python
from rest_framework import viewsets

class ArticleViewSet(viewsets.ModelViewSet):
    queryset = Article.objects.all()             # the data
    serializer_class = ArticleSerializer          # how to serialize it
    # That's it! This provides ALL standard CRUD endpoints automatically:
    #   list (GET), create (POST), retrieve (GET /id), update (PUT/PATCH /id), destroy (DELETE /id)
```

एक `ModelViewSet` ले मडेलको लागि **RESTful CRUD endpoints को सम्पूर्ण सेट** स्वचालित रूपमा प्रदान गर्छ — list, create, retrieve, update, partial update, र delete — केवल queryset र serializer बाट। प्रत्येक view अलगै लेख्नुको आवश्यकता छैन।

## Routers — स्वचालित URL उत्पादन

```python
from rest_framework.routers import DefaultRouter

router = DefaultRouter()
router.register(r"articles", ArticleViewSet)     # register the viewset

urlpatterns = router.urls
# automatically creates the RESTful URLs:
#   GET    /articles/        → list
#   POST   /articles/        → create
#   GET    /articles/{id}/   → retrieve
#   PUT    /articles/{id}/   → update
#   PATCH  /articles/{id}/   → partial update
#   DELETE /articles/{id}/   → destroy
```

एक **router** ले viewset लाई स्वचालित रूपमा RESTful URLs को पूर्ण सेटमा म्याप गर्छ — एक viewset रजिस्टर गर्दा सही HTTP methods को साथ सबै परम्परागत endpoints उत्पन्न हुन्छ, म्यानुअल URL कन्फिगरेशन हटाएर।

## Viewsets अनुकूलन गर्दै

```python
class ArticleViewSet(viewsets.ModelViewSet):
    serializer_class = ArticleSerializer
    permission_classes = [IsAuthenticated]        # authorization

def get_queryset(self):                        # customize the data per request
        return Article.objects.filter(author=self.request.user)

# add CUSTOM endpoints beyond CRUD with @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"})
```

Viewsets लाई methods (`get_queryset`, `perform_create`) override गरेर, अनुमतिहरू सेट गरेर, र **custom actions** (`@action`) जोडेर अनुकूलित गरिन्छ मानक CRUD भन्दा परे endpoints को लागि।

## Viewsets बनाम generic API views

```text
ModelViewSet  → ALL CRUD in one class + router → least code for standard REST resources
Generic views (ListCreateAPIView, etc.) → more explicit, one class per endpoint group
APIView       → full manual control for non-standard/custom endpoints
→ Use viewsets+routers for conventional REST resources; generic/APIView for custom needs.
```

## यो किन महत्त्वपूर्ण छ

Viewsets र routers RESTful APIs कुशलतापूर्वक निर्माण गर्नको लागि शक्तिशाली DRF विशेषता हुन् — तिनीहरूले एक मडेल लाई पूर्ण REST resource को रूपमा expose गर्ने अत्यन्त सामान्य केसको लागि abstraction को उच्चतम स्तरको प्रतिनिधित्व गर्छन्, र तिनीहरू बझ्नु उत्पादक API विकासको लागि मूल्यवान छ।

मुख्य लाभ नाटकीय **boilerplate reduction** छ: एक `ModelViewSet` र एक router ले तपाईंलाई सही HTTP methods र URLs को साथ resource को लागि पूर्ण, परम्परागत REST API दिन्छ (सबै CRUD endpoints) केवल queryset र serializer बाट — जो अन्यथा धेरै अलग views र म्यानुअल URL patterns को जगहमा हुने थियो।

यो मानक REST APIs निर्माण अत्यन्त छिटो बनाता है जबकि **RESTful conventions** (सुसंगत URL संरचना र HTTP method semantics) स्वचालित रूपमा पालन गरिन्छ।

Viewsets लचकदार रहन्छ — तपाई methods override गरेर (प्रति user queryset फिल्टर गर्दै, अनुमतिहरू नियन्त्रण गर्दै, create/update मा hook गर्दै) र **custom actions** (`@action`) जोडेर तिनीहरू अनुकूलन गर्नुहुन्छ मानक CRUD भन्दा परे endpoints को लागि।

Viewsets र routers बझ्नु, तिनीहरूले कसरी endpoints उत्पन्न गर्छन्, तिनीहरूलाई कसरी अनुकूलन गर्ने, र **कहिले तिनीहरू प्रयोग गर्ने** (परम्परागत REST resources) अधिक स्पष्ट generic views वा APIView (custom/non-standard endpoints) को विरुद्ध महत्त्वपूर्ण व्यावहारिक ज्ञान छ DRF विकासको लागि।

REST APIs निर्माण आज Django को प्राथमिक प्रयोग भएकोले, र viewsets+routers मानक resources को लागि idiomatic, सबैभन्दा-उत्पादक तरीका भएकोले, तिनीहरू frequently-used, महत्त्वपूर्ण DRF toolkit को भाग हुन् जो विकासकर्ताहरूलाई न्यूनतम कोड को साथ robust APIs निर्माण गर्न र custom requirements को लागि flexibility राख्न देन्छ।