ما هي المسلسلات (Serializers) في Django REST Framework؟

Question

Accepted Answer

**Django REST Framework (DRF)** هو المعيار الفعلي لبناء REST APIs مع Django، و**المسلسلات (Serializers)** هي مفهومه الأساسي. يقوم المسلسل بتحويل البيانات المعقدة (نسخ النموذج، querysets) **إلى** JSON لاستجابات API، وتحويل JSON الوارد **مرة أخرى** إلى كائنات Python موثوقة — يتعامل مع كل من التسلسل والتحقق، تماماً كما تفعل النماذج (Forms) بالنسبة للـ 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) — الحد الأدنى من الكود لتسلسل وتحقق النموذج.

## التسلسل: object → 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 APIs مع Django REST Framework، وهي الأداة القياسية لـ Django APIs — لذا فهم هذه المفاهيم ضروري لأي مطور Django حديث في الخلفية يقدم JSON للواجهات الأمامية أو تطبيقات الجوال أو الخدمات الأخرى.

تحل المسلسلات الاحتياجات الأساسية لـ API: تحويل بيانات Python/النموذج **إلى JSON** للاستجابات (التسلسل) وتحويل **JSON الوارد إلى كائنات Python موثوقة** لإنشاء/تحديث البيانات (فك التسلسل + التحقق).

job جانب التحقق حرج لـ **الأمان والمتانة** — مثل النماذج بالنسبة للـ HTML، المسلسلات تضمن عدم الثقة أبداً بالـ raw API input، التحقق منه مقابل قواعد الحقول قبل وصوله إلى قاعدة البيانات. يوفر **ModelSerializer** فائدة إنتاجية كبيرة بإنشاء الحقول تلقائياً من النماذج (DRY، مثل ModelForm)، مما يجعل من السهل جداً عرض النماذج كموارد API، بينما نمط `is_valid()`/`save()` يتعامل مع دورة الحياة الكاملة للإنشاء/التحديث بنظافة.

فهم كيفية تسلسل الكائنات و querysets، وفك التسلسل والتحقق من المدخلات، وإضافة التحقق المخصص والحقول المحسوبة، واستخدام **المسلسلات المتداخلة** للبيانات ذات الصلة (التحكم في شكل API بشكل مستقل عن مخطط قاعدة البيانات) أساسي لبناء APIs.

المسلسلات هي حيث يتعامل DRF مع مخاوف API الأساسية لتحويل البيانات والتحقق، مما يجعلها معرفة مركزية يجب معرفتها — مشابهة في الأهمية للنماذج بالنسبة للـ Django التقليدي، لكن بالنسبة لتطبيقات API-driven التي تهيمن على تطوير الويب الحديث.