- すべてのスーパー・インタフェース:
CommonDataSource
PooledConnectionオブジェクトのファクトリです。 このインタフェースを実装するオブジェクトは、通常、Java Naming and Directory Interface (JNDI)に基づくネーミング・サービスに登録されます。 - 導入されたバージョン:
- 1.4
-
メソッドのサマリー
修飾子と型メソッド説明default PooledConnectionBuilder新しいPooledConnectionBuilderインスタンスを作成intデータベースへの接続試行中に、このデータ・ソースが待機する最長時間(秒)を取得します。このDataSourceオブジェクトのログ・ライターを取得します。プールされた接続として使用可能な、データベースへの物理接続の確立を試みます。getPooledConnection(String user, String password) プールされた接続として使用可能な、データベースへの物理接続の確立を試みます。voidsetLoginTimeout(int seconds) データベースへの接続試行中に、このデータ・ソースが待機する最長時間(秒)を指定します。voidsetLogWriter(PrintWriter out) このDataSourceオブジェクトのログ・ライターをjava.io.PrintWriterオブジェクトに設定します。インタフェースjavax.sql.CommonDataSourceで宣言されたメソッド
createShardingKeyBuilder, getParentLogger
-
メソッドの詳細
-
getPooledConnection
PooledConnection getPooledConnection() throws SQLExceptionプールされた接続として使用可能な、データベースへの物理接続の確立を試みます。- 戻り値:
- この
ConnectionPoolDataSourceオブジェクトが表すデータベースへの物理接続であるPooledConnectionオブジェクト - 例外:
SQLException- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
getPooledConnection
プールされた接続として使用可能な、データベースへの物理接続の確立を試みます。- パラメータ:
user- その代理として接続が行われるデータベース・ユーザーpassword- ユーザーのパスワード- 戻り値:
- この
ConnectionPoolDataSourceオブジェクトが表すデータベースへの物理接続であるPooledConnectionオブジェクト - 例外:
SQLException- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
getLogWriter
PrintWriter getLogWriter() throws SQLExceptionこの
DataSourceオブジェクトのログ・ライターを取得します。ログ・ライターとは、このデータ・ソースに対するすべてのロギング・メッセージやトレース・メッセージの出力先となるキャラクタ出力ストリームのことです。 このオブジェクトのメソッドによって出力されたメッセージや、このオブジェクトが作成した他のオブジェクトのメソッドによって出力されたメッセージなども含まれます。 データ・ソース固有のログ・ライターに表示されたメッセージは、
java.sql.DriverManagerクラスに関連付けられたログ・ライターには出力されません。DataSourceオブジェクトが作成されると、ログ・ライターはnullに初期化されます。つまり、デフォルトではロギングは無効です。- 定義:
- インタフェース
CommonDataSource内のgetLogWriter - 戻り値:
- このデータ・ソースのログ・ライター。ログの取得が無効の場合はnull
- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setLogWriter
void setLogWriter(PrintWriter out) throws SQLException この
DataSourceオブジェクトのログ・ライターをjava.io.PrintWriterオブジェクトに設定します。ログ・ライターとは、このデータ・ソースに対するすべてのロギング・メッセージやトレース・メッセージの出力先となるキャラクタ出力ストリームのことです。 このオブジェクトのメソッドによって出力されたメッセージや、このオブジェクトが作成した他のオブジェクトのメソッドによって出力されたメッセージなども含まれます。 データ・ソース固有のログ・ライターに表示されたメッセージは、
java.sql.DriverManagerクラスに関連付けられたログ・ライターには出力されません。DataSourceオブジェクトが作成されると、ログ・ライターはnullに初期化されます。つまり、デフォルトではロギングは無効です。- 定義:
- インタフェース
CommonDataSource内のsetLogWriter - パラメータ:
out- 新しいログ・ライター。ロギングを無効にする場合はnullに設定する- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setLoginTimeout
void setLoginTimeout(int seconds) throws SQLException データベースへの接続試行中に、このデータ・ソースが待機する最長時間(秒)を指定します。 値が0のとき、デフォルトのシステム・タイムアウトが設定されている場合はその値になります。そうでない場合はタイムアウトしないことを意味します。
DataSourceオブジェクトが作成されると、ログイン・タイムアウトは0に初期化されます。- 定義:
- インタフェース
CommonDataSource内のsetLoginTimeout - パラメータ:
seconds- データ・ソースのログイン制限時間- 例外:
SQLException- データベース・アクセス・エラーが発生した場合。- 導入されたバージョン:
- 1.4
- 関連項目:
-
getLoginTimeout
int getLoginTimeout() throws SQLExceptionデータベースへの接続試行中に、このデータ・ソースが待機する最長時間(秒)を取得します。 値が0のとき、デフォルトのシステム・タイムアウトが設定されている場合はその値になります。そうでない場合はタイムアウトしないことを意味します。DataSourceオブジェクトが作成されると、ログイン・タイムアウトは0に初期化されます。- 定義:
- インタフェース
CommonDataSource内のgetLoginTimeout - 戻り値:
- データ・ソースのログイン制限時間
- 例外:
SQLException- データベース・アクセス・エラーが発生した場合。- 導入されたバージョン:
- 1.4
- 関連項目:
-
createPooledConnectionBuilder
default PooledConnectionBuilder createPooledConnectionBuilder() throws SQLException新しいPooledConnectionBuilderインスタンスを作成- 実装要件:
- デフォルトの実装では、
SQLFeatureNotSupportedExceptionがスローされます。 - 戻り値:
- 作成されたConnectionBuilderインスタンス
- 例外:
SQLException- ビルダーの作成中にエラーが発生した場合SQLFeatureNotSupportedException- 運転手がシャーディングをサポートしていない場合- 導入されたバージョン:
- 9
- 関連項目:
-