JDBCTM 指南：入門4 - Statement

4 - Statement
本概述是從《JDBCTM Database Access from JavaTM: A Tutorial and Annotated Reference 》這本書中摘引來的。JavaSoft 目前正在準備這本書。這是一本教程，同時也是 JDBC 的重要參考手冊，它將作爲 Java 系列的組成部份在 1997 年春季由 Addison-Wesley 出版公司出版。


4.1 概述
Statement 對象用於將 SQL 語句發送到數據庫中。實際上有三種 Statement 對象，它們都作爲在給定連接上執行 SQL 語句的包容器：Statement、PreparedStatement（它從 Statement 繼承而來）和 CallableStatement（它從 PreparedStatement 繼承而來）。它們都專用於發送特定類型的 SQL 語句： Statement 對象用於執行不帶參數的簡單 SQL 語句；PreparedStatement 對象用於執行帶或不帶 IN 參數的預編譯 SQL 語句；CallableStatement 對象用於執行對數據庫已存儲過程的調用。

Statement 接口提供了執行語句和獲取結果的基本方法。PreparedStatement 接口添加了處理 IN 參數的方法；而 CallableStatement 添加了處理 OUT 參數的方法。


4.1.1 創建 Statement 對象
建立了到特定數據庫的連接之後，就可用該連接發送 SQL 語句。Statement 對象用 Connection 的方法 createStatement 創建，如下列代碼段中所示：

Connection con = DriverManager.getConnection(url, "sunny", "");
Statement stmt = con.createStatement();

爲了執行 Statement 對象，被髮送到數據庫的 SQL 語句將被作爲參數提供給 Statement 的方法：

ResultSet rs = stmt.executeQuery("SELECT a, b, c FROM Table2");

4.1.2 使用 Statement 對象執行語句
Statement 接口提供了三種執行 SQL 語句的方法：executeQuery、executeUpdate 和 execute。使用哪一個方法由 SQL 語句所產生的內容決定。

方法 executeQuery 用於產生單個結果集的語句，例如 SELECT 語句。

方法 executeUpdate 用於執行 INSERT、UPDATE 或 DELETE 語句以及 SQL DDL（數據定義語言）語句，例如 CREATE TABLE 和 DROP TABLE。INSERT、UPDATE 或 DELETE 語句的效果是修改表中零行或多行中的一列或多列。executeUpdate 的返回值是一個整數，指示受影響的行數（即更新計數）。對於 CREATE TABLE 或 DROP TABLE 等不操作行的語句，executeUpdate 的返回值總爲零。

方法 execute 用於執行返回多個結果集、多個更新計數或二者組合的語句。因爲多數程序員不會需要該高級功能，所以本概述後面將在單獨一節中對其進行介紹。

執行語句的所有方法都將關閉所調用的 Statement 對象的當前打開結果集（如果存在）。這意味着在重新執行 Statement 對象之前，需要完成對當前 ResultSet 對象的處理。

應注意，繼承了 Statement 接口中所有方法的 PreparedStatement 接口都有自己的 executeQuery、executeUpdate 和 execute 方法。Statement 對象本身不包含 SQL 語句，因而必須給 Statement.execute 方法提供 SQL 語句作爲參數。PreparedStatement 對象並不將 SQL 語句作爲參數提供給這些方法，因爲它們已經包含預編譯 SQL 語句。CallableStatement 對象繼承這些方法的 PreparedStatement 形式。對於這些方法的 PreparedStatement 或 CallableStatement 版本，使用查詢參數將拋出 SQLException。


4.1.3 語句完成
當連接處於自動提交模式時，其中所執行的語句在完成時將自動提交或還原。語句在已執行且所有結果返回時，即認爲已完成。對於返回一個結果集的 executeQuery 方法，在檢索完 ResultSet 對象的所有行時該語句完成。對於方法 executeUpdate，當它執行時語句即完成。但在少數調用方法 execute 的情況中，在檢索所有結果集或它生成的更新計數之後語句才完成。

有些 DBMS 將已存儲過程中的每條語句視爲獨立的語句；而另外一些則將整個過程視爲一個複合語句。在啓用自動提交時，這種差別就變得非常重要，因爲它影響什麼時候調用 commit 方法。在前一種情況中，每條語句單獨提交；在後一種情況中，所有語句同時提交。


4.1.4 關閉 Statement 對象
Statement 對象將由 Java 垃圾收集程序自動關閉。而作爲一種好的編程風格，應在不需要 Statement 對象時顯式地關閉它們。這將立即釋放 DBMS 資源，有助於避免潛在的內存問題。


4.1.5 Statement 對象中的 SQL 轉義語法
Statement 可包含使用 SQL 轉義語法的 SQL 語句。轉義語法告訴驅動程序其中的代碼應該以不同方式處理。驅動程序將掃描任何轉義語法，並將它轉換成特定數據庫可理解的代碼。這使得轉義語法與 DBMS 無關，並允許程序員使用在沒有轉義語法時不可用的功能。

轉義子句由花括號和關鍵字界定：

{keyword . . . parameters . . . }

該關鍵字指示轉義子句的類型，如下所示。


escape 表示 LIKE 轉義字符


字符“%”和“_”類似於 SQL LIKE 子句中的通配符（“%”匹配零個或多個字符，而“_”則匹配一個字符）。爲了正確解釋它們，應在其前面加上反斜槓（“/”），它是字符串中的特殊轉義字符。在查詢末尾包括如下語法即可指定用作轉義字符的字符：

{escape 'escape-character'}


例如，下列查詢使用反斜槓字符作爲轉義字符，查找以下劃線開頭的標識符名：

