DRF viewsets এবং routers কী?

Question

Accepted Answer

Django REST Framework-এ, **viewsets** একটি সম্পর্কিত API endpoints-এর সেটের লজিক (একটি রিসোর্সের জন্য CRUD অপারেশন) একটি একক ক্লাসে গ্রুপ করে, এবং **routers** স্বয়ংক্রিয়ভাবে তাদের জন্য URL রাউটিং তৈরি করে। একসাথে তারা 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 পদ্ধতি override করে কাস্টমাইজ করা হয় (`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 হল RESTful APIs দক্ষতার সাথে তৈরির জন্য একটি শক্তিশালী DRF বৈশিষ্ট্য — তারা অত্যন্ত সাধারণ ক্ষেত্রে একটি মডেলকে সম্পূর্ণ REST রিসোর্স হিসাবে উন্মোচন করার জন্য abstraction-এর সর্বোচ্চ স্তরের প্রতিনিধিত্ব করে, এবং তাদের বোঝা উৎপাদনশীল API ডেভেলপমেন্টের জন্য মূল্যবান।

মূল সুবিধা হল নাটকীয় **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 নমনীয় থাকে — আপনি পদ্ধতি override করে কাস্টমাইজ করেন (প্রতি ব্যবহারকারীর queryset ফিল্টার করা, permissions নিয়ন্ত্রণ করা, create/update-এ হুক করা) এবং **custom actions** যোগ করেন (`@action`) মৌলিক CRUD-এর বাইরে endpoints-এর জন্য।

Viewsets এবং routers বোঝা, কীভাবে তারা endpoints তৈরি করে, কীভাবে সেগুলি কাস্টমাইজ করতে হয়, এবং **কখন সেগুলি ব্যবহার করতে হবে** (প্রথাগত REST রিসোর্স) বনাম আরও স্পষ্ট generic views বা APIView (কাস্টম/অ-মানক endpoints) DRF ডেভেলপমেন্টের জন্য গুরুত্বপূর্ণ প্রায়োগিক জ্ঞান।

যেহেতু REST APIs তৈরি করা আজ Django-এর প্রাথমিক ব্যবহার, এবং viewsets+routers হল idiomatic, সবচেয়ে-উৎপাদনশীল উপায় মানক রিসোর্সের জন্য, তারা DRF toolkit-এর একটি ঘন ঘন-ব্যবহৃত, গুরুত্বপূর্ণ অংশ যা ডেভেলপারদের ন্যূনতম কোডের সাথে শক্তিশালী APIs তৈরি করতে দেয় যখন কাস্টম প্রয়োজনীয়তা পরিচালনা করার নমনীয়তা ধরে রাখে।