DRF viewsets आणि routers काय आहेत?

Question

Accepted Answer

Django REST Framework मध्ये, **viewsets** संबंधित API endpoints (एका संसाधनासाठी CRUD ऑपरेशन) चे तर्क एका वर्गात गटबद्ध करतात, आणि **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 नोंदणी करणे सर्व परंपरागत endpoints सह सर्व उचित HTTP methods व URLs तयार करते, handbook 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 पद्धती override करून कस्टमाइज केले जातात (`get_queryset`, `perform_create`), permissions सेट करून, आणि मानक CRUD च्या पलीकडे endpoints साठी **custom actions** (`@action`) जोडून.

## 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 संसाधन म्हणून उघड करण्याच्या अत्यंत सामान्य घटनेसाठी abstraction च्या सर्वोच्च पातळीचे प्रतिनिधित्व करतात, आणि त्यांना समजून घेणे उत्पादक API विकासासाठी मूल्यवान आहे.

मुख्य लाभ नाटकीय **boilerplate reduction** आहे: `ModelViewSet` अधिक router आपल्याला एका संसाधनासाठी संपूर्ण, परंपरागत REST API देते (सर्व CRUD endpoints सर्व उचित HTTP methods आणि URLs सह) फक्त एक queryset आणि serializer वरून — जे अन्यथा अनेक वेगळ्या views आणि handbook URL patterns असेल.

हे मानक REST APIs बांधणे अत्यंत वेगवान बनवते तर **RESTful conventions** (सातत्यपूर्ण URL structure आणि HTTP method semantics) स्वयंचलितपणे अनुसरण केले जातात.

Viewsets लवचिक राहतात — आपण पद्धती override करून त्यांना कस्टमाइज करता (प्रत्येक user साठी queryset फिल्टर करणे, permissions नियंत्रित करणे, create/update मध्ये hook करणे) आणि मानक CRUD च्या पलीकडे endpoints साठी **custom actions** (`@action`) जोडून.

Viewsets आणि routers समजून घेणे, ते कसे endpoints तयार करतात, त्यांना कसे कस्टमाइज करता येते, आणि **कधी त्यांचा उपयोग करता येतो** (परंपरागत REST संसाधन) विरुद्ध अधिक स्पष्ट generic views किंवा APIView (custom/non-standard endpoints) हे DRF विकाससाठी महत्वाचे व्यावहारिक ज्ञान आहे.

आज Django चा प्राथमिक उपयोग REST APIs तयार करणे आहे, आणि viewsets+routers हे परंपरागत संसाधनांसाठी idiomatic, सर्वात-उत्पादक मार्ग आहे, ते DRF toolkit चे वारंवार-वापरले जाणारे, महत्वाचे भाग आहेत जे developers ला किमान code सह मजबूत APIs तयार करण्यास परवानगी देतात तर custom आवश्यकता हाताळण्याचे लवचिकता राखतात.