javax.persistence.spi.PersistenceProvider Maven / Gradle / Ivy
// $Id: PersistenceProvider.java 17752 2009-10-15 01:19:21Z [email protected] $
// EJB3 Specification Copyright 2004-2009 Sun Microsystems, Inc.
package javax.persistence.spi;
import javax.persistence.EntityManagerFactory;
import java.util.Map;
/**
* Interface implemented by the persistence provider.
*
* It is invoked by the container in Java EE environments and
* by the {@link javax.persistence.Persistence} class in Java SE environments to
* create an {@link javax.persistence.EntityManagerFactory}.
*
* @since Java Persistence 1.0
*/
public interface PersistenceProvider {
/**
* Called by Persistence class when an
* EntityManagerFactory is to be created.
*
* @param emName the name of the persistence unit
* @param 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
* (and may be null if no properties are specified).
*
* @return EntityManagerFactory for the persistence unit,
* or null if the provider is not the right provider
*/
public EntityManagerFactory createEntityManagerFactory(String emName, Map map);
/**
* Called by the container when an EntityManagerFactory
* is to be created.
*
* @param info metadata for use by the persistence provider
* @param map a Map of integration-level properties for use
* by the persistence provider (may be null if no properties
* are specified).
* If a Bean Validation provider is present in the classpath,
* the container must pass the ValidatorFactory instance in
* the map with the key "javax.persistence.validation.factory".
*
* @return EntityManagerFactory for the persistence unit
* specified by the metadata
*/
public EntityManagerFactory createContainerEntityManagerFactory(PersistenceUnitInfo info, Map map);
/**
* Return the utility interface implemented by the persistence
* provider.
*
* @return ProviderUtil interface
*
* @since Java Persistence 2.0
*/
public ProviderUtil getProviderUtil();
}