svn commit: r926225 - /openjpa/trunk/openjpa-project/src/doc/manual/migration_considerations.xml

[dw...@apache.org]

Author: dwoods
Date: Mon Mar 22 17:58:56 2010
New Revision: 926225

URL: http://svn.apache.org/viewvc?rev=926225&view=rev
Log:
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.

Modified:
    openjpa/trunk/openjpa-project/src/doc/manual/migration_considerations.xml

Modified: openjpa/trunk/openjpa-project/src/doc/manual/migration_considerations.xml
URL: http://svn.apache.org/viewvc/openjpa/trunk/openjpa-project/src/doc/manual/migration_considerations.xml?rev=926225&r1=926224&r2=926225&view=diff
==============================================================================
--- openjpa/trunk/openjpa-project/src/doc/manual/migration_considerations.xml (original)
+++ openjpa/trunk/openjpa-project/src/doc/manual/migration_considerations.xml Mon Mar 22 17:58:56 2010
@@ -174,6 +174,30 @@
                     demonstrate the behavioral differences.
                 </para>
             </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 id="Disabling AutoOff Collection Tracking">
             <title>