概述 Java 数据库连接 3.0 规范的新功能和改进之处
Josh Heidebrecht（jheidebr@ca.ibm.com）
软件工程师，IBM
2001 年 7 月
Java 数据库连接（Java Database Connectivity，JDBC）API 是作为 Java 2 标准版（Java 2 Standard Edition，J2SE）和 Java 2 企业版（Java 2 Enterprise Edition，J2EE）平台的一个关键部分出现的。它是一种主要的基于标准的机制，能让 Java 语言通过编程来访问关系数据库，所以当 Java Community Process 发布一份新版本的规范时，开发人员一定会感兴趣。在此，我们就 Sun Microsystems 最近发布的 JDBC 规范的提议最终草案（Proposed Final Draft）3.0 版本来总结一下它的一些新的主要功能。加入讨论论坛，与作者和其他读者分享您对本文的看法。
介绍
Java 数据库连接（JDBC）3.0 规范建立在其原本稳固的基础上，增加了几个新功能以弥补原来功能不足的地方。无论是 java.sql 还是第一次出现的 javax.sql 软件包，都会包含在还处于测试阶段的 Java 1.4 版平台中。在今年晚些时候它就会被正式发布，到时 Java 开发人员就能够利用这些改进了，所以现在正是开始了解这些改变的好时候。
我们会简单地讨论一下 JDBC 的设计师们为这个版本所考虑到的几个设计目标。理解了设计师们的设计基本原理，我们就可以更好地去理解那些改变。我们会总结一下规范中的几个新功能以便了解整个 API 是怎样被改变的。另外，我们还会深入研究几个最适用于应用程序开发人员的关键功能，以成功地协助您利用其新性能。
设计目标
设计 JDBC 3.0 规范的初衷主要是让原先的 JDBC 规范下的功能更加完美。因此，这个新规范的设计指导原则之一就是要与现存的应用程序和驱动程序保持兼容性。所以，JDBC 2 的用户可以放心，他们的应用程序能在 JDBC 3.0 下正确运行。另外，使用以前那些遭反对的方法写进 JDBC 1 API 的代码也可以继续运行。
随着 J2EE 平台迅速的日益流行，设计师们也想增强 JDBC 的可伸缩性。新增的语句池和增强的连接池支持离实现这个目标还很远。此外，设计师们还仔细地考虑 JDBC 与新的连接器体系结构之间的关系，来继续提高服务器上的 Java 技术。
在 JDBC 2 开发的过程中，SQL99 还处在一种变化不定的情况下。现在规范已经完成了，而且数据库厂商已经采用了部分标准。所以自然地，JDBC 规范就跟着将自己与 SQL99 功能的一部分相统一。最新的 JDBC 规范已经采用了 SQL99 标准中那些已经被广泛支持的功能，还有那些在五年内可能会获得支持的功能。
如果一个数据库还不支持 JDBC 3.0 所支持的部分 SQL99 功能，驱动程序可以使用元数据 API 向应用程序开发人员表明：其底层数据库不支持一部分 JDBC 功能。这一点允许数据库厂商生产出相应的 JDBC 驱动程序，尽管他们可能不支持所有的功能。增加的两种新的数据类型以及对事务的 Savepoint 的支持说明了两个和 SQL99 有关的改变。
新功能摘要
元数据 API
元数据 API 已经得到更新，DatabaseMetaData 接口现在可以检索 SQL 类型的层次结构，一种新的 ParameterMetaData 接口可以描述 PreparedStatement 对象中参数的类型和属性。
CallableStatements 中已命名的参数
在 JDBC 3.0 之前，设置一个存储过程中的一个参数要指定它的索引值，而不是它的名称。 CallableStatement 接口已经被更新了，现在您可以用名称来指定参数。
数据类型的改变
JDBC 所支持的数据类型作了几个改变，其中之一是增加了两种新的数据类型。
为了便于修改 CLOB（Character Large Object，字符型巨对象）、BLOB（Binary Large Object，二进制巨对象）和 REF（SQL 结构）类型的值，同名的数据类型接口都被更新了。接下来的是，因为我们现在能够更新这些数据类型的值，所以 ResultSet 接口也被修改了，以支持对这些数据类型的列的更新，也包括对 ARRAY 类型的更新。
增加的两种新的数据类型是 java.sql.Types.DATALINK 和 java.sql.Types.BOOLEAN。新增的数据类型指的是同名的 SQL 类型。DATALINK 提供对外部资源的访问或 URL，而 BOOLEAN 类型在逻辑上和 BIT 类型是等同的，只是增加了在语义上的含义。DATALINK 列值是通过使用新的 getURL() 方法从 ResultSet 的一个实例中检索到的，而 BOOLEAN 类型是通过使用 getBoolean() 来检索的。
检索自动产生的关键字
为了解决对获取自动产生的或自动增加的关键字的值的需求，JDBC 3.0 API 现在将获取这种值变得很轻松。要确定任何所产生的关键字的值，只要简单地在语句的 execute() 方法中指定一个可选的标记，表示您有兴趣获取产生的值。您感兴趣的程度可以是 Statement.RETURN_GENERATED_KEYS，也可以是 Statement.NO_GENERATED_KEYS。在执行这条语句后，所产生的关键字的值就会通过从 Statement 的实例方法 getGeneratedKeys() 来检索 ResultSet 而获得。ResultSet 包含了每个所产生的关键字的列。清单 1 中的示例创建一个新的作者并返回对应的自动产生的关键字。
清单 1. 检索自动产生的关键字
Statement stmt = conn.createStatement();
// Obtain the generated key that results from the query.
stmt.executeUpdate("INSERT INTO authors " +
′(first_name, last_name) " +
"valueS (′George′, ′Orwell′)",
Statement.RETURN_GENERATED_KEYS);
ResultSet rs = stmt.getGeneratedKeys();
if ( rs.next() ) {
// Retrieve the auto generated key(s).
int key = rs.getInt();
}
连接器关系
大多数应用程序开发人员不需要知道 JDBC 和 J2EE 连结器体系结构之间的关系，就可以很好地使用 JDBC API。但是，由于 JDBC 3.0 规范已经考虑到这项新的体系结构，这使得开发人员能更好地理解 JDBC 在哪里适合 J2EE 标准，以及这个规范的发展方向是什么。
J2EE 连结器体系结构指定了一组协议，允许企业的信息系统以一种可插入的方式连接到应用服务器上。这种体系结构定义了负责与外部系统连接的资源适配器。连接器服务提供者接口（The Connectors Service Provider Interface，SPI）恰好和 JDBC 接口提供的服务紧密配合。
JDBC API 实现了连结器体系结构定义的三个协议中的两个。第一个是将应用程序组件与后端系统相连接的连接管理，它是由 DataSource 和 ConnectionPoolDataSource 接口来实现的。第二个是支持对资源的事务性访问的事务管理，它是由 XADataSource 来处理的。第三个是支持后端系统的安全访问的安全性管理，在这点上，JDBC 规范并没有任何对应点。尽管有最后那个不足，JDBC 接口仍能映射到连接器 SPI 上。如果一个驱动程序厂商将其 JDBC 驱动程序映射到连接器系统协议上，它就可以将其驱动程序部署为资源适配器，并立刻享受可插性、封装和在应用服务器中部署的好处。这样，一个标准的 API 就可以在不同种类的的企业信息系统中，供企业开发人员使用。
ResultSet 可保持性
一个可保持的游标（或结果），就是说该游标在包含它的事务被提交后，也不会自动地关闭。JDBC 3.0 增加了对指定游标可保持性的支持。要制定您 ResultSet 的可保持性，您必须在使用 createStatement()、prepareStatement() 或 prepareCall() 方法准备编写一条语句时就这么做。可保持性可以是下面常量中的一个。
HOLD_CURSORS_OVER_COMMIT ResultSet 对象（游标）没有被关闭；它们在提交操作得到显式的或隐式的执行以后仍保持打开的状态。
CLOSE_CURSORS_AT_COMMIT ResultSet 对象（游标）在提交操作得到显式的或隐式的执行后被关闭。
总的来说，在事务提交之后关闭游标操作会带来更好的性能。除非您在事务结束后还需要该游标，否则您最好在执行提交操作后将其关闭。因为规范没有规定 ResultSet 的缺省的可保持性，所以具体行为还将取决于执行情况。然而，我希望在可以使用 JDBC 3.0 驱动程序时，大多数执行在事务结束后仍旧会关闭游标。
返回多重结果
JDBC 2 规范的一个局限是，在任意时刻，返回多重结果的语句只能打开一个 ResultSet。作为 JDBC 3.0 规范中改变的一个部分，规范将允许 Statement 接口支持多重打开的 ResultSets。然而，重要的是 execute() 方法仍然会关闭任何以前 execute() 调用中打开的 ResultSet。所以，要支持多重打开的结果，Statement 接口就要加上一个重载的 getMoreResults() 方法。新式的方法会做一个整数标记，在 getResultSet() 方法被调用时指定前一次打开的 ResultSet 的行为。接口将按如下所示定义标记：
CLOSE_ALL_RESULTS 当调用 getMoreResults() 时，所有以前打开的 ResultSet 对象都将被关闭。
CLOSE_CURRENT_RESULT 当调用 getMoreResults() 时，当前的 ResultSet 对象将被关闭。
KEEP_CURRENT_RESULT 当调用 getMoreResults() 时，当前的 ResultSet 对象将不会被关闭。
清单 2 展示的是一个处理多重打开结果的示例。
清单 2. 如何处理多重打开结果
String procCall;
// Set the value of procCall to call a stored procedure.
// …
CallableStatement cstmt = connection.prepareCall(procCall);
int retval = cstmt.execute();
