JdbcTransactionManager (Spring Framework API)

java.lang.ObjectSE
- org.springframework.transaction.support.AbstractPlatformTransactionManager
- - org.springframework.jdbc.datasource.DataSourceTransactionManager
  - - org.springframework.jdbc.support.JdbcTransactionManager

実装されているすべてのインターフェース:
SerializableSE, InitializingBean, PlatformTransactionManager, ResourceTransactionManager, TransactionManager
```
public class JdbcTransactionManager
extends DataSourceTransactionManager
```
JdbcAccessor - プレーンな DataSourceTransactionManager のサブクラスを揃え、コミットとロールバックのステップに共通の JDBC 例外変換を追加します。通常、デフォルトで同じ SQLExceptionTranslator インフラストラクチャを適用する JdbcTemplate と組み合わせて使用されます。
例外の変換は、シリアライズ可能なトランザクション（たとえば、Postgres）でのコミットステップに特に関連します。この場合、コミットの遅延が同時実行の失敗の原因となる可能性があります。これにより、TransactionSystemException の代わりに ConcurrencyFailureException を呼び出し元にスローできます。
HibernateTransactionManager および JpaTransactionManager と同様に、このトランザクションマネージャーは AbstractPlatformTransactionManager.commit(org.springframework.transaction.TransactionStatus) から DataAccessException をスローし、AbstractPlatformTransactionManager.rollback(org.springframework.transaction.TransactionStatus) からもスローする可能性があります。呼び出しコードは、TransactionException の隣でそのような例外を処理するために準備する必要があります。これは、TransactionSynchronization 実装が flush および beforeCommit フェーズでそのような例外をスローする場合があるため、これは一般的に賢明です。
導入:
5.3
作成者:
Juergen Hoeller, Sebastien Deleuze
関連事項:
DataSourceTransactionManager, DataSourceTransactionManager.setDataSource(javax.sql.DataSource), setExceptionTranslator(org.springframework.jdbc.support.SQLExceptionTranslator), 連載形式

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

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

コンストラクターの概要

コンストラクター
コンストラクターと説明
`JdbcTransactionManager()` 新しい JdbcTransactionManager インスタンスを作成します。
`JdbcTransactionManager(DataSourceSE dataSource)` 新しい JdbcTransactionManager インスタンスを作成します。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`afterPropertiesSet()` 必要に応じて例外トランスレータを積極的に初期化し、何も設定されていない場合は指定された DataSource のデフォルトのトランスレータを作成します。
`SQLExceptionTranslator`	`getExceptionTranslator()` このインスタンスの例外トランスレータを返します。
`boolean`	`isLazyInit()` このトランザクションマネージャーの SQLExceptionTranslator を遅延初期化するかどうかを返します。
`void`	`setDatabaseProductName(StringSE dbName)` このトランザクションマネージャーが使用する DataSource のデータベース製品名を指定します。
`void`	`setExceptionTranslator(SQLExceptionTranslator exceptionTranslator)` このインスタンスの例外トランスレーターを設定します。
`void`	`setLazyInit(boolean lazyInit)` SQLException が最初に発生したときに、このトランザクションマネージャーの SQLExceptionTranslator を遅延初期化するかどうかを設定します。
`protected RuntimeExceptionSE`	`translateException(StringSE task, SQLExceptionSE ex)` この実装は `SQLExceptionTranslator` の使用を試み、`TransactionSystemException` にフォールバックします。

クラス org.springframework.jdbc.datasource.DataSourceTransactionManager から継承されたメソッド
doBegin, doCleanupAfterCompletion, doCommit, doGetTransaction, doResume, doRollback, doSetRollbackOnly, doSuspend, getDataSource, getResourceFactory, isEnforceReadOnly, isExistingTransaction, obtainDataSource, prepareTransactionalConnection, setDataSource, setEnforceReadOnly

クラス 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

- コンストラクターの詳細
  - JdbcTransactionManager
```
public JdbcTransactionManager()
```
    新しい JdbcTransactionManager インスタンスを作成します。DataSource を使用できるように設定する必要があります。
    関連事項:
    DataSourceTransactionManager.setDataSource(javax.sql.DataSource)
  - JdbcTransactionManager
