类 AbstractEntityManagerFactoryBean

字段详细资料

• logger

  protected final Log logger

  Logger available to subclasses.

构造器详细资料

• AbstractEntityManagerFactoryBean

  public AbstractEntityManagerFactoryBean()

方法详细资料

• setPersistenceProviderClass

  public void setPersistenceProviderClass​(Class<? extends PersistenceProvider> persistenceProviderClass)

  Set the PersistenceProvider implementation class to use for creating the EntityManagerFactory. If not specified, the persistence provider will be taken from the JpaVendorAdapter (if any) or retrieved through scanning (as far as possible).

  另请参阅:

  JpaVendorAdapter.getPersistenceProvider(), PersistenceProvider, Persistence

• setPersistenceProvider

  public void setPersistenceProvider​(@Nullable
                                     PersistenceProvider persistenceProvider)

  Set the PersistenceProvider instance to use for creating the EntityManagerFactory. If not specified, the persistence provider will be taken from the JpaVendorAdapter (if any) or determined by the persistence unit deployment descriptor (as far as possible).

  另请参阅:

  JpaVendorAdapter.getPersistenceProvider(), PersistenceProvider, Persistence

• getPersistenceProvider

  @Nullable
  public PersistenceProvider getPersistenceProvider()

  从接口复制的说明: EntityManagerFactoryInfo
  Return the underlying PersistenceProvider that the underlying EntityManagerFactory was created with.

  指定者:

  getPersistenceProvider 在接口中 EntityManagerFactoryInfo

  返回:

  the PersistenceProvider used to create this EntityManagerFactory, or null if the standard JPA provider autodetection process was used to configure the EntityManagerFactory

• setPersistenceUnitName

  public void setPersistenceUnitName​(@Nullable
                                     String persistenceUnitName)

  Specify the name of the EntityManagerFactory configuration.

  Default is none, indicating the default EntityManagerFactory configuration. The persistence provider will throw an exception if ambiguous EntityManager configurations are found.

  另请参阅:

  Persistence.createEntityManagerFactory(String)

• getPersistenceUnitName

  @Nullable
  public String getPersistenceUnitName()

  从接口复制的说明: EntityManagerFactoryInfo
  Return the name of the persistence unit used to create this EntityManagerFactory, or null if it is an unnamed default.

  If getPersistenceUnitInfo() returns non-null, the result of getPersistenceUnitName() must be equal to the value returned by PersistenceUnitInfo.getPersistenceUnitName().

  指定者:

  getPersistenceUnitName 在接口中 EntityManagerFactoryInfo

  另请参阅:

  EntityManagerFactoryInfo.getPersistenceUnitInfo(), PersistenceUnitInfo.getPersistenceUnitName()

• setJpaProperties

  public void setJpaProperties​(Properties jpaProperties)

  Specify JPA properties, to be passed into Persistence.createEntityManagerFactory (if any).

  Can be populated with a String "value" (parsed via PropertiesEditor) or a "props" element in XML bean definitions.

  另请参阅:

  Persistence.createEntityManagerFactory(String, Map), PersistenceProvider.createContainerEntityManagerFactory(PersistenceUnitInfo, Map)

• setJpaPropertyMap

  public void setJpaPropertyMap​(@Nullable
                                Map<String,​?> jpaProperties)

  Specify JPA properties as a Map, to be passed into Persistence.createEntityManagerFactory (if any).

  Can be populated with a "map" or "props" element in XML bean definitions.

  另请参阅:

  Persistence.createEntityManagerFactory(String, Map), PersistenceProvider.createContainerEntityManagerFactory(PersistenceUnitInfo, Map)

• getJpaPropertyMap

  public Map<String,​Object> getJpaPropertyMap()

  Allow Map access to the JPA properties to be passed to the persistence provider, with the option to add or override specific entries.

  Useful for specifying entries directly, for example via "jpaPropertyMap[myKey]".

