接口 java.sql.Driver
- public interface Driver
Java SQL 框架允许用于多个数据库驱动程序。
每个驱动程序应提供实现驱动程序接口的一个类。
DriverManager 将加载所能查找到的尽可能多的驱动程序,然后对任何给定连接请求,试着将每个驱动程序依次连接到目标 URL 。
建议每个 Driver 类都应该短小并且独立,以便不必引用大量支持代码就能加载和查询 Driver 类。
加载一个 Driver 类时,应创建自身的实例并用 DriverManager 注册。这意味着使用 Class.forName("foo.bah.Driver") 用户就能加载和注册一个驱动程序。
- 参见:
- DriverManager, Connection
方法索引
- acceptsURL(String)
- 若驱动程序能打开与给定 URL 的连接,则返回 true 。
- connect(String, Properties)
- 试图与给定 URL 建立数据库连接。
- getMajorVersion()
- 获取驱动程序的主版本号。
- getMinorVersion()
- 获取驱动程序的次版本号。
- getPropertyInfo(String, Properties)
-
getPropertyInfo 方法能让通用的 GUI
工具知道应该向用户提示什么样的属性而使得用户有足够的信息去连接一个数据库。
- jdbcCompliant()
- 报告驱动程序是否是真正的 JDBC COMPLIANT(tm) 驱动程序。
方法
connect
public abstract Connection connect(String url,
Properties info) throws SQLException
- 试图建立到给定 URL 的数据库连接。若认识到连接给定 URL 的驱动程序是错误的,则该驱动程序应返回“ null ”。通常, 当请求 JDBC 驱动程序管理者连接到某个给定 URL 时,它依次向每个加载的驱动程序传送 URL 。
若连接到给定 URL 的驱动程序是正确的,但连接到数据库有困难,则该驱动程序应引起 SQLException 。
用 java.util.Properties 参数作为连接参数可传送任意字符串标记/值对。通常 Properties 里至少应包括“用户”和“口令”特性。
- 参数:
- url - 待连接的数据库的 URL
- info - 作为连接参数的任意字符串标记/值对的列表;通常至少应包括“用户”和“口令”特性
- 返回值:
- 与 URL 的一个连接
- 抛出:
SQLException
- 若发生了数据库访问错误。
acceptsURL
public abstract boolean acceptsURL(String url) throws SQLException
- 若驱动程序能打开与给定 URL 的连接,则返回 true 。若驱动程序能理解 URL 中所指定的子协议,则驱动程序返回 true ,若不能理解则返回 false 。
- 参数:
- url - 数据库的 URL
- 返回值:
- 若该驱动程序能连接到给定 URL ,则为 true 。
- 抛出:
SQLException
- 若发生了数据库访问错误。
getPropertyInfo
public abstract DriverPropertyInfo[] getPropertyInfo(String url,
Properties info) throws SQLException
-
getPropertyInfo 方法能让通用的 GUI
工具知道应该向用户提示什么样的属性,从而使得用户有足够的信息去连接一个数据库。注意:根据用户目前所提供的数值要求,附加信息也许成为必需的了,因此可能有必要调用几个 getPropertyInfo 来迭代。
- 参数:
- url - 待连接的数据库的 URL
- info - 连接打开时将要发送标记/值对的建议列表。
- 返回值:
- 描述可能特性的 DriverPropertyInfo 对象数组。若无特性请求,则该数组可为空。
- 抛出:
SQLException
- 若发生了数据库访问错误。
getMajorVersion
public abstract int getMajorVersion()
- 获取驱动程序的主版本号。初始应为 1 。
getMinorVersion
public abstract int getMinorVersion()
- 获取驱动程序的次版本号。初始应为 0 。
jdbcCompliant
public abstract boolean jdbcCompliant()
- 报告驱动程序是否是真正的 JDBC COMPLIANT(tm) 的驱动程序。若驱动程序发送 JDBC 适应测试,
则驱动程序可能只报告“ true ”,否则返回 false 。
JDBC 适应性要求全部支持 JDBC API 和 SQL 92 输入项级别。要求适应 JDBC 的驱动程序对所有主要的经济数据库是可用的。该方法不鼓励开发不适应 JDBC 的驱动程序,但承认有些销售商有兴趣用 JDBC API
和框架开发不支持全部数据库功能的低开销数据库或某些特殊数据库,如不能用 SQL 实现的文档信息检索。