X-Git-Url: http://wamblee.org/gitweb/?a=blobdiff_plain;f=test%2Fenterprise%2Fsrc%2Fmain%2Fjava%2Forg%2Fwamblee%2Ftest%2Fpersistence%2Fpackage-info.java;h=7c7a4c4d6d7f8d2171e3e12353eeb802f81d5b57;hb=ad1fd8aecbeebe81befc0b39184ff5026451ef74;hp=3005512588ce7977c69e07eff61a88e0ef158127;hpb=cb91054f35281c6fc5619f93ff71df46bf4686b9;p=utils

diff --git a/test/enterprise/src/main/java/org/wamblee/test/persistence/package-info.java b/test/enterprise/src/main/java/org/wamblee/test/persistence/package-info.java
index 30055125..7c7a4c4d 100644
--- a/test/enterprise/src/main/java/org/wamblee/test/persistence/package-info.java
+++ b/test/enterprise/src/main/java/org/wamblee/test/persistence/package-info.java
@@ -12,7 +12,7 @@
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 /**
  * <p>
  * This package provides test library for database testing in general and JPA testing
@@ -39,6 +39,8 @@
  *   </li>
  *   <li> <a href="#db-jpa-services">Testing a service that requires a transaction</a>
  *   </li>
+ *   <li> <a href="#db-user-transaction">Controlling transactions through a <code>UserTransaction</code></a>
+ *   </li>
  * </ul>
  * 
  * <p>
@@ -166,6 +168,12 @@
  *      });
  * </pre>
  * 
+ * <p>
+ *   Note that in addition to this method it is also possible to directly control transactions
+ *   through {@link JpaBuilder#begin()}, {@link JpaBuilder#commit(javax.persistence.EntityManager)}, 
+ *   and {@link JpaBuilder#rollback(javax.persistence.EntityManager)}. 
+ * </p>
+ * 
  * <a name="db-jpa-plus-jdbc">
  *   <h2>JPA testing combined with JDBC and DBUnit</h2>
  * </a>
@@ -197,7 +205,18 @@
  * is in fact a so-called contextual reference.
  * Next, the proxy is obtained from the factory. Invoking any method on it will make sure a new 
  * transaction is started and a new entity manager is created for the scope of that transaction.
- * </p> 
+ * </p>
+ * 
+ * <a name="db-user-transaction">
+ *   <h2>Controlling transactions through a <code>UserTransaction</h2>
+ * </a>
+ * 
+ * <p>
+ * It is also possible to manage JPA transaction through a <code>UserTransaction</code>. 
+ * This is mostly useful if you are test software that uses <code>UserTransaction</code> for 
+ * managing transactions, or if you want to manage multiple transactional resources. 
+ * See the explanation at {@link org.wamblee.test.transactions.SimpleTransactionManager} for more details. 
+ * </p>
  * 
  * <a name="design-overview">
  *   <h2>Design overview</h2>
@@ -246,4 +265,3 @@
  */
 package org.wamblee.test.persistence;
 
-