django rest框架中的save()、create()和update()有啥区别?

Posted

技术标签:

【中文标题】django rest框架中的save()、create()和update()有啥区别?【英文标题】:What is the different between save(), create() and update () in django rest framework?django rest框架中的save()、create()和update()有什么区别? 【发布时间】:2017-12-19 09:50:34 【问题描述】:

我在使用序列化程序在 django rest 框架上制作 api 时感到困惑,请告诉我 save()、create() 和 update() 方法之间的确切区别,我的代码示例如下,

View.py

class AddUser(views.APIView):
    serializer_class = UserForAdminSerializer

    def post(self, request, *args, **kwargs):

        serializer = UserForAdminSerializer(data=request.data)

        if serializer.is_valid():

            serializer.save()
            return Response(serializer.data, status=status.HTTP_201_CREATED)
        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

serializers.py

class UserForAdminSerializer(serializers.ModelSerializer):

    first_name = serializers.CharField(max_length=30)
    last_name = serializers.CharField(max_length=30)
    name = serializers.CharField(max_length=30)
    password = serializers.CharField(max_length=20, style='input_type': 'password')

    class Meta:
        model = User
        fields = ('id', 'url', 'first_name', 'last_name', 'name', 'username', 'email', 'password',
                  'total_exp_year', 'total_exp_month', 'voteup_count', 'is_featured',
                  'is_active', 'headline', 'description', 'profile_picture', )

    def create(self, validated_data):
        password = validated_data.pop('password', None)
        instance = self.Meta.model(**validated_data)
        if password is not None:
            instance.set_password(password)
        instance.save()
        return instance

在 view.py 文件中的上述代码上,我使用了 save() 方法,而 serializers.py 使用了 save() 或 update() 方法,所以请解释一下它是如何工作的,并清除我在 save() 和 create() 之间的混淆

【问题讨论】:

【参考方案1】:

在 Django Rest Framework documentation 中,他们非常清楚地解释了何时覆盖保存方法和何时创建方法。

为了您的方便,我在这里发布他们的解释


在某些情况下,.create() 和 .update() 方法名称可能没有意义。例如,在联系表单中,我们可能不会创建新实例,而是发送电子邮件或其他消息。 在这些情况下,您可能会选择直接覆盖 .save() ,因为它更具可读性和意义。 示例:-

class ContactForm(serializers.Serializer):
    email = serializers.EmailField()
    message = serializers.CharField()

    def save(self):
        email = self.validated_data['email']
        message = self.validated_data['message']
        send_email(from=email, message=message)

【讨论】:

感谢 Arpit SVT :) 请看一眼:***.com/questions/45119536/…也【参考方案2】:

通常最好的理解代码的方法是实际阅读它,所以让我们看看source:

class BaseSerializer(Field):
    ...
    def update(self, instance, validated_data):
        raise NotImplementedError('`update()` must be implemented.')

    def create(self, validated_data):
        raise NotImplementedError('`create()` must be implemented.')

    def save(self, **kwargs):
        ...
        ... a lot of assertions and safety checks ...
        ... 

        validated_data = dict(
            list(self.validated_data.items()) +
            list(kwargs.items())
        )

        if self.instance is not None:
            self.instance = self.update(self.instance, validated_data)
            ....
        else:
            self.instance = self.create(validated_data)
            ...
        return self.instance

好的,所以,在这个基类中,方法 updatecreate 留给具体的子类来实现(因为对于序列化程序,例如 ListSerializerModelSerializer,细节会有所不同)。

然而,save 已实现,它基本上只是检查对象是新的还是现有的 (if self.instance is not None) 并分别调用 updatecreate代码将在每个其他序列化程序中调用。

我们来看看具体的子类:

def create(self, validated_data):
    ...
    ... some stuff happening
    ...

    try:
        # Here is the important part! Creating new object!
        instance = ModelClass.objects.create(**validated_data)
    except TypeError:
        raise TypeError(msg)

    # Save many-to-many relationships after the instance is created.
    if many_to_many:
        for field_name, value in many_to_many.items():
            set_many(instance, field_name, value)

    return instance


def update(self, instance, validated_data):
    raise_errors_on_nested_writes('update', self, validated_data)
    info = model_meta.get_field_info(instance)

    # Simply set each attribute on the instance, and then save it.
    # Note that unlike `.create()` we don't need to treat many-to-many
    # relationships as being a special case. During updates we already
    # have an instance pk for the relationships to be associated with.
    for attr, value in validated_data.items():
        if attr in info.relations and info.relations[attr].to_many:
            set_many(instance, attr, value)
        else:
            setattr(instance, attr, value)
    instance.save()

    return instance

您可以看到createupdate 调用set_many(instance, attr, value) 来设置对象属性的值。但是,create 之前会进行一次 critical 调用:ModelClass.objects.create(**validated_data)。这实际上创建了新实例。

我希望这能澄清一点。

【讨论】:

感谢 Siegmeyer :) 你能解释一下更新定义中self和instance有什么区别吗? @LittleBrain 对于任何想知道未来的人来说,self 实际上是序列化器的当前实例,因为实例是序列化器引用的模型的实例。所以 Serializer 的 update() 方法实现了 Serializer 应该如何操作模型实例。

以上是关于django rest框架中的save()、create()和update()有啥区别?的主要内容,如果未能解决你的问题,请参考以下文章

save() 上的 Django Rest Framework 完整性错误,is_valid() 返回 true

django rest框架中的异步

使用 django-rest 框架中的 GET 方法将 url 作为参数传递?

Django Rest 框架中的发布请求处理

django框架学习六:优化views.py文件,使用rest_framework中的APIVew和Response返回

django rest框架中的只写,只读字段