CciLocalTransactionManager (Spring Framework API)

java.lang.ObjectSE
- org.springframework.transaction.support.AbstractPlatformTransactionManager
- - org.springframework.jca.cci.connection.CciLocalTransactionManager

実装されたすべてのインターフェース:
SerializableSE, InitializingBean, PlatformTransactionManager, ResourceTransactionManager, TransactionManager
使用すべきではありません。
5.3 以降、特定のデータアクセス API を推奨 (代替がない場合はネイティブ CCI の使用を推奨)
```
@DeprecatedSE
public class CciLocalTransactionManager
extends AbstractPlatformTransactionManager
implements ResourceTransactionManager, InitializingBean
```
単一の CCI ConnectionFactory のローカルトランザクションを管理する PlatformTransactionManager 実装。指定された ConnectionFactory からスレッドに CCI 接続をバインドし、ConnectionFactory ごとに 1 つのスレッドバインド接続を可能にします。
アプリケーションコードは、標準の Java EE スタイルの ConnectionFactory.getConnection()EE 呼び出しではなく、ConnectionFactoryUtils.getConnection(ConnectionFactory) を介して CCI 接続を取得するために必要です。CciTemplate などの Spring クラスは、この戦略を暗黙的に使用します。このトランザクションマネージャーと組み合わせて使用しない場合、ConnectionFactoryUtils ルックアップ戦略はネイティブ DataSource ルックアップとまったく同じように動作します。携帯用に使用できます。
または、アプリケーションコードが標準の Java EE ルックアップパターン ConnectionFactory.getConnection()EE で動作するようにすることもできます。たとえば、Spring をまったく認識しないレガシーコードの場合です。その場合は、ターゲット ConnectionFactory の TransactionAwareConnectionFactoryProxy を定義します。これは、Spring 管理のトランザクションに自動的に参加します。
導入:
1.2
作成者:
Thierry Templier, Juergen Hoeller
関連事項:
ConnectionFactoryUtils.getConnection(javax.resource.cci.ConnectionFactory), ConnectionFactoryUtils.releaseConnection(javax.resource.cci.Connection, javax.resource.cci.ConnectionFactory), TransactionAwareConnectionFactoryProxy, CciTemplate, 直列化された形式

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

フィールドサマリー
- クラス org.springframework.transaction.support.AbstractPlatformTransactionManager から継承されたフィールド
  logger, SYNCHRONIZATION_ALWAYS, SYNCHRONIZATION_NEVER, SYNCHRONIZATION_ON_ACTUAL_TRANSACTION

コンストラクターのサマリー

コンストラクター
コンストラクターと説明
`CciLocalTransactionManager()` 使用すべきではありません。新しい CciLocalTransactionManager インスタンスを作成します。
`CciLocalTransactionManager(ConnectionFactoryEE connectionFactory)` 使用すべきではありません。新しい CciLocalTransactionManager インスタンスを作成します。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド非推奨のメソッド
修飾子と型	メソッドと説明
`void`	`afterPropertiesSet()` 使用すべきではありません。すべての Bean プロパティを設定し、`BeanFactoryAware`、`ApplicationContextAware` などを満たした後、包含 `BeanFactory` によって呼び出されます。
`protected void`	`doBegin(ObjectSE transaction, TransactionDefinition definition)` 使用すべきではありません。指定されたトランザクション定義に従って、セマンティクスで新しいトランザクションを開始します。
`protected void`	`doCleanupAfterCompletion(ObjectSE transaction)` 使用すべきではありません。トランザクション完了後にリソースをクリーンアップします。
`protected void`	`doCommit(DefaultTransactionStatus status)` 使用すべきではありません。指定されたトランザクションの実際のコミットを実行します。
`protected ObjectSE`	`doGetTransaction()` 使用すべきではありません。現在のトランザクション状態のトランザクションオブジェクトを返します。
`protected void`	`doResume(ObjectSE transaction, ObjectSE suspendedResources)` 使用すべきではありません。現在のトランザクションのリソースを再開します。
`protected void`	`doRollback(DefaultTransactionStatus status)` 使用すべきではありません。指定されたトランザクションの実際のロールバックを実行します。
`protected void`	`doSetRollbackOnly(DefaultTransactionStatus status)` 使用すべきではありません。指定されたトランザクションをロールバックのみに設定します。
`protected ObjectSE`	`doSuspend(ObjectSE transaction)` 使用すべきではありません。現在のトランザクションのリソースを一時停止します。
`ConnectionFactoryEE`	`getConnectionFactory()` 使用すべきではありません。このインスタンスがローカルトランザクションを管理する CCI ConnectionFactory を返します。
`ObjectSE`	`getResourceFactory()` 使用すべきではありません。このトランザクションマネージャーが動作するリソースファクトリを返します。
`protected boolean`	`isExistingTransaction(ObjectSE transaction)` 使用すべきではありません。指定されたトランザクションオブジェクトが既存のトランザクション（つまり、すでに開始されているトランザクション）を示しているかどうかを確認します。
`protected boolean`	`isRollbackOnly(ObjectSE transaction)` 使用すべきではありません。
`void`	`setConnectionFactory(ConnectionFactoryEE cf)` 使用すべきではありません。このインスタンスがローカルトランザクションを管理する CCI ConnectionFactory を設定します。

