X-Git-Url: http://wamblee.org/gitweb/?a=blobdiff_plain;f=test%2Fenterprise%2Fsrc%2Fsite%2Fxdoc%2Findex.xml;h=49f8f8dbc144b64346e526aa702616b3fa6c7184;hb=cb91054f35281c6fc5619f93ff71df46bf4686b9;hp=44fc196b604781bf625a1f363cd8b2e2d955a315;hpb=9cd9d0f6f0dc9c27faa2a173b657cfe715e2d34d;p=utils diff --git a/test/enterprise/src/site/xdoc/index.xml b/test/enterprise/src/site/xdoc/index.xml index 44fc196b..49f8f8db 100644 --- a/test/enterprise/src/site/xdoc/index.xml +++ b/test/enterprise/src/site/xdoc/index.xml @@ -2,50 +2,79 @@ - + user guide Erik Brakkee -
-

Part of the wamblee.org utilities library are test utilities for Java EE development. - Currently, the following utilities are provided:

+
+

Several utilities are provide for Java EE testing:

    -
  • JPA testing: Simple out of the box unit testing with JPA connecting to an inmemory - database or an external database.
    • -
  • JNDI based test support: In particular mocking JNDI in unit test.
    • +
  • transactions
    • +
  • jndi
    • +
  • Persistence
- - - - - - - - - - - - -
- -
-
- +
- - - - - +

To configure your pom, you must configure three dependencies:

+
    +
  • The general JPA test support library.
    • +
  • A JPA implementation-specific library.
    • +
  • The dependency on your specific JPA provider.
    • +
+

The above 'three stage rocket' is necessary because:

+
    +
  • Customizations to the persistence unit for different JPA providers might conflict and + might require additional JPA provider specific dependencies.
    • +
  • 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).
    • +
  • The specific JPA implementation and version to use must be determined by you + and not by the test support library.
    • +
+ + +

Always include the dependency below:

+ + + + + + + + + +
groupIdartifactId
org.wambleewamblee-test-enterprise
 - - + + +

Choose one from the choices below:

+ + + + + + + + + + + + + + + + + + + + + +
ProvidergroupIdartifactId
Eclipse linkorg.wambleewamblee-test-eclipselink
Toplinkorg.wambleewamblee-test-toplink
Hibernate (from 3.4.0.GA and higher).org.wambleewamblee-test-hibernate
- + -