Cad iad serializers i Django REST Framework?

Question

Accepted Answer

**Django REST Framework (DRF)** an caighdeán gníomhaoichte do API REST a thógáil le Django, agus **serializers** an bhunsmaoin ann. Tiontaíonn serializer sonraí casta (samhlacha samhail, querysets) **go** JSON do fhreagairtí API, agus tiontaíonn JSON isteach **ar ais** go dtí rudaí Python fhíoraithe — ag láimhseáil socrúthú agus bailíochtú, cosúil le foirmeacha a dhéanann do HTML.

## ModelSerializer — an cás coitianta

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

Is ionann `ModelSerializer` agus an leagan a ghinfear réimsí ó shamhail (cosúil le ModelForm) — an t-íoscíonn cód a sheichealbhú agus a bhailíochtú samhail.

## 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 + bailíochtú: 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
```

Athscálaíonn an patrún foirmeacha: `is_valid()` bailíonn sonraí isteach a dhéantar i gcoinne rialacha réimse agus an samhail, agus `save()` bhitheann sé. Toradh sonraí neamhbhailí ar theachtaireachtaí earráide struchtúrtha.

## Bailíochtú agus réimsí saincheaptha

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

## Serializers foluain (sonraí gaolmhara)

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

D'fhéadfadh serializers a **foluain** chun rudaí gaolmhara a ionadaíocht (agus sonraí údar a neadú i JSON an alt) — agus rialuithe tú cruth an API go neamhspleách ar an bhunachar sonraí.

## Cén fáth a bhíonn sé tábhachtach

Is iad serializers an fhondúireacht chun API REST a thógáil le Django REST Framework, ar an uirlis chaighdeánach í do API Django — agus dá bhrí sin is gá duit a thuiscint chun aon chúl-thosaigh Django nua-aimseartha a bheidhéartha JSON do thosaigh, feidhmchlár soghluaiste, nó seirbhísí eile.

Réitíonn serializers an dá riachtanas bunúsach an API: sonraí Python/samhail a thiontú **go JSON** do fhreagairtí (serialization) agus JSON isteach a thiontú **go dtí rudaí Python fhíoraithe** chun sonraí a chruthú/a nuashonrú (deserializization + bailíochtú).

Is ríthábhachtach an ghné bhailíochtúcháin do **slándáil agus treiseadh** — cosúil le foirmeacha do HTML, cinntíonn serializers nach gcreidfeá go deo ionchuir API amh, á bhailíochtú i gcoinne rialacha réimse roimh dul go dtí do bhunachar sonraí. **ModelSerializer** spréacharnach mór-thábhachtach a bhíonn sa tslánaiochta trí réimsí a ghiniúint ó shamhlacha (DRY, cosúil le ModelForm), a dhéanann sé fánach rudaí a leagan amach mar acmhainní API, agus an patrún `is_valid()`/`save()` a láimhseáil an saol iomlán a chruthú/a nuashonrú go geal.

Is gá duit a thuiscint conas rudaí agus querysets a sheichealbhú, ionchuir a dhesicealbhú agus a bhailíochtú, bailíochtú agus réimsí ríofartha saincheaptha a chur leis, agus **serializers foluain** a úsáid ar son sonraí gaolmhara (cruth an API a rialú go neamhspleách ar scéim bunachair sonraí) bunúsach do API a thógáil.

Is é an áit ina láimhseálann DRF imní bhunúsacha an API maidir le socrúthú agus bailíochtú sonraí — á dhéanamh lárnach, ríochtúsáinithe fios — cosmhail san tábhacht le foirmeacha do dhraíochta dhúchasacha, ach ar API-dhreachtaithe agus ar an dream a dhé-iomhá ar fad ar nua-bhliain iomlán web fhorbartha.