The purpose of this library is to provide an out-of-the box configuration for testing code that relies on JPA. While there are many other libraries for that purpuse the specific goals of this one are:

• test the real persistence.xml instead of a separate one just for testing (so that they don't get out of sync)
• Fast teardown of test-database (Only records are deleted, dbs are reused)
• Out-of-the-box memory-db config that is easy to use

• Install JDK 7 or higher

You can install Oracle JDK or OpenJDK depending on the OS you use. Other JVM implementations should also work, but are untested.

• Install Maven 3 or higher

Be sure to follow the provided installation instructions

• configure JAVA_HOME and PATH environment variables

make sure the JAVA_HOME environment variable points to the path of your JDK installation and that both javac and mvn are available in your PATH-variable

• Run mvn install from the project's root directory

That's it.

With maven add this dependency to your pom.xml:

<dependency>
  <groupId>org.openengsb.labs.jpatest</groupId>
  <artifactId>jpa-test-core</artifactId>
  <scope>test</scope>
  <version>LATEST_JPATEST_VERSION</version>
</dependency>

To use EntityManagers in your junit-tests include the Rule in your tests like this:

@Rule
public final TestPersistenceUnit testPersistenceUnit = new TestPersistenceUnit();

@Test
public void myTest throws Exception {
  EntityManager em = testPersistenceUnit.getPersistenceUnit("my-persistence-unit")
  // do stuff with our em
}

Right now the library will only work testing with OpenJPA and H2Database. While this might sound as a no go for your project consider that most of your JPA tests will tackle if your queries are correct JPA provider and database independent. So, while this might not be a 100% match it will (in many cases) still provider ways better results than going without it.