Django rest froamwork-ModelSerializer

本文介绍: Mo delSe r i alize r类还公开了一个API，您可以重写该API，以便在实例化序列化程序时更改自动确定序列化程序字段的方式。通常，如果Mod elSe r i alizer 默认情况下不生成所需的字段，则应将它们显式添加到类中，或者仅使用常规Ser i alizer类。但是，在某些情况下，您可能希望创建一个新的基类，该基类定义如何为任何给定的模型创建序列化程序字段。Django 模型字段到REST框架序列化程序字段的映射。您可以覆盖此映射以更改应用于每个模型字段的默认序列化程序字段。

通常，您会想要与Django Mod el 定义紧密映射的
Serializer 类。

ModelSerializer 类提供了一个快捷方式，使用该快捷方式可以自动创建具有与Mod el字段对应的字段的 Serializer 类别。

ModelSerializer 类与常规 Serializer 类相同，不同之处在于：

声明Mod elSerializer如下所示：

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

默认情况下，类上的所有模型字段都将映射到相应的序列化程序字段。

模型上的任何关系（如外键）都将映射到 PrimaryKeyRelatedField。默认情况下不包括反向关系，除非按照序列化程序关系文档中的指定显式包括反向关系。

序列化程序类生成有用的详细表示字符串，使您能够完全检查其字段的状态。当使用 ModelSerializers 时，这一点尤其有用，因为在ModelSerializers中，您需要确定自动为您创建的字段和验证器集。

要做到这一点，请使用 python manage.py shell 打开 Django shell，然后导入序列化程序类，实例化它，并打印对象表示…

&gt;&gt;&gt; from myapp.serializers import AccountSerializer
&gt;&gt;> serializer = AccountSerializer()
>>> print(repr(serializer))
AccountSerializer():
    id = IntegerField(label='ID', read_only=True)
    name = CharField(allow_blank=True, max_length=100, required=False)
    owner = PrimaryKeyRelatedField(queryset=User.objects.all())

如果只希望在模型序列化程序中使用默认字段的子集，可以使用 fields 或 exclude 选项，就像使用 ModelForm 一样。强烈建议您使用 fields 属性显式设置应序列化的所有字段。这将在模型更改时无意中暴露数据的可能性降到最低。

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

您还可以将 fields 属性设置为特殊值 '__all__'，以指示应使用模型中的所有字段。

class AccountSerializer(serializers.ModelSerializer):
    class Meta:
        model = Account
        fields = '__all__'

可以用 exclude 属性指定要从序列化程序中排除的字段列表。
例如：

class AccountSerializer(serializers.ModelSerializer):
    class Meta:
        model = Account
        exclude = ['users']

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

您可以向 ModelSerializer 添加额外的字段，或者通过在类上声明字段来覆盖默认字段，就像对 Serializer 类一样。

class AccountSerializer(serializers.ModelSerializer):
    url = serializers.CharField(source='get_absolute_url', read_only=True)
    groups = serializers.PrimaryKeyRelatedField(many=True)

    class Meta:
        model = Account
        fields = ['url', 'groups']

您可能希望将多个字段指定为只读字段。您可以使用快捷方式Meta 选项 read_only_fields，而不是使用 read_only=True 属性显式添加每个字段。

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

默认情况下，editable=False 设置的模型字段和 AutoField 字段将设置为只读，不需要添加到 read_only_fields 选项中。

还有一个快捷方式允许您使用 extra_kwargs 选项在字段上指定任意附加的关键字参数。与read_only_fields的情况一样，这意味着您不需要在序列化程序上显式声明字段。

class CreateUserSerializer(serializers.ModelSerializer):
    class Meta:
        model = User
        fields = ['email', 'username', 'password']
        extra_kwargs = {'password': {'write_only': True}}

    def create(self, validated_data):
        user = User(
            email=validated_data['email'],
            username=validated_data['username']
        )
        user.set_password(validated_data['password'])
        user.save()
        return user