compact2, compact3

java.sql

Interface Driver

public interface Driver

每个驱动程序类必须实现的接口。

java SQL架构允许多个数据库驱动程序。

每个驱动程序都应该提供一个实现了驱动程序接口的类。

这也将尝试加载许多司机可以找到然后对于任何给定的连接请求，它将要求依次驱动程序尝试连接到目标URL。

强烈建议每个驱动类应该是小的和独立的，使驱动程序类可以加载和查询，而不会带来大量的支持代码。

当一个驱动程序类的加载，它应该创建一个自己的示例，DriverManager登记。这意味着一个用户可以通过调用来加载和注册一个驱动程序：

Class.forName("foo.bah.Driver")

JDBC驱动程序可能要创建一个DriverAction实现接收通知的时候DriverManager.deregisterDriver(java.sql.Driver)被称为。

另请参见：

DriverManager， Connection， DriverAction

方法摘要

Modifier and Type	Method and Description
boolean	acceptsURL(String url) 检索驱动程序是否认为它可以打开给定的网址的连接。
Connection	connect(String url, Properties info) 试图使一个数据库连接到给定的网址。
int	getMajorVersion() 检索驱动程序的主要版本号。
int	getMinorVersion() 获取驱动程序的次要版本号。
Logger	getParentLogger() 返回所有的司机使用的记录仪父记录器。
DriverPropertyInfo[]	getPropertyInfo(String url, Properties info) 获取此驱动程序的可能属性的信息。
boolean	jdbcCompliant() 报告是否这个驱动程序是一个真正的JDBC兼容的™司机。

方法详细信息

connect

Connection connect(String url,
                   Properties info)
            throws SQLException

试图使一个数据库连接到给定的网址。驱动程序应该返回“空”，如果它意识到它是错误的类型的驱动程序连接到给定的网址。这是常见的，如JDBC驱动程序经理被要求连接到一个给定的URL的URL传递到每个加载的驱动程序将。

司机应该要连接到给定的URL，但连接数据库的问题正确的司机抛出一个SQLException。

的Properties参数可以用来传递任意字符串标签/值对作为连接参数。通常至少“用户”和“密码”属性应该被包含在Properties对象。

注：如果属性指定的url部分也在Properties对象指定，它是实现定义为价值优先。为了获得最大的可移植性，应用程序只需要指定一次属性。

参数

url -数据库的连接URL

info -列表的任意字符串标签/值对作为连接参数。通常至少有一个“用户”和“密码”属性应包括。

结果

一个 Connection对象代表的URL连接

异常

SQLException -如果一个数据库访问错误或URL是 null

acceptsURL

boolean acceptsURL(String url)
            throws SQLException

检索驱动程序是否认为它可以打开给定的网址的连接。通常司机如果他们了解 false指定URL，如果他们不回来 true子协议。

参数

url -数据库的URL

结果

true如果司机了解给定的URL； false否则

异常

SQLException -如果一个数据库访问错误或URL是 null

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兼容的™司机。一个司机只报告 true这里如果通过JDBC兼容的测试；否则需要返回 false。

JDBC兼容的要求全面支持JDBC API和SQL 92入门级的支持。可以预期的是，JDBC兼容的驱动程序可用于所有主要的商业数据库。

这种方法的目的不是鼓励非JDBC驱动程序的开发，但承认这样一个事实，一些厂商在使用JDBC API和框架的轻量级数据库，不支持完整的数据库功能感兴趣，或特殊的数据库如文献信息检索在一个SQL语句的执行是不可行的。

结果

如果这个司机是 true JDBC兼容； false否则

getParentLogger

Logger getParentLogger()
                throws SQLFeatureNotSupportedException

返回所有的司机使用的记录仪父记录器。这应该是记录的远根记录器，仍然是所有该驱动程序所用的伐木工的祖先。配置此记录器将影响所有的驱动程序所生成的日志信息。在最坏的情况下，这可能是根记录器。

结果

这个司机母记录器

异常

SQLFeatureNotSupportedException如果司机不使用 java.util.logging。

从以下版本开始：

一点七