[exo-jcr-commits] exo-jcr SVN: r1536 - jcr/trunk/exo.jcr.component.core/src/main/java/org/exoplatform/services/jcr/impl/core/lock/jbosscache.

[do-not-reply at jboss.org]

Author: nfilotto
Date: 2010-01-22 03:13:52 -0500 (Fri, 22 Jan 2010)
New Revision: 1536

Modified:
   jcr/trunk/exo.jcr.component.core/src/main/java/org/exoplatform/services/jcr/impl/core/lock/jbosscache/CacheableLockManager.java
Log:
EXOJCR-424: Add comments

Modified: jcr/trunk/exo.jcr.component.core/src/main/java/org/exoplatform/services/jcr/impl/core/lock/jbosscache/CacheableLockManager.java
===================================================================
--- jcr/trunk/exo.jcr.component.core/src/main/java/org/exoplatform/services/jcr/impl/core/lock/jbosscache/CacheableLockManager.java	2010-01-21 20:14:07 UTC (rev 1535)
+++ jcr/trunk/exo.jcr.component.core/src/main/java/org/exoplatform/services/jcr/impl/core/lock/jbosscache/CacheableLockManager.java	2010-01-22 08:13:52 UTC (rev 1536)
@@ -56,6 +56,7 @@
 import org.jboss.cache.DefaultCacheFactory;
 import org.jboss.cache.Fqn;
 import org.jboss.cache.Node;
+import org.jboss.cache.loader.CacheLoader;
 import org.picocontainer.Startable;
 
 import java.io.Serializable;
@@ -983,8 +984,10 @@
    }
    
    /**
-    * Execute the given action outside a transaction
-    * @throws LockException 
+    * Execute the given action outside a transaction. This is needed since the {@link Cache} used by {@link CacheableLockManager}
+    * manages the persistence of its locks thanks to a {@link CacheLoader} and a {@link CacheLoader} lock the JBoss cache {@link Node}
+    * even for read operations which cause deadlock issue when a XA {@link Transaction} is already opened
+    * @throws LockException when a exception occurs
     */
    private <R, A> R executeLockActionNonTxAware(LockActionNonTxAware<R, A> action, A arg) throws LockException
    {