• setEntityManagerFactoryInterface

  public void setEntityManagerFactoryInterface​(Class<? extends EntityManagerFactory> emfInterface)

  Specify the (potentially vendor-specific) EntityManagerFactory interface that this EntityManagerFactory proxy is supposed to implement.

  The default will be taken from the specific JpaVendorAdapter, if any, or set to the standard javax.persistence.EntityManagerFactory interface else.

  另请参阅:

  JpaVendorAdapter.getEntityManagerFactoryInterface()

• setEntityManagerInterface

  public void setEntityManagerInterface​(@Nullable
                                        Class<? extends EntityManager> emInterface)

  Specify the (potentially vendor-specific) EntityManager interface that this factory's EntityManagers are supposed to implement.

  The default will be taken from the specific JpaVendorAdapter, if any, or set to the standard javax.persistence.EntityManager interface else.

  另请参阅:

  JpaVendorAdapter.getEntityManagerInterface(), EntityManagerFactoryInfo.getEntityManagerInterface()

• getEntityManagerInterface

  @Nullable
  public Class<? extends EntityManager> getEntityManagerInterface()

  从接口复制的说明: EntityManagerFactoryInfo
  Return the (potentially vendor-specific) EntityManager interface that this factory's EntityManagers will implement.

  A null return value suggests that autodetection is supposed to happen: either based on a target EntityManager instance or simply defaulting to javax.persistence.EntityManager.

  指定者:

  getEntityManagerInterface 在接口中 EntityManagerFactoryInfo

• setJpaDialect

  public void setJpaDialect​(@Nullable
                            JpaDialect jpaDialect)

  Specify the vendor-specific JpaDialect implementation to associate with this EntityManagerFactory. This will be exposed through the EntityManagerFactoryInfo interface, to be picked up as default dialect by accessors that intend to use JpaDialect functionality.

  另请参阅:

  EntityManagerFactoryInfo.getJpaDialect()

• getJpaDialect

  @Nullable
  public JpaDialect getJpaDialect()

  从接口复制的说明: EntityManagerFactoryInfo
  Return the vendor-specific JpaDialect implementation for this EntityManagerFactory, or null if not known.

  指定者:

  getJpaDialect 在接口中 EntityManagerFactoryInfo

• setJpaVendorAdapter

  public void setJpaVendorAdapter​(@Nullable
                                  JpaVendorAdapter jpaVendorAdapter)

  Specify the JpaVendorAdapter implementation for the desired JPA provider, if any. This will initialize appropriate defaults for the given provider, such as persistence provider class and JpaDialect, unless locally overridden in this FactoryBean.

• getJpaVendorAdapter

  @Nullable
  public JpaVendorAdapter getJpaVendorAdapter()

  Return the JpaVendorAdapter implementation for this EntityManagerFactory, or null if not known.

• setBootstrapExecutor

  public void setBootstrapExecutor​(@Nullable
                                   AsyncTaskExecutor bootstrapExecutor)

  Specify an asynchronous executor for background bootstrapping, e.g. a SimpleAsyncTaskExecutor.

  EntityManagerFactory initialization will then switch into background bootstrap mode, with a EntityManagerFactory proxy immediately returned for injection purposes instead of waiting for the JPA provider's bootstrapping to complete. However, note that the first actual call to a EntityManagerFactory method will then block until the JPA provider's bootstrapping completed, if not ready by then. For maximum benefit, make sure to avoid early EntityManagerFactory calls in init methods of related beans, even for metadata introspection purposes.

  从以下版本开始:

  4.3

• getBootstrapExecutor

  @Nullable
  public AsyncTaskExecutor getBootstrapExecutor()

  Return the asynchronous executor for background bootstrapping, if any.

  从以下版本开始:

  4.3

• setBeanClassLoader

  public void setBeanClassLoader​(ClassLoader classLoader)

  从接口复制的说明: BeanClassLoaderAware
  Callback that supplies the bean class loader to a bean instance.

  Invoked after the population of normal bean properties but before an initialization callback such as InitializingBean'sInitializingBean.afterPropertiesSet() method or a custom init-method.

  指定者:

  setBeanClassLoader 在接口中 BeanClassLoaderAware

  参数:

  classLoader - the owning class loader

