java.sql

インタフェース Driver

public interface Driver

すべてのドライバクラスが実装しなければならないインタフェースです。

Java の SQL フレームワークでは、複数のデータベースドライバが使用可能です。

各ドライバは、Driver インタフェースを実装するクラスを指定しなければいけません。

DriverManager は、見つけたすべてのドライバをロードしようとします。そして、指定された接続要求に対し、各ドライバにターゲットの URL に接続するように要求します。

Driver クラスは、小さく、かつスタンドアロンであることを強くお勧めします。そうすれば、支援のためのコードを大量に導入することなく、Driver クラスをロードし、クエリーすることができるからです。

Driver クラスをロードするときは、そのインスタンスを生成し、DriverManager で登録しなければいけません。つまり、ユーザーは次のメソッドを呼び出すことでドライバをロードし、登録できます。

   Class.forName("foo.bah.Driver")
 

関連項目:

DriverManager, Connection

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
boolean	acceptsURL(String url) 指定された URL に接続できるとドライバが判断するかどうかを取得します。
Connection	connect(String url, Properties info) 指定された URL にデータベース接続を試みます。
int	getMajorVersion() ドライバのメジャーバージョン番号を取得します。
int	getMinorVersion() ドライバのマイナーバージョンを取得します。
Logger	getParentLogger() このドライバで使用されるすべてのロガーの親ロガーを返します。
DriverPropertyInfo[]	getPropertyInfo(String url, Properties info) このドライバの有効なプロパティーについての情報を取得します。
boolean	jdbcCompliant() このドライバが JDBC CompliantTM ドライバであるかどうかを報告します。

メソッドの詳細

connect

Connection connect(String url,
                 Properties info)
                   throws SQLException

指定された URL にデータベース接続を試みます。指定された URL に、間違ったドライバを接続しようとしていることがわかった場合には、ドライバは null を返さなければいけません。これは、JDBC ドライバマネージャーが、指定された URL に接続するように要求されて、ロードされているドライバに順番にその URL を渡すときも同様です。

ドライバが、指定された URL に接続するための正しいドライバであっても、データベースへの接続に障害が生じた場合には、ドライバは SQLException をスローします。

java.util.Properties の引数は、任意の文字列タグおよび値のペアを、接続引数として渡すために使用できます。通常は、少なくとも「user」プロパティーと「password」プロパティーを Properties オブジェクトに含めるべきです。

パラメータ:

url - 接続先のデータベースの URL

info - 接続引数としての、任意の文字列タグおよび値のペアのリスト。通常は、少なくとも「user」プロパティーと「password」プロパティーを指定するべきです。

戻り値:

URL への接続を表す Connection オブジェクト

例外:

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

acceptsURL

boolean acceptsURL(String url)
                   throws SQLException

指定された URL に接続できるとドライバが判断するかどうかを取得します。通常、ドライバは、URL で指定されたサブプロトコルを認識する場合は true、認識しない場合は false を返します。

パラメータ:

url - データベースの URL

戻り値:

このドライバが指定された URL を認識する場合は true、そうでない場合は false

例外:

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

getPropertyInfo

DriverPropertyInfo[] getPropertyInfo(String url,
                                   Properties info)
                                     throws SQLException

このドライバの有効なプロパティーについての情報を取得します。

getPropertyInfo メソッドは、データベースに接続するために十分な情報を得る目的で、汎用 GUI ツールが人に確認すべきプロパティーを発見するためものです。これまでに人が与えた値によっては、追加の値が必要になることがあり、そのために getPropertyInfo メソッドへの呼び出しを何回か繰り返す必要が生じることがあることに注意してください。

パラメータ:

url - 接続先のデータベースの URL

info - 接続オープン時に送られるタグ/値ペアの推奨リスト

戻り値:

可能なプロパティーを記述する DriverPropertyInfo オブジェクトの配列。プロパティーが必要ない場合は、この配列は空になることもある

例外:

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

getMajorVersion

int getMajorVersion()

ドライバのメジャーバージョン番号を取得します。最初は、この値は 1 であるべきです。

戻り値:

このドライバのメジャーバージョン番号

getMinorVersion

int getMinorVersion()

ドライバのマイナーバージョンを取得します。最初は、この値は 0 であるべきです。

戻り値:

このドライバのマイナーバージョン番号

jdbcCompliant

boolean jdbcCompliant()

このドライバが JDBC Compliant^TM ドライバであるかどうかを報告します。ドライバは JBDC の準拠テストにパスする場合にだけ true を返し、そうでない場合は false を返す必要があります。

JDBC に準拠するには、JDBC API と SQL 92 Entry Level の完全なサポートが必要です。JBDC 準拠のドライバは、主要な商用データベースのすべてで使用できます。

このメソッドは、JBDC 準拠ではないドライバの開発を推奨することは意図していません。しかし、いくつかのベンダーが、完全なデータベース機能をサポートしていない軽量データベース、あるいは文献情報検索のような SQL による実装が実施できない特別なデータベースに対して、JDBC の API とフレームワークを適用することに興味を持っていることを認識した結果としてあります。

戻り値:

このドライバが JDBC 準拠の場合は true、そうでない場合は false

getParentLogger

Logger getParentLogger()
                       throws SQLFeatureNotSupportedException

このドライバで使用されるすべてのロガーの親ロガーを返します。これはこのドライバによって使用されているすべてのロガーの上位ロガーであるルートロガーからもっとも遠いロガーになるはずです。このロガーを構成すると、ドライバによって生成されたすべてのログメッセージに影響します。最悪の場合、これがルート Logger になる可能性があります。

戻り値:

このドライバの親ロガー

例外:

SQLFeatureNotSupportedException - ドライバが java.util.logging を使用しない場合。

導入されたバージョン:

1.7