SingleConnectionDataSource (Spring Framework 5.0.0.RELEASE API)

java.lang.ObjectSE
- org.springframework.jdbc.datasource.AbstractDataSource
- - org.springframework.jdbc.datasource.AbstractDriverBasedDataSource
  - - org.springframework.jdbc.datasource.DriverManagerDataSource
    - - org.springframework.jdbc.datasource.SingleConnectionDataSource

実装されているすべてのインターフェース:
WrapperSE, CommonDataSourceSE, DataSourceSE, DisposableBean, SmartDataSource
```
public class SingleConnectionDataSource
extends DriverManagerDataSource
implements SmartDataSource, DisposableBean
```
使用後に閉じられない単一の JDBC 接続をラップする SmartDataSource の実装。明らかに、これはマルチスレッド対応ではありません。
シャットダウン時に、誰かが close() メソッドを介して基礎となる接続を閉じる必要があることに注意してください。SmartDataSource に対応している（たとえば DataSourceUtils.releaseConnection を使用している）場合、クライアントコードは接続ハンドルで close を呼び出しません。
永続化ツールを使用する場合など、クライアントコードがプールされた接続を想定して close() を呼び出す場合は、"suppressClose" を "true" に設定します。これにより、物理的な接続ではなく、クローズ抑制プロキシが返されます。
これは主にテスト用です。例: DataSource で動作することを期待するコードについて、アプリケーションサーバーの外で簡単にテストできます。DriverManagerDataSource とは対照的に、常に同じ接続を再利用し、物理接続の過剰な作成を回避します。
作成者:
Rod Johnson, Juergen Hoeller
関連事項:
getConnection(), Connection.close()SE, DataSourceUtils.releaseConnection(java.sql.Connection, javax.sql.DataSource)

フィールドのサマリー
- クラス org.springframework.jdbc.datasource.AbstractDataSource から継承されたフィールド
  logger

コンストラクターの概要

コンストラクター
コンストラクターと説明
`SingleConnectionDataSource()` Bean スタイルの構成のコンストラクター。
`SingleConnectionDataSource(ConnectionSE target, boolean suppressClose)` 指定された接続で新しい SingleConnectionDataSource を作成します。
`SingleConnectionDataSource(StringSE url, boolean suppressClose)` 指定された標準 DriverManager パラメーターで新しい SingleConnectionDataSource を作成します。
`SingleConnectionDataSource(StringSE url, StringSE username, StringSE password, boolean suppressClose)` 指定された標準 DriverManager パラメーターで新しい SingleConnectionDataSource を作成します。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`destroy()` 基になる接続を閉じます。
`protected BooleanSE`	`getAutoCommitValue()` 返された接続の "autoCommit" 設定を上書きする必要があるかどうかを返します。
`protected ConnectionSE`	`getCloseSuppressingConnectionProxy(ConnectionSE target)` すべてのメソッド呼び出しを委譲するプロキシを使用して、指定された接続をラップしますが、クローズ呼び出しを抑制します。
`ConnectionSE`	`getConnection()` この実装は、この DataSource のデフォルトのユーザー名とパスワードを使用して `getConnectionFromDriver` に委譲します。
`ConnectionSE`	`getConnection(StringSE username, StringSE password)` カスタムのユーザー名とパスワードを指定しても、単一の接続では意味がありません。
`void`	`initConnection()` DriverManager を介して基になる接続を初期化します。
`protected boolean`	`isSuppressClose()` 返された接続がクローズ抑制プロキシか物理接続かを返します。
`protected void`	`prepareConnection(ConnectionSE con)` 公開する前に、所定の接続を準備します。
`void`	`resetConnection()` 基礎となる共有接続をリセットして、次のアクセスで再初期化します。
`void`	`setAutoCommit(boolean autoCommit)` 返された接続の "autoCommit" 設定を上書きするかどうかを設定します。
`void`	`setSuppressClose(boolean suppressClose)` 返された接続をクローズ抑制プロキシにするか物理接続にするかを設定します。
`boolean`	`shouldClose(ConnectionSE con)` これは単一の接続です。「プール」に戻るときに接続を閉じないでください。

クラス org.springframework.jdbc.datasource.DriverManagerDataSource から継承されたメソッド
getConnectionFromDriver, getConnectionFromDriverManager, setDriverClassName

クラス org.springframework.jdbc.datasource.AbstractDriverBasedDataSource から継承されたメソッド
getCatalog, getConnectionFromDriver, getConnectionProperties, getPassword, getSchema, getUrl, getUsername, setCatalog, setConnectionProperties, setPassword, setSchema, setUrl, setUsername

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

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

インターフェース javax.sql.CommonDataSourceSE から継承されたメソッド
getLoginTimeoutSE, getLogWriterSE, getParentLoggerSE, setLoginTimeoutSE, setLogWriterSE

インターフェース java.sql.WrapperSE から継承されたメソッド
isWrapperForSE, unwrapSE

- コンストラクターの詳細
  - SingleConnectionDataSource
```
public SingleConnectionDataSource()
```
    Bean スタイルの構成のコンストラクター。
  - SingleConnectionDataSource
```
public SingleConnectionDataSource(StringSE url,
                                  StringSE username,
                                  StringSE password,
                                  boolean suppressClose)
```
    指定された標準 DriverManager パラメーターで新しい SingleConnectionDataSource を作成します。
    パラメーター:
    url - DriverManager へのアクセスに使用する JDBC URL
    username - DriverManager へのアクセスに使用する JDBC ユーザー名
    password - DriverManager へのアクセスに使用する JDBC パスワード
    suppressClose - 返された接続がクローズ抑制プロキシまたは物理接続である場合
    関連事項:
    DriverManager.getConnection(String, String, String)SE
  - SingleConnectionDataSource