• getBeanClassLoader

  public ClassLoader getBeanClassLoader()

  从接口复制的说明: EntityManagerFactoryInfo
  Return the ClassLoader that the application's beans are loaded with.

  Proxies will be generated in this ClassLoader.

  指定者:

  getBeanClassLoader 在接口中 EntityManagerFactoryInfo

• setBeanFactory

  public void setBeanFactory​(BeanFactory beanFactory)

  从接口复制的说明: BeanFactoryAware
  Callback that supplies the owning factory to a bean instance.

  Invoked after the population of normal bean properties but before an initialization callback such as InitializingBean.afterPropertiesSet() or a custom init-method.

  指定者:

  setBeanFactory 在接口中 BeanFactoryAware

  参数:

  beanFactory - owning BeanFactory (never null). The bean can immediately call methods on the factory.

  另请参阅:

  BeanInitializationException

• setBeanName

  public void setBeanName​(String name)

  从接口复制的说明: BeanNameAware
  Set the name of the bean in the bean factory that created this bean.

  Invoked after population of normal bean properties but before an init callback such as InitializingBean.afterPropertiesSet() or a custom init-method.

  指定者:

  setBeanName 在接口中 BeanNameAware

  参数:

  name - the name of the bean in the factory. Note that this name is the actual bean name used in the factory, which may differ from the originally specified name: in particular for inner bean names, the actual bean name might have been made unique through appending "#..." suffixes. Use the BeanFactoryUtils.originalBeanName(String) method to extract the original bean name (without suffix), if desired.

• afterPropertiesSet

  public void afterPropertiesSet()
                          throws PersistenceException

  从接口复制的说明: InitializingBean
  Invoked by the containing BeanFactory after it has set all bean properties and satisfied BeanFactoryAware, ApplicationContextAware etc.

  This method allows the bean instance to perform validation of its overall configuration and final initialization when all bean properties have been set.

  指定者:

  afterPropertiesSet 在接口中 InitializingBean

  抛出:

  PersistenceException

• createEntityManagerFactoryProxy

  protected EntityManagerFactory createEntityManagerFactoryProxy​(@Nullable
                                                                 EntityManagerFactory emf)

  Create a proxy for the given EntityManagerFactory. We do this to be able to return a transaction-aware proxy for an application-managed EntityManager.

  参数:

  emf - the EntityManagerFactory as returned by the persistence provider, if initialized already

  返回:

  the EntityManagerFactory proxy

• createNativeEntityManagerFactory

  protected abstract EntityManagerFactory createNativeEntityManagerFactory()
                                                                    throws PersistenceException

  Subclasses must implement this method to create the EntityManagerFactory that will be returned by the getObject() method.

  返回:

  the EntityManagerFactory instance returned by this FactoryBean

  抛出:

  PersistenceException - if the EntityManager cannot be created

• translateExceptionIfPossible

  @Nullable
  public DataAccessException translateExceptionIfPossible​(RuntimeException ex)

  Implementation of the PersistenceExceptionTranslator interface, as autodetected by Spring's PersistenceExceptionTranslationPostProcessor.

  Uses the dialect's conversion if possible; otherwise falls back to standard JPA exception conversion.

  指定者:

  translateExceptionIfPossible 在接口中 PersistenceExceptionTranslator

  参数:

  ex - a RuntimeException to translate

  返回:

  the corresponding DataAccessException (or null if the exception could not be translated, as in this case it may result from user code rather than from an actual persistence problem)

  另请参阅:

  PersistenceExceptionTranslationPostProcessor, PersistenceExceptionTranslator.translateExceptionIfPossible(java.lang.RuntimeException), EntityManagerFactoryUtils.convertJpaAccessExceptionIfPossible(java.lang.RuntimeException)

