DefaultTransactionDefinition (Spring Framework API)

java.lang.ObjectSE
- org.springframework.transaction.support.DefaultTransactionDefinition

実装されているすべてのインターフェース:
SerializableSE, TransactionDefinition
既知の直属サブクラス
DefaultTransactionAttribute, TransactionTemplate
```
public class DefaultTransactionDefinition
extends ObjectSE
implements TransactionDefinition, SerializableSE
```
TransactionDefinition インターフェースのデフォルト実装。Bean スタイルの構成と適切なデフォルト値（PROPAGATION_REQUIRED、ISOLATION_DEFAULT、TIMEOUT_DEFAULT、readOnly = false）を提供します。
TransactionTemplate と DefaultTransactionAttribute の両方の基本クラス。
導入:
08.05.2003
作成者:
Juergen Hoeller
関連事項:
連載形式

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static StringSE`	`PREFIX_ISOLATION` TransactionDefinition で定義されている分離定数のプレフィックス。
`static StringSE`	`PREFIX_PROPAGATION` TransactionDefinition で定義された伝搬定数のプレフィックス。
`static StringSE`	`PREFIX_TIMEOUT` 説明文字列のトランザクションタイムアウト値のプレフィックス。
`static StringSE`	`READ_ONLY_MARKER` 説明文字列内の読み取り専用トランザクションのマーカー。

インターフェース org.springframework.transaction.TransactionDefinition から継承されたフィールド
ISOLATION_DEFAULT, ISOLATION_READ_COMMITTED, ISOLATION_READ_UNCOMMITTED, ISOLATION_REPEATABLE_READ, ISOLATION_SERIALIZABLE, PROPAGATION_MANDATORY, PROPAGATION_NESTED, PROPAGATION_NEVER, PROPAGATION_NOT_SUPPORTED, PROPAGATION_REQUIRED, PROPAGATION_REQUIRES_NEW, PROPAGATION_SUPPORTS, TIMEOUT_DEFAULT

コンストラクターの概要

コンストラクター
コンストラクターと説明
`DefaultTransactionDefinition()` デフォルト設定で、新しい DefaultTransactionDefinition を作成します。
`DefaultTransactionDefinition(int propagationBehavior)` 指定された伝播動作で新しい DefaultTransactionDefinition を作成します。
`DefaultTransactionDefinition(TransactionDefinition other)` コピーコンストラクター。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`boolean`	`equals(ObjectSE other)` この実装は、`toString()` の結果を比較します。
`protected StringBuilderSE`	`getDefinitionDescription()` このトランザクション定義の識別記述を返します。
`int`	`getIsolationLevel()` 分離レベルを返します。
`StringSE`	`getName()` このトランザクションの名前を返します。
`int`	`getPropagationBehavior()` 伝播動作を返します。
`int`	`getTimeout()` トランザクションタイムアウトを返します。
`int`	`hashCode()` この実装は、`toString()` のハッシュコードを返します。
`boolean`	`isReadOnly()` 読み取り専用トランザクションとして最適化するかどうかを返します。
`void`	`setIsolationLevel(int isolationLevel)` 分離レベルを設定します。
`void`	`setIsolationLevelName(StringSE constantName)` TransactionDefinition の対応する定数の名前で分離レベルを設定します。
`void`	`setName(StringSE name)` このトランザクションの名前を設定します。
`void`	`setPropagationBehavior(int propagationBehavior)` 伝播動作を設定します。
`void`	`setPropagationBehaviorName(StringSE constantName)` TransactionDefinition の対応する定数の名前で伝播動作を設定します。
`void`	`setReadOnly(boolean readOnly)` 読み取り専用トランザクションとして最適化するかどうかを設定します。
`void`	`setTimeout(int timeout)` 秒数として、適用するタイムアウトを設定します。
`StringSE`	`toString()` このトランザクション定義の識別記述を返します。

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, finalizeSE, getClassSE, notifySE, notifyAllSE, waitSE, waitSE, waitSE

インターフェース org.springframework.transaction.TransactionDefinition から継承されたメソッド
withDefaults

- フィールドの詳細
  - PREFIX_PROPAGATION
```
public static final StringSE PREFIX_PROPAGATION
```
    TransactionDefinition で定義された伝搬定数のプレフィックス。
    関連事項:
    定数フィールド値
  - PREFIX_ISOLATION
```
public static final StringSE PREFIX_ISOLATION
```
    TransactionDefinition で定義されている分離定数のプレフィックス。
    関連事項:
    定数フィールド値
  - PREFIX_TIMEOUT
```
public static final StringSE PREFIX_TIMEOUT
```
    説明文字列のトランザクションタイムアウト値のプレフィックス。
    関連事項:
    定数フィールド値
  - READ_ONLY_MARKER
```
public static final StringSE READ_ONLY_MARKER
```
    説明文字列内の読み取り専用トランザクションのマーカー。
    関連事項:
    定数フィールド値
- コンストラクターの詳細
  - DefaultTransactionDefinition
```
public DefaultTransactionDefinition()
```
    デフォルト設定で、新しい DefaultTransactionDefinition を作成します。Bean プロパティ setter を使用して変更できます。
    関連事項:
    setPropagationBehavior(int), setIsolationLevel(int), setTimeout(int), setReadOnly(boolean), setName(java.lang.String)
  - DefaultTransactionDefinition
```
public DefaultTransactionDefinition(TransactionDefinition other)
```
    コンストラクターをコピーします。定義は、Bean プロパティ setter を介して変更できます。
    関連事項:
    setPropagationBehavior(int), setIsolationLevel(int), setTimeout(int), setReadOnly(boolean), setName(java.lang.String)
  - DefaultTransactionDefinition
```
public DefaultTransactionDefinition(int propagationBehavior)
```
    指定された伝播動作で新しい DefaultTransactionDefinition を作成します。Bean プロパティ setter を使用して変更できます。
    パラメーター:
    propagationBehavior - TransactionDefinition インターフェースの伝搬定数の 1 つ
    関連事項:
    setIsolationLevel(int), setTimeout(int), setReadOnly(boolean)
- メソッドの詳細
  - 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 にすることができます。
    これは、該当する場合、トランザクションモニターに表示されるトランザクション名として使用されます（たとえば、WebLogic's）。
    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 の hashCodeSE
    関連事項:
    toString()
  - toString
```
public StringSE toString()
```
    このトランザクション定義の識別記述を返します。
    形式は、toString の結果を TransactionAttribute 型の Bean プロパティにフィードできるように、TransactionAttributeEditor で使用される形式と一致します。
    equals および hashCode の正しい動作のために、サブクラスでオーバーライドする必要があります。または、equals(java.lang.Object) および hashCode() をそれ自体でオーバーライドできます。
    オーバーライド:
    クラス ObjectSE の toStringSE
    関連事項:
    getDefinitionDescription(), TransactionAttributeEditor
  - getDefinitionDescription
```
protected final StringBuilderSE getDefinitionDescription()
```
    このトランザクション定義の識別記述を返します。
    toString() 結果に含めるために、サブクラスで使用できます。

クラス DefaultTransactionDefinition

フィールドのサマリー

インターフェース org.springframework.transaction.TransactionDefinition から継承されたフィールド

コンストラクターの概要

メソッドのサマリー

クラス java.lang.ObjectSE から継承されたメソッド

インターフェース org.springframework.transaction.TransactionDefinition から継承されたメソッド

フィールドの詳細

PREFIX_PROPAGATION

PREFIX_ISOLATION

PREFIX_TIMEOUT

READ_ONLY_MARKER

コンストラクターの詳細

DefaultTransactionDefinition

DefaultTransactionDefinition

DefaultTransactionDefinition

メソッドの詳細

setPropagationBehaviorName

setPropagationBehavior

getPropagationBehavior

setIsolationLevelName

setIsolationLevel

getIsolationLevel

setTimeout

getTimeout

setReadOnly

isReadOnly

setName

getName

equals

hashCode

toString

getDefinitionDescription