You are viewing a plain text version of this content. The canonical link for it is here.

Posted to commits@myfaces.apache.org by st...@apache.org on 2011/09/17 11:30:39 UTC

svn commit: r1171931 - /myfaces/extensions/cdi/trunk/jee-modules/jpa-module/impl/src/main/java/org/apache/myfaces/extensions/cdi/jpa/impl/DefaultTransactionalInterceptorStrategy.java

Author: struberg
Date: Sat Sep 17 09:30:39 2011
New Revision: 1171931

URL: http://svn.apache.org/viewvc?rev=1171931&view=rev
Log:
EXTCDI-223 improve JavaDoc

Modified:
    myfaces/extensions/cdi/trunk/jee-modules/jpa-module/impl/src/main/java/org/apache/myfaces/extensions/cdi/jpa/impl/DefaultTransactionalInterceptorStrategy.java

Modified: myfaces/extensions/cdi/trunk/jee-modules/jpa-module/impl/src/main/java/org/apache/myfaces/extensions/cdi/jpa/impl/DefaultTransactionalInterceptorStrategy.java
URL: http://svn.apache.org/viewvc/myfaces/extensions/cdi/trunk/jee-modules/jpa-module/impl/src/main/java/org/apache/myfaces/extensions/cdi/jpa/impl/DefaultTransactionalInterceptorStrategy.java?rev=1171931&r1=1171930&r2=1171931&view=diff
==============================================================================
--- myfaces/extensions/cdi/trunk/jee-modules/jpa-module/impl/src/main/java/org/apache/myfaces/extensions/cdi/jpa/impl/DefaultTransactionalInterceptorStrategy.java (original)
+++ myfaces/extensions/cdi/trunk/jee-modules/jpa-module/impl/src/main/java/org/apache/myfaces/extensions/cdi/jpa/impl/DefaultTransactionalInterceptorStrategy.java Sat Sep 17 09:30:39 2011
@@ -45,7 +45,18 @@ import java.lang.annotation.Annotation;
 import java.lang.reflect.Field;
 
 /**
+ * <p>Default implementation of our pluggable PersistenceStrategy.
+ * It supports nested Transactions with the MANDATORY behaviour.</p>
  *
+ * <p>The outermost &#064;Transactional interceptor for the given
+ * {@link javax.inject.Qualifier} will open an {@link EntityTransaction}
+ * and the outermost &#064;Transactional interceptor for <b>all</b>
+ * EntityManagers will flush and subsequently close all open transactions.</p>
+ *
+ * <p>If an Exception occurs in flushing the EntityManagers or any other Exception
+ * gets thrown inside the intercepted method chain and <i>not</i> gets catched
+ * until the outermost &#064;Transactional interceptor gets reached, then all
+ * open transactions will get rollbacked.</p>
  */
 @Dependent
 public class DefaultTransactionalInterceptorStrategy implements PersistenceStrategy