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（資料定義語言 (Data Definition Language)）語句，例如 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; // 沒有其它結果