[jboss-cvs] jboss-seam/src/main/org/jboss/seam/transaction ...
Gavin King
gavin.king at jboss.com
Thu Jun 21 00:36:14 EDT 2007
User: gavin
Date: 07/06/21 00:36:14
Modified: src/main/org/jboss/seam/transaction Transaction.java
Log:
javadoc
Revision Changes Path
1.8 +11 -2 jboss-seam/src/main/org/jboss/seam/transaction/Transaction.java
(In the diff below, changes in quantity of whitespace are not shown.)
Index: Transaction.java
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/src/main/org/jboss/seam/transaction/Transaction.java,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -b -r1.7 -r1.8
--- Transaction.java 20 Jun 2007 17:45:58 -0000 1.7
+++ Transaction.java 21 Jun 2007 04:36:14 -0000 1.8
@@ -16,8 +16,17 @@
import org.jboss.seam.util.Naming;
/**
- * Abstracts all possible transaction management APIs
- * behind a JTA-compatible interface.
+ * Abstracts all possible transaction management APIs behind a
+ * JTA-compatible interface. Unfortunately, many
+ * otherwise-perfectly-intelligent-looking Java developers like
+ * to invent their own transaction management APIs when they get
+ * bored, even though JTA is well-known to be more than good
+ * enough. For example, one of the co-authors of this class was
+ * present at the creation of not one but two "alternative"
+ * transaction APIs (org.hibernate.Transaction and
+ * javax.persistence.EntityTransaction), and is more
+ * embarrassed by this than by any other of his many professional
+ * blunders.
*
* @author Mike Youngstrom
* @author Gavin King
More information about the jboss-cvs-commits
mailing list