```
public SingleConnectionDataSource(StringSE url,
                                  boolean suppressClose)
```
    指定された標準 DriverManager パラメーターで新しい SingleConnectionDataSource を作成します。
    パラメーター:
    url - DriverManager へのアクセスに使用する JDBC URL
    suppressClose - 返された接続がクローズ抑制プロキシまたは物理接続である場合
    関連事項:
    DriverManager.getConnection(String, String, String)SE
  - SingleConnectionDataSource
```
public SingleConnectionDataSource(ConnectionSE target,
                                  boolean suppressClose)
```
    指定された接続で新しい SingleConnectionDataSource を作成します。
    パラメーター:
    target - 基になるターゲット接続
    suppressClose - Connection を close() 呼び出しを抑制する Connection でラップする必要がある場合 (プールされた接続を予期しているが、SmartDataSource インターフェースを知らないアプリケーションで、通常の close() の使用を可能にする)
- メソッドの詳細
  - setSuppressClose
```
public void setSuppressClose(boolean suppressClose)
```
    返された接続をクローズ抑制プロキシにするか物理接続にするかを設定します。
  - isSuppressClose
```
protected boolean isSuppressClose()
```
    返された接続がクローズ抑制プロキシか物理接続かを返します。
  - setAutoCommit
```
public void setAutoCommit(boolean autoCommit)
```
    返された接続の "autoCommit" 設定を上書きするかどうかを設定します。
  - getAutoCommitValue
```
@Nullable
protected BooleanSE getAutoCommitValue()
```
    返された接続の "autoCommit" 設定を上書きする必要があるかどうかを返します。
    戻り値:
    "autoCommit" 値、または何も適用しない場合は null
  - getConnection
```
public ConnectionSE getConnection()
                         throws SQLExceptionSE
```
    クラスからコピーされた説明: AbstractDriverBasedDataSource
    この実装は、この DataSource のデフォルトのユーザー名とパスワードを使用して getConnectionFromDriver に委譲します。
    次で指定:
    インターフェース DataSourceSE の getConnectionSE
    オーバーライド:
    クラス AbstractDriverBasedDataSource の getConnection
    例外:
    SQLExceptionSE
    関連事項:
    AbstractDriverBasedDataSource.getConnectionFromDriver(String, String), AbstractDriverBasedDataSource.setUsername(java.lang.String), AbstractDriverBasedDataSource.setPassword(java.lang.String)
  - getConnection
```
public ConnectionSE getConnection(StringSE username,
                                StringSE password)
                         throws SQLExceptionSE
```
    カスタムのユーザー名とパスワードを指定しても、単一の接続では意味がありません。同じユーザー名とパスワードが与えられた場合、単一の接続を返します。それ以外の場合は SQLException をスローします。
    次で指定:
    インターフェース DataSourceSE の getConnectionSE
    オーバーライド:
    クラス AbstractDriverBasedDataSource の getConnection
    例外:
    SQLExceptionSE
    関連事項:
    AbstractDriverBasedDataSource.getConnectionFromDriver(String, String)
  - shouldClose
```
public boolean shouldClose(ConnectionSE con)
```
    これは単一の接続です。「プール」に戻るときに接続を閉じないでください。
    次で指定:
    インターフェース SmartDataSource の shouldClose
    パラメーター:
    con - 確認する接続
    戻り値:
    指定された接続を閉じるかどうか
    関連事項:
    Connection.close()SE
  - destroy
```
public void destroy()
```
    基になる接続を閉じます。この DataSource のプロバイダーは、適切なシャットダウンに注意する必要があります。
    この Bean は DisposableBean を実装しているため、Bean ファクトリは、キャッシュされたシングルトンの破棄時にこれを自動的に呼び出します。
    次で指定:
    インターフェース DisposableBean の destroy
  - initConnection
```
public void initConnection()
                    throws SQLExceptionSE
```
    DriverManager を介して基になる接続を初期化します。
    例外:
    SQLExceptionSE
  - resetConnection
```
public void resetConnection()
```
    基礎となる共有接続をリセットして、次のアクセスで再初期化します。
  - prepareConnection
```
protected void prepareConnection(ConnectionSE con)
                          throws SQLExceptionSE
```
    公開する前に、所定の接続を準備します。
    デフォルトの実装では、必要に応じて自動コミットフラグが適用されます。サブクラスでオーバーライドできます。
    パラメーター:
    con - 準備する接続
    例外:
    SQLExceptionSE
    関連事項:
    setAutoCommit(boolean)
  - getCloseSuppressingConnectionProxy
```
protected ConnectionSE getCloseSuppressingConnectionProxy(ConnectionSE target)
```
    すべてのメソッド呼び出しを委譲するプロキシを使用して、指定された接続をラップしますが、クローズ呼び出しを抑制します。
    パラメーター:
    target - ラップする元の接続
    戻り値:
    ラップされた接続

クラス SingleConnectionDataSource

フィールドのサマリー

クラス org.springframework.jdbc.datasource.AbstractDataSource から継承されたフィールド

コンストラクターの概要

メソッドのサマリー

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

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

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

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

インターフェース javax.sql.CommonDataSourceSE から継承されたメソッド

インターフェース java.sql.WrapperSE から継承されたメソッド

コンストラクターの詳細

SingleConnectionDataSource

SingleConnectionDataSource

SingleConnectionDataSource

SingleConnectionDataSource

メソッドの詳細

setSuppressClose

isSuppressClose

setAutoCommit

getAutoCommitValue

getConnection

getConnection

shouldClose

destroy

initConnection

resetConnection

prepareConnection

getCloseSuppressingConnectionProxy