compact3

Package java.sql

提供使用Java ^TM编程语言访问和处理存储在数据源（通常是关系数据库）中的数据的API。

See: 描述

接口摘要

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

类摘要

类	描述
Date	大约一毫秒值的薄包装，允许JDBC将其标识为SQL DATE值。
DriverManager	用于管理一组JDBC驱动程序的基本服务。 注意： JDBC 2.0 API中新增的DataSource接口提供了连接数据源的另一种方式。
DriverPropertyInfo	用于进行连接的驱动程序属性。
SQLPermission	SecurityManager将检查运行具有SecurityManager的应用程序的代码的 SecurityManager ，调用 DriverManager.deregisterDriver方法， DriverManager.setLogWriter方法， DriverManager.setLogStream （已弃用）方法， SyncFactory.setJNDIContext方法， SyncFactory.setLogger方法， Connection.setNetworktimeout方法或 Connection.abort方法。
Time	围绕 java.util.Date类的薄包装，允许JDBC API将其标识为SQL TIME值。
Timestamp	一个围绕 java.util.Date的薄包装，允许JDBC API将其标识为SQL TIMESTAMP值。
Types	定义用于标识通用SQL类型的常量的类，称为JDBC类型。

枚举摘要

Enum	描述
ClientInfoStatus	通过调用 Connection.setClientInfo无法设置属性的状态 Connection.setClientInfo
JDBCType	定义用于标识通用SQL类型（称为JDBC类型）的常量。
PseudoColumnUsage	伪/隐藏列使用枚举。
RowIdLifetime	RowId寿命值的枚举。

异常摘要

异常	描述
BatchUpdateException	当批处理更新操作发生错误时抛出SQLException的子类。
DataTruncation	抛出一个异常 DataTruncation异常（写入），或报告为 DataTruncation警告（读取时）数据值意外地截断超过其已超过其他原因 MaxFieldSize 。
SQLClientInfoException	的子类SQLException当一个或多个客户端信息属性不能在设置抛出Connection 。
SQLDataException	SQLState类值为“ 22 ”时，或在供应商指定的条件下抛出的SQLException子类。
SQLException	提供有关数据库访问错误或其他错误的信息的异常。
SQLFeatureNotSupportedException	当SQLState类值为' 0A '（值为'零'A）时，抛出SQLException的子类。
SQLIntegrityConstraintViolationException	当SQLState类值为“ 23 ”时，或在供应商指定的条件下，抛出SQLException的子类。
SQLInvalidAuthorizationSpecException	当SQLState类值为“ 28 ”时，或在供应商指定的条件下，抛出SQLException的子类。
SQLNonTransientConnectionException	SQLException的子类抛出SQLState类值“ 08 ”，或者在供应商指定的条件下。
SQLNonTransientException	的子类SQLException当这样的情况：除非事业一样重试操作将失败，抛出SQLException修正。
SQLRecoverableException	的子类SQLException在以前失败的操作也许能够在应用程序执行某些恢复步骤并重试整个事务或分布式事务，事务分支的情况下取得成功的情况下抛出。
SQLSyntaxErrorException	当SQLState类值为' 42 '时，或在供应商指定的条件下，抛出SQLException的子类。
SQLTimeoutException	的子类SQLException时指定的超时抛出Statement.setQueryTimeout ， DriverManager.setLoginTimeout ， DataSource.setLoginTimeout ， XADataSource.setLoginTimeout已过期。
SQLTransactionRollbackException	当SQLState类值为“ 40 ”时，或在供应商指定的条件下，抛出SQLException的子类。
SQLTransientConnectionException	SQLException的子类为SQLState类值“ 08 ”，或在供应商指定的条件下。
SQLTransientException	SQLException的子类在以前失败的操作可能能够在没有应用程序级别功能的任何干预的情况下重试操作时能够成功的情况下抛出。
SQLWarning	提供有关数据库访问警告的信息的异常。

Package java.sql Description

提供使用Java ^TM编程语言访问和处理存储在数据源（通常是关系数据库）中的数据的API。 该API包括一个框架，可以动态地安装不同的驱动程序来访问不同的数据源。 尽管JDBC ^TM API主要面向将SQL语句传递到数据库，但它提供了以表格格式从任何数据源读取和写入数据。 可以通过javax.sql.RowSet组接口来提供读写器设备，以便使用和更新数据表，平面文件或任何其他表格数据源中的数据。

