Kaj so DRF viewseti in marsirutnikai?

Question

Accepted Answer

V Django REST Framework **viewseti** združijo logiko za nabor povezanih API končnih točk (CRUD operacije za vir) v en razred, **marsirutnikai** pa samodejno generirajo URL-usmerjanje zanje. Skupaj dramatično zmanjšata potrebo za nastavno kodo pri gradnji RESTful API-jev.

## ModelViewSet — polna CRUD v nekaj vrsticah

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

A `ModelViewSet` samodejno zagotovi **popoln nabor RESTful CRUD končnih točk** za model — seznam, ustvarjanje, pridobivanje, posodabljanje, delno posodabljanje in brisanje — zgolj s querysetom in serializerjem. Ni treba pisati vsak pogled posebej.

## Marsirutnikai — samodejno generiranje URL-ov

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

**Marsiruthik** samodejno mapira viewset na popoln nabor standardnih RESTful URL-ov — registracija enega viewseta ustvari vse konvencionalne končne točke s pravilnimi HTTP metodami, kar odpravlja ročno konfiguriranje URL-ov.

## Prilagajanje viewsetov

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

Viewseti se prilagodijo s prekrivanjem metod (`get_queryset`, `perform_create`), nastavitvijo dovoljenj in dodajanjem **prilagojenih dejanj** (`@action`) za končne točke onkraj standardne CRUD-a.

## Viewseti v primerjavi s splošnimi API pogledi

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

## Zakaj je to pomembno

Viewseti in marsirutnikai so zmogljiva DRF funkcionalnost za učinkovito gradnjo RESTful API-jev — predstavljajo najvišjo raven abstrakcije za izjemno pogost primer izpostavljanja modela kot polnega REST vira, njihovo razumevanje pa je dragoceno za produktivni razvoj API-jev.

Glavna prednost je dramatično **zmanjšanje nastavne kode**: `ModelViewSet` skupaj z marsiruthnikom zagotovi popoln, konvencionalen REST API za vir (vse CRUD končne točke s pravilnimi HTTP metodami in URL-i) zgolj s querysetom in serializerjem — kar nadomešča to, kar bi sicer bila mnoga ločena pogleda in ročnih vzorcev URL-ov.

To omogoča gradnjo standardnih REST API-jev izjemno hitro, hkrati pa zagotavlja, da se **RESTful konvencije** (skladna struktura URL-ov in semantika HTTP metod) upoštevajo samodejno.

Viewseti ostajajo fleksibilni — prilagodite jih s prekrivanjem metod (filtriranje querysetov na uporabnika, nadzor dovoljenj, priklapljanje na ustvarjanje/posodabljanje) in dodajanjem **prilagojenih dejanj** (`@action`) za končne točke onkraj osnovne CRUD-a.

Razumevanje viewsetov in marsirutnikov, kako generirajo končne točke, kako jih prilagoditi in **kdaj jih uporabiti** (konvencionalni REST viri) v primerjavi z bolj eksplicitnimi splošnimi pogledi ali APIView (prilagojene/nestandardne končne točke) je pomembno praktično znanje za razvoj DRF.

Ker je gradnja REST API-jev primarni namen Django-ja danes, in viewseti+marsirutnikai so idiomatičen, najbolj produktiven način za to pri standardnih virih, so pogosto uporabljeni, pomembni del DRF orodjarnika, ki razvojnim delavcem omogoča gradnjo robustnih API-jev z minimalnim kodom, hkrati pa ohranja fleksibilnost za ravnanje s prilagojenim zahtevami.