Çfarë janë viewsets dhe routers në DRF?

Question

Accepted Answer

Në Django REST Framework, **viewsets** grupojnë logjikën për një seri pikash përfundimi të lidhura të API-t (operacionet CRUD për një burim) në një klasë të vetme, dhe **routers** gjenerojnë automatikisht rrugën e URL-it për ato. Së bashku ato zvogëlojnë ndjeshëm kodin standart për ndërtimin e API-ve RESTful.

## ModelViewSet — CRUD i plotë në disa rreshta

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

Një `ModelViewSet` siguron automatikisht **grupin e plotë të pikave përfundimi CRUD RESTful** për një model — list, create, retrieve, update, partial update, dhe delete — vetëm nga një queryset dhe serializer. Nuk ka nevojë të shkruani secilin view veç e veç.

## Routers — gjenerimi automatik i URL-eve

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

Një **router** harton një viewset në një seri të plotë të URL-eve standarde RESTful automatikisht — regjistrimi i një viewset gjenerojnë të gjitha pikat përfundimi konvencionale me metodat HTTP të duhura, duke eliminuar konfigurimin manual të URL-eve.

## Përshtatja e 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 përshtaten duke zëvendësuar metodat (`get_queryset`, `perform_create`), duke vendosur lejet, dhe duke shtuar **veprime të personalizuara** (`@action`) për pikat përfundimi përtej CRUD standard.

## Viewsets kundrejt 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.
```

## Pse ka rëndësi

Viewsets dhe routers janë një veçori e fuqishme e DRF për ndërtimin e API-ve RESTful në mënyrë efikase — ato përfaqësojnë nivelin më të lartë të abstraktimit për rastin jashtëzakonisht të zakonshëm të ekspozimit të një modeli si një burim i plotë REST, dhe kuptimi i tyre është i vlefshëm për zhvillimin produktiv të API-ve.

Benefiti kryesor është zvogëlimi dramatik i **kodit standart**: një `ModelViewSet` plus një router ju jep një API REST të plotë, konvencionale për një burim (të gjitha pikat përfundimi CRUD me metodat HTTP dhe URL-et e duhura) vetëm nga një queryset dhe serializer — zëvendësimi i asaj që përndryshe do të ishte shumë views të veçanta dhe modele URL manual.

Kjo e bën ndërtimin e API-ve standarde REST të shpejtë në mënyrë të jashtëzakonshme ndërsa siguron që **konvencionet RESTful** (struktura konsistente e URL-it dhe semantika e metodës HTTP) ndiqen automatikisht.

Viewsets mbeten fleksibël — ju i përshtatni ato duke zëvendësuar metodat (filtrimi i queryset sipas përdoruesit, kontrollimi i lejeve, goditja në create/update) dhe shtimi i **veprimeve të personalizuara** (`@action`) për pikat përfundimi përtej CRUD bazik.

Kuptimi i viewsets dhe routers, si ato gjenerojnë pikat përfundimi, si t'i përshtatni ato, dhe **kur t'i përdorni ato** (burimet CRUD konvencionale) kundrejt views më eksplicite ose APIView (pikat përfundimi të personalizuara/jo-standarde) është njohuri praktike e rëndësishme për zhvillimin e DRF.

Meqenëse ndërtimi i API-ve REST është një përdorim parësor i Django sot, dhe viewsets+routers janë mënyra idiomatike, më produktive për ta bërë atë për burime standarde, ato janë një pjesë e shpeshtë përdorur, e rëndësishme e grupit të veglave DRF që i lejon zhvilluesve të ndërtojnë API robuste me kod minimal ndërsa ruajnë fleksibilitetin për të trajtuar kërkesat e personalizuara.