Django REST Framework-এ serializer কী?

Question

Accepted Answer

**Django REST Framework (DRF)** হল Django দিয়ে REST API তৈরির জন্য মূলমন্ত্র, এবং **serializer** হল এর মূল ধারণা। একটি serializer জটিল ডেটা (মডেল ইনস্ট্যান্স, querysets) কে JSON-এ রূপান্তরিত করে API প্রতিক্রিয়ার জন্য, এবং আসন্ন JSON-কে validated Python অবজেক্টে রূপান্তরিত করে — serialization এবং validation উভয়ই পরিচালনা করে, অনেকটা 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 এর মতো) — একটি মডেল serialize এবং validate করার জন্য minimal code।

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

প্যাটার্ন ফর্মগুলি প্রতিফলিত করে: `is_valid()` ফিল্ড নিয়ম এবং মডেলের বিপরীতে আসন্ন ডেটা validate করে, এবং `save()` এটি persist করে। অবৈধ ডেটা structured error messages উৎপন্ন করে।

## Custom validation এবং ক্ষেত্র

```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** করতে পারে সম্পর্কিত অবজেক্ট প্রতিনিধিত্ব করতে (একটি নিবন্ধের JSON-এর মধ্যে একজন লেখকের ডেটা embed করা) — এবং আপনি ডাটাবেস থেকে স্বাধীনভাবে API-র আকার নিয়ন্ত্রণ করেন।

## কেন এটি গুরুত্বপূর্ণ

Serializer হল Django REST Framework দিয়ে REST API তৈরির কোণপ্রস্তর, যা Django API-র জন্য মানক টুল — তাই যেকোনো আধুনিক Django ব্যাকএন্ড-এর জন্য যা frontends, মোবাইল অ্যাপ্লিকেশন বা অন্যান্য সেবায় JSON পরিবেশন করে, এগুলি বোঝা অপরিহার্য।

Serializer একটি API-র দুটি মৌলিক প্রয়োজন সমাধান করে: Python/মডেল ডেটা কে JSON-এ প্রতিক্রিয়ার জন্য রূপান্তরিত করা (serialization) এবং আসন্ন JSON-কে ডেটা তৈরি/আপডেট করার জন্য validated Python অবজেক্টে রূপান্তরিত করা (deserialization + validation)।

Validation দিক **নিরাপত্তা এবং robustness** এর জন্য গুরুত্বপূর্ণ — HTML-র জন্য ফর্মের মতো, serializers নিশ্চিত করে যে আপনি কখনও raw API ইনপুট বিশ্বাস করবেন না, এটি আপনার ডাটাবেসে পৌঁছানোর আগে ফিল্ড নিয়মের বিপরীতে validate করুন। **ModelSerializer** মডেল থেকে ক্ষেত্র স্বয়ংক্রিয়ভাবে তৈরি করে একটি প্রধান উৎপাদনশীলতা জয় প্রদান করে (DRY, ModelForm এর মতো), এটি trivial করে মডেল কে API সম্পদ হিসেবে expose করতে, যখন `is_valid()`/`save()` প্যাটার্ন সম্পূর্ণ create/update জীবনচক্র পরিষ্কারভাবে পরিচালনা করে।

কীভাবে অবজেক্ট এবং querysets serialize করতে হয়, ইনপুট deserialize এবং validate করতে হয়, custom validation এবং computed ক্ষেত্র যোগ করতে হয়, এবং সম্পর্কিত ডেটার জন্য **nested serializers** ব্যবহার করতে হয় (ডাটাবেস স্কিমা থেকে স্বাধীনভাবে API-র আকার নিয়ন্ত্রণ করা) তা বোঝা API তৈরির জন্য মৌলিক।

Serializer হল যেখানে DRF ডেটা রূপান্তর এবং validation-র মূল API উদ্বেগ পরিচালনা করে, তাদের কেন্দ্রীয়, অবশ্যই-জানতে-হবে জ্ঞান করে তোলে — traditional Django-র জন্য ফর্মের গুরুত্বের সাথে উপমা, কিন্তু API-চালিত অ্যাপ্লিকেশনের জন্য যা আধুনিক ওয়েব ডেভেলপমেন্ট আধিপত্য বিস্তার করে।