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>
+ <property name="openjpa.DataCache" value="true(ExcludedTypes=foo.bar.Person;foo.bar.Employee)"/>
+ </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>
+ <property name="openjpa.DataCache" value="true(Types=foo.bar.FullTimeEmployee)"/>
+ </programlisting>
+ </para>
+ </example>
<para>
See the <ulink url="../javadoc/org/apache/openjpa/persistence/DataCache.html">
<classname>org.apache.openjpa.persistence.DataCache</classname></ulink> Javadoc