net.sf.javagimmicks.jpa.testing

Class HsqlJpaTestRule

java.lang.Object

org.junit.rules.ExternalResource

net.sf.javagimmicks.jpa.testing.AbstractJpaTestRule

net.sf.javagimmicks.jpa.testing.HsqlJpaTestRule

All Implemented Interfaces:

org.junit.rules.TestRule

public class HsqlJpaTestRule
extends AbstractJpaTestRule

A JUnit TestRule that creates a temporary file-based Hypersonic SQL database (using HsqlDbTestRule) 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 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.

Usage example:

 public class HsqlDbTestRuleTest
 {
 
    @Rule
    public HsqlJpaTestRule _jpa = new HsqlJpaTestRule(FooEntity.class.getPackage().getName());
 
    @Test
    public void test() throws SQLException
    {
       final EntityManager em = _jpa.createEntityManager();
       Assert.assertNotNull(em);
 
       em.getTransaction().begin();
 
       // Do some JPA operations
 
       em.getTranscation().commit();
 
       em.close();
    }
 }
 

Nested Class Summary

Nested classes/interfaces inherited from class net.sf.javagimmicks.jpa.testing.AbstractJpaTestRule

AbstractJpaTestRule.EntityManagerFactoryConfigurator

Constructor Summary

Constructors

Constructor and Description
HsqlJpaTestRule(AbstractJpaTestRule.EntityManagerFactoryConfigurator configurator, File dbFolder, String... entityPackages) Creates a new instance using the given EntityManagerFactoryConfigurator and folder for the internal database.
HsqlJpaTestRule(AbstractJpaTestRule.EntityManagerFactoryConfigurator configurator, String... entityPackages) Creates a new instance using the given EntityManagerFactoryConfigurator for the internal database.
HsqlJpaTestRule(File dbFolder, String... entityPackages) Creates a new instance using the given folder for the internal database.
HsqlJpaTestRule(String... entityPackages) Creates a new instance with no special configuration.

Method Summary

Methods inherited from class net.sf.javagimmicks.jpa.testing.AbstractJpaTestRule

createEntityManager, createEntityManager, getEntityManagerFactory

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

Constructor Detail

HsqlJpaTestRule

public HsqlJpaTestRule(AbstractJpaTestRule.EntityManagerFactoryConfigurator configurator,
               File dbFolder,
               String... entityPackages)

Creates a new instance using the given EntityManagerFactoryConfigurator and folder for the internal database.

Parameters:

configurator - a EntityManagerFactoryConfigurator for performing custom configuration logic on the internal BasicDataSource and LocalContainerEntityManagerFactoryBean

dbFolder - the temporary folder where the database should be set up

entityPackages - a list of names of packages to scan for entity classes

Throws:

IllegalArgumentException - if the list of package names is empty

HsqlJpaTestRule

public HsqlJpaTestRule(File dbFolder,
               String... entityPackages)

Creates a new instance using the given folder for the internal database.

Parameters:

dbFolder - the temporary folder where the database should be set up

entityPackages - a list of names of packages to scan for entity classes

Throws:

IllegalArgumentException - if the list of package names is empty

HsqlJpaTestRule

public HsqlJpaTestRule(AbstractJpaTestRule.EntityManagerFactoryConfigurator configurator,
               String... entityPackages)

Creates a new instance using the given EntityManagerFactoryConfigurator for the internal database.

Parameters:

configurator - a EntityManagerFactoryConfigurator for performing custom configuration logic on the internal BasicDataSource and LocalContainerEntityManagerFactoryBean

entityPackages - a list of names of packages to scan for entity classes

Throws:

IllegalArgumentException - if the list of package names is empty

HsqlJpaTestRule

public HsqlJpaTestRule(String... entityPackages)

Creates a new instance with no special configuration.

Parameters:

entityPackages - a list of names of packages to scan for entity classes

Throws:

IllegalArgumentException - if the list of package names is empty