```
public JdbcTransactionManager(DataSourceSE dataSource)
```
    新しい JdbcTransactionManager インスタンスを作成します。
    パラメーター:
    dataSource - トランザクションを管理する JDBC DataSource
- メソッドの詳細
  - setDatabaseProductName
```
public void setDatabaseProductName(StringSE dbName)
```
    このトランザクションマネージャーが使用する DataSource のデータベース製品名を指定します。これにより、DataSource から接続を取得せずに SQLErrorCodeSQLExceptionTranslator を初期化してメタデータを取得できます。
    パラメーター:
    dbName - エラーコードエントリを識別するデータベース製品名
    関連事項:
    JdbcAccessor.setDatabaseProductName(java.lang.String), SQLErrorCodeSQLExceptionTranslator.setDatabaseProductName(java.lang.String), DatabaseMetaData.getDatabaseProductName()SE
  - setExceptionTranslator
```
public void setExceptionTranslator(SQLExceptionTranslator exceptionTranslator)
```
    このインスタンスの例外トランスレーターを設定します。
    カスタムトランスレータが提供されていない場合、SQLException のベンダー固有のエラーコードを調べるデフォルトの SQLErrorCodeSQLExceptionTranslator が使用されます。
    関連事項:
    JdbcAccessor.setExceptionTranslator(org.springframework.jdbc.support.SQLExceptionTranslator), SQLErrorCodeSQLExceptionTranslator
  - getExceptionTranslator
```
public SQLExceptionTranslator getExceptionTranslator()
```
    このインスタンスの例外トランスレータを返します。
    何も設定されていない場合、指定された DataSource のデフォルト SQLErrorCodeSQLExceptionTranslator を作成します。
    関連事項:
    DataSourceTransactionManager.getDataSource()
  - setLazyInit
```
public void setLazyInit(boolean lazyInit)
```
    SQLException が最初に発生したときに、このトランザクションマネージャーの SQLExceptionTranslator を遅延初期化するかどうかを設定します。デフォルトは "true" です。起動時に初期化するために "false" に切り替えることができます。
    初期化は、afterPropertiesSet() が呼び出された場合にのみ適用されます。
    関連事項:
    getExceptionTranslator(), afterPropertiesSet()
  - isLazyInit
```
public boolean isLazyInit()
```
    このトランザクションマネージャーの SQLExceptionTranslator を遅延初期化するかどうかを返します。
    関連事項:
    getExceptionTranslator()
  - afterPropertiesSet
```
public void afterPropertiesSet()
```
    必要に応じて例外トランスレータを積極的に初期化し、何も設定されていない場合は指定された DataSource のデフォルトのトランスレータを作成します。
    次で指定:
    インターフェース InitializingBean の afterPropertiesSet
    オーバーライド:
    クラス DataSourceTransactionManager の afterPropertiesSet
  - translateException
```
protected RuntimeExceptionSE translateException(StringSE task,
                                              SQLExceptionSE ex)
```
    この実装は SQLExceptionTranslator の使用を試み、TransactionSystemException にフォールバックします。
    オーバーライド:
    クラス DataSourceTransactionManager の translateException
    パラメーター:
    task - タスクの説明 (コミットまたはロールバック)
    ex - コミット / ロールバックからスローされる SQLException
    戻り値:
    スローする変換された例外、DataAccessException または TransactionException
    関連事項:
    getExceptionTranslator(), DataSourceTransactionManager.translateException(java.lang.String, java.sql.SQLException)

クラス JdbcTransactionManager

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

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

フィールドのサマリー

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

コンストラクターの概要

メソッドのサマリー

クラス org.springframework.jdbc.datasource.DataSourceTransactionManager から継承されたメソッド

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

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

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

コンストラクターの詳細

JdbcTransactionManager

JdbcTransactionManager

メソッドの詳細

setDatabaseProductName

setExceptionTranslator

getExceptionTranslator

setLazyInit

isLazyInit

afterPropertiesSet

translateException