Django REST Framework میں serializers کیا ہیں؟

Question

Accepted Answer

**Django REST Framework (DRF)** Django کے ساتھ REST APIs بنانے کا معیاری ذریعہ ہے، اور **serializers** اس کا بنیادی تصور ہیں۔ ایک serializer پیچیدہ ڈیٹا (model instances، querysets) کو API جوابات کے لیے JSON میں تبدیل کرتا ہے، اور آنے والے JSON کو validated Python objects میں واپس تبدیل کرتا ہے — serialization اور validation دونوں کو سنبھالتا ہے، بالکل جیسے 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` خودکار طور پر model سے fields بناتا ہے (ModelForm کی طرح) — ایک model کو serialize اور validate کرنے کے لیے کم سے کم کوڈ۔

## Serializing: 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
```

## Deserializing + validation: JSON → validated object

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

یہ نمونہ forms سے ملتا ہے: `is_valid()` آنے والے ڈیٹا کو field rules اور model کے خلاف validate کرتا ہے، اور `save()` اسے محفوظ کرتا ہے۔ غلط ڈیٹا منظم error messages دیتا ہے۔

## Custom validation اور fields

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

## Nested serializers (متعلقہ ڈیٹا)

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

Serializers **nest** کر سکتے ہیں متعلقہ objects کی نمائندگی کے لیے (ایک مضمون کے JSON میں مصنف کا ڈیٹا شامل کرنا) — اور آپ API کی شکل database سے آزادانہ کنٹرول کرتے ہیں۔

## یہ اہم کیوں ہے

Serializers Django REST Framework کے ساتھ REST APIs بنانے کی بنیاد ہیں، جو Django APIs کا معیاری ٹول ہے — اس لیے ان کو سمجھنا کسی بھی جدید Django backend کے لیے ضروری ہے جو JSON کو frontends، موبائل apps، یا دیگر services کو فراہم کرتا ہے۔

Serializers API کی دو بنیادی ضروریات کو حل کرتے ہیں: Python/model ڈیٹا کو جوابات کے لیے JSON میں تبدیل کرنا (serialization) اور آنے والے **JSON کو validated Python objects میں تبدیل کرنا** ڈیٹا بنانے/اپڈیٹ کرنے کے لیے (deserialization + validation)۔

Validation پہلو **سیکیورٹی اور مضبوطی** کے لیے اہم ہے — HTML کے لیے forms کی طرح، serializers یقینی بناتے ہیں کہ آپ کبھی بھی raw API input پر اعتماد نہ کریں، اسے field rules کے خلاف validate کریں اس سے پہلے کہ یہ آپ کے database تک پہنچے۔ **ModelSerializer** ایک بڑی productivity جیت فراہم کرتا ہے models سے fields کو خودکار بناتے ہوئے (DRY، ModelForm کی طرح)، یہ trivial بناتا ہے models کو API resources کے طور پر expose کرنا، جبکہ `is_valid()`/`save()` نمونہ مکمل create/update lifecycle کو صاف طریقے سے سنبھالتا ہے۔

یہ سمجھنا کہ objects اور querysets کو کیسے serialize کریں، input کو deserialize اور validate کریں، custom validation اور computed fields شامل کریں، اور متعلقہ ڈیٹا کے لیے **nested serializers** استعمال کریں (database schema سے آزادانہ API کی شکل کنٹرول کریں) APIs بنانے کے لیے بنیادی ہے۔

Serializers وہ جگہ ہے جہاں DRF API کی بنیادی فکریں data transformation اور validation کے بارے میں ہینڈل کرتا ہے، انہیں مرکزی، ضروری معلومات بناتے ہوئے — روایتی Django کے لیے forms کی نسبت میں اہمیت میں، لیکن API-driven applications کے لیے جو جدید ویب ڈیولپمنٹ میں غالب ہیں۔