如何在 Django REST 框架中更改字段名称

Question

我正在尝试更改 DRF 序列化程序中的模型字段名称，如 SQL 中的别名。我尝试了不同的方法，但都没有成功。

models.py

class Park(models.Model):
    name = models.CharField(max_length=256)
    alternate_name = models.CharField(max_length=256, blank=True)
    objects = models.GeoManager()

    class Meta:
        db_table = u'p_park'

    def __unicode__(self):
        return '%s' % self.name

    def alias_alternate_name(self):
        return self.alternate_name

serializers.py

class ParkSerializer(serializers.ModelSerializer):

    location = serializers.Field(source='alias_alternate_name')
    #location = serializers.SerializerMethodField(source='alias_alternate_name')

    #alternate_name as location


    class Meta:
        model = Park
        fields = ('id', 'name', 'location')

我也尝试在 Django Queryset 中添加别名，但无法更改。

更新

这是我面临的例外

/ViewName/ 'module' 对象的 AttributeError 没有属性 'Field'

我该怎么做？

Answer 1

另一种方法

class UrlHyperlinkedModelSerializer(serializers.HyperlinkedModelSerializer):
    field_name_map = {}

    def to_representation(self, instance):
        res = super().to_representation(instance)
        nres = res.__class__()
        for k, v in res.items():
            nres[self.field_name_map.get(k, k)] = v
        return nres

class CommentSerializer(UrlHyperlinkedModelSerializer):
    field_name_map = {
        'a': 'a_url'
    }

    class Meta:
        model = models.Comment
        fields = ['a', 'url', 'body', 'created_at']

Answer 2

序列化器字段和序列化器有一个非常好的功能，通常称为“源”，您可以在其中指定模型字段的数据源。

class ParkSerializer(serializers.ModelSerializer):
    location = serializers.SomeSerializerField(source='alternate_name')

    class Meta:
        model = Park
        fields = ('other_fields', 'location')

其中 serializers.SomeSerializerField 可以是您的模型所建议的 serializers.CharField，但也可以是任何其他字段。此外，您可以改为放置关系字段和其他序列化程序，这仍然会像魅力一样工作。即即使alternate_name 是另一个模型的外键字段。

class ParkSerializer(serializers.ModelSerializer):
    locations = AlternateNameSerializer(source='alternate_name', many=true)

    class Meta:
        model = Park
        fields = ('other_fields', 'locations')

class AlternateNameSerializer(serializers.ModelSerialzer):
    class Meta:
        model = SomeModel

这也适用于创建、删除和修改请求。它有效地创建了序列化程序中的字段名称和模型中的字段名称的一对一映射。

Answer 3

我知道这是将近 2 年后的事了，但我认为这可能对任何未来的开发者都有帮助...

代码不起作用的原因是 models.py
location = serializers.Field(source='alias_alternate_name')
中的以下行 这就是异常试图告诉我们的。即：
AttributeError at /ViewName/ 'module' object has no attribute 'Field'
表示 serializers 模块没有名为 Field 的项目。

我想提供与其他答案不同的解决方案：
修改 models.py 以包含 related_name 字段，然后在序列化程序中简单地使用此名称。

这种方法的优点是序列化程序中的字段名称和模型中的字段名称的一对一映射代码较少，缺点是这种方法可能不适用于复杂的外键关系。

这是我的方法的演示：

models.py

class Park(models.Model):
    name = models.CharField(max_length=256)
    alternate_name = models.CharField(max_length=256, blank=True, related_name='location')
    objects = models.GeoManager()

    class Meta:
        db_table = u'p_park'

serializers.py

class ParkSerializer(serializers.ModelSerializer):

    class Meta:
        model = Park
        fields = ('id', 'name', 'location')

在此处了解更多信息： https://www.django-rest-framework.org/api-guide/relations/

Answer 4

你可以使用serializers.SerializerMethodField:

这是模型 Park，其中包含 name 和 alternate_name 字段。

class Park(models.Model):
    name = models.CharField(max_length=256)
    alternate_name = models.CharField(max_length=256, blank=True)
    objects = models.GeoManager()

    class Meta:
        db_table = u'p_park'

    def __unicode__(self):
        return '%s' % self.name

这里是 Park 模型的 Serializer，ParkSerializer。这会将alternate_name 的名称更改为位置。

class ParkSerializer(serializers.ModelSerializer):
    location = serializers.SerializerMethodField('get_alternate_name')

    class Meta:
        model = Park
        fields = ('other_fields', 'location')

    def get_alternate_name(self, obj):
        return obj.alternate_name

此外，您可以将serializers.CharField 与source 属性一起使用：

class ParkSerializer(serializers.ModelSerializer):
    location = serializers.CharField(source='other_fields')

    class Meta:
        model = Park
        fields = ('other_fields', 'location')

Django 用于遍历外键的__ 表示法也可以：

location = serializers.CharField(source='OtherModel__other_fields')

如果您想更改 API 上的返回类型，同样的原则也适用，因此您也可以更改 serializers.DecimalField(source=...) 和其他字段类型。

但这仅适用于只读字段。

Answer 5

这也适用于写操作

class ParkSerializer(serializers.ModelSerializer):
    location = serializers.CharField(source='alternate_name')

    class Meta:
        model = Park
        fields = ('id', 'name', 'location')