compact2, compact3

javax.sql

インタフェースDataSource

すべてのスーパー・インタフェース:

CommonDataSource、Wrapper

public interface DataSource
extends CommonDataSource, Wrapper

このDataSourceオブジェクトが表す物理データ・ソースへの接続に対するファクトリです。DriverManager機能の代わりに、DataSourceオブジェクトが接続を得るための適切な手段となります。DataSourceインタフェースを実装するオブジェクトは、一般に、Java™ Naming and Directory (JNDI) APIを基にしたネーム・サービスに登録されています。

DataSourceインタフェースは、ドライバ・ベンダーによって実装されています。実装には3種類あります。

1. 基本実装 -- 標準Connectionオブジェクトを生成する
2. 接続プール実装 -- 自動的に接続プールに参加するConnectionオブジェクトを生成する。この実装は中間層の接続プール管理プログラムとともに動作する。
3. 分散トランザクション実装 -- 分散トランザクションで使用され、ほとんどの場合に常に接続プールに参加するConnectionオブジェクトを生成する。この実装は中間層のトランザクション・マネージャと、多くの場合は常に接続プール管理プログラムとともに動作する。

DataSourceオブジェクトは、必要に応じて変更可能なプロパティを保持します。たとえば、データ・ソースが別のサーバーへ移動した場合、そのサーバーについてのプロパティを変更できます。データ・ソースのプロパティを変更できるため、データ・ソースにアクセスするコードを変更する必要がないという利点があります。

DataSourceオブジェクトを介してアクセスされたドライバは、自分自身をDriverManagerで登録しません。むしろ、DataSourceオブジェクトがルックアップ操作により取得されて、Connectionオブジェクトを作成するために使用されます。基本実装では、DataSourceオブジェクトにより取得された接続は、DriverManager機能により取得した接続と同じものになります。

DataSourceの実装には引数なしのpublicコンストラクタが含まれている必要があります。

導入されたバージョン:

1.4

メソッドのサマリー

修飾子と型	メソッドと説明
Connection	getConnection() このDataSourceオブジェクトが表すデータ・ソースへの接続の確立を試みます。
Connection	getConnection(String username, String password) このDataSourceオブジェクトが表すデータ・ソースへの接続の確立を試みます。

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

getLoginTimeout, getLogWriter, getParentLogger, setLoginTimeout, setLogWriter

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

isWrapperFor, unwrap

メソッドの詳細

getConnection

Connection getConnection()
                  throws SQLException

このDataSourceオブジェクトが表すデータ・ソースへの接続の確立を試みます。

戻り値:

データ・ソースへの接続

例外:

SQLException - データベース・アクセス・エラーが発生した場合

SQLTimeoutException - ドライバが、setLoginTimeoutメソッドで指定されたタイムアウト値が経過したと判定し、少なくとも現在のデータベース接続の試みを取り消そうとしたとき

getConnection

Connection getConnection(String username,
                         String password)
                  throws SQLException

このDataSourceオブジェクトが表すデータ・ソースへの接続の確立を試みます。

パラメータ:

username - その代理として接続が行われるデータベース・ユーザー

password - ユーザーのパスワード

戻り値:

データ・ソースへの接続

例外:

SQLException - データベース・アクセス・エラーが発生した場合

SQLTimeoutException - ドライバが、setLoginTimeoutメソッドで指定されたタイムアウト値が経過したと判定し、少なくとも現在のデータベース接続の試みを取り消そうとしたとき

導入されたバージョン:

1.4