Package java.sql

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

See: 描述

接口摘要

接口	描述
Array	对于SQL类型 ARRAY java编程语言中的映射。
Blob	表示（映射）在™java编程语言SQL BLOB价值。
CallableStatement	该接口用于执行SQL存储过程。
Clob	对于SQL CLOB类型在java编程语言的映射™。
Connection	一个特定数据库的连接（会话）。
DatabaseMetaData	全面的数据库信息作为一个整体。
Driver	每个驱动程序类必须实现的接口。
DriverAction	一个接口，必须实现一个 Driver时要通知的 DriverManager。
NClob	对于SQL NCLOB类型在java编程语言的映射™。
ParameterMetaData	可以用来在一个 PreparedStatement对象为每个参数的类型和属性的标记信息的对象。
PreparedStatement	对象是一个预编译的SQL语句。
Ref	在一个SQL REF价值java编程语言的映射，这是一个结构化的数据库中的值类型。
ResultSet	表示数据库结果集的数据表，它通常是通过执行查询数据库的语句生成的。
ResultSetMetaData	可以用来在一个 ResultSet对象列的类型和属性信息的对象。
RowId	表示（映射）在rowid SQL值java编程语言。
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驱动程序的基本服务。 注：的 DataSource界面，新的JDBC 2 API，提供了另一种方式来连接数据源。
DriverPropertyInfo	用于连接的驱动属性。
SQLPermission	该 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原因状态枚举
JDBCType	定义用于确定通用的SQL类型的常数，称为JDBC类型。
PseudoColumnUsage	伪/隐藏列的使用的枚举。
RowIdLifetime	为ROWID寿命值的枚举。

异常摘要

异常	描述
BatchUpdateException	对 SQLException扔在批处理更新操作期间发生错误时，子类的。
DataTruncation	抛出一个异常作为一个 DataTruncation例外（写）或报告为 DataTruncation警告（在读）当一个数据值竟是截断超过 MaxFieldSize以外的原因。
SQLClientInfoException	子类的 SQLException时引发一个或多个客户信息属性无法设置在 Connection。
SQLDataException	对 SQLException当SQLSTATE类的值的二十二的子类，或在供应商规定的条件。
SQLException	在数据库访问错误或其他错误中提供信息的异常。
SQLFeatureNotSupportedException	对 SQLException当SQLSTATE值为“0”类的子类（值为零”的）。
SQLIntegrityConstraintViolationException	对 SQLException当SQLSTATE类的值的二十三的子类，或在供应商规定的条件。
SQLInvalidAuthorizationSpecException	对 SQLException当SQLSTATE类的值的二十八的子类，或在供应商规定的条件。
SQLNonTransientConnectionException	对 SQLException抛出SQLSTATE值“08”的子类，或在供应商规定的条件。
SQLNonTransientException	这类 SQLException时抛出的一个实例，一个重试其操作的可能的原因是 SQLException除非纠正失败。
SQLRecoverableException	这类 SQLException抛出的情况下，失败的操作可以申请执行一些复苏的步骤和重试整个交易或在分布式事务的情况下成功，交易部门。
SQLSyntaxErrorException	对 SQLException当SQLSTATE类的值的四十二的子类，或在供应商规定的条件。
SQLTimeoutException	对 SQLException当超时的 Statement.setQueryTimeout， DriverManager.setLoginTimeout， DataSource.setLoginTimeout指定子类的， XADataSource.setLoginTimeout已过期。
SQLTransactionRollbackException	对 SQLException当SQLSTATE类的值的四十的子类，或在供应商规定的条件。
SQLTransientConnectionException	对于定制类的值“08” SQLException子类，或在供应商规定的条件。
SQLTransientException	对 SQLException类抛出的情况下，失败的操作可能成功当操作重试无任何干预的应用层的功能。
SQLWarning	提供数据库访问警告的信息的异常。

Package java.sql Description

