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() ドライバのマイナーバージョンを取得します。
DriverPropertyInfo[]	getPropertyInfo(String url, Properties info) このドライバの有効なプロパティについての情報を取得します。
boolean	jdbcCompliant() このドライバが JDBC CompliantTM であるかどうかを通知します。

メソッドの詳細

connect

public 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

public boolean acceptsURL(String url)
                   throws SQLException

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

パラメータ:

url - データベースの URL

戻り値:

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

例外:

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

getPropertyInfo

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

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

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

パラメータ:

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

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

戻り値:

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

例外:

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

getMajorVersion

public int getMajorVersion()

ドライバのメジャーバージョンを取得します。最初は、この値は 1 でなければなりません。

戻り値:

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

getMinorVersion

public int getMinorVersion()

ドライバのマイナーバージョンを取得します。最初は、この値は 0 でなければなりません。

戻り値:

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

jdbcCompliant

public boolean jdbcCompliant()

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

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

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

戻り値:

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