WebSphereUowTransactionManager (Spring Framework API)

java.lang.ObjectSE
- org.springframework.transaction.support.AbstractPlatformTransactionManager
- - org.springframework.transaction.jta.JtaTransactionManager
  - - org.springframework.transaction.jta.WebSphereUowTransactionManager

実装されているすべてのインターフェース:
SerializableSE, InitializingBean, TransactionFactory, PlatformTransactionManager, CallbackPreferringPlatformTransactionManager, TransactionManager
```
public class WebSphereUowTransactionManager
extends JtaTransactionManager
implements CallbackPreferringPlatformTransactionManager
```
WebSphere の JNDI 環境から取得した、UOWManager インスタンスに委譲する WebSphere 固有の PlatformTransactionManager 実装。これにより、Spring は、公式にサポートされている WebSphere API に完全に準拠した方法で、トランザクションの一時停止を含む WebSphere トランザクションコーディネーターの全機能を活用できます。
このクラスによって実装される CallbackPreferringPlatformTransactionManager インターフェースは、呼び出し側が execute(org.springframework.transaction.TransactionDefinition, org.springframework.transaction.support.TransactionCallback<T>) メソッドを介して TransactionCallback を渡す必要があることを示します。これは、標準の JTA API（UserTransaction/TransactionManager）ではなく、コールバックベースの WebSphere UOWManager API を介して処理されます。これにより、WebSphere で非公開の javax.transaction.TransactionManager API を使用せずに、サポートされている WebSphere API 境界内にとどまります。
このトランザクションマネージャーの実装は、Spring の標準 JtaTransactionManager から派生し、TransactionCallback ベースの execute(org.springframework.transaction.TransactionDefinition, org.springframework.transaction.support.TransactionCallback<T>) メソッドを使用しない呼び出し元に対して、JTA UserTransaction ハンドルを介した getTransaction / commit / rollback 呼び出しを介したプログラムによるトランザクション境界をサポートする機能を継承しています。ただし、この getTransaction スタイルではトランザクションの一時停止はサポートされていません（公式の WebSphere の推奨事項にかかわらず、JtaTransactionManager.setTransactionManager(javax.transaction.TransactionManager) 参照を明示的に指定しない限り）。トランザクションの一時停止が必要になる可能性のあるコードには、execute(org.springframework.transaction.TransactionDefinition, org.springframework.transaction.support.TransactionCallback<T>) スタイルを使用します。
このトランザクションマネージャーは、WebSphere、6.1.0.9 およびそれ以降と互換性があります。UOWManager のデフォルトの JNDI の場所は、"java:comp/websphere/UOWManager" です。場所が WebSphere ドキュメントと異なる場合は、このトランザクションマネージャーの "uowManagerName" Bean プロパティを使用して実際の場所を指定するだけです。
NOTE: この JtaTransactionManager は、Spring 側の特定のトランザクション区分動作を改善することを目的としています。永続性プロバイダーで個別に構成された WebSphere トランザクション戦略と共存でき、それらのセットアップを何らかの方法で具体的に接続する必要はありません。
導入:
2.5
作成者:
Juergen Hoeller
関連事項:
setUowManager(com.ibm.wsspi.uow.UOWManager), setUowManagerName(java.lang.String), UOWManager, 連載形式

ネストされたクラスの要約
- クラス org.springframework.transaction.support.AbstractPlatformTransactionManager から継承されたネストクラス / インターフェース
  AbstractPlatformTransactionManager.SuspendedResourcesHolder

フィールドのサマリー
フィールド
修飾子と型フィールドと説明
static StringSE DEFAULT_UOW_MANAGER_NAME
WebSphere UOWManager のデフォルトの JNDI ロケーション。
- クラス org.springframework.transaction.jta.JtaTransactionManager から継承されたフィールド
  DEFAULT_TRANSACTION_SYNCHRONIZATION_REGISTRY_NAME, DEFAULT_USER_TRANSACTION_NAME, FALLBACK_TRANSACTION_MANAGER_NAMES
- クラス org.springframework.transaction.support.AbstractPlatformTransactionManager から継承されたフィールド
  logger, SYNCHRONIZATION_ALWAYS, SYNCHRONIZATION_NEVER, SYNCHRONIZATION_ON_ACTUAL_TRANSACTION

フィールド
修飾子と型	フィールドと説明
`static StringSE`	`DEFAULT_UOW_MANAGER_NAME` WebSphere UOWManager のデフォルトの JNDI ロケーション。

コンストラクターの概要

