openjpa-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From curti...@apache.org
Subject svn commit: r946733 - in /openjpa/branches/2.0.x: ./ openjpa-project/src/doc/manual/ref_guide_meta.xml openjpa-project/src/doc/manual/ref_guide_optimization.xml openjpa-project/src/doc/manual/ref_guide_remote.xml
Date Thu, 20 May 2010 18:05:01 GMT
Author: curtisr7
Date: Thu May 20 18:05:01 2010
New Revision: 946733

URL: http://svn.apache.org/viewvc?rev=946733&view=rev
Log:
OPENJPA-1673: Update 2.0.x docs for MetaDataRepository.

Modified:
    openjpa/branches/2.0.x/   (props changed)
    openjpa/branches/2.0.x/openjpa-project/src/doc/manual/ref_guide_meta.xml
    openjpa/branches/2.0.x/openjpa-project/src/doc/manual/ref_guide_optimization.xml
    openjpa/branches/2.0.x/openjpa-project/src/doc/manual/ref_guide_remote.xml

Propchange: openjpa/branches/2.0.x/
------------------------------------------------------------------------------
--- svn:mergeinfo (original)
+++ svn:mergeinfo Thu May 20 18:05:01 2010
@@ -1,2 +1,2 @@
 /openjpa/branches/1.0.x:736493
-/openjpa/trunk:934507,935033,935035,935073-935074,936436,936445
+/openjpa/trunk:934507,935033,935035,935073-935074,936436,936445,946726

Modified: openjpa/branches/2.0.x/openjpa-project/src/doc/manual/ref_guide_meta.xml
URL: http://svn.apache.org/viewvc/openjpa/branches/2.0.x/openjpa-project/src/doc/manual/ref_guide_meta.xml?rev=946733&r1=946732&r2=946733&view=diff
==============================================================================
--- openjpa/branches/2.0.x/openjpa-project/src/doc/manual/ref_guide_meta.xml (original)
+++ openjpa/branches/2.0.x/openjpa-project/src/doc/manual/ref_guide_meta.xml Thu May 20 18:05:01
2010
@@ -126,23 +126,18 @@ scanned for annotated JPA entities.
 		<itemizedlist>
 		<listitem><para>
 			<literal>Preload</literal>: A boolean property. If true, OpenJPA will eagerly
load the repository on 
-			EntityManagerFactory creation. As a result, all Entity classes will be eagerly loaded
by the JVM. If 
-			false, the repository will be lazily loaded as Entity classes are loaded by the JVM. The
default value 
-			is false.
+			EntityManagerFactory creation. As a result, all Entity classes will be eagerly loaded
by the JVM. 
+                        Once MetaData preloading completes, all locking is removed from the
MetaDataRepository and this will 
+                        result in a much more scalable repository. If false, the repository
will be lazily loaded as Entity 
+                        classes are loaded by the JVM. The default value is false.
 			</para>
-            	</listitem>
-		<listitem><para>
-			<literal>NoLock</literal>: If true, the repository will be treated as a read
only data structure and 
-			minimal locking will be imposed on users. Preload must be set to true for OpenJPA to honor
setting 
-			NoLock to true. The default value is false.
-			</para>
-            	</listitem>            	
+            	</listitem>           	
             	</itemizedlist>
         	
 	        <title>Metadata Repository</title>
 	        <example id="ref_guide_meta_repo">
 <programlisting>
-&lt;property name="openjpa.MetaDataRepository" value="Preload=true,NoLock=true"/&gt;
+&lt;property name="openjpa.MetaDataRepository" value="Preload=true"/&gt;
 </programlisting>
 	        </example>
 	</section>

Modified: openjpa/branches/2.0.x/openjpa-project/src/doc/manual/ref_guide_optimization.xml
URL: http://svn.apache.org/viewvc/openjpa/branches/2.0.x/openjpa-project/src/doc/manual/ref_guide_optimization.xml?rev=946733&r1=946732&r2=946733&view=diff
==============================================================================
--- openjpa/branches/2.0.x/openjpa-project/src/doc/manual/ref_guide_optimization.xml (original)
+++ openjpa/branches/2.0.x/openjpa-project/src/doc/manual/ref_guide_optimization.xml Thu May
20 18:05:01 2010
@@ -606,6 +606,21 @@ scalability problems. You can disable th
 linkend="ref_guide_runtime_broker_finalization"/> for details.
                     </entry>
                 </row>
+                <row>
+                    <entry colname="name">
+                        <emphasis role="bold">
+                            Preload MetaDataRepository
+                        </emphasis>
+                        <para>
+<emphasis>scalability</emphasis>
+                        </para>
+                    </entry>
+                    <entry colname="desc">
+By default, the MetaDataRepository is lazily loaded which means that fair amounts of locking
+is used to ensure that metadata is processed properly. Enabling preloading allows OpenJPA
to
+load metadata upfront and remove locking. See <xref linkend="ref_guide_meta_repository"/>
for details.
+                    </entry>
+                </row>                
             </tbody>
         </tgroup>
     </table>

Modified: openjpa/branches/2.0.x/openjpa-project/src/doc/manual/ref_guide_remote.xml
URL: http://svn.apache.org/viewvc/openjpa/branches/2.0.x/openjpa-project/src/doc/manual/ref_guide_remote.xml?rev=946733&r1=946732&r2=946733&view=diff
==============================================================================
--- openjpa/branches/2.0.x/openjpa-project/src/doc/manual/ref_guide_remote.xml (original)
+++ openjpa/branches/2.0.x/openjpa-project/src/doc/manual/ref_guide_remote.xml Thu May 20
18:05:01 2010
@@ -354,7 +354,7 @@ use detached state managers, as determin
 DetachState setting.</emphasis> Detach all fields and relations as described by the
loaded 
 property when an explicit detach is requested or when a 
 single Entity is being detached as part of serialization. When the entire 
-persistence context is being auto-detached(@See openjpa.AutoDetach), 
+persistence context is being auto-detached ( <literal>openjpa.AutoDetach</literal>
), 
 the minimal amount of work will be completed to disassociate all Entities from 
 the persistence context. <emphasis role="bold">It is highly recommended that all Entities
have a 
 @Version field when using this property</emphasis>. In addition, care needs to be taken




Mime
View raw message