UserCredentialsDataSourceAdapter (Spring Framework 5.1.1.RELEASE API)

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

実装済みのインターフェース一覧:
java.sql.Wrapper, javax.sql.CommonDataSource, javax.sql.DataSource, InitializingBean
既知の直属サブクラス
IsolationLevelDataSourceAdapter
```
public class UserCredentialsDataSourceAdapter
extends DelegatingDataSource
```
ターゲット JDBC DataSource のアダプター。指定されたユーザー資格情報をすべての標準 getConnection() 呼び出しに適用し、ターゲットで getConnection(username, password) を暗黙的に呼び出します。他のすべてのメソッドは、ターゲット DataSource の対応するメソッドに委譲するだけです。
ユーザー資格情報が構成されていないターゲット JNDI DataSource をプロキシするために使用できます。クライアントコードは、標準の getConnection() 呼び出しを使用して、通常どおりこの DataSource で機能します。
次の例では、クライアントコードは、事前構成された "myDataSource" を透過的に操作し、指定されたユーザー資格情報を使用して "myTargetDataSource" に暗黙的にアクセスできます。
```
 <bean id="myTargetDataSource" class="org.springframework.jndi.JndiObjectFactoryBean">
   <property name="jndiName" value="java:comp/env/jdbc/myds"/>
 </bean>

 <bean id="myDataSource" class="org.springframework.jdbc.datasource.UserCredentialsDataSourceAdapter">
   <property name="targetDataSource" ref="myTargetDataSource"/>
   <property name="username" value="myusername"/>
   <property name="password" value="mypassword"/>
 </bean>
```
"username" が空の場合、このプロキシはターゲット DataSource の標準 getConnection() メソッドに委譲するだけです。これは、特定のターゲット DataSource で必要な場合に、ユーザー資格情報を暗黙的に渡すオプションだけのために、UserCredentialsDataSourceAdapter Bean 定義を保持するために使用できます。
導入:
1.0.2
作成者:
Juergen Hoeller
関連事項:
getConnection()

コンストラクター概要
コンストラクター
コンストラクターと説明
UserCredentialsDataSourceAdapter()

コンストラクター
コンストラクターと説明
`UserCredentialsDataSourceAdapter()`

方法の概要

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`protected java.sql.Connection`	`doGetConnection(java.lang.String username, java.lang.String password)` この実装は、ターゲット DataSource の `getConnection(username, password)` メソッドに委譲し、指定されたユーザー資格情報を渡します。
`java.sql.Connection`	`getConnection()` 現在スレッドにバインドされた資格情報があるかどうかを確認し、可能な場合はそれらを使用して、静的に指定されたユーザー名とパスワード（つまり
`java.sql.Connection`	`getConnection(java.lang.String username, java.lang.String password)` 指定されたユーザー資格情報をそのままにして、`doGetConnection(String, String)` に委譲するだけです。
`void`	`removeCredentialsFromCurrentThread()` 現在のスレッドからこのプロキシのユーザー資格情報を削除します。
`void`	`setCatalog(java.lang.String catalog)` 取得した各接続に適用するデータベースカタログを指定します。
`void`	`setCredentialsForCurrentThread(java.lang.String username, java.lang.String password)` このプロキシと現在のスレッドのユーザー資格情報を設定します。
`void`	`setPassword(java.lang.String password)` このアダプターが接続の取得に使用するデフォルトのユーザーのパスワードを設定します。
`void`	`setSchema(java.lang.String schema)` 取得した各接続に適用するデータベーススキーマを指定します。
`void`	`setUsername(java.lang.String username)` このアダプターが接続の取得に使用するデフォルトのユーザー名を設定します。

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

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

- コンストラクターの詳細
  - UserCredentialsDataSourceAdapter
```
public UserCredentialsDataSourceAdapter()
```
- メソッドの詳細
  - setUsername
```
public void setUsername(java.lang.String username)
```
    このアダプターが接続の取得に使用するデフォルトのユーザー名を設定します。
    デフォルトは特定のユーザーではありません。明示的に指定されたユーザー名は、常に DataSource レベルで指定されたユーザー名 / パスワードを上書きすることに注意してください。
    関連事項:
    setPassword(java.lang.String), setCredentialsForCurrentThread(String, String), getConnection(String, String)
  - setPassword
