[Hibernate-commits] Hibernate2/doc/reference/src advanced_or_mapping.xml,1.13,1.14

[<one...@us...>]

Update of /cvsroot/hibernate/Hibernate2/doc/reference/src
In directory sc8-pr-cvs1:/tmp/cvs-serv9603/reference/src

Modified Files:
	advanced_or_mapping.xml 
Log Message:
documented nonstrict-read-write cache

Index: advanced_or_mapping.xml
===================================================================
RCS file: /cvsroot/hibernate/Hibernate2/doc/reference/src/advanced_or_mapping.xml,v
retrieving revision 1.13
retrieving revision 1.14
diff -C2 -d -r1.13 -r1.14
*** advanced_or_mapping.xml	29 Mar 2003 13:31:22 -0000	1.13
--- advanced_or_mapping.xml	6 Apr 2003 11:03:12 -0000	1.14
***************
*** 968,980 ****
              <programlistingco>
                  <areaspec>
!                     <area id="cache1" coords="1 40"/>
                  </areaspec>
!                 <programlisting><![CDATA[<jcs-cache usage="read-write|read-only" />]]></programlisting>
                  <calloutlist>
                      <callout arearefs="cache1">
                          <para>
!                             <literal>usage</literal> specifies the caching strategy
!                             (<literal>read-write</literal>,
!                             <literal>read-only</literal>)
                          </para>
                      </callout>                   
--- 968,981 ----
              <programlistingco>
                  <areaspec>
!                     <area id="cache1" coords="1 61"/>
                  </areaspec>
!                 <programlisting><![CDATA[<jcs-cache usage="read-write|nonstrict-read-write|read-only" />]]></programlisting>
                  <calloutlist>
                      <callout arearefs="cache1">
                          <para>
!                             <literal>usage</literal> specifies the caching strategy:
!                             <literal>read-write</literal>,
!                             <literal>nonstrict-read-write</literal> or
!                             <literal>read-only</literal>
                          </para>
                      </callout>                   
***************
*** 1025,1028 ****
--- 1026,1044 ----
      </set>
  </class>]]></programlisting>
+ 
+         </sect2>
+ 
+         <sect2 id="adv-or-mapping-s3-3">
+             <title>Nonstrict Read / Write Cache</title>
+ 
+             <para>
+                 If the application occasionally needs to update data and strict transaction isolation is
+                 not required, a <literal>nonstrict-read-write</literal> cache might be appropriate. This cache 
+                 may be used in a clustered environment when JCS distributed caching is configured. If the 
+                 cache is used in a JTA environment, you must specify
+                 <literal>hibernate.transaction.manager_lookup_class</literal>. In other environments, you should 
+                 ensure that the transaction is completed when <literal>Session.close()</literal> or
+                 <literal>Session.disconnect()</literal> is called.
+             </para>
  
          </sect2>