JavaTM Platform
Standard Ed. 6

软件包 java.sql

提供使用 Java TM 编程语言访问并处理存储在数据源(通常是一个关系数据库)中的数据的 API。

请参见:
          描述

接口摘要
Array SQL 类型 ARRAY 在 Java 编程语言中的映射关系。
Blob SQL BLOB 值在 JavaTM 编程语言中的表示形式(映射关系)。
CallableStatement 用于执行 SQL 存储过程的接口。
Clob SQL 类型 CLOB 在 JavaTM 编程语言中的映射关系。
Connection 与特定数据库的连接(会话)。
DatabaseMetaData 关于数据库的整体综合信息。
Driver 每个驱动程序类必须实现的接口。
NClob SQL NCLOB 类型在 JavaTM 编程语言中的映射。
ParameterMetaData 可用于获取关于 PreparedStatement 对象中每个参数标记的类型和属性信息的对象。
PreparedStatement 表示预编译的 SQL 语句的对象。
Ref Java 编程语言中 SQL REF 值的映射关系,它是到数据库中的 SQL 结构类型值的引用。
ResultSet 表示数据库结果集的数据表,通常通过执行查询数据库的语句生成。
ResultSetMetaData 可用于获取关于 ResultSet 对象中列的类型和属性信息的对象。
RowId SQL ROWID 值在 Java 编程语言中的表示形式(映射)。
Savepoint 保存点的表示形式,保存点是可以从 Connection.rollback 方法引用的当前事务中的点。
SQLData 该接口用于 SQL 用户定义类型 (UDT) 到 Java 编程语言中类的自定义映射关系。
SQLInput 一个输入流,它包含表示 SQL 结构化类型或 SQL 不同类型的实例的值组成的流。
SQLOutput 用于将用户定义类型的属性写回数据库的输出流。
SQLXML SQL XML 类型在 JavaTM 编程语言中的映射关系。
Statement 用于执行静态 SQL 语句并返回它所生成结果的对象。
Struct 用于 SQL 结构化类型的 Java 编程语言中的标准映射关系。
Wrapper 在相关实例实际上是代理类时提供获取委托实例能力的 JDBC 类的接口。
 

类摘要
Date 一个包装了毫秒值的瘦包装器 (thin wrapper),它允许 JDBC 将毫秒值标识为 SQL DATE 值。
DriverManager 管理一组 JDBC 驱动程序的基本服务。
DriverPropertyInfo 用于建立连接的驱动程序属性。
SQLPermission SecurityManager 将用来检查在 applet 中运行的代码何时调用 DriverManager.setLogWriter 方法或 DriverManager.setLogStream(不建议使用)方法的权限。
Time 一个与 java.util.Date 类有关的瘦包装器 (thin wrapper),它允许 JDBC 将该类标识为 SQL TIME 值。
Timestamp 一个与 java.util.Date 类有关的瘦包装器 (thin wrapper),它允许 JDBC API 将该类标识为 SQL TIMESTAMP 值。
Types 定义用于标识一般 SQL 类型(称为 JDBC 类型)的常量的类。
 

枚举摘要
ClientInfoStatus 无法通过调用 Connection.setClientInfo 设置属性的原因状态的枚举。
RowIdLifetime RowId 生存期值的枚举。
 

