[jboss-cvs] JBossCache/docs/TreeCache/en/modules ...

[Brian Stansberry]

  User: bstansberry
  Date: 07/01/29 22:20:16

  Modified:    docs/TreeCache/en/modules   Tag: Branch_JBossCache_1_4_0
                        configuration.xml transactions.xml
  Log:
  [JBCACHE-955] Add LockParentForChildInsertRemove
  
  Revision  Changes    Path
  No                   revision
  
  
  No                   revision
  
  
  1.10.2.4  +16 -0     JBossCache/docs/TreeCache/en/modules/Attic/configuration.xml
  
  (In the diff below, changes in quantity of whitespace are not shown.)
  
  Index: configuration.xml
  ===================================================================
  RCS file: /cvsroot/jboss/JBossCache/docs/TreeCache/en/modules/Attic/configuration.xml,v
  retrieving revision 1.10.2.3
  retrieving revision 1.10.2.4
  diff -u -b -r1.10.2.3 -r1.10.2.4
  --- configuration.xml	7 Dec 2006 22:35:39 -0000	1.10.2.3
  +++ configuration.xml	30 Jan 2007 03:20:16 -0000	1.10.2.4
  @@ -44,6 +44,9 @@
       -->
       <attribute name="IsolationLevel">REPEATABLE_READ</attribute>
   
  +    <!-- Lock parent before doing node additions/removes -->
  +    <attribute name="LockParentForChildInsertRemove">true</attribute>
  +
       <!--     Valid modes are LOCAL
                                REPL_ASYNC
                                REPL_SYNC
  @@ -376,6 +379,19 @@
   
              <row>
                 <entry>
  +                <para>LockParentForChildInsertRemove</para>
  +             </entry>
  +
  +             <entry>
  +                <para>Whether inserting or removing a node requires a write lock
  +                on the node's parent (when pessimistic locking is used.) Default
  +                is <literal>true</literal>
  +                </para>
  +             </entry>
  +          </row>
  +
  +           <row>
  +              <entry>
                    <para>MultiplexerService</para>
                 </entry>
   
  
  
  
  1.2.4.2   +16 -0     JBossCache/docs/TreeCache/en/modules/Attic/transactions.xml
  
  (In the diff below, changes in quantity of whitespace are not shown.)
  
  Index: transactions.xml
  ===================================================================
  RCS file: /cvsroot/jboss/JBossCache/docs/TreeCache/en/modules/Attic/transactions.xml,v
  retrieving revision 1.2.4.1
  retrieving revision 1.2.4.2
  diff -u -b -r1.2.4.1 -r1.2.4.2
  --- transactions.xml	9 Jul 2006 17:16:36 -0000	1.2.4.1
  +++ transactions.xml	30 Jan 2007 03:20:16 -0000	1.2.4.2
  @@ -112,6 +112,22 @@
   		    </orderedlist>
   		
   		</section>
  +         
  +         <section>
  +             <title>Insertion and Removal of Nodes</title>
  +         
  +	         <para>
  +	         By default, before inserting a new node into the tree or removing an existing node from the
  +	         tree, JBoss Cache will attempt to acquire a write lock on the new node's parent node.  This
  +	         approach treats child nodes as an integral part of a parent node's state. This approach
  +	         provide greater correctness, but at a cost of lesser concurrency if nodes are frequently
  +	         added or removed. For use cases where this greater correctness is not meaningful, JBoss
  +	         Cache provides a configuration option <literal>LockParentForChildInsertRemove</literal>.
  +	         If this is set to <literal>false</literal>, insertions and removals of child nodes only
  +	         require the acquisition of a <emphasis>read lock</emphasis> on the parent node.
  +	         </para>
  +         </section>
  +         
   	</section>
   
   	<section><title>Optimistic locking</title>