package rename for test libraries.
[utils] / test / enterprise / src / site / xdoc / index.xml
1 <?xml version="1.0"?>
2 <document xmlns="http://maven.apache.org/XDOC/2.0"
3   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4   xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
5
6   <properties>
7     <title>user guide</title>
8     <author email="erik@brakkee.org">Erik Brakkee</author>
9   </properties>
10   <body>
11     <section name="Introduction">
12       <p>Several utilities are provide for Java EE testing: </p>
13       <ul>
14         <li><a href="apidocs/org/wamblee/test/transactionspackage-summary.html">transactions</a></li>
15         <li><a href="apidocs/org/wamblee/test/jndi/package-summary.html">jndi</a></li>
16         <li><a href="apidocs/org/wamblee/test/persistence/package-summary.html">Persistence</a></li>
17       </ul>
18     </section>
19
20     <section name="Maven POM configuration">
21       <p>To configure your pom, you must configure three dependencies: </p>
22       <ul>
23         <li>The general JPA test support library.</li>
24         <li>A JPA implementation-specific library.</li>
25         <li>The dependency on your specific JPA provider.</li>
26       </ul>
27       <p> The above 'three stage rocket' is necessary because: </p>
28       <ul>
29         <li>Customizations to the persistence unit for different JPA providers might conflict and
30           might require additional JPA provider specific dependencies.</li>
31         <li>Different JPA providers can, in general, not be used within the same application. (an
32           exception is of course an OSGI environment when JPA is used as per the OSGI enterprise
33           spec). </li>
34         <li>The specific JPA implementation and version to use <em>must</em> be determined by you
35           and not by the test support library. </li>
36       </ul>
37       
38       <subsection name="The general JPA test support library">
39         <p>Always include the dependency below: </p>
40         <table>
41           <tr>
42             <th>groupId</th>
43             <th>artifactId</th>
44           </tr>
45           <tr>
46             <td>org.wamblee</td>
47             <td>wamblee-test-enterprise</td>
48           </tr>
49         </table>
50       </subsection>
51       
52       <subsection name="JPA implementation-specific library">
53         <p>Choose one from the choices below: </p>
54         <table>
55           <tr>
56             <th>Provider</th>
57             <th>groupId</th>
58             <th>artifactId</th>
59           </tr>
60           <tr>
61             <td>Eclipse link</td>
62             <td>org.wamblee</td>
63             <td>wamblee-test-eclipselink</td>
64           </tr>
65           <tr>
66             <td>Toplink</td>
67             <td>org.wamblee</td>
68             <td>wamblee-test-toplink</td>
69           </tr>
70           <tr>
71             <td>Hibernate (from 3.4.0.GA and higher).</td>
72             <td>org.wamblee</td>
73             <td>wamblee-test-hibernate</td>
74           </tr>
75         </table>
76       </subsection>
77     </section>
78
79   </body>
80 </document>