クラス DefaultTransactionDefinition

メソッドの詳細

• setPropagationBehaviorName

  public final void setPropagationBehaviorName(StringSE constantName) throws IllegalArgumentExceptionSE

  TransactionDefinition の対応する定数の名前によって伝播動作を設定します。たとえば、"PROPAGATION_REQUIRED"。

  パラメーター:

  constantName - 定数の名前

  例外:

  IllegalArgumentExceptionSE - 指定された値が PROPAGATION_ 定数の 1 つに解決できない場合、または null である場合

  関連事項:

  • setPropagationBehavior(int)
  • TransactionDefinition.PROPAGATION_REQUIRED

• setPropagationBehavior

  public final void setPropagationBehavior(int propagationBehavior)

  伝播動作を設定します。TransactionDefinition インターフェースの伝搬定数のいずれかでなければなりません。デフォルトは PROPAGATION_REQUIRED です。

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

  TransactionDefinition.ISOLATION_DEFAULT 以外のレベルが指定された場合、カスタム分離レベルをサポートしないトランザクションマネージャーは例外をスローすることに注意してください。

  例外:

  IllegalArgumentExceptionSE - 指定された値が PROPAGATION_ 定数のいずれでもない場合

  関連事項:

  • TransactionDefinition.PROPAGATION_REQUIRED

• getPropagationBehavior

  public final int getPropagationBehavior()

  インターフェースからコピーされた説明: TransactionDefinition

  伝播動作を返します。

  this interface で定義された PROPAGATION_XXX 定数のいずれかを返さなければなりません。

  デフォルトは TransactionDefinition.PROPAGATION_REQUIRED です。

  次で指定:

  インターフェース TransactionDefinition の getPropagationBehavior 

  戻り値:

  伝播挙動

  関連事項:

  • TransactionDefinition.PROPAGATION_REQUIRED
  • TransactionSynchronizationManager.isActualTransactionActive()

• setIsolationLevelName

  public final void setIsolationLevelName(StringSE constantName) throws IllegalArgumentExceptionSE

  TransactionDefinition の対応する定数の名前によって分離レベルを設定します。たとえば、"ISOLATION_DEFAULT"。

  パラメーター:

  constantName - 定数の名前

  例外:

  IllegalArgumentExceptionSE - 指定された値が ISOLATION_ 定数の 1 つに解決できない場合、または null である場合

  関連事項:

  • setIsolationLevel(int)
  • TransactionDefinition.ISOLATION_DEFAULT

• setIsolationLevel

  public final void setIsolationLevel(int isolationLevel)

  分離レベルを設定します。TransactionDefinition インターフェースの分離定数の 1 つでなければなりません。デフォルトは ISOLATION_DEFAULT です。

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

  TransactionDefinition.ISOLATION_DEFAULT 以外のレベルが指定された場合、カスタム分離レベルをサポートしないトランザクションマネージャーは例外をスローすることに注意してください。

  例外:

  IllegalArgumentExceptionSE - 指定された値が ISOLATION_ 定数のいずれでもない場合

  関連事項:

  • TransactionDefinition.ISOLATION_DEFAULT

• getIsolationLevel

  public final int getIsolationLevel()

  インターフェースからコピーされた説明: TransactionDefinition

  分離レベルを返します。

  this interface で定義された ISOLATION_XXX 定数のいずれかを返さなければなりません。これらの定数は、ConnectionSE の同じ定数の値と一致するように設計されています。

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

  デフォルトは TransactionDefinition.ISOLATION_DEFAULT です。TransactionDefinition.ISOLATION_DEFAULT 以外のレベルが指定された場合、カスタム分離レベルをサポートしないトランザクションマネージャーは例外をスローすることに注意してください。

  次で指定:

  インターフェース TransactionDefinition の getIsolationLevel 

  戻り値:

  分離レベル

  関連事項:

  • TransactionDefinition.ISOLATION_DEFAULT
  • AbstractPlatformTransactionManager.setValidateExistingTransaction(boolean)

• setTimeout

  public final void setTimeout(int timeout)

  秒数として、適用するタイムアウトを設定します。デフォルトは TIMEOUT_DEFAULT（-1）です。

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

  タイムアウトをサポートしないトランザクションマネージャーは、TransactionDefinition.TIMEOUT_DEFAULT 以外のタイムアウトが指定された場合に例外をスローすることに注意してください。

  関連事項:

  • TransactionDefinition.TIMEOUT_DEFAULT

