Τι είναι τα DRF viewsets και routers;

Question

Accepted Answer

Στο Django REST Framework, τα **viewsets** ομαδοποιούν τη λογική για ένα σύνολο σχετικών API endpoints (οι CRUD πράξεις για ένα resource) σε μια μοναδική κλάση, και οι **routers** δημιουργούν αυτόματα την URL δρομολόγηση για αυτά. Μαζί μειώνουν δραστικά το boilerplate για την κατασκευή RESTful APIs.

## 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** για ένα model — list, create, retrieve, update, partial update, και delete — μόνο από ένα queryset και serializer. Δεν χρειάζεται να γράψετε κάθε view χωριστά.

## Routers — αυτόματη δημιουργία URLs

```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 μεθόδους, εξαλείφοντας τη χειροκίνητη διαμόρφωση URLs.

## Προσαρμογή 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 προσαρμόζονται με την παράκαμψη μεθόδων (`get_queryset`, `perform_create`), τη ρύθμιση δικαιωμάτων, και την προσθήκη **custom actions** (`@action`) για endpoints πέρα από το τυπικό CRUD.

## 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 — αντιπροσωπεύουν το υψηλότερο επίπεδο αφαίρεσης για την εξαιρετικά συχνή περίπτωση της έκθεσης ενός model ως πλήρες REST resource, και η κατανόησή τους είναι πολύτιμη για παραγωγική ανάπτυξη API.

Το κύριο όφελος είναι η δραματική **μείωση boilerplate**: ένα `ModelViewSet` συν ένας router σας δίνει ένα πλήρες, συμβατικό REST API για ένα resource (όλα τα CRUD endpoints με σωστές HTTP μεθόδους και URLs) μόνο από ένα queryset και serializer — αντικαθιστώντας αυτό που διαφορετικά θα ήταν πολλές ξεχωριστές views και χειροκίνητα URL patterns.

Αυτό κάνει την κατασκευή τυπικών REST APIs εξαιρετικά γρήγορη, ενώ εξασφαλίζει ότι τα **RESTful συμβατικά** (συνεπής δομή URL και σημασιολογία HTTP μεθόδου) ακολουθούνται αυτόματα.

Τα viewsets παραμένουν ευέλικτα — τα προσαρμόζετε με την παράκαμψη μεθόδων (φιλτράρισμα του queryset ανά χρήστη, έλεγχος δικαιωμάτων, σύνδεση σε create/update) και προσθήκη **custom actions** (`@action`) για endpoints πέρα από το βασικό CRUD.

Η κατανόηση των viewsets και routers, πώς δημιουργούν endpoints, πώς να τα προσαρμόσετε, και **πότε να τα χρησιμοποιήσετε** (συμβατικά REST resources) έναντι πιο ρητών generic views ή APIView (custom/μη-τυπικά endpoints) είναι σημαντική πρακτική γνώση για ανάπτυξη DRF.

Επειδή η κατασκευή REST APIs είναι μια πρωτεύουσα χρήση του Django σήμερα, και viewsets+routers είναι ο ιδιωματικός, πιο παραγωγικός τρόπος να το κάνετε για τυπικά resources, είναι ένα συχνά χρησιμοποιούμενο, σημαντικό μέρος του DRF toolkit που επιτρέπει στους developers να κατασκευάσουν ισχυρά APIs με ελάχιστο κώδικα, διατηρώντας ταυτόχρονα την ευελιξία να αντιμετωπίσουν προσαρμοσμένες απαιτήσεις.