JavaTM 2
Platform
Std. Ed. v1.4.0

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 CompliantTM であるかどうかを通知します。ドライバが JBDC の準拠テストにパスする場合にだけ true を返し、そうでない場合は false を返します。

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

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

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

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.