LazyConnectionDataSourceProxy (Spring Framework 5.1.15.RELEASE API)

java.lang.ObjectSE
- org.springframework.jdbc.datasource.DelegatingDataSource
- - org.springframework.jdbc.datasource.LazyConnectionDataSourceProxy

実装されたすべてのインターフェース:
WrapperSE, CommonDataSourceSE, DataSourceSE, InitializingBean
```
public class LazyConnectionDataSourceProxy
extends DelegatingDataSource
```
ターゲット DataSource のプロキシは、実際の JDBC 接続を遅延して取得します。つまり、最初に文を作成するまで取得しません。自動コミットモード、トランザクション分離、読み取り専用モードなどの接続初期化プロパティは保持され、実際の接続がフェッチされるとすぐに (ある場合)、実際の JDBC 接続に適用されます。ステートメントが作成されていない場合、コミットおよびロールバック呼び出しは無視されます。
この DataSource プロキシにより、実際に必要な場合を除き、プールから JDBC 接続をフェッチすることを回避できます。JDBC トランザクション制御は、プールから接続を取得したり、データベースと通信したりせずに実行できます。これは、JDBC ステートメントの最初の作成時に遅延して行われます。
LazyConnectionDataSourceProxy と TransactionAwareDataSourceProxy の両方を構成する場合、後者が最も外側の DataSource であることを確認してください。このようなシナリオでは、データアクセスコードはトランザクション対応の DataSource と通信し、DataSource は LazyConnectionDataSourceProxy と連動します。
物理 JDBC 接続の遅延フェッチは、一般的なトランザクション境界環境で特に役立ちます。これにより、実際のデータアクセスが発生しない場合にパフォーマンスを犠牲にすることなく、データアクセスを実行する可能性のあるすべてのメソッドでトランザクションを区別できます。
この DataSource プロキシは、DataSourceTransactionManager や HibernateTransactionManager などのローカルトランザクション戦略を使用しても、JTA およびトランザクション JNDI DataSource（Java EE サーバーによって提供される）に類似した動作を提供します。トランザクション戦略として Spring の JtaTransactionManager を使用しても、付加価値はありません。
特に二次キャッシュで結果を解決する可能性が高い場合、Hibernate での読み取り専用操作の場合、JDBC 接続の遅延フェッチもお勧めします。これにより、このような読み取り専用操作でデータベースと通信する必要がまったくなくなります。非トランザクション読み取りでも同じ効果が得られますが、JDBC 接続の遅延フェッチにより、トランザクションで読み取りを実行できます。
注意 : この DataSource プロキシは、実際の JDBC 接続の遅延フェッチを処理するために、（ConnectionProxy インターフェースを実装する）ラップされた接続を返す必要があります。Wrapper.unwrap(java.lang.Class<T>)SE を使用してネイティブ JDBC 接続を取得します。
導入:
1.1.4
作成者:
Juergen Hoeller
関連事項:
DataSourceTransactionManager

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

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

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`afterPropertiesSet()` すべての Bean プロパティを設定し、`BeanFactoryAware`、`ApplicationContextAware` などを満たした後、包含 `BeanFactory` によって呼び出されます。
`protected void`	`checkDefaultConnectionProperties(ConnectionSE con)` デフォルトの接続プロパティ（自動コミット、トランザクション分離）を確認し、ターゲット DataSource から実際の JDBC 接続を取得せずに正しく公開できるようにします。
`protected BooleanSE`	`defaultAutoCommit()` デフォルトの自動コミット値を公開します。
`protected IntegerSE`	`defaultTransactionIsolation()` デフォルトのトランザクション分離値を公開します。
`ConnectionSE`	`getConnection()` ステートメント（または PreparedStatement または CallableStatement）を要求されたときに実際の JDBC 接続を遅延フェッチする接続ハンドルを返します。
`ConnectionSE`	`getConnection(StringSE username, StringSE password)` ステートメント（または PreparedStatement または CallableStatement）を要求されたときに実際の JDBC 接続を遅延フェッチする接続ハンドルを返します。
`void`	`setDefaultAutoCommit(boolean defaultAutoCommit)` デフォルトの自動コミットモードを設定して、ターゲット接続がまだフェッチされていない場合に公開します（-> 実際の JDBC 接続のデフォルトはまだ不明です）。
`void`	`setDefaultTransactionIsolation(int defaultTransactionIsolation)` デフォルトのトランザクション分離レベルを設定して、ターゲット接続がまだフェッチされていない場合に公開します（-> 実際の JDBC 接続のデフォルトはまだ不明です）。
`void`	`setDefaultTransactionIsolationName(StringSE constantName)` `Connection`SE の対応する定数の名前でデフォルトのトランザクション分離レベルを設定します。

クラス org.springframework.jdbc.datasource.DelegatingDataSource から継承されたメソッド
getLoginTimeout, getLogWriter, getParentLogger, getTargetDataSource, isWrapperFor, obtainTargetDataSource, setLoginTimeout, setLogWriter, setTargetDataSource, unwrap

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

- コンストラクターの詳細
  - LazyConnectionDataSourceProxy
```
public LazyConnectionDataSourceProxy()
```
    新しい LazyConnectionDataSourceProxy を作成します。
    関連事項:
    DelegatingDataSource.setTargetDataSource(javax.sql.DataSource)
  - LazyConnectionDataSourceProxy
```
public LazyConnectionDataSourceProxy(DataSourceSE targetDataSource)
```
    新しい LazyConnectionDataSourceProxy を作成します。
    パラメーター:
    targetDataSource - ターゲット DataSource
- メソッドの詳細
  - setDefaultAutoCommit
