You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openjpa.apache.org by pc...@apache.org on 2007/03/01 07:43:00 UTC
svn commit: r513189 - in
/incubator/openjpa/trunk/openjpa-project/src/doc/manual:
ref_guide_optimization.xml ref_guide_runtime.xml
Author: pcl
Date: Wed Feb 28 22:43:00 2007
New Revision: 513189
URL: http://svn.apache.org/viewvc?view=rev&rev=513189
Log:
OPENJPA-160. Docs updates.
Modified:
incubator/openjpa/trunk/openjpa-project/src/doc/manual/ref_guide_optimization.xml
incubator/openjpa/trunk/openjpa-project/src/doc/manual/ref_guide_runtime.xml
Modified: incubator/openjpa/trunk/openjpa-project/src/doc/manual/ref_guide_optimization.xml
URL: http://svn.apache.org/viewvc/incubator/openjpa/trunk/openjpa-project/src/doc/manual/ref_guide_optimization.xml?view=diff&rev=513189&r1=513188&r2=513189
==============================================================================
--- incubator/openjpa/trunk/openjpa-project/src/doc/manual/ref_guide_optimization.xml (original)
+++ incubator/openjpa/trunk/openjpa-project/src/doc/manual/ref_guide_optimization.xml Wed Feb 28 22:43:00 2007
@@ -574,7 +574,8 @@
</para>
</entry>
<entry colname="desc">
-By default, OpenJPA's EntityManagers use finalizers to ensure that resources
+Outside of a Java EE 5 application server or other JPA persistence container,
+OpenJPA's EntityManagers use finalizers to ensure that resources
get cleaned up. If you are properly managing your resources, this finalization
is not necessary, and will introduce unneeded synchronization, leading to
scalability problems. You can disable this protective behavior by setting the
Modified: incubator/openjpa/trunk/openjpa-project/src/doc/manual/ref_guide_runtime.xml
URL: http://svn.apache.org/viewvc/incubator/openjpa/trunk/openjpa-project/src/doc/manual/ref_guide_runtime.xml?view=diff&rev=513189&r1=513188&r2=513189
==============================================================================
--- incubator/openjpa/trunk/openjpa-project/src/doc/manual/ref_guide_runtime.xml (original)
+++ incubator/openjpa/trunk/openjpa-project/src/doc/manual/ref_guide_runtime.xml Wed Feb 28 22:43:00 2007
@@ -119,14 +119,16 @@
</secondary>
</indexterm>
<para>
-The default OpenJPAEntityManager implementation automatically closes itself
-during instance finalization. This guards against accidental resource leaks
-that may occur if a developer fails to explicitly close EntityManagers when
-finished with them, but it also incurs a scalability bottleneck, since the
-JVM must perform synchronization during instance creation, and since the
-finalizer thread will have more instances to monitor. To avoid this overhead,
-set the <link linkend="openjpa.BrokerImpl"><literal>openjpa.BrokerImpl</literal>
-</link> configuration property to <literal>non-finalizing</literal>.
+Outside of a Java EE 5 application server or other JPA persistence container
+environment, the default OpenJPAEntityManager implementation automatically
+closes itself during instance finalization. This guards against accidental
+resource leaks that may occur if a developer fails to explicitly close
+EntityManagers when finished with them, but it also incurs a scalability
+bottleneck, since the JVM must perform synchronization during instance creation,
+and since the finalizer thread will have more instances to monitor. To avoid
+this overhead, set the
+<link linkend="openjpa.BrokerImpl"><literal>openjpa.BrokerImpl</literal></link>
+configuration property to <literal>non-finalizing</literal>.
</para>
</section>
<section id="ref_guide_runtime_broker_extension">