列挙定数の詳細

• REQUIRED

  public static final Propagation REQUIRED

  現在のトランザクションをサポートし、存在しない場合は新しいトランザクションを作成します。同じ名前の EJB トランザクション属性に類似しています。

  これは、トランザクションアノテーションのデフォルト設定です。

• SUPPORTS

  public static final Propagation SUPPORTS

  現在のトランザクションをサポートし、存在しない場合は非トランザクションで実行します。同じ名前の EJB トランザクション属性に類似しています。

  メモ: トランザクション同期を使用するトランザクションマネージャーの場合、PROPAGATION_SUPPORTS は、同期が適用されるトランザクションスコープを定義するため、トランザクションがまったくない場合とは少し異なります。結果として、同じリソース（JDBC 接続、Hibernate セッションなど）が指定されたスコープ全体で共有されます。これは、トランザクションマネージャーの実際の同期構成に依存することに注意してください。

  関連事項:

  AbstractPlatformTransactionManager.setTransactionSynchronization(int)

• MANDATORY

  public static final Propagation MANDATORY

  現在のトランザクションをサポートし、存在しない場合は例外をスローします。同じ名前の EJB トランザクション属性に類似しています。

• REQUIRES_NEW

  public static final Propagation REQUIRES_NEW

  新しいトランザクションを作成し、存在する場合は現在のトランザクションを一時停止します。同じ名前の EJB トランザクション属性に類似しています。

  注意 : 実際のトランザクションの停止は、すべてのトランザクションマネージャーですぐに使用できるわけではありません。これは特に JtaTransactionManager に当てはまります。JtaTransactionManager では、javax.transaction.TransactionManager を使用可能にする必要があります（標準 Java EE ではサーバー固有です）。

  関連事項:

  JtaTransactionManager.setTransactionManager(javax.transaction.TransactionManager)

• NOT_SUPPORTED

  public static final Propagation NOT_SUPPORTED

  非トランザクションで実行し、現在のトランザクションが存在する場合はそれを一時停止します。同じ名前の EJB トランザクション属性に類似しています。

  注意 : 実際のトランザクションの停止は、すべてのトランザクションマネージャーですぐに使用できるわけではありません。これは特に JtaTransactionManager に当てはまります。JtaTransactionManager では、javax.transaction.TransactionManager を使用可能にする必要があります（標準 Java EE ではサーバー固有です）。

  関連事項:

  JtaTransactionManager.setTransactionManager(javax.transaction.TransactionManager)

• NEVER

  public static final Propagation NEVER

  非トランザクションで実行し、トランザクションが存在する場合は例外をスローします。同じ名前の EJB トランザクション属性に類似しています。

• NESTED

  public static final Propagation NESTED

  現在のトランザクションが存在する場合はネストされたトランザクション内で実行し、それ以外の場合は PROPAGATION_REQUIRED のように動作します。EJB には類似の機能はありません。

  メモ: ネストされたトランザクションの実際の作成は、特定のトランザクションマネージャーでのみ機能します。すぐに利用できる、これは JDBC 3.0 ドライバーで作業する場合の JDBCDataSourceTransactionManager にのみ適用されます。一部の JTA プロバイダーは、ネストされたトランザクションもサポートする場合があります。

  関連事項:

  DataSourceTransactionManager

メソッドの詳細

• values

  public static Propagation[] values()

  この列挙型の定数を含む配列を、宣言されている順序で返します。このメソッドは、次のように定数を反復するために使用できます。

  for (Propagation c : Propagation.values())
      System.out.println(c);
  

  戻り値:

  この列挙型の定数を宣言されている順序で含む配列

• valueOf

  public static Propagation valueOf(StringSE name)

  指定された名前を持つこの型の列挙定数を返します。文字列は、この型の列挙定数を宣言するために使用される識別子と正確に一致する必要があります。(余分な空白文字は許可されません。)

  パラメーター:

  name - 返される列挙定数の名前。

  戻り値:

  指定された名前の列挙定数

  例外:

  IllegalArgumentExceptionSE - この列挙型に指定された名前の定数がない場合

  NullPointerExceptionSE - 引数が null の場合

• value

  public int value()