```
public void setDefaultAutoCommit(boolean defaultAutoCommit)
```
    デフォルトの自動コミットモードを設定して、ターゲット接続がまだフェッチされていない場合に公開します（-> 実際の JDBC 接続のデフォルトはまだ不明です）。
    指定しない場合、起動時にターゲットの接続を確認することでデフォルトが決定されます。そのチェックが失敗した場合、デフォルトは接続の最初のアクセスで遅延して決定されます。
    関連事項:
    Connection.setAutoCommit(boolean)SE
  - setDefaultTransactionIsolation
```
public void setDefaultTransactionIsolation(int defaultTransactionIsolation)
```
    デフォルトのトランザクション分離レベルを設定して、ターゲット接続がまだフェッチされていない場合に公開します（-> 実際の JDBC 接続のデフォルトはまだ不明です）。
    このプロパティは、ConnectionSE インターフェースで定義されている int 定数値 (例: 8) を受け入れます。これは主にプログラムによる使用を目的としています。名前で値を設定するには、"defaultTransactionIsolationName" プロパティの使用を検討してください (例: "TRANSACTION_SERIALIZABLE" )。
    指定しない場合、起動時にターゲットの接続を確認することでデフォルトが決定されます。そのチェックが失敗した場合、デフォルトは接続の最初のアクセスで遅延して決定されます。
    関連事項:
    setDefaultTransactionIsolationName(java.lang.String), Connection.setTransactionIsolation(int)SE
  - setDefaultTransactionIsolationName
```
public void setDefaultTransactionIsolationName(StringSE constantName)
```
    ConnectionSE の対応する定数の名前でデフォルトのトランザクション分離レベルを設定します。"TRANSACTION_SERIALIZABLE"。
    パラメーター:
    constantName - 定数の名前
    関連事項:
    setDefaultTransactionIsolation(int), Connection.TRANSACTION_READ_UNCOMMITTEDSE, Connection.TRANSACTION_READ_COMMITTEDSE, Connection.TRANSACTION_REPEATABLE_READSE, Connection.TRANSACTION_SERIALIZABLESE
  - afterPropertiesSet
```
public void afterPropertiesSet()
```
    インターフェースからコピーされた説明: InitializingBean
    すべての Bean プロパティを設定し、BeanFactoryAware、ApplicationContextAware などを満たした後、包含 BeanFactory によって呼び出されます。
    このメソッドにより、Bean インスタンスは、すべての Bean プロパティが設定されたときに、その全体的な構成の検証と最終的な初期化を実行できます。
    次で指定:
    インターフェース InitializingBean の afterPropertiesSet
    オーバーライド:
    クラス DelegatingDataSource の afterPropertiesSet
  - checkDefaultConnectionProperties
```
protected void checkDefaultConnectionProperties(ConnectionSE con)
                                         throws SQLExceptionSE
```
    デフォルトの接続プロパティ（自動コミット、トランザクション分離）を確認し、ターゲット DataSource から実際の JDBC 接続を取得せずに正しく公開できるようにします。
    これは起動時に 1 回呼び出されますが、ターゲット Connection を取得するたびに呼び出されます。起動時にチェックが失敗した場合（データベースがダウンしたため）、それらの設定を遅延的に取得します。
    パラメーター:
    con - チェックに使用する接続
    例外:
    SQLExceptionSE - Connection メソッドによってスローされた場合
  - defaultAutoCommit
```
@Nullable
protected BooleanSE defaultAutoCommit()
```
    デフォルトの自動コミット値を公開します。
  - defaultTransactionIsolation
```
@Nullable
protected IntegerSE defaultTransactionIsolation()
```
    デフォルトのトランザクション分離値を公開します。
  - getConnection
```
public ConnectionSE getConnection()
                         throws SQLExceptionSE
```
    ステートメント（または PreparedStatement または CallableStatement）を要求されたときに実際の JDBC 接続を遅延フェッチする接続ハンドルを返します。
    返された Connection ハンドルは ConnectionProxy インターフェースを実装し、基になるターゲット Connection を取得できるようにします。
    次で指定:
    インターフェース DataSourceSE の getConnectionSE
    オーバーライド:
    クラス DelegatingDataSource の getConnection
    戻り値:
    遅延接続ハンドル
    例外:
    SQLExceptionSE
    関連事項:
    ConnectionProxy.getTargetConnection()
  - getConnection
```
public ConnectionSE getConnection(StringSE username,
                                StringSE password)
                         throws SQLExceptionSE
```
    ステートメント（または PreparedStatement または CallableStatement）を要求されたときに実際の JDBC 接続を遅延フェッチする接続ハンドルを返します。
    返された Connection ハンドルは ConnectionProxy インターフェースを実装し、基になるターゲット Connection を取得できるようにします。
    次で指定:
    インターフェース DataSourceSE の getConnectionSE
    オーバーライド:
    クラス DelegatingDataSource の getConnection
    パラメーター:
    username - 接続ごとのユーザー名
    password - 接続ごとのパスワード
    戻り値:
    遅延接続ハンドル
    例外:
    SQLExceptionSE
    関連事項:
    ConnectionProxy.getTargetConnection()

クラス LazyConnectionDataSourceProxy

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

メソッドのサマリー

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

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

コンストラクターの詳細

LazyConnectionDataSourceProxy

LazyConnectionDataSourceProxy

メソッドの詳細

setDefaultAutoCommit

setDefaultTransactionIsolation

setDefaultTransactionIsolationName

afterPropertiesSet

checkDefaultConnectionProperties

defaultAutoCommit

defaultTransactionIsolation

getConnection

getConnection