誰能給我壹份關於Package java.sql 的中文文檔啊

概述軟件包類使用樹已過時索引幫助

JavaTM 2 Platform

Standard Ed. 5.0

上壹個軟件包下壹個軟件包框架無框架所有類

--------------------------------------------------------------------------------

軟件包 java.sql

提供使用 JavaTM 編程語言訪問並處理存儲在數據源（通常是壹個關系數據庫）中的數據的 API。

請參見：

描述

接口摘要

Array SQL 類型 ARRAY 在 Java 編程語言中的映射關系。

Blob SQL BLOB 值在 JavaTM 編程語言中的表示形式（映射關系）。

CallableStatement 用於執行 SQL 存儲過程的接口。

Clob SQL 類型 CLOB 在 JavaTM 編程語言中的映射關系。

Connection 與特定數據庫的連接（會話）。

DatabaseMetaData 關於數據庫的整體綜合信息。

Driver 每個驅動程序類必須實現的接口。

ParameterMetaData 可用於獲取關於 PreparedStatement 對象中參數的類型和屬性信息的對象。

PreparedStatement 表示預編譯的 SQL 語句的對象。

Ref Java 編程語言中 SQL REF 值的映射關系，它是到數據庫中的 SQL 結構類型值的引用。

ResultSet 表示數據庫結果集的數據表，通常通過執行查詢數據庫的語句生成。

ResultSetMetaData 可用於獲取關於 ResultSet 對象中列的類型和屬性信息的對象。

Savepoint 保存點的表示形式，保存點是可以從 Connection.rollback 方法引用的當前事務中的點。

SQLData 該接口用於 SQL 用戶定義類型 (UDT) 到 Java 編程語言中類的自定義映射關系。

SQLInput 壹個輸入流，它包含表示 SQL 結構化類型或 SQL 不同類型的實例的值組成的流。

SQLOutput 用於將用戶定義類型的屬性寫回數據庫的輸出流。

Statement 用於執行靜態 SQL 語句並返回它所生成結果的對象。

Struct 用於 SQL 結構化類型的 Java 編程語言中的標準映射關系。

類摘要

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 類型）的常量的類。

異常摘要

BatchUpdateException 當在進行批量更新操作期間發生錯誤時，拋出該異常。

DataTruncation 報告 DataTruncation 警告的異常（讀取時），或者 JDBC 意外地截斷某壹數據值時拋出 DataTruncation 異常（寫入時）。

SQLException 該異常提供關於數據庫訪問錯誤或其他錯誤的信息。

SQLWarning 提供關於數據庫訪問警告信息的異常。

軟件包 java.sql 的描述

提供使用 JavaTM 編程語言訪問並處理存儲在數據源（通常是壹個關系數據庫）中的數據的 API。此 API 包括壹個框架，憑借此框架可以動態地安裝不同驅動程序來訪問不同數據源。盡管 JDBCTM API 主要用於將 SQL 語句傳遞給數據庫，但它還可以用於以表格方式從任何數據源中讀寫數據。通過接口的 javax.sql.RowSet 組可以使用的 reader/writer 實用程序，可以被定制以使用和更新來自電子表格、純文本文件或其他任何表格式數據源的數據。

JDBCTM 3.0 API 中包括的內容

JDBCTM 3.0 API 中包括 java.sql 包，被稱為 JDBC 核心 API，和 javax.sql 包，被稱為 JDBC Optional Package API。完整的 JDBC API 包含在 J2SE 1.4 中。javax.sql 包擴展了 JDBC API 的功能，將它從客戶端 API 擴展到服務器端 API，該包是 JavaTM 2 SDK、企業版 (J2EETM) 技術的重要部分。（註意，J2EE 平臺還包括完整 JDBC API;JDBC 3.0 API 中的新特性包含在 J2EE 1.3 版中）。

版本

JDBC 3.0 API 綜合了以前所有 JDBC API 版本：

JDBC 2.1 核心 API

JDBC 2.0 Optional Package API

（註意，JDBC 2.1 核心 API 和 JDBC 2.0 Optional Package API 組合在壹起被稱為 JDBC 2.0 API。）

The JDBC 1.2 API

The JDBC 1.0 API

類、接口、方法、字段、構造方法和異常都有以下 "since" 標記，以指示它們何時被引入 Java 平臺。當將這些 "since" 標記用於 JDBC API 的 JavadocTM 註釋時，它們指示以下內容：

Since 1.4：JDBC 3.0 API 中的新內容和 J2SE 平臺 1.4 版的部分內容

Since 1.2：JDBC 2.0 API 中的新內容和 J2SE 平臺 1.2 版的部分內容

Since 1.1 或者沒有 "since" 標記：原始 JDBC 1.0 API 和 JDKTM 1.1 版的部分內容

註：許多新特性都是可選的，因此，在這些版本支持的驅動程序和特性中有壹些變體。在嘗試使用它之前,總是檢查驅動程序的文檔，以查看它是否支持某壹特性。

註：SQLPermission 類被添加到 JDK 1.3 中。此類用於防止對與 DriverManager 相關聯的記錄流進行無授權訪問，該流可以包含諸如表名稱、列數據等信息。

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 InterfaceTM (JNDI) 用於向命名服務註冊壹個 DataSource 對象和檢索該對象。

入池連接：允許使用和重新使用連接

分布式事務：允許事務跨越不同的 DBMS 服務器

RowSet 技術：提供壹個處理和傳遞數據的便捷方法

UDT 的自定義映射關系

可以將 SQL 中定義的用戶定義類型 (UDT) 映射到 Java 編程語言中的類。SQL 結構化類型或 SQL DISTINCT 類型是可以自定義映射的 UDT。以下三個步驟設置了壹個自定義映射關系：

在 SQL 中定義 SQL 結構化類型或 DISTINCT 類型

定義 Java 編程語言中的類，SQL UDT 將映射到該類。此類必須實現 SQLData 接口。

在 Connection 對象的類型映射表中創建壹個項，該項包含兩項內容：

UDT 的完全限定 SQL 名稱

實現 SQLData 接口的類的 Class 對象

為 UDT 準備好這些之後，在該 UDT 上調用 ResultSet.getObject 或 CallableStatement.getObject 方法將自動檢索該 UDT 的自定義映射關系。此外，PreparedStatement.setObject 方法會自動將該對象映射回其 SQL 類型，以便將它存儲在數據源中。

包規範

Specification of the JDBC 3.0 API

相關文檔

Getting Started：主要接口的概述

Chapters on the JDBC API：來自 The Java Tutorial Continued 的在線版本

JDBCTMAPI Tutorial and Reference, Second Edition:Universal Data Access for the Java 2 Platform：JDBC 2.0 API 的完整的參考和指南

從以下版本開始：

1.1

--------------------------------------------------------------------------------

概述軟件包類使用樹已過時索引幫助

JavaTM 2 Platform

Standard Ed. 5.0