序列化器 – Django REST框架

Django REST框架中的序列化器负责将对象转换为javascript和前端框架所能理解的数据类型。序列化器还提供了反序列化的功能，在首先验证了传入的数据后，允许将解析的数据转换回复杂的类型。REST框架中的序列化器与Django的Form和ModelForm类的工作非常相似。最常用的两个主要序列化器是ModelSerializer和HyperLinkedModelSerialzer。
这篇文章围绕着如何在Django REST框架中从头开始使用序列化器，到高级序列化器字段和参数。假设你已经熟悉了如何用Django REST框架开始一个项目？

• 创建和使用序列化器
• ModelSerializer
• HyperLinkedModelSerializer
• Serializer Fields
• 串行器字段中的核心参数

创建和使用序列化器

创建一个基本的串行器

要创建一个基本的序列化器，需要从rest_framework导入序列化器类，并为序列化器定义字段，就像在Django中创建一个表单或模型一样。

示例

# import serializer from rest_framework
from rest_framework import serializers
 
# create a serializer
class CommentSerializer(serializers.Serializer):
    # initialize fields
    email = serializers.EmailField()
    content = serializers.CharField(max_length = 200)
    created = serializers.DateTimeField()

这样，人们可以根据所需字段为任何特定的实体或对象声明序列化器。序列化器可用于序列化和反序列化数据。

使用序列化器对数据进行序列化

现在我们可以使用CommentSerializer来序列化一个评论，或者评论的列表。同样，使用序列化器类看起来很像使用表单类。让我们先创建一个Comment类来创建一个可以被我们的序列化器理解的Comment类型的对象。

# import datetime object
from datetime import datetime
 
# create a class
class Comment(object):
    def __init__(self, email, content, created = None):
        self.email = email
        self.content = content
        self.created = created or datetime.now()
# create a object
comment = Comment(email ='leila@example.com', content ='foo bar')

现在我们的对象已经准备好了，让我们试着将这个注释对象序列化。运行下面的命令。

Python manage.py shell

现在运行以下代码

# import comment serializer
>>> from apis.serializers import CommentSerializer

# import datetime for date and time
>>> from datetime import datetime

# create a object
>>> class Comment(object):
...     def __init__(self, email, content, created=None):
...         self.email = email
...         self.content = content
...         self.created = created or datetime.now()
... 

# create a comment object
>>> comment = Comment(email='leila@example.com', content='foo bar')

# serialize the data
>>> serializer = CommentSerializer(comment)

# print serialized data
>>> serializer.data

现在让我们检查一下这个的输出。

要查看更多关于如何创建和使用串行器的信息，请访问 – 创建和使用串行器

ModelSerializer

ModelSerializer类提供了一个快捷方式，让你自动创建一个Serializer类，其字段与Model字段对应。

ModelSerializer类与普通的Serializer类相同，只是。

• 它将根据模型自动为你生成一组字段。
• 它将自动为序列化器生成验证器，例如唯一的验证器。
• 它包括.create()和.update()的简单默认实现。

语法 –

class SerializerName(serializers.ModelSerializer):
    class Meta:
        model = ModelName
        fields = List of Fields

示例 –

class AccountSerializer(serializers.ModelSerializer):
    class Meta:
        model = Account
        fields = ['id', 'account_name', 'users', 'created']

默认情况下，类上的所有模型字段将被映射到相应的序列化器字段。
要检查如何在你的项目中使用ModelSerializer，请访问 – ModelSerializer in serializers – Django REST Framework 。

HyperlinkedModelSerializer

HyperlinkedModelSerializer类与ModelSerializer类类似，只是它使用超链接来表示关系，而不是主键。默认情况下，序列化器将包括一个url字段，而不是一个主键字段。url字段将使用HyperlinkedIdentityField序列化器字段来表示，模型上的任何关系将使用HyperlinkedRelatedField序列化器字段表示。

语法 –

class SerializerName(serializers.HyperlinkedModelSerializer):
    class Meta:
        model = ModelName
        fields = List of Fields

示例 –

class AccountSerializer(serializers.HyperlinkedModelSerializer):
    class Meta:
        model = Account
        fields = ['id', 'account_name', 'users', 'created']

要检查如何在你的项目中使用HyperLinkedModelSerializer，请访问 – HyperlinkedModelSerializer in serializers – Django REST Framework 。

Serializer Fields

串行器字段中的核心参数

Django中的序列化字段与Django表格字段和Django模型字段相同，因此需要某些参数来操作这些字段的行为。