Apakah serializer dalam Django REST Framework?

Question

Accepted Answer

**Django REST Framework (DRF)** ialah standard de facto untuk membina REST API dengan Django, dan **serializer** ialah konsep terasnya. Sebuah serializer menukar data kompleks (instance model, queryset) **kepada** JSON untuk respons API, dan menukar JSON masuk **kembali** kepada objek Python yang disahkan — mengendalikan kedua-dua serialisasi dan pengesahan, sama seperti borang untuk HTML.

## ModelSerializer — kes biasa

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

Satu `ModelSerializer` menjana medan secara automatik daripada model (seperti ModelForm) — kod minimum untuk menserialkan dan mengesahkan model.

## Menserialkan: objek → 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
```

## Menyahserialkan + pengesahan: JSON → objek yang disahkan

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

Corak ini mencerminkan borang: `is_valid()` mengesahkan data masuk terhadap peraturan medan dan model, dan `save()` mengekalkannya. Data tidak sah menghasilkan mesej ralat berstruktur.

## Pengesahan dan medan tersuai

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

## Serializer bersarang (data berkaitan)

```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 boleh **bersarang** untuk mewakili objek berkaitan (membenamkan data pengarang dalam JSON sesuatu artikel) — dan anda mengawal bentuk API secara bebas daripada pangkalan data.

## Mengapa ia penting

Serializer ialah batu asas untuk membina REST API dengan Django REST Framework, yang merupakan alat standard untuk API Django — jadi memahaminya adalah penting untuk mana-mana back-end Django moden yang menyajikan JSON kepada frontend, aplikasi mudah alih, atau perkhidmatan lain.

Serializer menyelesaikan dua keperluan asas sesuatu API: menukar data Python/model **kepada JSON** untuk respons (serialisasi) dan menukar **JSON masuk kepada objek Python yang disahkan** untuk mencipta/mengemas kini data (nyahserialisasi + pengesahan).

Aspek pengesahan adalah kritikal untuk **keselamatan dan keteguhan** — seperti borang untuk HTML, serializer memastikan anda tidak pernah mempercayai input API mentah, mengesahkannya terhadap peraturan medan sebelum ia sampai ke pangkalan data anda. **ModelSerializer** memberikan kelebihan produktiviti yang besar dengan menjana medan secara automatik daripada model (DRY, seperti ModelForm), menjadikannya remeh untuk mendedahkan model sebagai sumber API, manakala corak `is_valid()`/`save()` mengendalikan keseluruhan kitaran hayat cipta/kemas kini dengan kemas.

Memahami cara menserialkan objek dan queryset, menyahserialkan dan mengesahkan input, menambah pengesahan tersuai dan medan terkira, serta menggunakan **serializer bersarang** untuk data berkaitan (mengawal bentuk API secara bebas daripada skema pangkalan data) adalah asas untuk membina API.

Serializer ialah tempat DRF mengendalikan tanggungjawab API teras transformasi dan pengesahan data, menjadikannya pengetahuan utama yang mesti diketahui — setara dari segi kepentingan dengan borang untuk Django tradisional, tetapi untuk aplikasi dipacu API yang menguasai pembangunan web moden.