クラス DefaultTransactionStatus
java.lang.ObjectSE
org.springframework.transaction.support.AbstractTransactionStatus
org.springframework.transaction.support.DefaultTransactionStatus
- 実装されているすべてのインターフェース:
FlushableSE、SavepointManager、TransactionExecution、TransactionStatus
AbstractPlatformTransactionManager によって使用される TransactionStatus インターフェースのデフォルト実装。基礎となる「トランザクションオブジェクト」の概念に基づいています。AbstractPlatformTransactionManager が内部的に必要とするすべてのステータス情報を保持します。これには、具体的なトランザクションマネージャーの実装によって決定される一般的なトランザクションオブジェクトが含まれます。
SavepointManager インターフェースを実装するトランザクションオブジェクトへのセーブポイント関連メソッドの委譲をサポートします。
注 : これは、特にないテスト環境でのモックトランザクションマネージャーのため、他の PlatformTransactionManager の実装で使用するためのものではありません。代わりに、プレーンな TransactionStatus インターフェースの代替 SimpleTransactionStatus クラスまたはモックを使用してください。
コンストラクターの概要
コンストラクターコンストラクター説明DefaultTransactionStatus(ObjectSE transaction, boolean newTransaction, boolean newSynchronization, boolean readOnly, boolean debug, ObjectSE suspendedResources) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。DefaultTransactionStatus(StringSE transactionName, ObjectSE transaction, boolean newTransaction, boolean newSynchronization, boolean nested, boolean readOnly, boolean debug, ObjectSE suspendedResources) 新しいDefaultTransactionStatusインスタンスを作成します。メソッドのサマリー
修飾子と型メソッド説明voidflush()トランザクションオブジェクトがSmartTransactionObjectインターフェースを実装している場合は、トランザクションオブジェクトにフラッシュを委譲します。protected SavepointManagerこの実装は、基になるトランザクションオブジェクトのSavepointManagerインターフェースを公開します（存在する場合）。このトランザクションで中断されているリソースの所有者を返します（ある場合）。基になるトランザクションオブジェクトを返します。トランザクションの定義された名前 (空の文字列の可能性があります) を返します。boolean実際のトランザクションがアクティブであるかどうかを返します。これは、新しいトランザクションだけでなく既存のトランザクションへの参加もカバーすることを目的としており、実際のトランザクションがまったく実行されていない場合にのみfalseを返します。booleanisDebug()このトランザクションの進行状況をデバッグするかどうかを返します。booleanトランザクションオブジェクトがSmartTransactionObjectインターフェースを実装している場合は、トランザクションオブジェクトをチェックして、ロールバックのみのフラグを決定します。booleanisNested()このトランザクションが別のトランザクション内でネストされた形式で実行される場合に返します。booleanこのトランザクションに対して新しいトランザクション同期が開かれた場合に返されます。booleanトランザクションマネージャーが現在のトランザクションを新しいトランザクションと見なすかどうかを返します。それ以外の場合は、既存のトランザクションに参加しているか、そもそも実際のトランザクションで実行されていない可能性があります。booleanこのトランザクションが読み取り専用トランザクションとして定義されている場合に返されます。boolean基になるトランザクションがSavepointManagerインターフェースを実装しているため、セーブポイントをサポートしているかどうかを返します。クラス org.springframework.transaction.support.AbstractTransactionStatus から継承されたメソッド
createAndHoldSavepoint, createSavepoint, getSavepoint, hasSavepoint, isCompleted, isLocalRollbackOnly, isRollbackOnly, releaseHeldSavepoint, releaseSavepoint, rollbackToHeldSavepoint, rollbackToSavepoint, setCompleted, setRollbackOnly, setSavepoint
コンストラクターの詳細
DefaultTransactionStatus
public DefaultTransactionStatus(@Nullable StringSE transactionName, @Nullable ObjectSE transaction, boolean newTransaction, boolean newSynchronization, boolean nested, boolean readOnly, boolean debug, @Nullable ObjectSE suspendedResources) 新しいDefaultTransactionStatusインスタンスを作成します。- パラメーター:
transactionName- トランザクションの定義された名前transaction- 内部トランザクション実装の状態を保持できる基になるトランザクションオブジェクトnewTransaction- トランザクションが新しい場合、それ以外の場合は既存のトランザクションに参加しますnewSynchronization- 指定されたトランザクションに対して新しいトランザクション同期が開かれた場合readOnly- トランザクションが読み取り専用としてマークされているかどうかdebug- このトランザクションを処理するには、デバッグログを有効にする必要がありますか？ ここでキャッシュすることで、デバッグシステムを有効にするかどうかをログシステムに問い合わせる繰り返し呼び出しを防ぐことができます。suspendedResources- このトランザクションのために中断されたリソースの所有者（存在する場合）- 導入:
- 6.1
DefaultTransactionStatus
@DeprecatedSE(since="6.1", forRemoval=true) public DefaultTransactionStatus(@Nullable ObjectSE transaction, boolean newTransaction, boolean newSynchronization, boolean readOnly, boolean debug, @Nullable ObjectSE suspendedResources) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
メソッドの詳細
getTransactionName
インターフェースからコピーされた説明:TransactionExecutionトランザクションの定義された名前 (空の文字列の可能性があります) を返します。Spring の宣言的トランザクションの場合、公開される名前は
fully-qualified class name + "." + method name（デフォルト）です。デフォルトの実装は空の文字列を返します。
getTransaction
基になるトランザクションオブジェクトを返します。- 例外:
IllegalStateExceptionSE- アクティブなトランザクションがない場合
hasTransaction
public boolean hasTransaction()インターフェースからコピーされた説明:TransactionExecution実際のトランザクションがアクティブであるかどうかを返します。これは、新しいトランザクションだけでなく既存のトランザクションへの参加もカバーすることを目的としており、実際のトランザクションがまったく実行されていない場合にのみfalseを返します。デフォルトの実装は
trueを返します。isNewTransaction
public boolean isNewTransaction()インターフェースからコピーされた説明:TransactionExecutionトランザクションマネージャーが現在のトランザクションを新しいトランザクションと見なすかどうかを返します。それ以外の場合は、既存のトランザクションに参加しているか、そもそも実際のトランザクションで実行されていない可能性があります。これは主にトランザクションマネージャーの状態処理のために使用されます。通常、これは意味的に適切であるため、アプリケーション目的には
TransactionExecution.hasTransaction()の使用を優先します。「新しい」ステータスはトランザクションマネージャー固有のものである可能性があります。たとえば、実際のネストされたトランザクションに対しては
trueを返しますが、セーブポイント管理が明示的に公開されている場合 (TransactionStatusなど)、セーブポイントベースのネストされたトランザクションスコープに対してはfalseを返す可能性があります。あらゆる種類のネストされた実行に対する複合チェックは、TransactionExecution.isNested()によって提供されます。デフォルトの実装は
trueを返します。isNewSynchronization
public boolean isNewSynchronization()このトランザクションに対して新しいトランザクション同期が開かれた場合に返されます。isNested
public boolean isNested()インターフェースからコピーされた説明:TransactionExecutionこのトランザクションが別のトランザクション内でネストされた形式で実行される場合に返します。デフォルトの実装は
falseを返します。isReadOnly
public boolean isReadOnly()インターフェースからコピーされた説明:TransactionExecutionこのトランザクションが読み取り専用トランザクションとして定義されている場合に返されます。デフォルトの実装は
falseを返します。isDebug
public boolean isDebug()このトランザクションの進行状況をデバッグするかどうかを返します。これは、logger.isDebugEnabled()への繰り返し呼び出しを防ぐために、AbstractPlatformTransactionManagerによって最適化として使用されます。実際にはクライアントコードを対象としていません。getSuspendedResources
このトランザクションで中断されているリソースの所有者を返します（ある場合）。isGlobalRollbackOnly
public boolean isGlobalRollbackOnly()トランザクションオブジェクトがSmartTransactionObjectインターフェースを実装している場合は、トランザクションオブジェクトをチェックして、ロールバックのみのフラグを決定します。たとえばタイムアウトが発生した場合など、グローバルトランザクション自体がトランザクションコーディネーターによってロールバックのみとマークされている場合、
trueを返します。- オーバーライド:
- クラス
AbstractTransactionStatusのisGlobalRollbackOnly - 関連事項:
getSavepointManager
この実装は、基になるトランザクションオブジェクトのSavepointManagerインターフェースを公開します（存在する場合）。- オーバーライド:
- クラス
AbstractTransactionStatusのgetSavepointManager - 例外:
NestedTransactionNotSupportedException- セーブポイントがサポートされていない場合- 関連事項:
isTransactionSavepointManager
public boolean isTransactionSavepointManager()基になるトランザクションがSavepointManagerインターフェースを実装しているため、セーブポイントをサポートしているかどうかを返します。flush
public void flush()トランザクションオブジェクトがSmartTransactionObjectインターフェースを実装している場合は、トランザクションオブジェクトにフラッシュを委譲します。