Driver (Java Platform SE 6)

メソッドの概要
`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 Compliant^TM であるかどうかを通知します。

メソッドの詳細

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 とフレームワークを適用することに興味を持っていることを認識した結果としてあります。