Django REST Framework'te serializer'lar nedir?

Question

Accepted Answer

**Django REST Framework (DRF)**, Django ile REST API'ları geliştirmenin standart seçimidir ve **serializer'lar** onun temel kavramıdır. Bir serializer, karmaşık verileri (model instance'ları, querysetler) API yanıtları için **JSON'a dönüştürür** ve gelen JSON'u **geriye doğrultarak** doğrulanmış Python nesnelerine dönüştürür — hem serialization hem de doğrulamayı gerçekleştirerek, tıpkı form'ların HTML için yaptığı gibi.

## ModelSerializer — yaygın durum

```python
from rest_framework import serializers
from .models import Article

class ArticleSerializer(serializers.ModelSerializer):
    class Meta:
        model = Article                              # build from a model (DRY)
        fields = ["id", "title", "body", "published", "created_at"]
        read_only_fields = ["id", "created_at"]
```

Bir `ModelSerializer`, modelden otomatik olarak alanlar oluşturur (bir ModelForm gibi) — bir modeli serialize etmek ve doğrulamak için minimal kod.

## Serialization: nesne → JSON

```python
article = Article.objects.get(pk=1)
serializer = ArticleSerializer(article)
serializer.data        # {"id": 1, "title": "Hello", "body": "...", ...} → return as JSON

# serialize a queryset (many objects)
serializer = ArticleSerializer(Article.objects.all(), many=True)
serializer.data        # a list of dicts
```

## Deserialization + doğrulama: JSON → doğrulanmış nesne

```python
serializer = ArticleSerializer(data=request.data)   # incoming JSON
if serializer.is_valid():                            # VALIDATE (like a form)
    article = serializer.save()                       # create/update the model
else:
    return Response(serializer.errors, status=400)   # validation error details
```

Desen form'lara benzerdir: `is_valid()` gelen verileri alan kurallarına ve modele karşı doğrular, ve `save()` bunu persiste eder. Geçersiz veriler yapılandırılmış hata mesajlarını döndürür.

## Özel doğrulama ve alanlar

```python
class ArticleSerializer(serializers.ModelSerializer):
    word_count = serializers.SerializerMethodField()   # a computed, read-only field

def get_word_count(self, obj):
        return len(obj.body.split())

def validate_title(self, value):                    # field-level validation
        if "spam" in value.lower():
            raise serializers.ValidationError("No spam")
        return value
```

## İç içe serializer'lar (ilişkili veriler)

```python
class AuthorSerializer(serializers.ModelSerializer):
    class Meta: model = Author; fields = ["name"]

class ArticleSerializer(serializers.ModelSerializer):
    author = AuthorSerializer(read_only=True)          # embed related author data
    class Meta: model = Article; fields = ["title", "author"]
```

Serializer'lar, ilişkili nesneleri temsil etmek için **iç içe** olabilir (bir yazarın verilerini bir makalenin JSON'una katıştırma) — ve API'nin şeklini veritabanından bağımsız olarak kontrol edersiniz.

## Neden önemli

Serializer'lar, Django REST Framework ile REST API'ları geliştirmenin temel taşıdır; bu, Django API'ları için standart araçtır — bu nedenle onları anlamak, JSON'u frontendlere, mobil uygulamalara veya diğer hizmetlere sunan herhangi bir modern Django back-end için gereklidir.

Serializer'lar, bir API'nin iki temel ihtiyacını çözer: Python/model verilerini yanıtlar için **JSON'a dönüştürmek** (serialization) ve gelen **JSON'u oluşturma/güncelleme için doğrulanmış Python nesnelerine dönüştürmek** (deserialization + doğrulama).

Doğrulama yönü **güvenlik ve sağlamlık** açısından çok önemlidir — HTML form'ları gibi, serializer'lar ham API girdisine hiçbir zaman güvenmemenizi sağlar, veritabanına ulaşmadan önce alan kurallarına karşı doğrularlar. **ModelSerializer**, modelden alanları otomatik olarak oluşturarak (DRY, ModelForm gibi) üretkenlikte büyük bir kazanım sağlar; bu, model'leri API kaynakları olarak ortaya çıkarmayı önemsiz kılar, `is_valid()`/`save()` deseni ise tam create/update yaşam döngüsünü temiz bir şekilde yönetir.

Nesneleri ve querysetleri serialize etmeyi, gelen verileri deserialize etmeyi ve doğrulamayı, özel doğrulama ve hesaplanmış alanlar eklemeyi ve ilişkili veriler için **iç içe serializer'lar** kullanmayı (API'nin şeklini veritabanı şemasından bağımsız olarak kontrol ederek) anlamak, API'ları geliştirmek için temeldir.

Serializer'lar, DRF'nin veri dönüşümü ve doğrulamaya ilişkin temel API endişelerini yönettiği yerdir; bu, onları merkezi, mutlaka bilinmesi gereken bilgi yapar — geleneksel Django için form'ların önem düzeyine benzer, ancak modern web geliştirmesine hâkim olan API odaklı uygulamalar için.