• getNativeEntityManagerFactory

  public EntityManagerFactory getNativeEntityManagerFactory()

  从接口复制的说明: EntityManagerFactoryInfo
  Return the raw underlying EntityManagerFactory.

  指定者:

  getNativeEntityManagerFactory 在接口中 EntityManagerFactoryInfo

  返回:

  the unadorned EntityManagerFactory (never null)

• getPersistenceUnitInfo

  @Nullable
  public PersistenceUnitInfo getPersistenceUnitInfo()

  从接口复制的说明: EntityManagerFactoryInfo
  Return the PersistenceUnitInfo used to create this EntityManagerFactory, if the in-container API was used.

  指定者:

  getPersistenceUnitInfo 在接口中 EntityManagerFactoryInfo

  返回:

  the PersistenceUnitInfo used to create this EntityManagerFactory, or null if the in-container contract was not used to configure the EntityManagerFactory

• getDataSource

  @Nullable
  public DataSource getDataSource()

  从接口复制的说明: EntityManagerFactoryInfo
  Return the JDBC DataSource that this EntityManagerFactory obtains its JDBC Connections from.

  指定者:

  getDataSource 在接口中 EntityManagerFactoryInfo

  返回:

  the JDBC DataSource, or null if not known

• getObject

  @Nullable
  public EntityManagerFactory getObject()

  Return the singleton EntityManagerFactory.

  指定者:

  getObject 在接口中 FactoryBean<EntityManagerFactory>

  返回:

  an instance of the bean (can be null)

  另请参阅:

  FactoryBeanNotInitializedException

• getObjectType

  public Class<? extends EntityManagerFactory> getObjectType()

  从接口复制的说明: FactoryBean
  Return the type of object that this FactoryBean creates, or null if not known in advance.

  This allows one to check for specific types of beans without instantiating objects, for example on autowiring.

  In the case of implementations that are creating a singleton object, this method should try to avoid singleton creation as far as possible; it should rather estimate the type in advance. For prototypes, returning a meaningful type here is advisable too.

  This method can be called before this FactoryBean has been fully initialized. It must not rely on state created during initialization; of course, it can still use such state if available.

  NOTE: Autowiring will simply ignore FactoryBeans that return null here. Therefore it is highly recommended to implement this method properly, using the current state of the FactoryBean.

  指定者:

  getObjectType 在接口中 FactoryBean<EntityManagerFactory>

  返回:

  the type of object that this FactoryBean creates, or null if not known at the time of the call

  另请参阅:

  ListableBeanFactory.getBeansOfType(java.lang.Class<T>)

• isSingleton

  public boolean isSingleton()

  从接口复制的说明: FactoryBean
  Is the object managed by this factory a singleton? That is, will FactoryBean.getObject() always return the same object (a reference that can be cached)?

  NOTE: If a FactoryBean indicates to hold a singleton object, the object returned from getObject() might get cached by the owning BeanFactory. Hence, do not return true unless the FactoryBean always exposes the same reference.

  The singleton status of the FactoryBean itself will generally be provided by the owning BeanFactory; usually, it has to be defined as singleton there.

  NOTE: This method returning false does not necessarily indicate that returned objects are independent instances. An implementation of the extended SmartFactoryBean interface may explicitly indicate independent instances through its SmartFactoryBean.isPrototype() method. Plain FactoryBean implementations which do not implement this extended interface are simply assumed to always return independent instances if the isSingleton() implementation returns false.

  The default implementation returns true, since a FactoryBean typically manages a singleton instance.

  指定者:

  isSingleton 在接口中 FactoryBean<EntityManagerFactory>

  返回:

  whether the exposed object is a singleton

  另请参阅:

  FactoryBean.getObject(), SmartFactoryBean.isPrototype()

• destroy

  public void destroy()

  Close the EntityManagerFactory on bean factory shutdown.

  指定者:

  destroy 在接口中 DisposableBean

• writeReplace

  protected Object writeReplace()
                         throws ObjectStreamException

  抛出:

  ObjectStreamException