LazyConnectionDataSourceProxy (Spring Framework 5.1.1.RELEASE API)

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

実装済みのインターフェース一覧:
java.sql.Wrapper, javax.sql.CommonDataSource, javax.sql.DataSource, 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>) を使用してネイティブ JDBC 接続を取得します。
導入:
1.1.4
作成者:
Juergen Hoeller
関連事項:
DataSourceTransactionManager

コンストラクター概要

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

方法の概要

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

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

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

クラス LazyConnectionDataSourceProxy

コンストラクター概要

方法の概要

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

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

コンストラクターの詳細

LazyConnectionDataSourceProxy

LazyConnectionDataSourceProxy

メソッドの詳細

setDefaultAutoCommit

setDefaultTransactionIsolation

setDefaultTransactionIsolationName

afterPropertiesSet

checkDefaultConnectionProperties

defaultAutoCommit

defaultTransactionIsolation

getConnection

getConnection