アノテーションインターフェース Transactional

要素の詳細

• value

  @AliasFor("transactionManager") StringSE value

  transactionManager() のエイリアス。

  関連事項:

  • transactionManager()

  デフォルト:

  ""

• transactionManager

  @AliasFor("value") StringSE transactionManager

  指定されたトランザクションの修飾子値。

  特定の TransactionManager Bean 定義の修飾子値（または Bean 名）に一致するターゲットトランザクションマネージャーを決定するために使用できます。

  あるいは、6.2 以降では、qualifier value を含む型レベルの Bean 修飾子アノテーションも考慮されます。特定のトランザクションマネージャーの修飾子値 (または Bean 名) と一致する場合、そのトランザクションマネージャーは、この属性に特定の修飾子がないトランザクション定義に使用されます。このような型レベルの修飾子は、具象クラスで宣言でき、基本クラスのトランザクション定義にも適用され、修飾されていない基本クラスメソッドのデフォルトのトランザクションマネージャーの選択を効果的にオーバーライドします。

  導入:

  4.2

  関連事項:

  • value()
  • PlatformTransactionManager
  • ReactiveTransactionManager

  デフォルト:

  ""

• label

  StringSE[] label

  ゼロ (0) 以上のトランザクションラベルを定義します。

  ラベルはトランザクションを説明するために使用でき、個々のトランザクションマネージャーが評価できます。ラベルは、単に説明的な目的を果たしたり、事前定義されたトランザクションマネージャー固有のオプションにマップしたりする場合があります。

  トランザクションラベルの評価方法の詳細については、実際のトランザクションマネージャーの実装に関するドキュメントを参照してください。

  導入:

  5.3

  関連事項:

  • DefaultTransactionAttribute.getLabels()

  デフォルト:

  {}

• propagation

  Propagation propagation

  トランザクション伝播型。

  デフォルトは Propagation.REQUIRED です。

  関連事項:

  • TransactionDefinition.getPropagationBehavior()

  デフォルト:

  REQUIRED

• isolation

  Isolation isolation

  トランザクション分離レベル。

  デフォルトは Isolation.DEFAULT です。

  新しく開始されたトランザクションにのみ適用されるため、Propagation.REQUIRED または Propagation.REQUIRES_NEW で使用するために特別に設計されています。異なる分離レベルの既存のトランザクションに参加するときに分離レベルの宣言を拒否したい場合は、トランザクションマネージャーで "validateExistingTransactions" フラグを "true" に切り替えることを検討してください。

  関連事項:

  • TransactionDefinition.getIsolationLevel()
  • AbstractPlatformTransactionManager.setValidateExistingTransaction(boolean)

  デフォルト:

  DEFAULT

• timeout

  int timeout

  このトランザクションのタイムアウト（秒単位）。

  基になるトランザクションシステムのデフォルトのタイムアウトがデフォルトになります。

  新たに開始されたトランザクションにのみ適用されるため、Propagation.REQUIRED または Propagation.REQUIRES_NEW での使用専用に設計されています。

  戻り値:

  秒単位のタイムアウト

  関連事項:

  • TransactionDefinition.getTimeout()

  デフォルト:

  -1

• timeoutString

  StringSE timeoutString

  このトランザクションのタイムアウト（秒単位）。

  基になるトランザクションシステムのデフォルトのタイムアウトがデフォルトになります。

  新たに開始されたトランザクションにのみ適用されるため、Propagation.REQUIRED または Propagation.REQUIRES_NEW での使用専用に設計されています。

  戻り値:

  タイムアウトを秒単位で文字列値で指定します。たとえばプレースホルダーなどです

  導入:

  5.3

  関連事項:

  • TransactionDefinition.getTimeout()

  デフォルト:

  ""

• readOnly

  boolean readOnly

  トランザクションが事実上読み取り専用である場合に true に設定できるブールフラグ。実行時に対応する最適化が可能です。

  デフォルトは false です。

  これは、実際のトランザクションサブシステムのヒントとしてのみ機能します。 必ずしも書き込みアクセスの試行が失敗するわけではありません。読み取り専用ヒントを解釈できないトランザクションマネージャーは、読み取り専用トランザクションを要求されたときに例外をスローせず、静かにヒントを無視します。

  関連事項:

  • TransactionDefinition.isReadOnly()
  • TransactionSynchronizationManager.isCurrentTransactionReadOnly()

  デフォルト:

  false

• rollbackFor

  ClassSE<? extends ThrowableSE>[] rollbackFor

  ゼロ (0) 以上の例外型SEを定義します。これは ThrowableSE のサブクラスである必要があり、どの例外型がトランザクションロールバックを引き起こす必要があるかを示します。

  デフォルトでは、トランザクションは RuntimeExceptionSE および ErrorSE でロールバックされますが、チェックされた例外（ビジネス例外）ではロールバックされません。詳細な説明については、DefaultTransactionAttribute.rollbackOn(Throwable) を参照してください。

  これは、( rollbackForClassName() とは対照的に) ロールバックルールを構築するための推奨される方法であり、型 セーフな方法で例外型とそのサブクラスを照合します。ロールバックルールのセマンティクスの詳細については、クラスレベルの javadoc を参照してください。

  関連事項:

  • rollbackForClassName()
  • RollbackRuleAttribute(Class)
  • DefaultTransactionAttribute.rollbackOn(Throwable)

  デフォルト:

  {}

• rollbackForClassName

  StringSE[] rollbackForClassName

  ゼロ (0) 以上の例外名パターン（ThrowableSE のサブクラスでなければならない例外の場合）を定義し、どの例外型がトランザクションのロールバックを引き起こさなければならないかを示します。

  ロールバックルールのセマンティクス、パターン、意図しない一致の可能性に関する警告の詳細については、クラスレベルの javadoc を参照してください。

  関連事項:

  • rollbackFor()
  • RollbackRuleAttribute(String)
  • DefaultTransactionAttribute.rollbackOn(Throwable)

  デフォルト:

  {}

• noRollbackFor

  ClassSE<? extends ThrowableSE>[] noRollbackFor

  ゼロ (0) 以上の例外 typesSE を定義します。これは ThrowableSE のサブクラスである必要があり、どの例外型がトランザクションのロールバックを引き起こしてはならないかを示します。

  これは、( noRollbackForClassName() とは対照的に) ロールバックルールを構築するための推奨される方法であり、型 セーフな方法で例外型とそのサブクラスを照合します。ロールバックルールのセマンティクスの詳細については、クラスレベルの javadoc を参照してください。

  関連事項:

  • noRollbackForClassName()
  • NoRollbackRuleAttribute(Class)
  • DefaultTransactionAttribute.rollbackOn(Throwable)

  デフォルト:

  {}

• noRollbackForClassName

  StringSE[] noRollbackForClassName

  ゼロ (0) 以上の例外名パターン（ThrowableSE のサブクラスでなければならない例外の場合）を定義し、どの例外型がトランザクションのロールバックを引き起こしてはならないかを示します。

  ロールバックルールのセマンティクス、パターン、意図しない一致の可能性に関する警告の詳細については、クラスレベルの javadoc を参照してください。

  関連事項:

  • noRollbackFor()
  • NoRollbackRuleAttribute(String)
  • DefaultTransactionAttribute.rollbackOn(Throwable)

  デフォルト:

  {}