10

Django-RESTフレームワークのドキュメントは、どれほど長いものであっても、背景が薄すぎると感じています。

restore_objectメソッドのattrs関数は何をしますか？

instance.title = attrs.get('title', instance.title)

2番目の引数は何を表しており、これが将来ドキュメントで何を意味するかをどのように探しますか？

また、の二重アスタリスクが何をreturn Snippet(**attrs)意味するのかわかりません。これは**keywArgsとは異なりますか？デシリアライズされたSnippetオブジェクトに返される引数は何ですか？

ドキュメントの別のセクションで、restore_object（）に表示さinstance.title = attrs['title']れますが、混乱が見られることを願っています。

ありがとうございました

class SnippetSerializer(serializers.Serializer):
    pk = serializers.Field()  # Note: `Field` is an untyped read-only field.
    title = serializers.CharField(required=False,
                                  max_length=100)
    code = serializers.CharField(widget=widgets.Textarea,
                                 max_length=100000)
    linenos = serializers.BooleanField(required=False)
    language = serializers.ChoiceField(choices=LANGUAGE_CHOICES,
                                       default='python')
    style = serializers.ChoiceField(choices=STYLE_CHOICES,
                                    default='friendly')

    def restore_object(self, attrs, instance=None):
        """
        Create or update a new snippet instance.
        """
        if instance:
            # Update existing instance
            instance.title = attrs.get('title', instance.title)
            instance.code = attrs.get('code', instance.code)
            instance.linenos = attrs.get('linenos', instance.linenos)
            instance.language = attrs.get('language', instance.language)
            instance.style = attrs.get('style', instance.style)
            return instance

        # Create new instance
        return Snippet(**attrs)
4

2 に答える 2

6

それをより明確にするために、ドキュメントを少し更新しました...

http://django-rest-framework.org/tutorial/1-serialization.html#creating-a-serializer-class

メソッドは次のようになります...

def restore_object(self, attrs, instance=None):
    """
    Create or update a new snippet instance, given a dictionary
    of deserialized field values.

    Note that if we don't define this method, then deserializing
    data will simply return a dictionary of items.
    """
    if instance:
        # Update existing instance
        instance.title = attrs.get('title', instance.title)
        instance.code = attrs.get('code', instance.code)
        instance.linenos = attrs.get('linenos', instance.linenos)
        instance.language = attrs.get('language', instance.language)
        instance.style = attrs.get('style', instance.style)
        return instance

    # Create new instance
    return Snippet(**attrs)

スタイルは、**attrsPython の標準的なキーワード展開を使用しています。良い説明については、こちらを参照してください。

最終的には同等のものになりますSnippet(title=attrs['title'], code=attrs['code'], ...)

それが役立つことを願っています!

于 2013-03-17T20:12:09.860 に答える