提供的API来访问和处理的数据存储在数据源（通常是一个关系数据库）使用java编程语言 ^TM。该接口包括一个框架，使不同的驱动程序可以动态地安装访问不同的数据源。虽然JDBC API主要面向 ^TM通过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，它的 ^TM java企业版的重要组成部分（java EE ^TM）技术。

版本

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

• JDBC 4.1 API
• JDBC 4 API
• JDBC 3 API
• JDBC 2.1核心API
• JDBC 2可选包api
  （注意2.1个核心API和JDBC API 2可选包一起被称为JDBC 2 API JDBC）
• JDBC 1.2 API
• JDBC 1 API

类、接口、方法、字段、构造函数和异常有以下“自”标签，表明当他们进入java平台。当这些“自”标签中使用javadoc^TM评论JDBC API，它们表明：

• 自1.8以来新的JDBC 4.2 API和java SE平台的一部分，8版
• 自1.7以来新的JDBC 4.1 API和java SE平台的一部分，7版
• 自1.6以来新的JDBC 4 API和java SE平台的一部分，6版
• 自1.4以来新的JDBC 3 API和J2SE平台的一部分，1.4版
• 自1.2以来新的JDBC 2 API和J2SE平台的一部分，1.2版
• 自1.1或无“自”的标签--原始的JDBC 1 API的jdk^TM部分，1.1版

注：许多新特性都是可选的；因此，有司机的一些变化和功能支持。总是检查您的驱动程序的文档，看看它是否支持一个功能，在你尝试使用它。

注：类SQLPermission在java^TM 2 SDK，增加了标准版，版本1.3。这个类是用来防止未经授权的访问日志流与DriverManager有关，其中可能包含的信息，如表名、列数据，等等。

什么java.sql包中包含

的 java.sql包中包含的API如下：

• 与通过DriverManager设施
  • DriverManager类——与司机联系
  • SQLPermission类——提供许可时，代码运行在一个安全管理，如一个小程序，尝试建立一个记录流通过DriverManager
  • Driver接口提供了API，用于注册和连接基于JDBC技术的驱动程序（“JDBC驱动程序”）；一般只有DriverManager类使用
  • DriverPropertyInfo类——提供JDBC驱动程序的性能；由一般用户不习惯
  数据库连接
• 发送SQL语句到数据库
  • Statement --用来发送SQL的基本语句
  • PreparedStatement --用来将准备好的语句或SQL的基本语句（来自Statement）
  • CallableStatement --用来调用数据库的存储过程（来自PreparedStatement）
  • Connection接口提供了用于创建报表和管理连接和性能的方法
  • Savepoint --提供了保存点在交易
• 检索和更新查询的结果
  • ResultSet接口
• 在java编程语言
  • Array接口，SQL ARRAY映射
  • Blob接口，SQL BLOB映射
  • Clob接口，SQL CLOB映射
  • SQL DATE Date类——映射
  • NClob接口，SQL NCLOB映射
  • Ref接口，SQL REF映射
  • RowId接口，SQL ROWID映射
  • Struct接口，SQL STRUCT映射
  • SQLXML接口，SQL XML映射
  • SQL TIME Time类——映射
  • SQL TIMESTAMP Timestamp类——映射
  • Types类——提供SQL类型常数
  SQL类型的类和接口标准映射
• 自定义映射SQL用户定义类型（UDT）对java编程语言中的类
  • SQLData接口指定一个UDT的这个类的实例的映射
  • SQLInput接口，提供用于从流中读取该属性的方法
  • SQLOutput接口提供的方法写UDT属性回流
• 元数据
  • DatabaseMetaData接口提供了关于数据库的信息
  • ResultSetMetaData接口提供了一个ResultSet对象的列的信息
  • ParameterMetaData接口-提供有关PreparedStatement命令的参数信息
• 例外
  • SQLException --大多数方法时抛出有问题的数据访问和一些其他原因的方法
  • SQLWarning——抛出一个警告
  • DataTruncation——抛出数据可能已被截断
  • BatchUpdateException——抛出不都在一个批处理命令更新成功执行