```
public void setPassword(java.lang.String password)
```
    このアダプターが接続の取得に使用するデフォルトのユーザーのパスワードを設定します。
    デフォルトは特定のパスワードではありません。明示的に指定されたユーザー名は、常に DataSource レベルで指定されたユーザー名 / パスワードを上書きすることに注意してください。
    関連事項:
    setUsername(java.lang.String), setCredentialsForCurrentThread(String, String), getConnection(String, String)
  - setCatalog
```
public void setCatalog(java.lang.String catalog)
```
    取得した各接続に適用するデータベースカタログを指定します。
    導入:
    4.3.2
    関連事項:
    Connection.setCatalog(java.lang.String)
  - setSchema
```
public void setSchema(java.lang.String schema)
```
    取得した各接続に適用するデータベーススキーマを指定します。
    導入:
    4.3.2
    関連事項:
    Connection.setSchema(java.lang.String)
  - setCredentialsForCurrentThread
```
public void setCredentialsForCurrentThread(java.lang.String username,
                                           java.lang.String password)
```
    このプロキシと現在のスレッドのユーザー資格情報を設定します。指定されたユーザー名とパスワードは、この DataSource プロキシ上の後続のすべての getConnection() 呼び出しに適用されます。
    これにより、静的に指定されたユーザー資格情報、つまり "username" および "password" Bean プロパティの値が上書きされます。
    パラメーター:
    username - 適用するユーザー名
    password - 適用するパスワード
    関連事項:
    removeCredentialsFromCurrentThread()
  - removeCredentialsFromCurrentThread
```
public void removeCredentialsFromCurrentThread()
```
    現在のスレッドからこのプロキシのユーザー資格情報を削除します。静的に指定されたユーザー資格情報は、その後再び適用されます。
    関連事項:
    setCredentialsForCurrentThread(java.lang.String, java.lang.String)
  - getConnection
```
public java.sql.Connection getConnection()
                                  throws java.sql.SQLException
```
    現在スレッドにバインドされた資格情報があるかどうかを確認し、可能な場合はそれらを使用して、静的に指定されたユーザー名とパスワード（つまり、Bean プロパティの値）にフォールバックします。
    決定された資格情報をパラメーターとして doGetConnection(String, String) に委譲します。
    次で指定:
    インターフェース javax.sql.DataSource 内の getConnection
    オーバーライド:
    クラス DelegatingDataSource の getConnection
    例外:
    java.sql.SQLException
  - getConnection
```
public java.sql.Connection getConnection(java.lang.String username,
                                         java.lang.String password)
                                  throws java.sql.SQLException
```
    指定されたユーザー資格情報をそのままにして、doGetConnection(String, String) に委譲するだけです。
    次で指定:
    インターフェース javax.sql.DataSource 内の getConnection
    オーバーライド:
    クラス DelegatingDataSource の getConnection
    例外:
    java.sql.SQLException
  - doGetConnection
```
protected java.sql.Connection doGetConnection(@Nullable
                                              java.lang.String username,
                                              @Nullable
                                              java.lang.String password)
                                       throws java.sql.SQLException
```
    この実装は、ターゲット DataSource の getConnection(username, password) メソッドに委譲し、指定されたユーザー資格情報を渡します。指定されたユーザー名が空の場合、ターゲット DataSource の標準 getConnection() メソッドに委譲するだけです。
    パラメーター:
    username - 使用するユーザー名
    password - 使用するパスワード
    戻り値:
    接続
    例外:
    java.sql.SQLException
    関連事項:
    DataSource.getConnection(String, String), DataSource.getConnection()

クラス UserCredentialsDataSourceAdapter

コンストラクター概要

方法の概要

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

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

コンストラクターの詳細

UserCredentialsDataSourceAdapter

メソッドの詳細

setUsername

setPassword

setCatalog

setSchema

setCredentialsForCurrentThread

removeCredentialsFromCurrentThread

getConnection

getConnection

doGetConnection