Django REST Framework (DRF) is de de-facto standaard voor het bouwen van REST API's met Django, en serializers zijn het kernbegrip. Een serializer converteert complexe gegevens (modelinstanties, querysets) naar JSON voor API-responses, en converteert inkomende JSON terug naar gevalideerde Python-objecten — het behandelt zowel serialisatie als validatie, net zoals formulieren dat doen voor HTML.
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"]
Een ModelSerializer genereert automatisch velden uit het model (zoals een ModelForm) — minimale code om een model te serialiseren en valideren.
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
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
Het patroon spiegelt formulieren: is_valid() valideert inkomende gegevens tegen veldregels en het model, en save() slaat het op. Ongeldige gegevens leveren gestructureerde foutmeldingen op.
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
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 kunnen genest worden om gerelateerde objecten weer te geven (het insluiten van een auteurs gegevens in een artikel's JSON) — en u controleert de vorm van de API onafhankelijk van de database.
Serializers zijn de hoeksteen van het bouwen van REST API's met Django REST Framework, wat het standaardgereedschap voor Django API's is — daarom is het begrijpen ervan essentieel voor elke moderne Django back-end die JSON aan frontends, mobiele apps of andere services aanbiedt.
Serializers lossen de twee fundamentele behoeften van een API op: het converteren van Python/modelgegevens naar JSON voor responses (serialisatie) en het converteren van inkomende JSON naar gevalideerde Python-objecten voor het aanmaken/bijwerken van gegevens (deserialisatie + validatie).
Het validatieaspect is kritiek voor veiligheid en robuustheid — net als formulieren voor HTML zorgen serializers ervoor dat je nooit rauwe API-invoer vertrouwt, deze valideert tegen veldregels voordat deze uw database bereikt. ModelSerializer biedt een grote productiviteitswinst door automatisch velden uit modellen te genereren (DRY, net als ModelForm), waardoor het triviaal is om modellen als API-resources beschikbaar te stellen, terwijl het patroon is_valid()/save() de volledige create/update-lifecycle schoon afhandelt.
Begrijpen hoe je objecten en querysets serialiseert, invoer deserialiseert en valideert, aangepaste validatie en berekende velden toevoegt, en geneste serializers gebruikt voor gerelateerde gegevens (de vorm van de API onafhankelijk van het databaseschema controleert) is fundamenteel voor het bouwen van API's.
Serializers zijn waar DRF de kerngegevens van de API-transformatie en -validatie afhandelt, waardoor ze centrale, essentiële kennis zijn — analoog in belang aan formulieren voor traditionele Django, maar voor de op API gestuurde toepassingen die moderne webontwikkeling domineren.
Een bibliotheek met IT-sollicitatievragen met gedetailleerde antwoorden — van Junior tot Senior.
Doneren