DRF viewset'leri ve router'ları nedir?

Question

Accepted Answer

Django REST Framework'te, **viewset'ler** bir dizi ilişkili API uç noktasının (bir kaynağın CRUD işlemleri) mantığını tek bir sınıfta gruplandırır ve **router'lar** bunlar için URL yönlendirmesini otomatik olarak oluşturur. Birlikte kullanıldıklarında RESTful API'ler oluşturmak için standart kodu önemli ölçüde azaltırlar.

## ModelViewSet — birkaç satırda tam 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)
```

Bir `ModelViewSet`, bir model için **tam RESTful CRUD uç noktaları kümesini** — liste, oluştur, al, güncelle, kısmi güncelle ve sil — sadece bir queryset ve serializer'dan otomatik olarak sağlar. Her view'ı ayrı ayrı yazmanıza gerek yoktur.

## Router'lar — otomatik URL oluşturma

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

Bir **router**, bir viewset'i otomatik olarak standart RESTful URL'lerin tam kümesine eşler — bir viewset kaydedilmesi doğru HTTP metotlarıyla tüm alışılagelen uç noktaları oluşturur ve manuel URL yapılandırmasını ortadan kaldırır.

## Viewset'leri özelleştirme

```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'ler metotları geçersiz kılarak (`get_queryset`, `perform_create`), izinler ayarlayarak ve standart CRUD'ın ötesindeki uç noktalar için **özel işlemler** (`@action`) ekleyerek özelleştirilir.

## Viewset'ler vs genel API view'ları

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

## Neden önemli

Viewset'ler ve router'lar, RESTful API'leri verimli bir şekilde oluşturmak için DRF'nin güçlü bir özelliğidir — bir modeli tam bir REST kaynağı olarak ortaya koymak için inanılmaz derecede yaygın olan durumlar için en yüksek soyutlama seviyesini temsil ederler ve bunları anlamak üretken API geliştirme için değerlidir.

Asıl avantaj, dramatik **standart kod azaltmasıdır**: bir `ModelViewSet` ve bir router, sadece bir queryset ve serializer'dan bir kaynak için tam, alışılagelen bir REST API'si (doğru HTTP metotları ve URL'leriyle tüm CRUD uç noktaları) sağlar — aksi takdirde birçok ayrı view ve manuel URL deseni gerektiren şeyin yerini alır.

Bu, standart REST API'leri oluşturmayı kayda değer şekilde hızlı hale getirirken **RESTful konvansiyonlarının** (tutarlı URL yapısı ve HTTP metot semantiği) otomatik olarak takip edilmesini sağlar.

Viewset'ler esnek kalır — metotları geçersiz kılarak (queryset'i kullanıcı başına filtreleme, izinleri kontrol etme, oluşturma/güncellemeye bağlama) ve temel CRUD'ın ötesindeki uç noktalar için **özel işlemler** (`@action`) ekleyerek bunları özelleştirirsiniz.

Viewset'leri ve router'ları, uç noktaları nasıl oluşturdukları, bunları nasıl özelleştireceği ve **ne zaman kullanılacağı** (alışılagelen REST kaynakları) vs daha açık genel view'lar veya APIView (özel/standart olmayan uç noktalar) hakkında anlamak, DRF geliştirmesi için önemli pratik bilgidir.

Bugün Django'nun birincil kullanımı REST API'leri oluşturmak olduğu ve viewset'ler + router'lar standart kaynaklar için idiyomatik, en üretken yol olduğu için, bunlar geliştiricilerin minimal kod ile sağlam API'ler oluşturmalarını sağlarken özel gereksinimleri işleme esnekliğini koruyan DRF araç setinin sık kullanılan, önemli bir parçasıdır.