10 其它新功能

本章描述了 JDBC 2.0 API 中的其它变化。

10.1 java.sql.ResultSet 的变化

ResultSet.getBigDecimal() 方法的新增版本可以返回全精度数值。

10.2 java.sql.ResultSetMetaData 的变化

ResultSetMetaData.getColumnType() 方法现在可以返回新的 SQL 类型代码： STRUCT、DISTINCT、BLOB 等。它通常返回 STRUCT 和 DISTINCT 类型代码来代表结构化数值和 distinct 数值，而不管使用的是缺省还是自定义类型映射方式。

ResultSetMetaData.getColumnTypeName() 方法应该为新 SQL 类型的以下值。

我们新增了 ResultSetMetaData.getColumnClassName() 方法，用于返回 Java 类的全限定名（如果调用 ResultSet.getObject() 方法来检索列中的数值，则生成该 Java 类的实例）。详细信息，参见单独的 API 文档。

当类型代码为 STRUCT、DISTINCT 或 JAVA_OBJECT 时，ResultSetMetaData.getColumnTypeName() 方法返回 SQL 类型全限定名。

10.3 DatabaseMetaData 的变化

DatabaseMetaData.getColumns() 方法现在可以返回以下的新 SQL3 类型的 DATA_TYPE 值： BLOB、CLOB 等等。DatabaseMetaData.getColumns() 方法所返回的类型名称与第 10.2 节中所列出的 SQL3 数据类型的类型名称一样。

新增了方法 DatabasemetaData.getConnection()，用于返回生成元数据对象的 Connection 对象。

新增了方法 DatabasemetaData.getUDTs()。详细信息，参见单独的 API 文档。

新增了支持新的 ResultSet 和批处理更新功能的方法： supportsResultSetConcurrency() 、 supportsBatchUpdates() 等。详细信息，参见单独的 API 文档。

10.4 java.sql.DriverManager 的变化

新增了 DriverManager.setLogWriter() 方法，该方法将 java.io.PrintWriter 对象作为输入参数。新增的 DriverManager.getLogWriter() 方法返回 PrintWriter 对象。不鼓励使用 set/getLogStream() 方法。

10.5 日期、时间和时间戳

JDBC API 沿循了 Java 平台的日期和时间表示方法，即以相对于格林尼治标准时间 1970 年 1 月 1 日 00:00:00 的毫秒值来表示日期和时间。因为大多数数据库不支持时区的概念，所以 JDBC 2.0 API 新增了几种方法，允许 JDBC 驱动程序利用 Calendar 获得/设置某一特定时区的 Date、Time 以及 Timestamp 值。例如，

ResultSet rs;
...
Date date1 = rs.getDate(1);

返回 Date 对象，该对象所含的毫秒值表示特定日期（如 1999 年 1 月3 日）及缺省时区中的标准时间 00:00:00。在缺省时区中，Date 的时间部分被设置为零，这是因为 SQL DATE 值没有时间部分。由于没有为 getDate() 显式地提供 Calendar，所以 JDBC 驱动程序在内部利用缺省时区（实际上是缺省 Calendar）来创建正确的毫秒值（假设基本数据库没有存储时区信息）。

下例检索 GMT（格林尼治标准时间）日期值。

ResultSet rs;
...

TimeZone.setDefault(TimeZone.getTimeZone("GMT"));
Calendar cal = Calendar.getInstance();
Date date2 = rs.getDate(1, cal);

上例中，Calendar 将被显式地传给 getDate()，以告知 JDBC 驱动程序如何计算正确的毫秒值。请注意：因为 JDBC 驱动程序在缺省情况下会采用缺省时区，所以只需更改一下缺省时区（不必显式地传递 Calendar）即可获得同样的结果。

请注意：如果假设缺省时区不是 GMT，则以上所创建的两个 Date 对象并不等同，即使它们表示的是“同一”日期。

if (date1.equals(date2))
	// 不可能执行到此

这是因为每种 Java 语言的 Date 对象实际上只是包含了标准化的毫秒时间值，而这些毫秒值在时区之间是不同的。如果应用程序要比较不同时区中的日期，则首先应该将日期转换到 Calendar。

应用程序应该利用 Calendar 来创建 Date 对象。应用程序在使用 Calendar 时，应该负责将所需日期中的时间指定为 00:00:00（因为 JDBC 采用了这种约定）。另外，应用程序在创建 Time 值时，必须将日期 January 1, 1970 指定给为 Time 创建毫秒值的 Calendar，因为这是 JDBC 对时间的约定。

目录 | 上一页 | 下一页

版权所有 © 1996, 1997 Sun Microsystems, Inc. 保留所有权利。