Mene ne serializers a Django REST Framework?

Question

Accepted Answer

**Django REST Framework (DRF)** shine gaida sanzuwanne don gina REST APIs tare da Django, kuma **serializers** shine mahimmin aiki. Serializer yana canza bayanan hadaddiye (model instances, querysets) **zuwa** JSON don amsa API, kuma yana canza JSON na zuwa **baya** zuwa abin da aka tabbatar da shi Python objects — yana kula da serialization da validation, kamar yadda forms ke yi don HTML.

## ModelSerializer — halin gida

```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` yana samar da fields ta atomatik daga model (kamar ModelForm) — karamin code don serialize da validate model.

## 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 → abin da aka tabbatar

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

Dabarar ta bi forms: `is_valid()` yana tabbatar da bayanan da ke zuwa a gida da doka na field da model, kuma `save()` yana adana shi. Bayanan da ba su dace ba suna samar da messages na tsari na errors.

## Custom validation da 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 (related data)

```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 na iya **haɗa** don wakiltar abubuwan da ke alaƙa (haɗa bayanan marubucin a cikin JSON na labarin) — kuma ka iya sarrafa ine na API daga abokin dangi.

## Dalilin da yake matuƙi

Serializers shine jihar asali na gina REST APIs tare da Django REST Framework, wanda shine gaida-gaida kayan aiki don Django APIs — saboda haka fahimta su da muhimmu don kowacce Django back-end na jiya wanda ke aiko JSON zuwa frontends, apps na hannu, ko ayyuka waje.

Serializers suna magance buɗe dalilai biyu na API: canza Python/model data **zuwa JSON** don amsa (serialization) kuma canza zuwa **JSON zuwa abin da aka tabbatar da shi Python objects** don ƙirƙira/update data (deserialization + validation).

Aspect na validation shine mahimmi don **security da karfi** — kamar forms don HTML, serializers suna tiyata ba ka taɗe raw API input, tabbatar da shi a gida da doka na field kafin ya isa database. **ModelSerializer** yana ba da babbar nasara ta fa'ida ta samar da fields ta atomatik daga models (DRY, kamar ModelForm), na sauƙa expose models azaman resources na API, yayin da `is_valid()`/`save()` dabarar ta kula da full create/update lifecycle sannu da sannu.

Fahimta yadda za a serialize objects da querysets, deserialize da validate input, saka custom validation da computed fields, da kula **nested serializers** don related data (sarrafa ine na API daga database schema) shine asali don gina APIs.

Serializers shine waje DRF ya kula da mahimman batutuwan API na canzawa da validation, na sauƙa su tsakiyanci, kana-sani ilmi — kamar mahimmanci kamar forms don DRF ga gida, kuma don ayyuka da ke da API wanda ya haskakawa sabon gida.