3.1 变更概述

JDBC 4.2 API 在以下领域引入了新内容和变更:

新增功能

REF CURSOR 支持

多个数据库支持 REF CURSOR 数据类型,用于从存储过程返回结果集。JDBC 4.2 增加了对 REF CURSOR 数据类型的支持。

大更新计数支持

此前,JDBC 方法通常使用 int 返回更新计数。随着数据规模增长,int 在某些场景下已无法表示实际的更新行数,因此 JDBC 4.2 增加了对大更新计数的支持。

java.sql.DriverAction 接口

驱动程序可以实现该接口,以便在被 DriverManager 注销时收到通知。

java.sql.SQLType 接口

该接口用于创建表示通用 SQL 类型(即 JDBC 类型)或供应商特定数据类型的对象。

java.sql.JDBCType 枚举

JDBCType 枚举用于标识通用 SQL 类型,可用于替代 Types.java 中定义的常量。

新增类型映射

表 B-4 新增映射(从 Java 对象到 JDBC 类型的映射)

  • 添加了 java.time.LocalDate 到 JDBC DATE 的映射支持
  • 添加了 java.time.LocalTime 到 JDBC TIME 的映射支持
  • 添加了 java.time.LocalDateTime 到 JDBC TIMESTAMP 的映射支持
  • 添加了 java.time.OffsetTime 到 JDBC TIME_WITH_TIMEZONE 的映射支持
  • 添加了 java.time.OffsetDateTime 到 JDBC TIMESTAMP_WITH_TIMEZONE 的映射支持

表 B-5 新增映射(setObject 和 setNull 在 Java 对象类型和目标 JDBC 类型之间的转换)

  • 允许 java.time.LocalDate 转换为 CHAR、VARCHAR、LONGVARCHAR 和 DATE
  • 允许 java.time.LocalTime 转换为 CHAR、VARCHAR、LONGVARCHAR 和 TIME
  • 允许 java.time.LocalDateTime 转换为 CHAR、VARCHAR、LONGVARCHAR 和 TIMESTAMP
  • 允许 java.time.OffsetTime 转换为 CHAR、VARCHAR、LONGVARCHAR 和 TIME_WITH_TIMEZONE
  • 允许 java.time.OffsetDateTime 转换为 CHAR、VARCHAR、LONGVARCHAR、TIME_WITH_TIMEZONE 和 TIMESTAMP_WITH_TIMEZONE

表 B-6 新增映射(通过 ResultSet 的 getter 方法读取 JDBC 类型)

  • 允许 getObject 返回 TIME_WITH_TIMEZONE、TIMESTAMP_WITH_TIMEZONE
赞助商

JDBC API 变更

下面列出已有 JDBC 类和接口的变更:

BatchUpdateException

  • 添加了新的构造函数以支持大更新计数
  • 添加了 getLargeUpdateCounts 方法

Connection

  • 添加了 abort、getNetworkTimeout、getSchema、setNetworkTimeout、setSchema 方法
  • 明确了 getTypeMap、setSchema、setTypeMap 方法的定义

CallableStatement

  • 重载了 registerOutParameter 和 setObject 方法
  • 明确了 getObject 方法的定义

Date

  • 添加了 toInstant、toLocalDate 方法
  • 重载了 valueOf 方法

DatabaseMetaData

  • 添加了 supportsRefCursors、getMaxLogicalLobSize 方法
  • 明确了 getIndexInfo 方法的定义

Driver

  • 明确了 acceptsURL 和 connect 方法的定义

DriverManager

  • 重载了 registerDriver 方法
  • 明确了 getConnection、deregisterDriver 和 registerDriver 方法的定义

PreparedStatement

  • 添加了 executeLargeUpdate 方法
  • 重载了 setObject 方法

ResultSet

  • 重载了 updateObject 方法
  • 明确了 getObject 方法的定义

Statement

  • 添加了 executeLargeBatch、executeLargeUpdate、getLargeUpdateCount、getLargeMaxRows 和 setLargeMaxRows 方法
  • 明确了 setEscapeProcessing 方法的定义

SQLInput

  • 添加了 readObject 方法

SQLOutput

  • 添加了 writeObject 方法

Time

  • 添加了 toInstant、toLocalTime 方法
  • 重载了 valueOf 方法

Timestamp

  • 添加了 from、toInstant、toLocalDateTime 方法
  • 重载了 valueOf 方法

Types

  • 添加了 REF_CURSOR、TIME_WITH_TIMEZONE 和 TIMESTAMP_WITH_TIMEZONE 类型

SQLXML

  • 明确了 getSource 和 setResult 方法的定义

DataSource 和 XADataSource

  • 明确了必须提供无参构造函数

有关受这些变更影响的类和接口列表,请参见第 5 章“类和接口”。