org.osgi.service.transaction.control.jpa

Interface JPAEntityManagerProviderFactory

public interface JPAEntityManagerProviderFactory

A factory for creating JPAEntityManagerProvider instances

This factory can be used if the JPAEntityManagerProvider should not be a public service, for example to protect a username/password.

Field Summary

Fields

Modifier and Type	Field and Description
static String	LOCAL_ENLISTMENT_ENABLED The property used to determine whether local enlistment is enabled for this resource provider
static String	PRE_ENLISTED_DB_CONNECTION The property used to indicate that database connections will be automatically enlisted in ongoing transactions without intervention from the JPA provider
static String	TRANSACTIONAL_DB_CONNECTION The property used to provide a JDBCConnectionProvider to the resource provider.
static String	XA_ENLISTMENT_ENABLED The property used to determine whether XA enlistment is enabled for this resource provider

Method Summary

Modifier and Type	Method and Description
JPAEntityManagerProvider	getProviderFor(org.osgi.service.jpa.EntityManagerFactoryBuilder emfb, Map<String,Object> jpaProperties, Map<String,Object> resourceProviderProperties) Create a private JPAEntityManagerProvider using an EntityManagerFactoryBuilder
JPAEntityManagerProvider	getProviderFor(javax.persistence.EntityManagerFactory emf, Map<String,Object> resourceProviderProperties) Create a private JPAEntityManagerProvider using an existing EntityManagerFactory.

Field Detail

XA_ENLISTMENT_ENABLED

static final String XA_ENLISTMENT_ENABLED

The property used to determine whether XA enlistment is enabled for this resource provider

See Also:

Constant Field Values

LOCAL_ENLISTMENT_ENABLED

static final String LOCAL_ENLISTMENT_ENABLED

The property used to determine whether local enlistment is enabled for this resource provider

See Also:

Constant Field Values

TRANSACTIONAL_DB_CONNECTION

static final String TRANSACTIONAL_DB_CONNECTION

The property used to provide a JDBCConnectionProvider to the resource provider. This will be converted into a DataSource by the factory, and passed to the EntityManagerFactoryBuilder using the javax.persistence.jtaDataSource property

See Also:

Constant Field Values

PRE_ENLISTED_DB_CONNECTION

static final String PRE_ENLISTED_DB_CONNECTION

The property used to indicate that database connections will be automatically enlisted in ongoing transactions without intervention from the JPA provider

See Also:

Constant Field Values

Method Detail

getProviderFor

JPAEntityManagerProvider getProviderFor(org.osgi.service.jpa.EntityManagerFactoryBuilder emfb,
                                        Map<String,Object> jpaProperties,
                                        Map<String,Object> resourceProviderProperties)

Create a private JPAEntityManagerProvider using an EntityManagerFactoryBuilder

Parameters:

emfb - The EntityManagerFactoryBuilder to create JPA resources with

jpaProperties - The properties to pass to the EntityManagerFactoryBuilder in order to create the underlying EntityManagerFactory and EntityManager instances

resourceProviderProperties - Configuration properties to pass to the JPA Resource Provider runtime

Returns:

A JPAEntityManagerProvider that can be used in transactions

getProviderFor

JPAEntityManagerProvider getProviderFor(javax.persistence.EntityManagerFactory emf,
                                        Map<String,Object> resourceProviderProperties)

Create a private JPAEntityManagerProvider using an existing EntityManagerFactory.

Parameters:

emf - The EntityManagerFactory to use in the JPAEntityManagerProvider

resourceProviderProperties - Configuration properties to pass to the JDBC Resource Provider runtime

Returns:

A JPAEntityManagerProvider that can be used in transactions