openjpa-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jrba...@apache.org
Subject svn commit: r1335721 - /openjpa/branches/2.2.x/openjpa-project/src/doc/manual/ref_guide_pc.xml
Date Tue, 08 May 2012 19:47:11 GMT
Author: jrbauer
Date: Tue May  8 19:47:10 2012
New Revision: 1335721

URL: http://svn.apache.org/viewvc?rev=1335721&view=rev
Log:
OPENJPA-2165 Ported documentation back to 2.2.x branch

Modified:
    openjpa/branches/2.2.x/openjpa-project/src/doc/manual/ref_guide_pc.xml

Modified: openjpa/branches/2.2.x/openjpa-project/src/doc/manual/ref_guide_pc.xml
URL: http://svn.apache.org/viewvc/openjpa/branches/2.2.x/openjpa-project/src/doc/manual/ref_guide_pc.xml?rev=1335721&r1=1335720&r2=1335721&view=diff
==============================================================================
--- openjpa/branches/2.2.x/openjpa-project/src/doc/manual/ref_guide_pc.xml (original)
+++ openjpa/branches/2.2.x/openjpa-project/src/doc/manual/ref_guide_pc.xml Tue May  8 19:47:10
2012
@@ -1485,6 +1485,23 @@ if you attempt to add an element to a co
 to the element type declared in metadata.  Defaults to <literal>false</literal>.
                         </para>
                     </listitem>
+                    <listitem>
+                        <para>
+<literal>DelayCollectionLoading</literal>: Whether to delay loading elements
of a
+lazily loaded collection.  Delay loading allows non-indexed add and remove
+operations to occur without prior loading of the collection from the data store.  This can
+improve performance of some applications by allowing them to perform simple add or remove
+operations on collections without requiring them to be loaded. Delayed proxies are
+loaded when an operation is performed that requires loading, such
+as iteration, size, serialization, and indexOf.  They can also be loaded by casting the
+proxy to a <ulink url="../javadoc/org/apache/openjpa/util/DelayedProxy.html"><classname>
+org.apache.openjpa.util.DelayedProxy</classname></ulink> and invoking the
+<methodname>load</methodname> method. If a broker factory is available after
detaching the owning
+entity, a collection may be available for delayed loading after the persistence context has
been
+cleared. In post-detachment, entities that are loaded are not associated with a persistence
context.
+Defaults to <literal>false</literal>.
+                        </para>
+                    </listitem>
                 </itemizedlist>
                 <para>
 The default proxy manager can proxy the standard methods of any 



Mime
View raw message