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 ਦੀ ਰਜਿਸਟ੍ਰੇਸ਼ਨ ਸਹੀ HTTP methods ਦੇ ਨਾਲ ਸਾਰੇ ਰਵਾਇਤੀ endpoints ਜਨਰੇਟ ਕਰਦੀ ਹੈ, ਦਸਤੀ URL configuration ਨੂੰ ਖਤਮ ਕਰਦੀ ਹੈ।

## 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 ਕਰਕੇ, permissions ਨੂੰ ਸੈੱਟ ਕਰਕੇ, ਅਤੇ ਮਾਨਕ CRUD ਤੋਂ ਪਰੇ endpoints ਲਈ **ਕਸਟਮ 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 ਦੇ ਨਾਲ ਆਪਣੇ ਆਪ ਨੂੰ ਸਿਰਫ਼ queryset ਅਤੇ serializer ਤੋਂ ਇੱਕ ਸਰੋਤ (ਸਹੀ HTTP methods ਅਤੇ URLs ਨਾਲ ਸਾਰੇ CRUD endpoints) ਲਈ ਇੱਕ ਮਕਮਲ, ਰਵਾਇਤੀ REST API ਦਿੰਦਾ ਹੈ — ਇਸ ਨੂੰ ਬਹੁਤ ਸਾਰੇ ਵੱਖਰੇ views ਅਤੇ ਦਸਤੀ URL patterns ਨੂੰ ਬਦਲਦੇ ਹੋ।

ਇਹ ਮਾਨਕ REST APIs ਬਣਾਉਣ ਨੂੰ ਬਹੁਤ ਤੇਜ਼ ਬਣਾਉਂਦਾ ਹੈ ਜਦੋਂ **RESTful conventions** (ਇਕਸਾਰ URL structure ਅਤੇ HTTP method semantics) ਆਪਣੇ ਆਪ ਹੀ ਪਾਲਿਆ ਜਾਂਦਾ ਹੈ।

Viewsets ਲਚਕਦਾਰ ਰਹਿੰਦੇ ਹਨ — ਤੁਸੀਂ ਉਨ੍ਹਾਂ ਨੂੰ methods (ਪ্রতिਭਾਗੀ ਪ੍ਰਤਿ queryset ਨੂੰ filter ਕਰਨਾ, permissions ਨੂੰ ਨਿਯੰਤ੍ਰਣ ਕਰਨਾ, create/update ਵਿੱਚ hooking) ਨੂੰ override ਕਰਕੇ ਅਤੇ ਮਾਨਕ CRUD ਤੋਂ ਪਰੇ endpoints ਲਈ **ਕਸਟਮ actions** (`@action`) ਸ਼ਾਮਿਲ ਕਰਕੇ ਕਸਟਮਾਈਜ਼ ਕਰਦੇ ਹੋ।

Viewsets ਅਤੇ routers ਨੂੰ ਸਮਝਣਾ, ਕਿਵੇਂ ਉਹ endpoints ਜਨਰੇਟ ਕਰਦੇ ਹਨ, ਕਿਵੇਂ ਉਹਨਾਂ ਨੂੰ ਕਸਟਮਾਈਜ਼ ਕਰਨਾ ਹੈ, ਅਤੇ **ਕਦੋਂ ਉਹਨਾਂ ਨੂੰ ਵਰਤਣਾ ਹੈ** (ਰਵਾਇਤੀ REST ਸਰੋਤ) ਬਨਾਮ ਵਧੇਰੇ explicit generic views ਜਾਂ APIView (ਕਸਟਮ/ਗੈਰ-ਮਾਨਕ endpoints) DRF ਵਿਕਾਸ ਲਈ ਮਹੱਤਵਪੂਰਨ ਵਿਹਾਰਕ ਗਿਆਨ ਹੈ।

ਕਿਉਂਕਿ REST APIs ਬਣਾਉਣਾ ਅੱਜ Django ਦੀ ਇੱਕ ਪ੍ਰਾਇਮਰੀ ਵਰਤੋਂ ਹੈ, ਅਤੇ viewsets+routers ਮਾਨਕ ਸਰੋਤਾਂ ਲਈ idiomatic, ਸਭ ਤੋਂ-ਉਤਪਾਦਕ ਤਰੀਕਾ ਹਨ, ਉਹ DRF toolkit ਦਾ ਇੱਕ ਵਾਰ-ਵਾਰ-ਵਰਤੀਆ ਜਾਣ ਵਾਲਾ, ਮਹੱਤਵਪੂਰਨ ਹਿੱਸਾ ਹਨ ਜੋ ਡਿਵੈਲਪਰਾਂ ਨੂੰ ਘੱਟ ਕੋਡ ਦੇ ਨਾਲ robust APIs ਬਣਾਉਣ ਦਿੰਦਾ ਹੈ ਜਦੋਂ ਕਸਟਮ ਲੋੜਾਂ ਨੂੰ ਸੰਭਾਲਣ ਲਈ ਲਚਕ ਨੂੰ ਬਰਕਰਾਰ ਰੱਖਦਾ ਹੈ।