Co jsou DRF viewsety a routery?

Question

Accepted Answer

V Django REST Framework **viewsety** seskupují logiku pro sadu souvisejících API endpointů (CRUD operace pro prostředek) do jedné třídy a **routery** automaticky generují URL routing pro ně. Dohromady dramaticky snižují boilerplate při vytváření RESTful API.

## ModelViewSet — kompletní CRUD v několika řádcích

```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` automaticky poskytuje **kompletní sadu RESTful CRUD endpointů** pro model — list, create, retrieve, update, partial update a delete — jen z querysetu a serializeru. Není potřeba psát každý view zvlášť.

## Routery — automatické generování 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** mapuje viewset na úplnou sadu standardních RESTful URL automaticky — registrace jednoho viewsetu generuje všechny konvenční endpointy se správnými HTTP metodami, což eliminuje ruční konfiguraci URL.

## Přizpůsobení viewsetů

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

Viewsety se přizpůsobují přepsáním metod (`get_queryset`, `perform_create`), nastavením oprávnění a přidáním **vlastních akcí** (`@action`) pro endpointy mimo standardní CRUD.

## Viewsety vs generické 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.
```

## Proč na tom záleží

Viewsety a routery jsou výkonná DRF funkce pro efektivní vytváření RESTful API — představují nejvyšší úroveň abstrakce pro velmi běžný případ vystavení modelu jako úplného REST prostředku, a jejich porozumění je cenné pro produktivní vývoj API.

Hlavní výhodou je dramatické **snížení boilerplate kódu**: `ModelViewSet` plus router vám dají kompletní, konvenční REST API pro prostředek (všechny CRUD endpointy se správnými HTTP metodami a URL) jen z querysetu a serializeru — což nahrazuje to, co by jinak byly mnohé samostatné views a ruční URL patterns.

Tím se vytváření standardních REST API stává pozoruhodně rychlé, zatímco **RESTful konvence** (konzistentní struktura URL a sémantika HTTP metod) jsou dodržovány automaticky.

Viewsety zůstávají flexibilní — přizpůsobíte je přepsáním metod (filtrování querysetu podle uživatele, řízení oprávnění, spojení do create/update) a přidáním **vlastních akcí** (`@action`) pro endpointy mimo základní CRUD.

Porozumění viewsetům a routerům, jak generují endpointy, jak je přizpůsobit a **kdy je používat** (konvenční REST prostředky) versus explicitnější generické views nebo APIView (vlastní/nestandardní endpointy) je důležité praktické znalosti pro vývoj s DRF.

Keďže vytváření REST API je primární použití Django v dnešní době a viewsety+routery jsou idiomatický, nejproduktivnější způsob, jak to udělat pro standardní prostředky, jsou důležitou, často používanou součástí DRF toolkitu, která vývojářům umožňuje vytvářet robustní API s minimálním kódem, přičemž si zachovávají flexibilitu pro zpracování vlastních požadavků.