org.opencastproject.util.persistencefn

Class PersistenceEnvs

java.lang.Object

org.opencastproject.util.persistencefn.PersistenceEnvs

public final class PersistenceEnvs
extends Object

Persistence environment factory.

Method Summary

Modifier and Type	Method and Description
static PersistenceEnv	mk(org.osgi.service.component.ComponentContext cc, String emName) Shortcut for persistenceEnvironment(newEntityManagerFactory(cc, emName)).
static PersistenceEnv	mk(org.osgi.service.component.ComponentContext cc, String emName, Map persistenceProps) Shortcut for newPersistenceEnvironment(newEntityManagerFactory(cc, emName, persistenceProps)).
static PersistenceEnv	mk(javax.persistence.EntityManagerFactory emf) Create a new, concurrently usable persistence environment which uses JPA local transactions.
static PersistenceEnv	mk(javax.persistence.spi.PersistenceProvider persistenceProvider, String emName, Map persistenceProps) Create a new persistence environment.
static PersistenceEnv	mkTestEnv(String emName) Create a new persistence environment based on an entity manager factory backed by an in-memory H2 database for testing purposes.
static PersistenceEnv	mkTestEnv(String emName, boolean withSqlLogging) Create a new persistence environment based on an entity manager factory backed by an in-memory H2 database for testing purposes.
static PersistenceEnv	mkTestEnvFromSystemProperties(String emName) Create a persistence environment for unit tests configured by the following system properties.

Methods inherited from class java.lang.Object

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

Method Detail

mk

public static PersistenceEnv mk(javax.persistence.EntityManagerFactory emf)

Create a new, concurrently usable persistence environment which uses JPA local transactions.

Transaction propagation is supported on a per thread basis.

mk

public static PersistenceEnv mk(org.osgi.service.component.ComponentContext cc,
                                String emName)

Shortcut for persistenceEnvironment(newEntityManagerFactory(cc, emName)).

See Also:

PersistenceUtil.newEntityManagerFactory(org.osgi.service.component.ComponentContext, String)

mk

public static PersistenceEnv mk(org.osgi.service.component.ComponentContext cc,
                                String emName,
                                Map persistenceProps)

Shortcut for newPersistenceEnvironment(newEntityManagerFactory(cc, emName, persistenceProps)).

See Also:

PersistenceUtil.newEntityManagerFactory(org.osgi.service.component.ComponentContext, String, java.util.Map)

mk

public static PersistenceEnv mk(javax.persistence.spi.PersistenceProvider persistenceProvider,
                                String emName,
                                Map persistenceProps)

Create a new persistence environment. This method is the preferred way of creating a persistence environment.

mkTestEnv

public static PersistenceEnv mkTestEnv(String emName)

Create a new persistence environment based on an entity manager factory backed by an in-memory H2 database for testing purposes.

Parameters:

emName - name of the persistence unit (see META-INF/persistence.xml)

mkTestEnv

public static PersistenceEnv mkTestEnv(String emName,
                                       boolean withSqlLogging)

Create a new persistence environment based on an entity manager factory backed by an in-memory H2 database for testing purposes.

Parameters:

emName - name of the persistence unit (see META-INF/persistence.xml)

withSqlLogging - turn on EclipseLink SQL logging

mkTestEnvFromSystemProperties

public static PersistenceEnv mkTestEnvFromSystemProperties(String emName)

Create a persistence environment for unit tests configured by the following system properties.

• -Dtest-database-url, JDBC URL, defaults to H2 in-memory database
• -Dtest-database-user, defaults to 'matterhorn'
• -Dtest-database-password, defaults to 'matterhorn'
• -Dsql-logging=[true|false], defaults to 'false', turns on SQL logging to the console
• -Dkeep-database=[true|false], defaults to 'false', keep an existing database or recreate at startup. Not used with H2.

Currently only MySQL is recognized.

Parameters:

emName - name of the persistence unit (see META-INF/persistence.xml)