• getTimeout

  public final int getTimeout()

  インターフェースからコピーされた説明: TransactionDefinition

  トランザクションタイムアウトを返します。

  秒数または TransactionDefinition.TIMEOUT_DEFAULT を返す必要があります。

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

  タイムアウトをサポートしないトランザクションマネージャーは、TransactionDefinition.TIMEOUT_DEFAULT 以外のタイムアウトが指定された場合に例外をスローすることに注意してください。

  デフォルトは TransactionDefinition.TIMEOUT_DEFAULT です。

  次で指定:

  インターフェース TransactionDefinition の getTimeout 

  戻り値:

  トランザクションのタイムアウト

• setReadOnly

  public final void setReadOnly(boolean readOnly)

  読み取り専用トランザクションとして最適化するかどうかを設定します。デフォルトは "false" です。

  読み取り専用フラグは、実際のリソーストランザクション（TransactionDefinition.PROPAGATION_REQUIRED/TransactionDefinition.PROPAGATION_REQUIRES_NEW）によって裏付けられているか、リソースレベルで非トランザクションで動作している（TransactionDefinition.PROPAGATION_SUPPORTS）かに関わらず、すべてのトランザクションコンテキストに適用されます。後者の場合、フラグは Hibernate Session などのアプリケーション内の管理対象リソースにのみ適用されます。

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

• isReadOnly

  public final boolean isReadOnly()

  インターフェースからコピーされた説明: TransactionDefinition

  読み取り専用トランザクションとして最適化するかどうかを返します。

  読み取り専用フラグは、実際のリソーストランザクション（TransactionDefinition.PROPAGATION_REQUIRED/TransactionDefinition.PROPAGATION_REQUIRES_NEW）によって裏付けられているか、リソースレベルで非トランザクションで動作している（TransactionDefinition.PROPAGATION_SUPPORTS）かに関わらず、すべてのトランザクションコンテキストに適用されます。後者の場合、フラグは Hibernate Session などのアプリケーション内の管理対象リソースにのみ適用されます。

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

  次で指定:

  インターフェース TransactionDefinition の isReadOnly 

  戻り値:

  トランザクションを読み取り専用として最適化する場合は true (デフォルトで false )

  関連事項:

  • TransactionSynchronization.beforeCommit(boolean)
  • TransactionSynchronizationManager.isCurrentTransactionReadOnly()

• setName

  public final void setName(StringSE name)

  このトランザクションの名前を設定します。デフォルトはなしです。

  これは、トランザクションモニターに表示されるトランザクション名として使用されます（該当する場合）（たとえば、WebLogic's）。

• getName

  @Nullable public final StringSE getName()

  インターフェースからコピーされた説明: TransactionDefinition

  このトランザクションの名前を返します。null にすることができます。

  これは、該当する場合、トランザクションモニターに表示されるトランザクション名として使用されます。

  Spring の宣言的トランザクションの場合、公開される名前は fully-qualified class name + "." + method name （デフォルト）です。

  次で指定:

  インターフェース TransactionDefinition の getName 

  戻り値:

  このトランザクションの名前（デフォルトでは null }

  関連事項:

  • TransactionAspectSupport
  • TransactionSynchronizationManager.getCurrentTransactionName()

• equals

  public boolean equals(@Nullable ObjectSE other)

  この実装は、toString() の結果を比較します。

  オーバーライド:

  クラス ObjectSE の equalsSE 

  関連事項:

  • toString()

• hashCode

  public int hashCode()

  この実装は、toString() のハッシュコードを返します。

  オーバーライド:

  クラス ObjectSE の hashCode 

  関連事項:

  • toString()

• toString

  public StringSE toString()

  このトランザクション定義の識別記述を返します。

  形式は、toString の結果を TransactionAttribute 型の Bean プロパティにフィードできるように、TransactionAttributeEditor で使用される形式と一致します。

  equals および hashCode の正しい動作のために、サブクラスでオーバーライドする必要があります。または、equals(java.lang.Object) および hashCode() をそれ自体でオーバーライドできます。

  オーバーライド:

  クラス ObjectSE の toString 

  関連事項:

  • getDefinitionDescription()
  • TransactionAttributeEditor

• getDefinitionDescription

  protected final StringBuilderSE getDefinitionDescription()

  このトランザクション定義の識別記述を返します。

  toString() 結果に含めるために、サブクラスで使用できます。