|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
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
所有类
|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |