JavaTM 2 Platform
Standard Ed. 6

軟體套件 java.sql

提供使用 JavaTM 程式語言存取並處理存儲在資料源(通常是一個關聯型資料庫)中的資料的 API。

請參見:
          描述

介面摘要
Array SQL 型別 ARRAY 在 Java 程式語言中的映射關係。
Blob SQL BLOB 值在 JavaTM 程式語言中的表示形式(映射關係)。
CallableStatement 用於執行 SQL 預儲程序的介面。
Clob SQL 型別 CLOB 在 JavaTM 程式語言中的映射關係。
Connection 與特定資料庫的連接(Session)。
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 中包括的內容

JDBCTM 4.0 API 中包括 java.sql 套件,被稱為 JDBC 核心 API,和 javax.sql 套件,被稱為 JDBC Optional Package API。完整的 JDBC API 套件含在 JavaTM 標準版 (Java SETM) 6 版中。javax.sql 套件擴展了 JDBC API 的功能,將它從客戶端 API 擴展到伺服器端 API,該套件是 JavaTM、企業版 (JavaTM) 技術的重要部分。

版本

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 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only