stmt.executeQuery("SELECT name FROM Identifiers
WHERE Id LIKE `/_%' {escape `/'};


fn 表示標量函數


幾乎所有 DBMS 都具有標量值的數值、字符串、時間、日期、系統和轉換函數。要使用這些函數，可使用如下轉義語法：關鍵字 fn 後跟所需的函數名及其參數。例如，下列代碼調用函數 concat 將兩個參數連接在一起：

{fn concat("Hot", "Java")};


可用下列語法獲得當前數據庫用戶名：

{fn user()};


標量函數可能由語法稍有不同的 DBMS 支持，而它們可能不被所有驅動程序支持。各種 DatabaseMetaData 方法將列出所支持的函數。例如，方法 getNumericFunctions 返回用逗號分隔的數值函數列表，而方法 getStringFunctions 將返回字符串函數，等等。

驅動程序將轉義函數調用映射爲相應的語法，或直接實現該函數。


d、t 和 ts 表示日期和時間文字


DBMS 用於日期、時間和時間標記文字的語法各不相同。JDBC 使用轉義子句支持這些文字的語法的 ISO 標準格式。驅動程序必須將轉義子句轉換成 DBMS 表示。

例如，可用下列語法在 JDBC SQL 語句中指定日期：

{d `yyyy-mm-dd'}


在該語法中，yyyy 爲年代，mm 爲月份，而 dd 則爲日期。驅動程序將用等價的特定於 DBMS 的表示替換這個轉義子句。例如，如果 '28- FEB-99' 符合基本數據庫的格式，則驅動程序將用它替換 {d 1999-02-28}。

對於 TIME 和 TIMESTAMP 也有類似的轉義子句：

{t `hh:mm:ss'}
{ts `yyyy-mm-dd hh:mm:ss.f . . .'}


TIMESTAMP 中的小數點後的秒（.f . . .）部分可忽略。


call 或 ? = call 表示已存儲過程



如果數據庫支持已存儲過程，則可從 JDBC 中調用它們，語法爲：

{call procedure_name[(?, ?, . . .)]}


或（其中過程返回結果參數）：

{? = call procedure_name[(?, ?, . . .)]}


方括號指示其中的內容是可選的。它們不是語法的必要部分。

輸入參數可以爲文字或參數。有關詳細信息，參見 JDBC 指南中第 7 節，“CallableStatement”。

可通過調用方法 DatabaseMetaData.supportsStoredProcedures 檢查數據庫是否支持已存儲過程。



oj 表示外部連接



外部連接的語法爲

{oj outer-join}


其中 outer-join 形式爲

table LEFT OUTER JOIN {table / outer-join} ON search-condition


外部連接屬於高級功能。有關它們的解釋可參見 SQL 語法。JDBC 提供了三種 DatabaseMetaData 方法用於確定驅動程序支持哪些外部連接類型：supportsOuterJoins、supportsFullOuterJoins 和 supportsLimitedOuterJoins。


方法 Statement.setEscapeProcessing 可打開或關閉轉義處理；缺省狀態爲打開。當性能極爲重要時，程序員可能想關閉它以減少處理時間。但通常它將出於打開狀態。應注意： setEscapeProcessing 不適用於 PreparedStatement 對象，因爲在調用該語句前它就可能已被髮送到數據庫。有關預編譯的信息，參見 PreparedStatement。


4.1.6 使用方法 execute
execute 方法應該僅在語句能返回多個 ResultSet 對象、多個更新計數或 ResultSet 對象與更新計數的組合時使用。當執行某個已存儲過程或動態執行未知 SQL 字符串（即應用程序程序員在編譯時未知）時，有可能出現多個結果的情況，儘管這種情況很少見。例如，用戶可能執行一個已存儲過程（使用 CallableStatement 對象 - 參見第 135 頁的 CallableStatement），並且該已存儲過程可執行更新，然後執行選擇，再進行更新，再進行選擇，等等。通常使用已存儲過程的人應知道它所返回的內容。

因爲方法 execute 處理非常規情況，所以獲取其結果需要一些特殊處理並不足爲怪。例如，假定已知某個過程返回兩個結果集，則在使用方法 execute 執行該過程後，必須調用方法 getResultSet 獲得第一個結果集，然後調用適當的 getXXX 方法獲取其中的值。要獲得第二個結果集，需要先調用 getMoreResults 方法，然後再調用 getResultSet 方法。如果已知某個過程返回兩個更新計數，則首先調用方法 getUpdateCount，然後調用 getMoreResults，並再次調用 getUpdateCount。

對於不知道返回內容，則情況更爲複雜。如果結果是 ResultSet 對象，則方法 execute 返回 true；如果結果是 Java int，則返回 false。如果返回 int，則意味着結果是更新計數或執行的語句是 DDL 命令。在調用方法 execute 之後要做的第一件事情是調用 getResultSet 或 getUpdateCount。調用方法 getResultSet 可以獲得兩個或多個 ResultSet 對象中第一個對象；或調用方法 getUpdateCount 可以獲得兩個或多個更新計數中第一個更新計數的內容。

當 SQL 語句的結果不是結果集時，則方法 getResultSet 將返回 null。這可能意味着結果是一個更新計數或沒有其它結果。在這種情況下，判斷 null 真正含義的唯一方法是調用方法 getUpdateCount，它將返回一個整數。這個整數爲調用語句所影響的行數；如果爲 -1 則表示結果是結果集或沒有結果。如果方法 getResultSet 已返回 null（表示結果不是 ResultSet 對象），則返回值 -1 表示沒有其它結果。也就是說，當下列條件爲真時表示沒有結果（或沒有其它結果）：

((stmt.getResultSet() == null) && (stmt.getUpdateCount() == -1))

如果已經調用方法 getResultSet 並處理了它返回的 ResultSet 對象，則有必要調用方法 getMoreResults 以確定是否有其它結果集或更新計數。如果 getMoreResults 返回 true，則需要再次調用 getResultSet 來檢索下一個結果集。如上所述，如果 getResultSet 返回 null，則需要調用 getUpdateCount 來檢查 null 是表示結果爲更新計數還是表示沒有其它結果。

當 getMoreResults 返回 false 時，它表示該 SQL 語句返回一個更新計數或沒有其它結果。因此需要調用方法 getUpdateCount 來檢查它是哪一種情況。在這種情況下，當下列條件爲真時表示沒有其它結果：

((stmt.getMoreResults() == false) && (stmt.getUpdateCount() == -1))

下面的代碼演示了一種方法用來確認已訪問調用方法 execute 所產生的全部結果集和更新計數：


stmt.execute(queryStringWithUnknownResults);
while (true) {
int rowCount = stmt.getUpdateCount();
if (rowCount > 0) { // 它是更新計數
System.out.println("Rows changed = " + count);
stmt.getMoreResults();
continue;
}
if (rowCount == 0) { // DDL 命令或 0 個更新
System.out.println(" No rows changed or statement was DDL
command");
stmt.getMoreResults();
continue;
}

// 執行到這裏，證明有一個結果集
// 或沒有其它結果

ResultSet rs = stmt.getResultSet;
if (rs != null) {
. . . // 使用元數據獲得關於結果集列的信息
while (rs.next()) {
. . . // 處理結果
stmt.getMoreResults();
continue;
}
break; // 沒有其它結果