什么是JDBC ^TM 4.2 API

该JDBC ^TM 4.2 API既包括java.sql包中，被称为JDBC核心API和javax.sql包，被称为JDBC可选包API。 这个完整的JDBC API包含在Java ^TM标准版（Java SE ^TM ）版本7中javax.sql包将JDBC API的功能从客户端API扩展到服务器端API，它是必不可少的部分的Java ^TM企业版（Java EE ^TM ）技术。

版本

JDBC 4.2 API包含以前的所有JDBC API版本：

• JDBC 4.1 API
• JDBC 4.0 API
• JDBC 3.0 API
• JDBC 2.1核心API
• JDBC 2.0可选软件包API
  （请注意，JDBC 2.1核心API和JDBC 2.0可选软件包API一起被称为JDBC 2.0 API。）
• JDBC 1.2 API
• JDBC 1.0 API

类，接口，方法，字段，构造函数和异常具有以下“since”标记，用于指示何时被引入Java平台。 当这些“since”标记用于JDBC API的Javadoc ^TM注释时，它们表示如下：

• 自从1.8 - 新的JDBC 4.2 API和Java SE平台的一部分，版本8
• 自从1.7 - 新的JDBC 4.1 API和Java SE平台的一部分，版本7
• 由于1.6 - 新增的JDBC 4.0 API和部分Java SE平台版本6
• 自1.4版本以来，JDBC 3.0 API和J2SE平台的一部分版本为1.4版本
• 自从1.2 - 新的JDBC 2.0 API和J2SE平台的1.2版本
• 由于1.1或没有“自”标签 - 在原始的JDBC 1.0 API和JDK ^TM 1.1版的一部分

注意：许多新功能是可选的; 因此，司机和他们支持的功能有一些变化。 在尝试使用驱动程序的文档之前，请务必查看驱动程序的文档是否支持该功能。

注： SQLPermission类已添加到Java ^TM 2 SDK，Standard Edition，1.3版本中。 此类用于防止对与相关联的记录流的未授权访问DriverManager ，其可以包含信息如表名，列的数据，等等。

什么java.sql包含

java.sql软件包包含以下API：

• 通过DriverManager工具与数据库建立连接
  • DriverManager类 - 与驱动程序建立连接
  • SQLPermission类 - 在安全管理器（如小程序）中运行的代码尝试通过DriverManager设置日志记录流时提供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
  • NClob接口 - SQL NCLOB映射
  • Ref接口 - SQL REF映射
  • RowId接口 - SQL ROWID映射
  • Struct接口 - SQL STRUCT映射
  • SQLXML接口 - SQL XML映射
  • Time类 - 映射为SQL TIME
  • Timestamp类 - 映射为SQL TIMESTAMP
  • Types类 - 为SQL类型提供常量
• 自定义将SQL用户定义类型（UDT）映射到Java编程语言中的类
  • SQLData interface - 指定UDT与该类实例的映射
  • SQLInput interface - 提供从流中读取UDT属性的方法
  • SQLOutput接口 - 提供将UDT属性写回流的方法
• 元数据
  • DatabaseMetaData接口 - 提供有关数据库的信息
  • ResultSetMetaData接口 - 提供有关ResultSet对象的列的信息
  • ParameterMetaData接口 - 提供有关参数的信息到PreparedStatement命令
• 例外
  • SQLException - 由于其他原因存在访问数据时遇到问题和某些方法，大多数方法抛出
  • SQLWarning - 抛出以指示警告
  • DataTruncation - 抛出以指示数据可能已被截断
  • BatchUpdateException - 抛出以指示批处理更新中的所有命令都不会成功执行

java.sql和javax.sql在JDBC 4.2 API中javax.sql功能

• 增加了JDBCType枚举和SQLType接口
• 支持REF CURSORS在CallableStatement
• DatabaseMetaData返回最大逻辑LOB大小的方法，如果支持参考光标
• 增加了对大型更新计数的支持

java.sql和javax.sql在JDBC 4.1 API中javax.sql功能