クラス org.springframework.transaction.support.AbstractPlatformTransactionManager から継承されたメソッド
commit, determineTimeout, getDefaultTimeout, getTransaction, getTransactionSynchronization, invokeAfterCompletion, isFailEarlyOnGlobalRollbackOnly, isGlobalRollbackOnParticipationFailure, isNestedTransactionAllowed, isRollbackOnCommitFailure, isValidateExistingTransaction, newTransactionStatus, prepareForCommit, prepareSynchronization, prepareTransactionStatus, registerAfterCompletionWithExistingTransaction, resume, rollback, setDefaultTimeout, setFailEarlyOnGlobalRollbackOnly, setGlobalRollbackOnParticipationFailure, setNestedTransactionAllowed, setRollbackOnCommitFailure, setTransactionSynchronization, setTransactionSynchronizationName, setValidateExistingTransaction, shouldCommitOnGlobalRollbackOnly, suspend, triggerBeforeCommit, triggerBeforeCompletion, useSavepointForNestedTransaction

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

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

- コンストラクターの詳細
  - CciLocalTransactionManager
```
public CciLocalTransactionManager()
```
    使用すべきではありません。
    新しい CciLocalTransactionManager インスタンスを作成します。ConnectionFactory を使用できるように設定する必要があります。
    関連事項:
    setConnectionFactory(javax.resource.cci.ConnectionFactory)
  - CciLocalTransactionManager
```
public CciLocalTransactionManager(ConnectionFactoryEE connectionFactory)
```
    使用すべきではありません。
    新しい CciLocalTransactionManager インスタンスを作成します。
    パラメーター:
    connectionFactory - ローカルトランザクションを管理する CCI ConnectionFactory
- メソッドの詳細
  - setConnectionFactory
```
public void setConnectionFactory(@Nullable
                                 ConnectionFactoryEE cf)
```
    使用すべきではありません。
    このインスタンスがローカルトランザクションを管理する CCI ConnectionFactory を設定します。
  - getConnectionFactory
```
@Nullable
public ConnectionFactoryEE getConnectionFactory()
```
    使用すべきではありません。
    このインスタンスがローカルトランザクションを管理する CCI ConnectionFactory を返します。
  - afterPropertiesSet
```
public void afterPropertiesSet()
```
    使用すべきではありません。
    インターフェースからコピーされた説明: InitializingBean
    すべての Bean プロパティを設定し、BeanFactoryAware、ApplicationContextAware などを満たした後、包含 BeanFactory によって呼び出されます。
    このメソッドにより、Bean インスタンスは、すべての Bean プロパティが設定されたときに、その全体的な構成の検証と最終的な初期化を実行できます。
    次で指定:
    インターフェース InitializingBean の afterPropertiesSet
  - getResourceFactory
```
public ObjectSE getResourceFactory()
```
    使用すべきではありません。
    インターフェースからコピーされた説明: ResourceTransactionManager
    このトランザクションマネージャーが動作するリソースファクトリを返します。JDBC DataSource または JMS ConnectionFactory。
    このターゲットリソースファクトリは、通常、スレッドごとの TransactionSynchronizationManager のリソースバインディングのリソースキーとして使用されます。
    次で指定:
    インターフェース ResourceTransactionManager の getResourceFactory
    戻り値:
    ターゲットリソースファクトリ (非 null)
    関連事項:
    TransactionSynchronizationManager.bindResource(java.lang.Object, java.lang.Object), TransactionSynchronizationManager.getResource(java.lang.Object)
  - doGetTransaction