异常摘要
BatchUpdateException 进行批量更新操作期间发生错误时抛出的 SQLException 子类。
DataTruncation DataTruncation 异常形式抛出的异常(写入时),或者由于除数据值超出 MaxFieldSize 之外的某种原因意外地截断该数据值时以 DataTruncation 警告形式报告的异常(读取时)。
SQLClientInfoException 当无法在 Connection 上设置一个或多个客户端信息属性时,抛出此 SQLException 的子类。
SQLDataException 当 SQLState 类值为“22”时抛出的 SQLException 子类。
SQLException 提供关于数据库访问错误或其他错误信息的异常。
SQLFeatureNotSupportedException 当 SQLState 类值为“0A”(值为“零”A)时抛出的 SQLException 子类。
SQLIntegrityConstraintViolationException 当 SQLState 类值为“23”时抛出的 SQLException 子类。
SQLInvalidAuthorizationSpecException 当 SQLState 类值为“28”时抛出的 SQLException 子类。
SQLNonTransientConnectionException SQLState 类值为“08”时抛出的 SQLException 子类,表示在失败原因没有纠正的情况下重试操作时,失败的连接操作不会成功。
SQLNonTransientException 重试相同操作将失败(除非纠正了 SQLException 的 cause)的情况下抛出的 SQLException 子类。
SQLRecoverableException 应用程序执行某些恢复步骤并重试整个事务或事务分支(在分布式事务中)后,可以成功执行先前失败操作的情况下抛出的 SQLException 子类。
SQLSyntaxErrorException 当 SQLState 类值为“42”时抛出的 SQLException 子类。
SQLTimeoutException Statement 指定的超时已到期时抛出的 SQLException 子类。
SQLTransactionRollbackException 当 SQLState 类值为“40”时,抛出此 SQLException 的子类。
SQLTransientConnectionException SQLState 类值为“08”时抛出的 SQLException 子类,表示在没有进行任何应用程序级更改的情况下重试操作时,失败的连接操作可以成功。
SQLTransientException 没有任何应用程序级功能干预时,重试先前失败操作可以成功的情况下抛出的 SQLException 子类。
SQLWarning 提供关于数据库访问警告信息的异常。
 

软件包 java.sql 的描述

提供使用 JavaTM 编程语言访问并处理存储在数据源(通常是一个关系数据库)中的数据的 API。此 API 包括一个框架,凭借此框架可以动态地安装不同驱动程序来访问不同数据源。尽管 JDBCTM API 主要用于将 SQL 语句传递给数据库,但它还可以用于以表格方式从任何数据源中读写数据。通过接口的 javax.sql.RowSet 组可以使用的 reader/writer 实用程序,可以被定制以使用和更新来自电子表格、纯文本文件或其他任何表格式数据源的数据。

JDBCTM 4.0 API 中包括的内容

JDBC TM 4.0 API 中包括 java.sql 包,被称为 JDBC 核心 API,和 javax.sql 包,被称为 JDBC Optional Package API。完整的 JDBC API 包含在 Java TM 标准版 (Java SE TM) 6 版中。 javax.sql 包扩展了 JDBC API 的功能,将它从客户端 API 扩展到服务器端 API,该包是 Java TM、企业版 (Java TM) 技术的重要部分。

版本

JDBC 4.0 API 综合了以前所有 JDBC API 版本:

类、接口、方法、字段、构造方法和异常都有以下 "since" 标记,以指示它们何时被引入 Java 平台。当将这些 "since" 标记用于 JDBC API 的 JavadocTM 注释时,它们指示以下内容:

注:许多新特性都是可选的,因此,在这些版本支持的驱动程序和特性中有一些变体。在尝试使用它之前,总是检查驱动程序的文档,以查看它是否支持某一特性。

注:SQLPermission 类被添加到 JavaTM 2 SDK 标准版 1.3 版中。此类用于防止对与 DriverManager 相关联的记录流进行无授权访问,该流可以包含诸如表名称、列数据等信息。

java.sql Package 包含的内容

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

JDBC 4.0 API 中引入的 java.sqljavax.sql 特性

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

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

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

UDT 的自定义映射关系

可以将 SQL 中定义的用户定义类型 (UDT) 映射到 Java 编程语言中的类。SQL 结构化类型或 SQL DISTINCT 类型是可以自定义映射的 UDT。以下三个步骤设置了一个自定义映射关系:
  1. 在 SQL 中定义 SQL 结构化类型或 DISTINCT 类型
  2. 定义 Java 编程语言中的类,SQL UDT 将映射到该类。此类必须实现 SQLData 接口。
  3. Connection 对象的类型映射表中创建一个项,该项包含两项内容:

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

包规范

相关文档

从以下版本开始:
1.1

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策