SingleConnectionDataSource (Spring Framework 5.1.1.RELEASE API)

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

実装済みのインターフェース一覧:
java.sql.Wrapper, javax.sql.CommonDataSource, javax.sql.DataSource, 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(), DataSourceUtils.releaseConnection(java.sql.Connection, javax.sql.DataSource)

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

コンストラクター概要

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

方法の概要

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`destroy()` 基になる接続を閉じます。
`protected java.lang.Boolean`	`getAutoCommitValue()` 返された接続の "autoCommit" 設定を上書きする必要があるかどうかを返します。
`protected java.sql.Connection`	`getCloseSuppressingConnectionProxy(java.sql.Connection target)` すべてのメソッド呼び出しを委譲するプロキシを使用して、指定された接続をラップしますが、クローズ呼び出しを抑制します。
`java.sql.Connection`	`getConnection()` この実装は、この DataSource のデフォルトのユーザー名とパスワードを使用して `getConnectionFromDriver` に委譲します。
`java.sql.Connection`	`getConnection(java.lang.String username, java.lang.String password)` カスタムのユーザー名とパスワードを指定しても、単一の接続では意味がありません。
`void`	`initConnection()` DriverManager を介して基になる接続を初期化します。
`protected boolean`	`isSuppressClose()` 返された接続がクローズ抑制プロキシか物理接続かを返します。
`protected void`	`prepareConnection(java.sql.Connection con)` 公開する前に、所定の接続を準備します。
`void`	`resetConnection()` 基礎となる共有接続をリセットして、次のアクセスで再初期化します。
`void`	`setAutoCommit(boolean autoCommit)` 返された接続の "autoCommit" 設定を上書きするかどうかを設定します。
`void`	`setSuppressClose(boolean suppressClose)` 返された接続をクローズ抑制プロキシにするか物理接続にするかを設定します。
`boolean`	`shouldClose(java.sql.Connection 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.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

インターフェース javax.sql.CommonDataSource から継承されたメソッド
getLoginTimeout, getLogWriter, getParentLogger, setLoginTimeout, setLogWriter

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

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

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

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

コンストラクターの詳細

SingleConnectionDataSource

SingleConnectionDataSource

SingleConnectionDataSource

SingleConnectionDataSource

メソッドの詳細

setSuppressClose

isSuppressClose

setAutoCommit

getAutoCommitValue

getConnection

getConnection

shouldClose

destroy

initConnection

resetConnection

prepareConnection

getCloseSuppressingConnectionProxy