155

I am trying to change Model field name in DRF Serializer like alias in SQL. I have tried different methods but cannot succeed.

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')

I have also tried to add alias in Django Queryset but cannot changed.

Updated

This is the exception that i am facing

AttributeError at /ViewName/ 'module' object has no attribute 'Field'

How can I do this?

3
  • 1
    Are you using a correct implementation of the serializers.SerializerMethodField approach? I mean this: serializers.SerializerMethodField('get_location') and def get_location(self, obj): ...
    – erthalion
    Apr 9, 2014 at 9:45
  • Can we see the imports of serializers.py?
    – joerick
    Apr 9, 2014 at 10:19
  • will downvote question because OP accepted a partially wrong and confusing answer instead of the better ones below...
    – NeuronQ
    Nov 6, 2017 at 15:49

5 Answers 5

300

There is a very nice feature in serializer fields and serializers in general called 'source' where you can specify source of data from the model field.

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

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

Where serializers.SomeSerializerField can be serializers.CharField as your model suggests but can also be any of the other fields. Also, you can put relational fields and other serializers instead and this would still work like charm. ie even if alternate_name was a foreignkey field to another model.

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

This works with the creation, deletion, and modification requests too. It effectively creates one on one mapping of the field name in the serializer and field name in models.

7
  • I agreed, that source is more general approach. But you can see few attempts to use it in the question, so if you would like to answer that way you also should make clear why original code is not working, isn't it?
    – erthalion
    Jan 16, 2016 at 13:02
  • Your code will work fine.. as long as the request is for list and retrieve
    – iankit
    Feb 24, 2016 at 10:18
  • 1
    Both answers are incomplete. In the case of foreign key, this method implies that when creating a new Park, you have to give the whole parent object (alternate_name) as a dict in your POST request, which is insane since the parent object already exists. One should be able to mention the foreign instance via its id.
    – stelios
    Oct 12, 2016 at 20:25
  • 3
    In my case (foreign key) I solved this problem with locations = serializers.PrimaryKeyRelatedField(source='alternate_name', queryset=AlternateName.objects.all()). Apparently RelatedField can be used as well.
    – stelios
    Oct 13, 2016 at 18:20
  • @chefarov source='new_name' is a generic argument you can give to serializer fields, relations and other related serializers etc.. Not sure why you say the answer is incomplete.
    – iankit
    Oct 14, 2016 at 5:26
96

You can use serializers.SerializerMethodField:

Here is the model Park, which has name and alternate_name fields.

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

Here is Serializer for Park Model, ParkSerializer. This changes the name of alternate_name to location.

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

Additionally, you can use serializers.CharField with source attribute:

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

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

Django's __ notation to traverse foreign key also works:

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

The same principle applies if you want to change the return type on the API, so you can do serializers.DecimalField(source=...) and other field types as well.

This would however work only for read only fields.

10
  • Now this exception is throwing AttributeError at /ViewName/ 'module' object has no attribute 'SerializerMethodField' Apr 9, 2014 at 9:52
  • 3
    How would this workout with create and edit requests?
    – iankit
    Oct 24, 2015 at 21:24
  • 2
    Line no 13 of 'Zen of Python' : "There should be one -- and preferably only one --obvious way to do it."
    – iankit
    Jan 28, 2016 at 15:07
  • 20
    This should not be the accepted answer. See the one below, that has almost 5 times as many upvotes at the time of me writing this.
    – cderwin
    Jun 17, 2016 at 20:24
  • 8
    This is a bad solution. Use the source kwarg instead as described below.
    – Patrick
    Jul 16, 2018 at 10:50
23

This would work for write operations also

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

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

Another method

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']

2
  • 1
    Some explanations as to what is going on and why would be nice.
    – Seb
    Jul 13, 2022 at 9:32
  • Did not work for me.
    – Ahsan
    Oct 6 at 3:45
-2

I know this is nearly 2 years later, but thought it might be of help for any future devs...

The reason the code doesn't work is because of the following line in models.py
location = serializers.Field(source='alias_alternate_name')
That's what the exception is trying to tell us. That is:
AttributeError at /ViewName/ 'module' object has no attribute 'Field'
means that the serializers module has no item called Field.

I want to offer a different solution than the other answers:
Modify models.py to include the related_name field and then simply use this name in serializers.

The advantage of this approach is that you have one on one mapping of field name in the serializer and field name in models with less code and the disadvantage of this is that this approach may not work with complex foreign key relationships.

Here is a demo of my approach:

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')

Read more about this here: https://www.django-rest-framework.org/api-guide/relations/

Your Answer

Reminder: Answers generated by Artificial Intelligence tools are not allowed on Stack Overflow. Learn more

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.