```
protected ObjectSE doGetTransaction()
```
    使用すべきではありません。
    クラスからコピーされた説明: AbstractPlatformTransactionManager
    現在のトランザクション状態のトランザクションオブジェクトを返します。
    返されるオブジェクトは通常、具体的なトランザクションマネージャーの実装に固有であり、対応するトランザクション状態を変更可能な形で保持します。このオブジェクトは、直接または DefaultTransactionStatus インスタンスの一部として、他のテンプレートメソッド（doBegin や doCommit など）に渡されます。
    返されるオブジェクトには、既存のトランザクション、つまり、トランザクションマネージャーでの現在の getTransaction 呼び出しの前にすでに開始されているトランザクションに関する情報が含まれている必要があります。その結果、doGetTransaction 実装は通常、既存のトランザクションを探し、返されたトランザクションオブジェクトに対応する状態を格納します。
    次で指定:
    クラス AbstractPlatformTransactionManager の doGetTransaction
    戻り値:
    現在のトランザクションオブジェクト
    関連事項:
    AbstractPlatformTransactionManager.doBegin(java.lang.Object, org.springframework.transaction.TransactionDefinition), AbstractPlatformTransactionManager.doCommit(org.springframework.transaction.support.DefaultTransactionStatus), AbstractPlatformTransactionManager.doRollback(org.springframework.transaction.support.DefaultTransactionStatus), DefaultTransactionStatus.getTransaction()
  - isExistingTransaction
```
protected boolean isExistingTransaction(ObjectSE transaction)
```
    使用すべきではありません。
    クラスからコピーされた説明: AbstractPlatformTransactionManager
    指定されたトランザクションオブジェクトが既存のトランザクション（つまり、すでに開始されているトランザクション）を示しているかどうかを確認します。
    結果は、新しいトランザクションに対して指定された伝播動作に従って評価されます。既存のトランザクションが中断される（PROPAGATION_REQUIRES_NEW の場合）か、新しいトランザクションが既存のトランザクションに参加する可能性があります（PROPAGATION_REQUIRED の場合）。
    デフォルト実装は false を返しますが、既存のトランザクションへの参加は一般にサポートされていないと想定しています。もちろん、サブクラスはそのようなサポートを提供することをお勧めします。
    オーバーライド:
    クラス AbstractPlatformTransactionManager の isExistingTransaction
    パラメーター:
    transaction - doGetTransaction によって返されるトランザクションオブジェクト
    戻り値:
    既存のトランザクションがある場合
    関連事項:
    AbstractPlatformTransactionManager.doGetTransaction()
  - doBegin
```
protected void doBegin(ObjectSE transaction,
                       TransactionDefinition definition)
```
    使用すべきではありません。
    クラスからコピーされた説明: AbstractPlatformTransactionManager
    指定されたトランザクション定義に従って、セマンティクスで新しいトランザクションを開始します。伝播動作の適用を気にする必要はありません。これは、この抽象マネージャーによってすでに処理されているためです。
    このメソッドは、トランザクションマネージャーが実際に新しいトランザクションを開始することを決定したときに呼び出されます。以前にトランザクションがなかったか、前のトランザクションが中断されています。
    特別なシナリオは、セーブポイントのないネストされたトランザクションです: useSavepointForNestedTransaction() が "false" を返す場合、このメソッドは、必要に応じてネストされたトランザクションを開始するために呼び出されます。このようなコンテキストでは、アクティブなトランザクションがあります。このメソッドの実装はこれを検出し、適切なネストされたトランザクションを開始する必要があります。
    次で指定:
    クラス AbstractPlatformTransactionManager の doBegin
    パラメーター:
    transaction - doGetTransaction によって返されるトランザクションオブジェクト
    definition - 伝播動作、分離レベル、読み取り専用フラグ、タイムアウト、トランザクション名を記述する TransactionDefinition インスタンス
  - doSuspend
```
protected ObjectSE doSuspend(ObjectSE transaction)
```
    使用すべきではありません。
    クラスからコピーされた説明: AbstractPlatformTransactionManager
    現在のトランザクションのリソースを一時停止します。トランザクションの同期はすでに中断されています。
    トランザクションの一時停止が一般的にサポートされていないと仮定すると、デフォルトの実装は TransactionSuspensionNotSupportedException をスローします。
    オーバーライド:
    クラス AbstractPlatformTransactionManager の doSuspend
    パラメーター:
    transaction - doGetTransaction によって返されるトランザクションオブジェクト
    戻り値:
    中断されたリソースを保持するオブジェクト (doResume に渡すために未検査のままになります)
    関連事項:
    AbstractPlatformTransactionManager.doResume(java.lang.Object, java.lang.Object)
  - doResume
