Ce sunt viewset-urile și routerele în Django REST Framework?

Question

Accepted Answer

În Django REST Framework, **viewset-urile** grupează logica pentru un set de puncte de terminare API conexe (operațiile CRUD pentru o resursă) într-o singură clasă, iar **routerele** generează automat rutarea URL pentru acestea. Împreună, ele reduc dramatic codul repetitiv pentru construirea API-urilor RESTful.

## ModelViewSet — CRUD complet în câteva linii

```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)
```

Un `ModelViewSet` furnizează automat **setul complet de puncte de terminare CRUD RESTful** pentru un model — listare, creare, preluare, actualizare, actualizare parțială și ștergere — doar din queryset și serializer. Nu este nevoie să scrieți fiecare view separat.

## Routerele — generarea automată a URL-urilor

```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
```

Un **router** mapează un viewset la un set complet de URL-uri RESTful standard automat — înregistrarea unui viewset generează toate punctele de terminare convenționale cu metodele HTTP corecte, eliminând configurația manuală a URL-urilor.

## Personalizarea viewset-urilor

```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"})
```

Viewset-urile sunt personalizate prin suprascrierea metodelor (`get_queryset`, `perform_create`), setarea permisiunilor și adăugarea **acțiunilor personalizate** (`@action`) pentru punctele de terminale dincolo de CRUD standard.

## Viewset-uri versus vizualizări API generice

```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.
```

## De ce conteaza

Viewset-urile și routerele sunt o caracteristică puternică a DRF pentru construirea eficientă a API-urilor RESTful — acestea reprezintă cel mai înalt nivel de abstracție pentru cazul extrem de frecvent al expunerii unui model ca o resursă REST completă, iar înțelegerea lor este valoroasă pentru dezvoltarea productivă a API-urilor.

Beneficiul principal este reducerea dramatică a **codului repetitiv**: un `ModelViewSet` plus un router vă oferă un API REST complet și convențional pentru o resursă (toate punctele de terminale CRUD cu metodele HTTP corecte și URL-urile) doar din queryset și serializer — înlocuind ceea ce ar fi altfel multe vizualizări separate și modele URL manuale.

Aceasta face ca construirea API-urilor REST standard să fie remarcabil de rapidă, în timp ce se asigură că **convențiile RESTful** (structura URL consistentă și semantica metodelor HTTP) sunt urmărite automat.

Viewset-urile rămân flexibile — le personalizați prin suprascrierea metodelor (filtrarea querysetului per utilizator, controlul permisiunilor, agățare în create/update) și adăugarea de **acțiuni personalizate** (`@action`) pentru punctele de terminale dincolo de CRUD de bază.

Înțelegerea viewset-urilor și routerelor, modul în care generează punctele de terminale, modul în care le personalizați și **când să le utilizați** (resurse REST convenționale) versus vizualizări mai explicite generice sau APIView (puncte de terminale personalizate/non-standard) este cunoștințe practice importante pentru dezvoltarea DRF.

Deoarece construirea API-urilor REST este o utilizare primară a Django astazi, iar viewset-uri+routere sunt modul idiomativ și cel mai productiv de a o face pentru resurse standard, acestea sunt o parte frecvent utilizată și importantă a toolkit-ului DRF care permite dezvoltatorilor să construiască API-uri robuste cu cod minim, păstrând în același timp flexibilitatea de a gestiona cerințe personalizate.