javax.persistence.spi
Interface PersistenceProvider

public interface PersistenceProvider

Interface implemented by a persistence provider. The implementation of this interface that is to be used for a given EntityManager is specified in persistence.xml file in the persistence archive. This interface is invoked by the Container when it needs to create an EntityManagerFactory, or by the Persistence class when running outside the Container.

Since:

Java Persistence 1.0

Method Summary

EntityManagerFactory	createContainerEntityManagerFactory(PersistenceUnitInfo info, Map map) Called by the container when an EntityManagerFactory is to be created.
EntityManagerFactory	createEntityManagerFactory(String emName, Map map) Called by Persistence class when an EntityManagerFactory is to be created.

Method Detail

createEntityManagerFactory

EntityManagerFactory createEntityManagerFactory(String emName,
                                                Map map)

Called by Persistence class when an EntityManagerFactory is to be created.

Parameters:

emName - The name of the persistence unit

map - A Map of properties for use by the persistence provider. These properties may be used to override the values of the corresponding elements in the persistence.xml file or specify values for properties not specified in the persistence.xml.

Returns:

EntityManagerFactory for the persistence unit, or null if the provider is not the right provider

createContainerEntityManagerFactory

EntityManagerFactory createContainerEntityManagerFactory(PersistenceUnitInfo info,
                                                         Map map)

Called by the container when an EntityManagerFactory is to be created.

Parameters:

info - Metadata for use by the persistence provider

map - A Map of integration-level properties for use by the persistence provider. Can be null if there is no integration-level property.

Returns:

EntityManagerFactory for the persistence unit specified by the metadata