```
protected void doResume(@Nullable
                        ObjectSE transaction,
                        ObjectSE suspendedResources)
```
    使用すべきではありません。
    クラスからコピーされた説明: AbstractPlatformTransactionManager
    現在のトランザクションのリソースを再開します。トランザクションの同期はその後再開されます。
    トランザクションの一時停止が一般的にサポートされていないと仮定すると、デフォルトの実装は TransactionSuspensionNotSupportedException をスローします。
    オーバーライド:
    クラス AbstractPlatformTransactionManager の doResume
    パラメーター:
    transaction - doGetTransaction によって返されるトランザクションオブジェクト
    suspendedResources - doSuspend によって返される、中断されたリソースを保持するオブジェクト
    関連事項:
    AbstractPlatformTransactionManager.doSuspend(java.lang.Object)
  - isRollbackOnly
```
protected boolean isRollbackOnly(ObjectSE transaction)
                          throws TransactionException
```
    使用すべきではありません。
    例外:
    TransactionException
  - doCommit
```
protected void doCommit(DefaultTransactionStatus status)
```
    使用すべきではありません。
    クラスからコピーされた説明: AbstractPlatformTransactionManager
    指定されたトランザクションの実際のコミットを実行します。
    実装では、「新規トランザクション」フラグまたはロールバック専用フラグを確認する必要はありません。これはすでに以前に処理されています。通常、渡されたステータスに含まれるトランザクションオブジェクトに対してストレートコミットが実行されます。
    次で指定:
    クラス AbstractPlatformTransactionManager の doCommit
    パラメーター:
    status - トランザクションのステータス表現
    関連事項:
    DefaultTransactionStatus.getTransaction()
  - doRollback
```
protected void doRollback(DefaultTransactionStatus status)
```
    使用すべきではありません。
    クラスからコピーされた説明: AbstractPlatformTransactionManager
    指定されたトランザクションの実際のロールバックを実行します。
    実装では、「新しいトランザクション」フラグを確認する必要はありません。これはすでに以前に処理されています。通常、渡されたステータスに含まれるトランザクションオブジェクトに対してストレートロールバックが実行されます。
    次で指定:
    クラス AbstractPlatformTransactionManager の doRollback
    パラメーター:
    status - トランザクションのステータス表現
    関連事項:
    DefaultTransactionStatus.getTransaction()
  - doSetRollbackOnly
```
protected void doSetRollbackOnly(DefaultTransactionStatus status)
```
    使用すべきではありません。
    クラスからコピーされた説明: AbstractPlatformTransactionManager
    指定されたトランザクションをロールバックのみに設定します。現在のトランザクションが既存のトランザクションに参加している場合にのみ、ロールバック時に呼び出されます。
    既存のトランザクションへの参加は一般にサポートされていないと想定して、デフォルトの実装は IllegalTransactionStateException をスローします。もちろん、サブクラスはそのようなサポートを提供することをお勧めします。
    オーバーライド:
    クラス AbstractPlatformTransactionManager の doSetRollbackOnly
    パラメーター:
    status - トランザクションのステータス表現
  - doCleanupAfterCompletion
```
protected void doCleanupAfterCompletion(ObjectSE transaction)
```
    使用すべきではありません。
    クラスからコピーされた説明: AbstractPlatformTransactionManager
    トランザクション完了後にリソースをクリーンアップします。
    doCommit および doRollback の実行後に、結果について呼び出されます。デフォルトの実装は何もしません。
    例外をスローするべきではなく、エラーに対して警告を発行するだけです。
    オーバーライド:
    クラス AbstractPlatformTransactionManager の doCleanupAfterCompletion
    パラメーター:
    transaction - doGetTransaction によって返されるトランザクションオブジェクト

クラス CciLocalTransactionManager

ネストされたクラスのサマリー

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

フィールドサマリー

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

コンストラクターのサマリー

メソッドのサマリー

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

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

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

コンストラクターの詳細

CciLocalTransactionManager

CciLocalTransactionManager

メソッドの詳細

setConnectionFactory

getConnectionFactory

afterPropertiesSet

getResourceFactory

doGetTransaction

isExistingTransaction

doBegin

doSuspend

doResume

isRollbackOnly

doCommit

doRollback

doSetRollbackOnly

doCleanupAfterCompletion