JavaTM 2 Platform
Standard Ed. 5.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

Connection connect(String url,
                   Properties info)
                   throws SQLException
试图创建一个到给定 URL 的数据库连接。如果驱动程序识别出它是连接到给定 URL 的错误类型的驱动程序,那么它应该返回 "null"。这会很常见,因为在要求 JDBC 驱动程序管理器连接到给定 URL 时,它会将该 URL 依次传递给每个已加载的驱动程序。

如果要连接到给定 URL 的驱动程序是正确的驱动程序,但却无法连接到数据库,则该驱动程序应该抛出 SQLException

可以使用 java.util.Properties 参数将任意字符串标记/值对作为连接参数传递。通常 Properties 对象中至少应该包括 "user" 和 "password" 属性。

参数:
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 CompliantTM 驱动程序。如果通过 JDBC 兼容测试,驱动程序在这里可以只报告 true;否则它需要返回 false

JDBC 兼容要求完全支持 JDBC API 和完全支持 SQL 92 Entry Level。期望 JDBC 兼容驱动程序可用于所有主要商业数据库。

此方法不打算鼓励开发非 JDBC 兼容驱动程序,但要认识到这样一个事实:一些供应商对将 JDBC API 和框架用于不支持完整的数据库功能的轻量级数据库感兴趣,或者对将 JDBC API 和框架用于一些特殊数据库感兴趣,比如文档信息检索,在这些数据库中 SQL 实现是不可行。

返回:
如果此驱动程序是 JDBC 兼容的,则返回 true;否则,返回 false

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策