Serializer trong Django REST Framework là gì?

Question

Accepted Answer

**Django REST Framework (DRF)** là tiêu chuẩn de facto để xây dựng REST API với Django, và **serializer** là khái niệm cốt lõi của nó. Một serializer chuyển dữ liệu phức tạp (instance của model, queryset) **sang** JSON cho response API, và chuyển JSON đến **ngược lại** thành các đối tượng Python đã validate — xử lý cả serialization và validation, giống như form làm cho HTML.

## ModelSerializer — trường hợp phổ biến

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

class ArticleSerializer(serializers.ModelSerializer):
    class Meta:
        model = Article                              # dựng từ một model (DRY)
        fields = ["id", "title", "body", "published", "created_at"]
        read_only_fields = ["id", "created_at"]
```

Một `ModelSerializer` tự sinh các field từ model (như một ModelForm) — mã tối thiểu để serialize và validate một model.

## Serialize: đối tượng → JSON

```python
article = Article.objects.get(pk=1)
serializer = ArticleSerializer(article)
serializer.data        # {"id": 1, "title": "Hello", "body": "...", ...} → trả về dưới dạng JSON

# serialize một queryset (nhiều đối tượng)
serializer = ArticleSerializer(Article.objects.all(), many=True)
serializer.data        # một danh sách các dict
```

## Deserialize + validation: JSON → đối tượng đã validate

```python
serializer = ArticleSerializer(data=request.data)   # JSON đến
if serializer.is_valid():                            # VALIDATE (như một form)
    article = serializer.save()                       # tạo/cập nhật model
else:
    return Response(serializer.errors, status=400)   # chi tiết lỗi validation
```

Pattern phản chiếu form: `is_valid()` validate dữ liệu đến theo quy tắc field và model, và `save()` lưu nó. Dữ liệu không hợp lệ cho ra các thông báo lỗi có cấu trúc.

## Validation và field tùy biến

```python
class ArticleSerializer(serializers.ModelSerializer):
    word_count = serializers.SerializerMethodField()   # một field được tính, chỉ đọc

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

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

## Serializer lồng nhau (dữ liệu liên quan)

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

class ArticleSerializer(serializers.ModelSerializer):
    author = AuthorSerializer(read_only=True)          # nhúng dữ liệu author liên quan
    class Meta: model = Article; fields = ["title", "author"]
```

Serializer có thể **lồng nhau** để biểu diễn các đối tượng liên quan (nhúng dữ liệu của một author bên trong JSON của một article) — và bạn kiểm soát hình dạng của API độc lập với database.

## Tại sao điều này quan trọng

Serializer là nền tảng của việc xây dựng REST API với Django REST Framework, vốn là công cụ tiêu chuẩn cho API Django — nên hiểu chúng là thiết yếu cho bất kỳ back-end Django hiện đại nào phục vụ JSON cho frontend, app mobile, hoặc dịch vụ khác.

Serializer giải quyết hai nhu cầu cơ bản của một API: chuyển dữ liệu Python/model **sang JSON** cho response (serialization) và chuyển **JSON đến thành đối tượng Python đã validate** để tạo/cập nhật dữ liệu (deserialization + validation).

Khía cạnh validation là then chốt cho **bảo mật và độ vững chắc** — như form cho HTML, serializer đảm bảo bạn không bao giờ tin tưởng input API thô, validate nó theo quy tắc field trước khi nó tới database. **ModelSerializer** mang lại một lợi ích năng suất lớn bằng cách tự sinh field từ model (DRY, như ModelForm), khiến việc phơi bày model thành tài nguyên API trở nên dễ dàng, trong khi pattern `is_valid()`/`save()` xử lý toàn bộ vòng đời tạo/cập nhật một cách gọn gàng.

Hiểu cách serialize đối tượng và queryset, deserialize và validate input, thêm validation tùy biến và field được tính, và dùng **serializer lồng nhau** cho dữ liệu liên quan (kiểm soát hình dạng của API độc lập với schema database) là nền tảng để xây dựng API.

Serializer là nơi DRF xử lý các mối quan tâm cốt lõi của API là biến đổi dữ liệu và validation, khiến chúng trở thành kiến thức trung tâm, bắt buộc phải biết — tương đương về tầm quan trọng với form cho Django truyền thống, nhưng cho các ứng dụng hướng API thống trị phát triển web hiện đại.