Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Fixed #8701, a couple of bad links in the docs.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@8941 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
commit 5697f87914406b070d47bab45e0137337a0fb746 1 parent d302be4
@jacobian jacobian authored
Showing with 16 additions and 18 deletions.
  1. +16 −18 docs/topics/serialization.txt
View
34 docs/topics/serialization.txt
@@ -57,25 +57,26 @@ be serialized.
Inherited Models
~~~~~~~~~~~~~~~~
-If you have a model that is defined using an `abstract base class`_, you don't
-have to do anything special to serialize that model. Just call the serializer
-on the object (or objects) that you want to serialize, and the output will be
-a complete representation of the serialized object.
+If you have a model that is defined using an :ref:`abstract base class
+<abstract-base-classes>`, you don't have to do anything special to serialize
+that model. Just call the serializer on the object (or objects) that you want to
+serialize, and the output will be a complete representation of the serialized
+object.
-However, if you have a model that uses `multi-table inheritance`_, you also
-need to serialize all of the base classes for the model. This is because only
-the fields that are locally defined on the model will be serialized. For
-example, consider the following models::
+However, if you have a model that uses :ref:`multi-table inheritance
+<multi-table-inheritance>`, you also need to serialize all of the base classes
+for the model. This is because only the fields that are locally defined on the
+model will be serialized. For example, consider the following models::
- class Place(models.Model):
- name = models.CharField(max_length=50)
+ class Place(models.Model):
+ name = models.CharField(max_length=50)
- class Restaurant(Place):
- serves_hot_dogs = models.BooleanField()
+ class Restaurant(Place):
+ serves_hot_dogs = models.BooleanField()
If you only serialize the Restaurant model::
- data = serializers.serialize('xml', Restaurant.objects.all())
+ data = serializers.serialize('xml', Restaurant.objects.all())
the fields on the serialized output will only contain the `serves_hot_dogs`
attribute. The `name` attribute of the base class will be ignored.
@@ -83,11 +84,8 @@ attribute. The `name` attribute of the base class will be ignored.
In order to fully serialize your Restaurant instances, you will need to
serialize the Place models as well::
- all_objects = list(Restaurant.objects.all()) + list(Place.objects.all())
- data = serializers.serialize('xml', all_objects)
-
-.. _abstract base class: http://www.djangoproject.com/documentation/model-api/#abstract-base-classes
-.. _multi-table inheritance: http://www.djangoproject.com/documentation/model-api/#multi-table-inheritance
+ all_objects = list(Restaurant.objects.all()) + list(Place.objects.all())
+ data = serializers.serialize('xml', all_objects)
Deserializing data
------------------
Please sign in to comment.
Something went wrong with that request. Please try again.