Что такое сериализаторы в Django REST Framework?

Question

Accepted Answer

**Django REST Framework (DRF)** — это де-факто стандарт для создания REST API с Django, а **сериализаторы** — его ключевая концепция. Сериализатор конвертирует сложные данные (экземпляры моделей, querysets) **в** JSON для ответов API и конвертирует входящий 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 независимо от базы данных.

## Почему это важно

Сериализаторы — это краеугольный камень построения REST API с Django REST Framework, который является стандартным инструментом для Django API — поэтому понимание их критически важно для любого современного Django бэкенда, отдающего JSON фронтендам, мобильным приложениям или другим сервисам.

Сериализаторы решают две фундаментальные потребности API: конвертирование Python/данных модели **в JSON** для ответов (сериализация) и конвертирование входящего **JSON в валидированные Python объекты** для создания/обновления данных (десериализация + валидация).

Аспект валидации критичен для **безопасности и надёжности** — как формы для HTML, сериализаторы гарантируют, что вы никогда не доверяете сырому API входу, валидируя его по правилам полей перед тем, как он попадёт в вашу базу данных. **ModelSerializer** предоставляет значительный прирост производительности, автоматически генерируя поля из моделей (DRY, как ModelForm), делая тривиальным экспонирование моделей как API ресурсов, в то время как паттерн `is_valid()`/`save()` чисто обрабатывает полный цикл создания/обновления.

Понимание того, как сериализовать объекты и querysets, десериализовать и валидировать входные данные, добавлять пользовательскую валидацию и вычисляемые поля, и использовать **вложенные сериализаторы** для связанных данных (контролируя форму API независимо от схемы базы данных) — основополагающий навык для построения API.

Сериализаторы — это место, где DRF обрабатывает основные API проблемы преобразования и валидации данных, делая их центральным, необходимым знанием — по важности аналогично формам для традиционного Django, но для приложений, управляемых API, которые доминируют в современной веб-разработке.