コンストラクター
コンストラクターと説明
`WebSphereUowTransactionManager()` 新しい WebSphereUowTransactionManager を作成します。
`WebSphereUowTransactionManager(com.ibm.wsspi.uow.UOWManager uowManager)` 指定された UOWManager の新しい WebSphereUowTransactionManager を作成します。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`afterPropertiesSet()` UserTransaction および TransactionManager ハンドルを初期化します。
`protected void`	`doRegisterAfterCompletionWithJtaTransaction(JtaTransactionObject txObject, ListSE<TransactionSynchronization> synchronizations)` 同期を、挿入された JTA 同期として UOWManager に登録します。
`<T> T`	`execute(TransactionDefinition definition, TransactionCallback<T> callback)` トランザクション内で、指定されたコールバックオブジェクトによって指定されたアクションを実行します。
`protected com.ibm.wsspi.uow.UOWManager`	`lookupDefaultUowManager()` デフォルトの JNDI ロケーション "java:comp/websphere/UOWManager" から WebSphere UOWManager を取得します。
`protected com.ibm.wsspi.uow.UOWManager`	`lookupUowManager(StringSE uowManagerName)` 設定された名前を使用して、JNDI で WebSphere UOWManager を検索します。
`void`	`setUowManager(com.ibm.wsspi.uow.UOWManager uowManager)` 直接参照として使用する WebSphere UOWManager を設定します。
`void`	`setUowManagerName(StringSE uowManagerName)` WebSphere UOWManager の JNDI 名を設定します。
`boolean`	`supportsResourceAdapterManagedTransactions()` WebSphere ResourceAdapters（JNDI で公開）は、MessageEndpointFactory の `isDeliveryTransacted` メソッドが `true` を返す場合、暗黙的にトランザクション登録を実行するため、`true` を返します。

クラス org.springframework.transaction.jta.JtaTransactionManager から継承されたメソッド
applyIsolationLevel, applyTimeout, buildUserTransaction, checkUserTransactionAndTransactionManager, createTransaction, doBegin, doCleanupAfterCompletion, doCommit, doGetJtaTransaction, doGetTransaction, doJtaBegin, doJtaResume, doJtaSuspend, doResume, doRollback, doSetRollbackOnly, doSuspend, findTransactionManager, findTransactionSynchronizationRegistry, findUserTransaction, getJndiEnvironment, getJndiTemplate, getTransactionManager, getTransactionSynchronizationRegistry, getUserTransaction, initTransactionSynchronizationRegistry, initUserTransactionAndTransactionManager, isExistingTransaction, lookupTransactionManager, lookupTransactionSynchronizationRegistry, lookupUserTransaction, registerAfterCompletionWithExistingTransaction, retrieveTransactionManager, retrieveTransactionSynchronizationRegistry, retrieveUserTransaction, setAllowCustomIsolationLevels, setAutodetectTransactionManager, setAutodetectTransactionSynchronizationRegistry, setAutodetectUserTransaction, setCacheUserTransaction, setJndiEnvironment, setJndiTemplate, setTransactionManager, setTransactionManagerName, setTransactionSynchronizationRegistry, setTransactionSynchronizationRegistryName, setUserTransaction, setUserTransactionName, shouldCommitOnGlobalRollbackOnly, useSavepointForNestedTransaction

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

インターフェース org.springframework.transaction.PlatformTransactionManager から継承されたメソッド
commit, getTransaction, rollback

- フィールドの詳細
  - DEFAULT_UOW_MANAGER_NAME
```
public static final StringSE DEFAULT_UOW_MANAGER_NAME
```
    WebSphere UOWManager のデフォルトの JNDI ロケーション。
    関連事項:
    setUowManagerName(java.lang.String), 定数フィールド値
- コンストラクターの詳細
  - WebSphereUowTransactionManager
```
public WebSphereUowTransactionManager()
```
    新しい WebSphereUowTransactionManager を作成します。
  - WebSphereUowTransactionManager
```
public WebSphereUowTransactionManager(com.ibm.wsspi.uow.UOWManager uowManager)
```
    指定された UOWManager の新しい WebSphereUowTransactionManager を作成します。
    パラメーター:
    uowManager - 直接参照として使用する WebSphere UOWManager
- メソッドの詳細
  - setUowManager
```
public void setUowManager(com.ibm.wsspi.uow.UOWManager uowManager)
```
    直接参照として使用する WebSphere UOWManager を設定します。
    通常、テストのセットアップにのみ使用されます。Java EE 環境では、UOWManager は常に JNDI からフェッチされます。
    関連事項:
    JtaTransactionManager.setUserTransactionName(java.lang.String)
  - setUowManagerName
```
public void setUowManagerName(StringSE uowManagerName)
```
    WebSphere UOWManager の JNDI 名を設定します。設定しない場合、デフォルトの "java:comp/websphere/UOWManager" が使用されます。
    関連事項:
    JtaTransactionManager.DEFAULT_USER_TRANSACTION_NAME, setUowManager(com.ibm.wsspi.uow.UOWManager)
  - afterPropertiesSet
```
public void afterPropertiesSet()
                        throws TransactionSystemException
```
    クラスからコピーされた説明: JtaTransactionManager
    UserTransaction および TransactionManager ハンドルを初期化します。
    次で指定:
    インターフェース InitializingBean の afterPropertiesSet
    オーバーライド:
    クラス JtaTransactionManager の afterPropertiesSet
    例外:
    TransactionSystemException
    関連事項:
    JtaTransactionManager.initUserTransactionAndTransactionManager()
  - lookupUowManager
