OPENJPA-1097 Add a note in the Migration Considerations doc about the 'fixed' serialization behavior and how DetachedStateField can be used to modify the behavior.

git-svn-id: https://svn.apache.org/repos/asf/openjpa/trunk@926225 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Donald Woods 2010-03-22 17:58:56 +00:00
parent 94a1323dfb
commit 86546e1e12
1 changed files with 24 additions and 0 deletions

View File

@ -174,6 +174,30 @@
demonstrate the behavioral differences. demonstrate the behavioral differences.
</para> </para>
</section> </section>
<section id="serialization">
<title>
Serialization of Entities
</title>
<para>
In 1.x.x releases of OpenJPA, when an entity was serialized
after calling EntityManager.find(), detach() or detachAll()
then all <xref linkend="ref_guide_pc_scos_proxy"/>
were removed as expected, but when the same entity instance
was serialized after calling EntityManager.clear() the
proxy classes were not removed.
</para>
<para>
Starting with OpenJPA 1.3 and 2.0, this behavior has been
modified, so that by default all proxies will be removed
during serialization. See
<xref linkend="ref_guide_pc_scos_proxy_serial"/>
on how the behavior changes based on the
<literal>DetachedStateField</literal> setting along with
<xref linkend="ref_guide_detach_state"/>
for more details on how to override the default
<literal>DetachedStateField</literal> setting.
</para>
</section>
</section> </section>
<section id="Disabling AutoOff Collection Tracking"> <section id="Disabling AutoOff Collection Tracking">
<title> <title>