java.sql和javax.sql功能介绍在JDBC 4.2 API

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

java.sql和javax.sql功能介绍在JDBC 4.1 API

• 让Connection，ResultSet和Statement对象要使用资源声明的尝试
• 支持添加到CallableStatement和ResultSet指定将通过getObject方法的java类
• DatabaseMetaData方法返回pseudocolumns如果生成的关键总是返回
• 对Connection增加了支持指定的数据库模式，取消和暂停的物理连接。
• 新增支持关闭Statement对象时，依赖于它的对象都已关闭
• 为Driver，DataSource获得父记录的支持，ConnectionPoolDataSource和XADataSource

介绍了JDBC 4 API的功能java.sql和javax.sql

• 汽车java.sql.driver发现--不再需要加载java.sql.Driver通过Class.forName
• 增加了国家字符集支持
• 对于SQL支持XML数据类型：2003
• SQLException增强--添加支持导致链接；共同价值规范SQLSTATE类添加新的SQLException
• 增强的BLOB / CLOB功能——支持创造和自由的一滴/ CLOB实例以及额外的方法添加到提高可达性
• 支持访问SQL数据
• 支持添加到允许一个JDBC应用程序访问一个JDBC资源，已由一个供应商包装实例，通常在一个应用服务器或连接池的环境。
• 可用性是一个PreparedStatement通知时，与PooledConnection关联已经关闭或司机决定无效

java.sql和javax.sql功能介绍在JDBC 3 API

• 合并报表-再利用与合并连接的语句
• 保存点，允许一个事务回滚到指定的保存点
• 属性定义为ConnectionPoolDataSource——指定连接将
• 对于一个PreparedStatement元数据对象参数
• 能够从自动生成的列中检索值的能力
• 能力有多ResultSet对象从CallableStatement对象同时开回来
• 确定参数CallableStatement对象的名字以及指标的能力
• ResultSet保持能力--指定游标应保持开启或关闭，在交易的最后的能力
• 能够检索和更新SQL结构化类型的实例，Ref对象引用
• 能力以编程方式更新BLOB，CLOB，ARRAY，和REF值。
• 另外的java.sql.Types.DATALINK数据类型允许的JDBC驱动程序访问存储在数据源对象
• 检索SQL类型层次结构的元数据添加

java.sql功能介绍在JDBC 2.1核心API

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

javax.sql功能介绍在JDBC API 2可选包

• 的DataSource接口的连接方式。java命名和目录interface^TM（JNDI）用于注册DataSource对象命名服务并检索。
• 汇总连接-允许连接被使用和重用
• 分布式事务-允许事务跨越不同的数据库管理系统服务器
• RowSet技术提供了一种方便的处理和传递数据的手段

对UDT自定义映射

用户定义类型（UDT）定义SQL可以映射到java编程语言中的类。一个SQL结构化类型或一个SQL DISTINCT型是UDT可以自定义映射。以下三个步骤建立一个自定义映射：

1. 在SQL定义SQL结构化类型或DISTINCT型
2. 定义类的java编程语言，SQL UDT将映射。这个类必须实现SQLData接口。
3. 在Connection对象类型Map中包含了两个东西入口：
   • 完全限定名称的UDT的SQL
   • 为实现SQLData接口的类的对象类

当这些都发生在UDT UDT，将自动检索它的自定义映射调用方法或CallableStatement.getObject ResultSet.getObject。同时，该PreparedStatement.setObject方法将自动Map对象回到SQL类型来存储它的数据源。

包装规格

• Specification of the JDBC 4.0 API

相关文件

• Getting Started——主要接口
  概述
• 从java教程继续
  在线版Chapters on the JDBC API
• JDBC^TMAPI Tutorial and Reference, Third Edition——JDBC 3 API的一个完整的参考教程

从以下版本开始：

1.1