LocalEntityManagerFactoryBean (Spring Framework 3.2.1.RELEASE API)
Date: 2013-01-24

org.springframework.orm.jpa

## Class LocalEntityManagerFactoryBean

- java.lang.Object
- - org.springframework.orm.jpa.AbstractEntityManagerFactoryBean
  - - org.springframework.orm.jpa.LocalEntityManagerFactoryBean

- All Implemented Interfaces:
    Serializable, Aware, BeanClassLoaderAware, BeanFactoryAware, BeanNameAware, DisposableBean, FactoryBean<EntityManagerFactory>, InitializingBean, PersistenceExceptionTranslator, EntityManagerFactoryInfo

      public class LocalEntityManagerFactoryBean
      extends AbstractEntityManagerFactoryBean

  `FactoryBean` that creates a JPA `EntityManagerFactory` according to JPA's standard standalone bootstrap contract. This is the simplest way to set up a shared JPA EntityManagerFactory in a Spring application context; the EntityManagerFactory can then be passed to JPA-based DAOs via dependency injection. Note that switching to a JNDI lookup or to a `LocalContainerEntityManagerFactoryBean` definition is just a matter of configuration!

  Configuration settings are usually read from a `META-INF/persistence.xml` config file, residing in the class path, according to the JPA standalone bootstrap contract. Additionally, most JPA providers will require a special VM agent (specified on JVM startup) that allows them to instrument application classes. See the Java Persistence API specification and your provider documentation for setup details.

  This EntityManagerFactory bootstrap is appropriate for standalone applications which solely use JPA for data access. If you want to set up your persistence provider for an external DataSource and/or for global transactions which span multiple resources, you will need to either deploy it into a full Java EE 5 application server and access the deployed EntityManagerFactory via JNDI, or use Spring's `LocalContainerEntityManagerFactoryBean` with appropriate configuration for local setup according to JPA's container contract.

  Note: This FactoryBean has limited configuration power in terms of what configuration it is able to pass to the JPA provider. If you need more flexible configuration, for example passing a Spring-managed JDBC DataSource to the JPA provider, consider using Spring's more powerful `LocalContainerEntityManagerFactoryBean` instead.

  Since:
    2.0
  Author:
    Juergen Hoeller, Rod Johnson
  See Also:
    `AbstractEntityManagerFactoryBean.setJpaProperties(java.util.Properties)`, `AbstractEntityManagerFactoryBean.setJpaVendorAdapter(org.springframework.orm.jpa.JpaVendorAdapter)`, `EntityManagerFactoryAccessor.setEntityManagerFactory(javax.persistence.EntityManagerFactory)`, `JpaTransactionManager.setEntityManagerFactory(javax.persistence.EntityManagerFactory)`, `LocalContainerEntityManagerFactoryBean`, `JndiObjectFactoryBean`, `SharedEntityManagerBean`, `Persistence.createEntityManagerFactory(java.lang.String)`, `PersistenceProvider.createEntityManagerFactory(java.lang.String, java.util.Map)`, Serialized Form

- - ### Field Summary

    - ### Fields inherited from class org.springframework.orm.jpa.AbstractEntityManagerFactoryBean

      `logger, nativeEntityManagerFactory`

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `LocalEntityManagerFactoryBean()`

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `protected EntityManagerFactory` | `createNativeEntityManagerFactory()` Initialize the EntityManagerFactory for the given configuration.

    - ### Methods inherited from class org.springframework.orm.jpa.AbstractEntityManagerFactoryBean

      `afterPropertiesSet, createEntityManagerFactoryProxy, destroy, getBeanClassLoader, getDataSource, getEntityManagerInterface, getJpaDialect, getJpaPropertyMap, getJpaVendorAdapter, getNativeEntityManagerFactory, getObject, getObjectType, getPersistenceProvider, getPersistenceUnitInfo, getPersistenceUnitName, isSingleton, setBeanClassLoader, setBeanFactory, setBeanName, setEntityManagerFactoryInterface, setEntityManagerInterface, setJpaDialect, setJpaProperties, setJpaPropertyMap, setJpaVendorAdapter, setPersistenceProvider, setPersistenceProviderClass, setPersistenceUnitName, translateExceptionIfPossible, writeReplace`

    - ### Methods inherited from class java.lang.Object

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

- - ### Constructor Detail

    - #### LocalEntityManagerFactoryBean

          public LocalEntityManagerFactoryBean()

  - ### Method Detail

    - #### createNativeEntityManagerFactory

          protected EntityManagerFactory createNativeEntityManagerFactory()
                                                                   throws PersistenceException

      Initialize the EntityManagerFactory for the given configuration.
      Specified by:
        `createNativeEntityManagerFactory` in class `AbstractEntityManagerFactoryBean`
      Returns:
        EntityManagerFactory instance returned by this FactoryBean
      Throws:
        `PersistenceException` - in case of JPA initialization errors