+
+ <section name="Maven POM configuration">
+ <p>To configure your pom, you must configure three dependencies: </p>
+ <ul>
+ <li>The general JPA test support library.</li>
+ <li>A JPA implementation-specific library.</li>
+ <li>The dependency on your specific JPA provider.</li>
+ </ul>
+ <p> The above 'three stage rocket' is necessary because: </p>
+ <ul>
+ <li>Customizations to the persistence unit for different JPA providers might conflict and
+ might require additional JPA provider specific dependencies.</li>
+ <li>Different JPA providers can, in general, not be used within the same application. (an
+ exception is of course an OSGI environment when JPA is used as per the OSGI enterprise
+ spec). </li>
+ <li>The specific JPA implementation and version to use <em>must</em> be determined by you
+ and not by the test support library. </li>
+ </ul>
+
+ <subsection name="The general JPA test support library">
+ <p>Always include the dependency below: </p>
+ <table>
+ <tr>
+ <th>groupId</th>
+ <th>artifactId</th>
+ </tr>
+ <tr>
+ <td>org.wamblee</td>
+ <td>wamblee-test-enterprise</td>
+ </tr>
+ </table>
+ </subsection>
+
+ <subsection name="JPA implementation-specific library">
+ <p>Choose one from the choices below: </p>
+ <table>
+ <tr>
+ <th>Provider</th>
+ <th>groupId</th>
+ <th>artifactId</th>
+ </tr>
+ <tr>
+ <td>Eclipse link</td>
+ <td>org.wamblee</td>
+ <td>wamblee-test-eclipselink</td>
+ </tr>
+ <tr>
+ <td>Toplink</td>
+ <td>org.wamblee</td>
+ <td>wamblee-test-toplink-essentials</td>
+ </tr>
+ <tr>
+ <td>Hibernate (from 3.4.0.GA and higher).</td>
+ <td>org.wamblee</td>
+ <td>wamblee-test-hibernate</td>
+ </tr>
+ </table>
+ </subsection>
+ </section>
+