クラス EntityManagerFactoryUtils

メソッドの詳細

• findEntityManagerFactory

  public static EntityManagerFactoryEE findEntityManagerFactory(ListableBeanFactory beanFactory, @Nullable StringSE unitName) throws NoSuchBeanDefinitionException

  指定された Spring アプリケーションコンテキスト（ListableBeanFactory で表されます）で指定された名前の EntityManagerFactory を見つけます。

  検出された EntityManagerFactory が EntityManagerFactoryInfo インターフェースを実装している場合、指定されたユニット名は構成された永続性ユニットと照合されます。そうでない場合、EntityManagerFactory Bean 名がその規則に従っていると想定して、永続性ユニット名は Spring Bean 名と照合されます。

  ユニット名が指定されていない場合、このメソッドはデフォルトの EntityManagerFactory から BeanFactory.getBean(Class) を検索します。

  パラメーター:

  beanFactory - 検索する ListableBeanFactory

  unitName - 永続性ユニットの名前 (null または空の場合があります。その場合、型 EntityManagerFactory の単一の Bean が検索されます。)

  戻り値:

  EntityManagerFactory

  例外:

  NoSuchBeanDefinitionException - コンテキストにそのような EntityManagerFactory がない場合

  関連事項:

  • EntityManagerFactoryInfo.getPersistenceUnitName()

• getTransactionalEntityManager

  @Nullable public static EntityManagerEE getTransactionalEntityManager(EntityManagerFactoryEE emf) throws DataAccessResourceFailureException

  指定されたファクトリから JPA EntityManager を取得します。たとえば、JpaTransactionManager を使用する場合、現在のスレッドにバインドされている対応する EntityManager を認識します。

  メモ: スレッドバインドの EntityManager が見つからない場合、null を返します。

  パラメーター:

  emf - EntityManager を作成する EntityManagerFactory

  戻り値:

  EntityManager、または見つからない場合は null 

  例外:

  DataAccessResourceFailureException - EntityManager を取得できなかった場合

  関連事項:

  • JpaTransactionManager

• getTransactionalEntityManager

  @Nullable public static EntityManagerEE getTransactionalEntityManager(EntityManagerFactoryEE emf, @Nullable MapSE<?,?> properties) throws DataAccessResourceFailureException

  指定されたファクトリから JPA EntityManager を取得します。たとえば、JpaTransactionManager を使用する場合、現在のスレッドにバインドされている対応する EntityManager を認識します。

  メモ: スレッドバインドの EntityManager が見つからない場合、null を返します。

  パラメーター:

  emf - EntityManager を作成する EntityManagerFactory

  properties - createEntityManager 呼び出しに渡されるプロパティ (null の場合があります)

  戻り値:

  EntityManager、または見つからない場合は null 

  例外:

  DataAccessResourceFailureException - EntityManager を取得できなかった場合

  関連事項:

  • JpaTransactionManager

• doGetTransactionalEntityManager

  @Nullable public static EntityManagerEE doGetTransactionalEntityManager(EntityManagerFactoryEE emf, MapSE<?,?> properties) throws PersistenceExceptionEE

  指定されたファクトリから JPA EntityManager を取得します。たとえば、JpaTransactionManager を使用する場合、現在のスレッドにバインドされている対応する EntityManager を認識します。

  getEntityManager と同じですが、元の PersistenceException をスローします。

  パラメーター:

  emf - EntityManager を作成する EntityManagerFactory

  properties - createEntityManager 呼び出しに渡されるプロパティ (null の場合があります)

  戻り値:

  EntityManager、または見つからない場合は null 

  例外:

  PersistenceExceptionEE - EntityManager を作成できなかった場合

  関連事項:

  • getTransactionalEntityManager(jakarta.persistence.EntityManagerFactory)
  • JpaTransactionManager

• doGetTransactionalEntityManager

  @Nullable public static EntityManagerEE doGetTransactionalEntityManager(EntityManagerFactoryEE emf, @Nullable MapSE<?,?> properties, boolean synchronizedWithTransaction) throws PersistenceExceptionEE

  指定されたファクトリから JPA EntityManager を取得します。たとえば、JpaTransactionManager を使用する場合、現在のスレッドにバインドされている対応する EntityManager を認識します。

  getEntityManager と同じですが、元の PersistenceException をスローします。

  パラメーター:

  emf - EntityManager を作成する EntityManagerFactory

  properties - createEntityManager 呼び出しに渡されるプロパティ (null の場合があります)

  synchronizedWithTransaction - 進行中のトランザクションに自動的に参加するかどうか (JPA 2.1 SynchronizationType ルールに準拠)

  戻り値:

  EntityManager、または見つからない場合は null 

  例外:

  PersistenceExceptionEE - EntityManager を作成できなかった場合

  関連事項:

  • getTransactionalEntityManager(jakarta.persistence.EntityManagerFactory)
  • JpaTransactionManager

• applyTransactionTimeout

  public static void applyTransactionTimeout(QueryEE query, EntityManagerFactoryEE emf)

  現在のトランザクションタイムアウトがある場合は、指定された JPA クエリオブジェクトに適用します。

  このメソッドは、それに応じて JPA クエリヒント "jakarta.persistence.query.timeout" を設定します。

  パラメーター:

  query - JPA クエリオブジェクト

  emf - クエリが作成された JPA EntityManagerFactory

• convertJpaAccessExceptionIfPossible

  @Nullable public static DataAccessException convertJpaAccessExceptionIfPossible(RuntimeExceptionSE ex)

  指定されたランタイム例外を org.springframework.dao 階層からの適切な例外に変換します。適切な変換がない場合は null を返します。他の例外はユーザーコードが原因である可能性があるため、変換しないでください。

  ここでは、オブジェクトが見つからない、楽観的ロックの失敗などの最も重要なケースについて説明します。より細かく変換するために、JpaTransactionManager などは JpaDialect を介した例外の高度な変換をサポートしています。

  パラメーター:

  ex - 発生したランタイム例外

  戻り値:

  対応する DataAccessException インスタンス、または例外を変換しない場合は null 

• closeEntityManager

  public static void closeEntityManager(@Nullable EntityManagerEE em)

  指定された JPA EntityManager を閉じ、スローされたクリーンアップ例外をキャッチしてログに記録します。

  パラメーター:

  em - JPA EntityManager を閉じる (null の場合があります)

  関連事項:

  • EntityManager.close()EE