Fixed #29423 -- Documented Field.value_from_object().

This commit is contained in:
Srinivas Reddy Thatiparthy 2018-05-25 20:53:13 +05:30 committed by Tim Graham
parent 738a0a4dc2
commit 4c35a173e8
2 changed files with 8 additions and 2 deletions

View File

@ -679,8 +679,8 @@ Converting field data for serialization
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
To customize how the values are serialized by a serializer, you can override
:meth:`~Field.value_to_string`. Using ``value_from_object()`` is the best way
to get the field's value prior to serialization. For example, since our
:meth:`~Field.value_to_string`. Using :meth:`~Field.value_from_object` is the
best way to get the field's value prior to serialization. For example, since
``HandField`` uses strings for its data storage anyway, we can reuse some
existing conversion code::

View File

@ -1857,6 +1857,12 @@ Field API reference
Besides saving to the database, the field also needs to know how to
serialize its value:
.. method:: value_from_object(obj)
Returns the field's value for the given model instance.
This method is often used by :meth:`value_to_string`.
.. method:: value_to_string(obj)
Converts ``obj`` to a string. Used to serialize the value of the field.