java.sql Package 包含的内容

java.sql 包中包含用于以下方面的 API：

• 通过 DriverManager 实用程序建立与数据库的连接
  • DriverManager 类：建立与驱动程序的连接
  • SQLPermission 类：当代码在 Security Manager（比如 applet）中运行时提供权限，试图通过 DriverManager 设置一个记录流
  • Driver 接口：提供用来注册和连接基于 JDBC 技术（“JDBC 驱动程序”）的驱动程序的 API，通常仅由 DriverManager 类使用
  • DriverPropertyInfo 类：提供 JDBC 驱动程序的属性，不是供一般用户使用的
• 向数据库发送 SQL 语句
  • Statement：用于发送基本 SQL 语句
  • PreparedStatement：用于发送准备好的语句或基本 SQL 语句（派生自 Statement）
  • CallableStatement：用于调用数据库存储过程（派生自 PreparedStatement）
  • Connection 接口：提供创建语句以及管理连接及其属性的方法
  • Savepoint：在事务中提供保存点
• 检索和更新查询的结果
  • ResultSet 接口
• SQL 类型到 Java 编程语言中的类和接口的标准映射关系
  • Array 接口：SQL ARRAY 的映射关系
  • Blob 接口：SQL BLOB 的映射关系
  • Clob 接口：SQL CLOB 的映射关系
  • Date 类：SQL DATE 的映射关系
  • Ref 接口：SQL REF 的映射关系
  • Struct 接口：SQL STRUCT 的映射关系
  • Time 类：SQL TIME 的映射关系
  • Timestamp 类：SQL TIMESTAMP 的映射关系
  • Types 类：提供用于 SQL 类型的常量
• 自定义映射 SQL 用户定义类型 (UDT) 到 Java 编程语言中的类
  • SQLData 接口：指定 UDT 到此类的一个实例的映射关系
  • SQLInput 接口：提供用来从流中读取 UDT 属性的方法
  • SQLOutput 接口：提供用来将 UDT 属性写回流中的方法
• 元数据
  • DatabaseMetaData 接口：提供有关数据库的信息
  • ResultSetMetaData 接口：提供有关 ResultSet 对象的列的信息
  • ParameterMetaData 接口：提供有关 PreparedStatement 命令的参数的信息
• 异常
  • SQLException：由大多数方法在访问数据出问题时抛出，以及因为其他原因由其他一些方法抛出
  • SQLWarning：为了指示一个警告而抛出
  • DataTruncation：为了指示数据可能已经被截断而抛出
  • BatchUpdateException：为了指示并不是批量更新中的所有命令都成功执行而抛出

 

JDBC 3.0 API 中引入的 java.sql 和 javax.sql 特性

• 入池语句 (pooled statement)：重新使用与某个已入池的连接 (pooled connection) 相关的语句
• 保存点：允许将事务回滚到某一指定保存点
• 为 ConnectionPoolDataSource 定义的属性：指定将连接入池的方法
• PreparedStatement 对象的参数的元数据
• 从自动生成的列中检索值的能力
• 使从 CallableStatement 对象中返回的多个 ResultSet 对象同时打开的能力
• 通过名称和索引标识 CallableStatement 对象的参数的能力
• ResultSet 可保存性：指定是否应该让游标在某一事务结束时保持打开或关闭状态的能力
• 检索和更新 Ref 对象引用的 SQL 结构化类型实例的能力
• 通过编程方式更新 BLOB、CLOB、ARRAY 和 REF 值的能力。
• java.sql.Types.DATALINK 数据类型的添加：允许 JDBC 驱动程序访问数据源以外的地方存储的对象
• 用于检索 SQL 类型分层结构的元数据的添加

 

JDBC 2.1 Core API 中引入的 java.sql 特性

• 可滚动的结果集：使用 ResultSet 接口中的新方法，这些方法允许将光标移动到某一特定行，或者移动到其当前位置的某一相对位置
• 批量更新
• 编程式更新：使用 ResultSet updater 方法
• 新数据类型：映射 SQL3 数据类型的接口
• 用户定义类型 (UDT) 的自定义映射关系
• 其他特性，包括性能提示、字符流的使用、java.math.BigDecimal 值的完全精度、其他安全性，以及对日期、时间和时间戳值中的时区的支持。

 

JDBC 2.0 Package API 中引入的 javax.sql 特性

• DataSource 接口被认为是建立连接的一种方式。Java Naming 和 Directory Interface^TM (JNDI) 用于向命名服务注册一个 DataSource 对象和检索该对象。
• 入池连接：允许使用和重新使用连接
• 分布式事务：允许事务跨越不同的 DBMS 服务器
• RowSet 技术：提供一个处理和传递数据的便捷方法

 

 

UDT 的自定义映射关系

可以将 SQL 中定义的用户定义类型 (UDT) 映射到 Java 编程语言中的类。SQL 结构化类型或 SQL DISTINCT 类型是可以自定义映射的 UDT。以下三个步骤设置了一个自定义映射关系：

1. 在 SQL 中定义 SQL 结构化类型或 DISTINCT 类型
2. 定义 Java 编程语言中的类，SQL UDT 将映射到该类。此类必须实现 SQLData 接口。
3. 在 Connection 对象的类型映射表中创建一个项，该项包含两项内容：
   • UDT 的完全限定 SQL 名称
   • 实现 SQLData 接口的类的 Class 对象

为 UDT 准备好这些之后，在该 UDT 上调用 ResultSet.getObject 或 CallableStatement.getObject 方法将自动检索该 UDT 的自定义映射关系。此外，PreparedStatement.setObject 方法会自动将该对象映射回其 SQL 类型，以便将它存储在数据源中。