Django REST Framework에서 serializer란 무엇인가요?

Question

Accepted Answer

**Django REST Framework(DRF)**는 Django로 REST API를 구축하는 사실상의 표준이며, **serializer**는 그 핵심 개념입니다. serializer는 복잡한 데이터(model 인스턴스, queryset)를 API 응답을 위한 JSON으로 **변환**하고, 들어오는 JSON을 검증된 Python 객체로 **다시 변환**합니다. form이 HTML에 대해 하는 것처럼 직렬화와 검증을 모두 처리합니다.

## ModelSerializer — 흔한 경우

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

class ArticleSerializer(serializers.ModelSerializer):
    class Meta:
        model = Article                              # model에서 구축(DRY)
        fields = ["id", "title", "body", "published", "created_at"]
        read_only_fields = ["id", "created_at"]
```

`ModelSerializer`는 model에서 필드를 자동 생성합니다(ModelForm처럼). model을 직렬화하고 검증하는 데 최소한의 코드만 필요합니다.

## 직렬화: 객체 → JSON

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

# queryset 직렬화(여러 객체)
serializer = ArticleSerializer(Article.objects.all(), many=True)
serializer.data        # dict의 리스트
```

## 역직렬화 + 검증: JSON → 검증된 객체

```python
serializer = ArticleSerializer(data=request.data)   # 들어오는 JSON
if serializer.is_valid():                            # 검증(form처럼)
    article = serializer.save()                       # model 생성/업데이트
else:
    return Response(serializer.errors, status=400)   # 검증 오류 상세
```

패턴은 form을 반영합니다: `is_valid()`는 필드 규칙과 model에 따라 들어오는 데이터를 검증하고, `save()`는 이를 영속화합니다. 잘못된 데이터는 구조화된 오류 메시지를 산출합니다.

## 커스텀 검증과 필드

```python
class ArticleSerializer(serializers.ModelSerializer):
    word_count = serializers.SerializerMethodField()   # 계산된 읽기 전용 필드

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

def validate_title(self, value):                    # 필드 수준 검증
        if "spam" in value.lower():
            raise serializers.ValidationError("No spam")
        return value
```

## 중첩 serializer(관련 데이터)

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

class ArticleSerializer(serializers.ModelSerializer):
    author = AuthorSerializer(read_only=True)          # 관련 author 데이터 임베드
    class Meta: model = Article; fields = ["title", "author"]
```

serializer는 관련 객체를 표현하기 위해 **중첩**될 수 있으며(article의 JSON 내에 author 데이터를 임베드), 데이터베이스와 독립적으로 API의 형태를 제어할 수 있습니다.

## 왜 중요한가

serializer는 Django REST Framework로 REST API를 구축하는 초석이며, DRF는 Django API의 표준 도구입니다. 따라서 serializer를 이해하는 것은 프론트엔드, 모바일 앱, 다른 서비스에 JSON을 제공하는 모든 현대 Django 백엔드에 필수적입니다.

serializer는 API의 두 가지 근본 요구를 해결합니다: Python/model 데이터를 응답을 위한 **JSON으로** 변환(직렬화)하고, 들어오는 **JSON을** 데이터를 생성/업데이트하기 위한 검증된 Python 객체로 변환(역직렬화 + 검증).

검증 측면은 **보안과 견고성**에 중요합니다. HTML의 form처럼, serializer는 원시 API 입력을 절대 신뢰하지 않도록 보장하여, 데이터베이스에 도달하기 전에 필드 규칙에 따라 검증합니다. **ModelSerializer**는 model에서 필드를 자동 생성하여(DRY, ModelForm처럼) model을 API 리소스로 노출하는 것을 사소하게 만드는 주요 생산성 이점을 제공하며, `is_valid()`/`save()` 패턴은 전체 생성/업데이트 수명주기를 깔끔하게 처리합니다.

객체와 queryset을 직렬화하는 방법, 입력을 역직렬화하고 검증하는 방법, 커스텀 검증과 계산된 필드를 추가하는 방법, 관련 데이터를 위한 **중첩 serializer**(데이터베이스 스키마와 독립적으로 API 형태 제어)를 사용하는 방법을 이해하는 것은 API 구축에 기초적입니다.

serializer는 DRF가 데이터 변환과 검증이라는 핵심 API 관심사를 다루는 곳으로, 중심적이고 반드시 알아야 할 지식입니다. 전통적 Django에서 form이 갖는 중요성에 비견되지만, 현대 웹 개발을 지배하는 API 기반 애플리케이션을 위한 것입니다.