net.sf.javagimmicks.jpa.testing

Class AbstractJpaTestRule

java.lang.Object

org.junit.rules.ExternalResource

net.sf.javagimmicks.jpa.testing.AbstractJpaTestRule

All Implemented Interfaces:

org.junit.rules.TestRule

Direct Known Subclasses:

DerbyJpaTestRule, H2JpaTestRule, HsqlJpaTestRule

public abstract class AbstractJpaTestRule
extends org.junit.rules.ExternalResource

A JUnit TestRule that creates a temporary file-based database (using an AbstractDbTestRule instance) during test execution and wraps Spring/Hibernate based local JPA container around it.

The developer can influence the temporary folder, where the database should be created and/or can provide initial configuration logic for the used BasicDataSource and LocalContainerEntityManagerFactoryBean via a AbstractJpaTestRule.EntityManagerFactoryConfigurator.

There is no need for a persistence.xml file for test execution, instead a list of package names must be provided that will automatically be scanned for entity classes.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	AbstractJpaTestRule.EntityManagerFactoryConfigurator A command interface for providing custom configuration logic for the internal LocalContainerEntityManagerFactoryBean and BasicDataSource.

Method Summary

Methods

Modifier and Type	Method and Description
javax.persistence.EntityManager	createEntityManager() Creates and returns a new EntityManager using the internal EntityManagerFactory.
javax.persistence.EntityManager	createEntityManager(Map properties) Creates and returns a new EntityManager using the internal EntityManagerFactory and applying the given Map of properties.
javax.persistence.EntityManagerFactory	getEntityManagerFactory() Returns the internal EntityManagerFactory.

Methods inherited from class org.junit.rules.ExternalResource

apply

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getEntityManagerFactory

public javax.persistence.EntityManagerFactory getEntityManagerFactory()

Returns the internal EntityManagerFactory.

Returns:

the internal EntityManagerFactory

createEntityManager

public javax.persistence.EntityManager createEntityManager()

Creates and returns a new EntityManager using the internal EntityManagerFactory.

Returns:

the new EntityManager

createEntityManager

public javax.persistence.EntityManager createEntityManager(Map properties)

Creates and returns a new EntityManager using the internal EntityManagerFactory and applying the given Map of properties.

As Hibernate is used as internal JPA layer, the properties need to be Hibernate-specific.

Parameters:

properties - a Map of properties to use for creating the EntityManager

Returns:

the new EntityManager