Django REST Frameworkのシリアライザーとは何ですか？

Question

Accepted Answer

**Django REST Framework (DRF)**は、Djangoを使用したREST APIを構築するための事実上の標準であり、**シリアライザー**はその中核的な概念です。シリアライザーは複雑なデータ（モデルインスタンス、クエリセット）をAPIレスポンス用のJSONに変換し、受け取ったJSONを検証されたPythonオブジェクトに変換し直します。これはシリアライゼーションと検証の両方を処理し、HTMLフォームが行うことと同様です。

## ModelSerializer — 一般的なケース

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

`ModelSerializer`はモデルからフィールドを自動生成します（ModelFormのように）— モデルをシリアライズして検証するための最小限のコードです。

## シリアライゼーション: オブジェクト → 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
```

## デシリアライゼーション + 検証: JSON → 検証済みオブジェクト

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

このパターンはフォームに似ています。`is_valid()`は受け取ったデータをフィールドルールとモデルに対して検証し、`save()`はそれを永続化します。無効なデータは構造化されたエラーメッセージを生成します。

## カスタム検証とフィールド

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

## ネストされたシリアライザー（関連データ）

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

シリアライザーは関連オブジェクトを表現するために**ネストできます**（著者データをアーティクルのJSON内に埋め込む）— APIの形状をデータベーススキーマとは独立して制御できます。

## なぜ重要なのか

シリアライザーはDjango REST Frameworkを使用したREST API構築の礎であり、Django APIの標準ツールです。そのため、これらを理解することはモダンなDjangoバックエンドを構築するために不可欠です。フロントエンド、モバイルアプリ、その他のサービスにJSONを提供する場合はなおさらです。

シリアライザーはAPIの2つの基本的なニーズを解決します。Python/モデルデータを**JSONに変換**してレスポンスとする（シリアライゼーション）こと、そして受け取ったJSONを**検証されたPythonオブジェクトに変換**してデータを作成/更新する（デシリアライゼーション + 検証）ことです。

検証の側面は**セキュリティとロバスト性**にとって非常に重要です。HTMLフォームと同様に、シリアライザーはAPIの生入力を決して信頼せず、フィールドルールに対して検証してからデータベースに到達させないようにします。**ModelSerializer**はモデルからフィールドを自動生成することで、DRY原則を適用し（ModelFormのように）、モデルをAPIリソースとして公開することは自明になり、`is_valid()`/`save()`パターンは作成/更新の全ライフサイクルをクリーンに処理します。

オブジェクトとクエリセットをシリアライズする方法、入力をデシリアライズして検証する方法、カスタム検証と計算フィールドを追加する方法、関連データのための**ネストされたシリアライザー**を使用する方法（データベーススキーマと独立してAPIの形状を制御する）を理解することはAPIを構築するための基本です。

シリアライザーはDRFがデータ変換と検証というコアなAPI関連事項を処理する場所であり、中心的で必須の知識です。これはトラディショナルなDjangoではフォームと同等の重要性を持っていますが、モダンなウェブ開発を支配するAPIドリブンアプリケーション向けのものです。