要素の詳細

• value

  @AliasFor(value="transactionManager")
  public abstract StringSE value

  transactionManager() のエイリアス。

  関連事項:

  transactionManager()

  デフォルト:

  ""

• transactionManager

  @AliasFor(value="value")
  public abstract StringSE transactionManager

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

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

  導入:

  4.2

  関連事項:

  value(), PlatformTransactionManager, ReactiveTransactionManager

  デフォルト:

  ""

• label

  public abstract StringSE[] label

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

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

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

  導入:

  5.3

  関連事項:

  DefaultTransactionAttribute.getLabels()

  デフォルト:

  {}

• propagation

  public abstract Propagation propagation

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

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

  関連事項:

  TransactionDefinition.getPropagationBehavior()

  デフォルト:

  org.springframework.transaction.annotation.Propagation.REQUIRED

• isolation

  public abstract Isolation isolation

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

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

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

  関連事項:

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

  デフォルト:

  org.springframework.transaction.annotation.Isolation.DEFAULT

• timeout

  public abstract int timeout

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

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

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

  戻り値:

  秒単位のタイムアウト

  関連事項:

  TransactionDefinition.getTimeout()

  デフォルト:

  -1

• timeoutString

  public abstract StringSE timeoutString

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

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

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

  戻り値:

  文字列値としての秒単位のタイムアウト。例: プレースホルダー

  導入:

  5.3

  関連事項:

  TransactionDefinition.getTimeout()

  デフォルト:

  ""

• readOnly

  public abstract boolean readOnly

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

  デフォルトは false です。

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

  関連事項:

  TransactionDefinition.isReadOnly(), TransactionSynchronizationManager.isCurrentTransactionReadOnly()

  デフォルト:

  false

• rollbackFor

  public abstract ClassSE<? extends ThrowableSE>[] rollbackFor

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

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

  これは、（rollbackForClassName() とは対照的に）例外クラスとそのサブクラスを一致させるロールバックルールを構築するための推奨する方法です。

  RollbackRuleAttribute(Class clazz) に似ています。

  関連事項:

  rollbackForClassName(), DefaultTransactionAttribute.rollbackOn(Throwable)

  デフォルト:

  {}

• rollbackForClassName

  public abstract StringSE[] rollbackForClassName

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

  これは、完全修飾クラス名の部分文字列にすることができますが、現在のところワイルドカードはサポートされていません。例: "ServletException" の値は javax.servlet.ServletException とそのサブクラスに一致します。

  NB: パターンの具体性と、パッケージ情報を含めるかどうか（これは必須ではありません）を慎重に検討してください。例: "Exception" はほぼすべてに一致し、おそらく他のルールを非表示にします。"Exception" がすべてのチェック済み例外のルールを定義することを意図していた場合、"java.lang.Exception" は正しいでしょう。"BaseBusinessException" などのより珍しい ExceptionSE 名では、FQN を使用する必要はありません。

  RollbackRuleAttribute(String exceptionName) に似ています。

  関連事項:

  rollbackFor(), DefaultTransactionAttribute.rollbackOn(Throwable)

  デフォルト:

  {}

• noRollbackFor

  public abstract ClassSE<? extends ThrowableSE>[] noRollbackFor

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

  これは、（noRollbackForClassName() とは対照的に）例外クラスとそのサブクラスを一致させるロールバックルールを構築するための推奨する方法です。

  NoRollbackRuleAttribute(Class clazz) に似ています。

  関連事項:

  noRollbackForClassName(), DefaultTransactionAttribute.rollbackOn(Throwable)

  デフォルト:

  {}

• noRollbackForClassName

  public abstract StringSE[] noRollbackForClassName

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

  指定された名前の処理方法の詳細については、rollbackForClassName() の説明を参照してください。

  NoRollbackRuleAttribute(String exceptionName) に似ています。

  関連事項:

  noRollbackFor(), DefaultTransactionAttribute.rollbackOn(Throwable)

  デフォルト:

  {}