DRF viewsets اور routers کیا ہیں؟

Question

Accepted Answer

Django REST Framework میں، **viewsets** متعلقہ API endpoints کے ایک سیٹ (کسی وسیلے کے 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 generation

```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 کے ساتھ تیار کرتا ہے، دستی URL ترتیب کو ختم کرتا ہے۔

## Viewsets کو customize کرنا

```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 کو override کر کے customize کیا جاتا ہے (`get_queryset`، `perform_create`)، permissions مقرر کر کے، اور **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 DRF کی ایک طاقتور خصوصیت ہیں RESTful APIs کو موثر طریقے سے بنانے کے لیے — وہ انتہائی عام معاملے کے لیے abstraction کی سب سے اعلیٰ سطح کی نمائندگی کرتے ہیں کہ کسی ماڈل کو مکمل REST وسیلے کے طور پر سامنے لایا جائے، اور انہیں سمجھنا productivity API development کے لیے قیمتی ہے۔

اہم فائدہ ڈرامائی **boilerplate میں کمی** ہے: ایک `ModelViewSet` اور ایک router آپ کو کسی وسیلے کے لیے ایک مکمل، روایتی REST API دیتا ہے (تمام CRUD endpoints صحیح HTTP methods اور URLs کے ساتھ) محض ایک queryset اور serializer سے — جو بصورت دیگر بہت سے الگ views اور دستی URL patterns کو بدل دیتا ہے۔

یہ معیاری REST APIs بنانے کو قابلِ ذکر حد تک تیز بناتا ہے جبکہ **RESTful conventions** (مستحکم URL structure اور HTTP method semantics) خودکار طور پر پیروی کی جاتی ہے۔

Viewsets لچکدار رہتے ہیں — آپ انہیں methods کو override کر کے customize کرتے ہیں (queryset کو user کے مطابق filter کرنا، permissions کو کنٹرول کرنا، create/update میں ہک کرنا) اور **custom actions** (`@action`) شامل کرتے ہیں بنیادی CRUD سے آگے کے endpoints کے لیے۔

Viewsets اور routers کو سمجھنا، کہ وہ endpoints کو کیسے تیار کرتے ہیں، انہیں کیسے customize کریں، اور **کب استعمال کریں** (روایتی REST وسائل) بمقابلہ زیادہ واضح generic views یا APIView (custom/non-standard endpoints) DRF development کے لیے اہم عملی علم ہے۔

چونکہ REST APIs بنانا آج Django کا بنیادی استعمال ہے، اور viewsets+routers معیاری وسائل کے لیے idiomatic، سب سے زیادہ productive طریقہ ہیں، وہ DRF ٹول کٹ کا ایک بار بار استعمال ہونے والا، اہم حصہ ہیں جو developers کو minimal code کے ساتھ robust APIs بنانے دیتا ہے جبکہ custom requirements کو سنبھالنے کی لچک برقرار رہتی ہے۔