```
protected com.ibm.wsspi.uow.UOWManager lookupUowManager(StringSE uowManagerName)
                                                 throws TransactionSystemException
```
    設定された名前を使用して、JNDI で WebSphere UOWManager を検索します。
    パラメーター:
    uowManagerName - UOWManager の JNDI 名
    戻り値:
    UOWManager オブジェクト
    例外:
    TransactionSystemException - JNDI ルックアップが失敗した場合
    関連事項:
    JtaTransactionManager.setJndiTemplate(org.springframework.jndi.JndiTemplate), setUowManagerName(java.lang.String)
  - lookupDefaultUowManager
```
protected com.ibm.wsspi.uow.UOWManager lookupDefaultUowManager()
                                                        throws TransactionSystemException
```
    デフォルトの JNDI ロケーション "java:comp/websphere/UOWManager" から WebSphere UOWManager を取得します。
    戻り値:
    UOWManager オブジェクト
    例外:
    TransactionSystemException - JNDI ルックアップが失敗した場合
    関連事項:
    JtaTransactionManager.setJndiTemplate(org.springframework.jndi.JndiTemplate)
  - doRegisterAfterCompletionWithJtaTransaction
```
protected void doRegisterAfterCompletionWithJtaTransaction(JtaTransactionObject txObject,
                                                           ListSE<TransactionSynchronization> synchronizations)
```
    同期を、挿入された JTA 同期として UOWManager に登録します。
    オーバーライド:
    クラス JtaTransactionManager の doRegisterAfterCompletionWithJtaTransaction
    パラメーター:
    txObject - 現在のトランザクションオブジェクト
    synchronizations - TransactionSynchronization オブジェクトのリスト
    関連事項:
    JtaTransactionManager.getTransactionManager(), Transaction.registerSynchronization(javax.transaction.Synchronization)SE, TransactionSynchronizationRegistry.registerInterposedSynchronization(javax.transaction.Synchronization)SE
  - supportsResourceAdapterManagedTransactions
```
public boolean supportsResourceAdapterManagedTransactions()
```
    WebSphere ResourceAdapters（JNDI で公開）は、MessageEndpointFactory の isDeliveryTransacted メソッドが true を返す場合、暗黙的にトランザクション登録を実行するため、true を返します。その場合は、JtaTransactionManager.createTransaction(java.lang.String, int) 呼び出しを単にスキップします。
    次で指定:
    インターフェース TransactionFactory の supportsResourceAdapterManagedTransactions
    オーバーライド:
    クラス JtaTransactionManager の supportsResourceAdapterManagedTransactions
    関連事項:
    MessageEndpointFactory.isDeliveryTransacted(java.lang.reflect.Method)EE, AbstractMessageEndpointFactory, TransactionFactory.createTransaction(java.lang.String, int)
  - execute
```
@Nullable
public <T> T execute(@Nullable
                               TransactionDefinition definition,
                               TransactionCallback<T> callback)
                        throws TransactionException
```
    インターフェースからコピーされた説明: CallbackPreferringPlatformTransactionManager
    トランザクション内で、指定されたコールバックオブジェクトによって指定されたアクションを実行します。
    トランザクション内で作成された結果オブジェクト、つまりドメインオブジェクトまたはドメインオブジェクトのコレクションを返すことができます。コールバックによってスローされた RuntimeException は、ロールバックを強制する致命的な例外として扱われます。このような例外は、テンプレートの呼び出し元に伝播されます。
    次で指定:
    インターフェース CallbackPreferringPlatformTransactionManager の execute
    パラメーター:
    definition - コールバックをラップするトランザクションの定義
    callback - トランザクションアクションを指定するコールバックオブジェクト
    戻り値:
    コールバックによって返された結果オブジェクト。ない場合は null
    例外:
    TransactionException - 初期化、ロールバック、システムエラーの場合

クラス WebSphereUowTransactionManager

ネストされたクラスの要約

クラス org.springframework.transaction.support.AbstractPlatformTransactionManager から継承されたネストクラス / インターフェース

フィールドのサマリー

クラス org.springframework.transaction.jta.JtaTransactionManager から継承されたフィールド

クラス org.springframework.transaction.support.AbstractPlatformTransactionManager から継承されたフィールド

コンストラクターの概要

メソッドのサマリー

クラス org.springframework.transaction.jta.JtaTransactionManager から継承されたメソッド

クラス org.springframework.transaction.support.AbstractPlatformTransactionManager から継承されたメソッド

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

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

フィールドの詳細

DEFAULT_UOW_MANAGER_NAME

コンストラクターの詳細

WebSphereUowTransactionManager

WebSphereUowTransactionManager

メソッドの詳細

setUowManager

setUowManagerName

afterPropertiesSet

lookupUowManager

lookupDefaultUowManager

doRegisterAfterCompletionWithJtaTransaction

supportsResourceAdapterManagedTransactions

execute