You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openjpa.apache.org by mi...@apache.org on 2010/02/11 00:01:45 UTC

svn commit: r908729 - /openjpa/trunk/openjpa-project/src/doc/manual/ref_guide_caching.xml

Author: mikedd
Date: Wed Feb 10 23:01:42 2010
New Revision: 908729

URL: http://svn.apache.org/viewvc?rev=908729&view=rev
Log:
Add doc for datacache inclusion/exclusion

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

Modified: openjpa/trunk/openjpa-project/src/doc/manual/ref_guide_caching.xml
URL: http://svn.apache.org/viewvc/openjpa/trunk/openjpa-project/src/doc/manual/ref_guide_caching.xml?rev=908729&r1=908728&r2=908729&view=diff
==============================================================================
--- openjpa/trunk/openjpa-project/src/doc/manual/ref_guide_caching.xml (original)
+++ openjpa/trunk/openjpa-project/src/doc/manual/ref_guide_caching.xml Wed Feb 10 23:01:42 2010
@@ -258,6 +258,44 @@
 }
 </programlisting>
             </example>
+
+            <para>
+            <indexterm>
+                <primary>caching</primary>
+                <secondary>exclusions</secondary>
+            </indexterm>
+            Entities may be explicitly excluded from the cache by providing a list of fully qualified class names in the ExcludedTypes argument. The entities provided via ExcludedTypes will not be cached regardless of the @DataCache annotation. 
+            </para>
+            <example id="ex_exclude_types_from_cache">
+                <title>
+                    Excluding entities
+                </title>
+                <para>
+                    Exclude entities foo.bar.Person and foo.bar.Employee from the cache. 
+                    <programlisting>
+                    &lt;property name="openjpa.DataCache" value="true(ExcludedTypes=foo.bar.Person;foo.bar.Employee)"/&gt;
+                    </programlisting>
+                </para>
+            </example>
+
+            <para>
+            <indexterm>
+                <primary>caching</primary>
+                <secondary>inclusions</secondary>
+            </indexterm>
+            Entities may be explicitly included from the cache by providing a list of fully qualified class names in the Types argument. The entities provided via ExcludedTypes will not cached regardless of the @DataCache annotation. Any entities which are not included in this list will not be cached. 
+            </para>
+            <example id="ex_include_types_in_cache">
+                <title>
+                    Including entities
+                </title>
+                <para>
+                    Include only entity foo.bar.FullTimeEmployee from the cache. 
+                    <programlisting>
+                    &lt;property name="openjpa.DataCache" value="true(Types=foo.bar.FullTimeEmployee)"/&gt;
+                    </programlisting>
+                </para>
+            </example>
             <para>
 See the <ulink url="../javadoc/org/apache/openjpa/persistence/DataCache.html">
 <classname>org.apache.openjpa.persistence.DataCache</classname></ulink> Javadoc