• 允许Connection ， ResultSet和Statement与尝试，与资源语句中使用对象
• 支持添加到CallableStatement和ResultSet以指定通过getObject方法转换为Java类型
• DatabaseMetaData返回DatabaseMetaData方法，以及是否始终返回生成的密钥
• 增加了对Connection支持，以指定数据库模式，中止并超时一个物理连接。
• 增加了关闭一个Statement对象的支持，当对象被关闭时
• 获得父记录器的支持Driver ， DataSource ， ConnectionPoolDataSource和XADataSource

java.sql和javax.sql在JDBC 4.0 API中javax.sql功能

• auto java.sql.Driver discovery - 不再需要加载java.sql.Driver类，通过Class.forName
• 添加了国家字符集支持
• 为SQL：2003 XML数据类型添加了支持
• SQLException增强功能 - 增加了原因链接的支持; 为常见的SQLState类值代码添加了新的SQLExceptions
• 增强的Blob / Clob功能 - 为创建和释放Blob / Clob实例提供的支持以及为改善可访问性而添加的其他方法
• 支持添加用于访问SQL ROWID
• 添加的支持允许JDBC应用程序访问由供应商（通常在应用程序服务器或连接池环境中）包装的JDBC资源的实例。
• 与PooledConnection相关联的PooledConnection已关闭或驱动程序确定无效时通知的PreparedStatement

java.sql和javax.sql在JDBC 3.0 API中javax.sql功能

• 池化语句 - 重用与池化连接相关联的语句
• 保存点 - 允许将事务回滚到指定的保存点
• 为ConnectionPoolDataSource定义的ConnectionPoolDataSource - 指定如何合并连接
• PreparedStatement对象参数的元数据
• 能够从自动生成的列中检索值
• 能够同时打开从CallableStatement ResultSet对象返回的多个ResultSet对象的能力
• 能够通过名称和索引来识别参数到CallableStatement对象
• ResultSet保持性 - 指定游标在事务结束时是否应该保持打开或关闭的能力
• 能够检索和更新Ref对象引用的SQL结构化类型实例
• 能够编程方式更新BLOB ， CLOB ， ARRAY和REF值。
• 添加java.sql.Types.DATALINK数据类型 - 允许JDBC驱动程序访问存储在数据源外部的对象
• 添加用于检索SQL类型层次结构的元数据

java.sql在JDBC 2.1 Core API中java.sql功能

• 可滚动结果集 - 使用ResultSet界面中的新方法，允许将光标移动到特定行或相对于其当前位置的位置
• 批量更新
• 程序化更新 - 使用ResultSet更新程序
• 新数据类型 - 映射SQL3数据类型的接口
• 用户定义类型（UDT）的自定义映射
• 其他功能，包括性能提示，字符流的使用，java.math.BigDecimal值的完全精确java.math.BigDecimal ，额外的安全性以及对日期，时间和时间戳值中时区的支持。

javax.sql在JDBC 2.0可选软件包API中javax.sql功能

• DataSource接口作为连接的一种手段。 Java命名和目录接口^TM （JNDI）用于注册具有命名服务的DataSource对象，并用于检索它。
• 池连接 - 允许连接被使用和重复使用
• 分布式事务 - 允许事务跨越不同的DBMS服务器
• RowSet技术 - 提供处理和传递数据的便利手段

UDT的自定义映射

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

1. 在SQL中定义SQL结构类型或DISTINCT类型
2. 定义要将SQL UDT映射到的Java编程语言中的类。 这个类必须实现SQLData接口。
3. 在Connection对象的类型映射中输入一个条目，其中包含两件事情：
   • UDT的完全限定的SQL名称
   • 所述类对象的类，它实现了SQLData接口

当这些功能适用于UDT时，调用该UDT上的方法ResultSet.getObject或CallableStatement.getObject将自动检索其自定义映射。 此外， PreparedStatement.setObject方法将自动将对象重新映射到其SQL类型以将其存储在数据源中。

包装规格

• Specification of the JDBC 4.0 API

相关文档

• Getting Started - 主要接口的视图

• Chapters on the JDBC API - 从Java教程的在线版本继续

• JDBC^TMAPI Tutorial and Reference, Third Edition - JDBC 3.0 API的完整参考和教程

从以下版本开始：

1.1