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


4.1 概述
Statement 對(duì)象用于將 SQL 語句發(fā)送到數(shù)據(jù)庫中。實(shí)際上有三種 Statement 對(duì)象，它們都作為在給定連接上執(zhí)行 SQL 語句的包容器：Statement、PreparedStatement（它從 Statement 繼承而來）和 CallableStatement（它從 PreparedStatement 繼承而來）。它們都專用于發(fā)送特定類型的 SQL 語句： Statement 對(duì)象用于執(zhí)行不帶參數(shù)的簡單 SQL 語句；PreparedStatement 對(duì)象用于執(zhí)行帶或不帶 IN 參數(shù)的預(yù)編譯 SQL 語句；CallableStatement 對(duì)象用于執(zhí)行對(duì)數(shù)據(jù)庫已存儲(chǔ)過程的調(diào)用。

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


4.1.1 創(chuàng)建 Statement 對(duì)象
建立了到特定數(shù)據(jù)庫的連接之后，就可用該連接發(fā)送 SQL 語句。Statement 對(duì)象用 Connection 的方法 createStatement 創(chuàng)建，如下列代碼段中所示：

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

為了執(zhí)行 Statement 對(duì)象，被發(fā)送到數(shù)據(jù)庫的 SQL 語句將被作為參數(shù)提供給 Statement 的方法：

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

4.1.2 使用 Statement 對(duì)象執(zhí)行語句
Statement 接口提供了三種執(zhí)行 SQL 語句的方法：executeQuery、executeUpdate 和 execute。使用哪一個(gè)方法由 SQL 語句所產(chǎn)生的內(nèi)容決定。

方法 executeQuery 用于產(chǎn)生單個(gè)結(jié)果集的語句，例如 SELECT 語句。

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

方法 execute 用于執(zhí)行返回多個(gè)結(jié)果集、多個(gè)更新計(jì)數(shù)或二者組合的語句。因?yàn)槎鄶?shù)程序員不會(huì)需要該高級(jí)功能，所以本概述后面將在單獨(dú)一節(jié)中對(duì)其進(jìn)行介紹。

執(zhí)行語句的所有方法都將關(guān)閉所調(diào)用的 Statement 對(duì)象的當(dāng)前打開結(jié)果集（如果存在）。這意味著在重新執(zhí)行 Statement 對(duì)象之前，需要完成對(duì)當(dāng)前 ResultSet 對(duì)象的處理。

應(yīng)注意，繼承了 Statement 接口中所有方法的 PreparedStatement 接口都有自己的 executeQuery、executeUpdate 和 execute 方法。Statement 對(duì)象本身不包含 SQL 語句，因而必須給 Statement.execute 方法提供 SQL 語句作為參數(shù)。PreparedStatement 對(duì)象并不將 SQL 語句作為參數(shù)提供給這些方法，因?yàn)樗鼈円呀?jīng)包含預(yù)編譯 SQL 語句。CallableStatement 對(duì)象繼承這些方法的 PreparedStatement 形式。對(duì)于這些方法的 PreparedStatement 或 CallableStatement 版本，使用查詢參數(shù)將拋出 SQLException。


4.1.3 語句完成
當(dāng)連接處于自動(dòng)提交模式時(shí)，其中所執(zhí)行的語句在完成時(shí)將自動(dòng)提交或還原。語句在已執(zhí)行且所有結(jié)果返回時(shí)，即認(rèn)為已完成。對(duì)于返回一個(gè)結(jié)果集的 executeQuery 方法，在檢索完 ResultSet 對(duì)象的所有行時(shí)該語句完成。對(duì)于方法 executeUpdate，當(dāng)它執(zhí)行時(shí)語句即完成。但在少數(shù)調(diào)用方法 execute 的情況中，在檢索所有結(jié)果集或它生成的更新計(jì)數(shù)之后語句才完成。

有些 DBMS 將已存儲(chǔ)過程中的每條語句視為獨(dú)立的語句；而另外一些則將整個(gè)過程視為一個(gè)復(fù)合語句。在啟用自動(dòng)提交時(shí)，這種差別就變得非常重要，因?yàn)樗�影響什么時(shí)候調(diào)用 commit 方法。在前一種情況中，每條語句單獨(dú)提交；在后一種情況中，所有語句同時(shí)提交。


4.1.4 關(guān)閉 Statement 對(duì)象
Statement 對(duì)象將由 Java 垃圾收集程序自動(dòng)關(guān)閉。而作為一種好的編程風(fēng)格，應(yīng)在不需要 Statement 對(duì)象時(shí)顯式地關(guān)閉它們。這將立即釋放 DBMS 資源，有助于避免潛在的內(nèi)存問題。


4.1.5 Statement 對(duì)象中的 SQL 轉(zhuǎn)義語法
Statement 可包含使用 SQL 轉(zhuǎn)義語法的 SQL 語句。轉(zhuǎn)義語法告訴驅(qū)動(dòng)程序其中的代碼應(yīng)該以不同方式處理。驅(qū)動(dòng)程序?qū)�掃描任何轉(zhuǎn)義語法，并將它轉(zhuǎn)換成特定數(shù)據(jù)庫可理解的代碼。這使得轉(zhuǎn)義語法與 DBMS 無關(guān)，并允許程序員使用在沒有轉(zhuǎn)義語法時(shí)不可用的功能。

轉(zhuǎn)義子句由花括號(hào)和關(guān)鍵字界定：

{keyword . . . parameters . . . }

該關(guān)鍵字指示轉(zhuǎn)義子句的類型，如下所示。


escape 表示 LIKE 轉(zhuǎn)義字符


字符“%”和“_”類似于 SQL LIKE 子句中的通配符（“%”匹配零個(gè)或多個(gè)字符，而“_”則匹配一個(gè)字符）。為了正確解釋它們，應(yīng)在其前面加上反斜杠（“\”），它是字符串中的特殊轉(zhuǎn)義字符。在查詢末尾包括如下語法即可指定用作轉(zhuǎn)義字符的字符：

{escape 'escape-character'}


例如，下列查詢使用反斜杠字符作為轉(zhuǎn)義字符，查找以下劃線開頭的標(biāo)識(shí)符名：

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


fn 表示標(biāo)量函數(shù)


幾乎所有 DBMS 都具有標(biāo)量值的數(shù)值、字符串、時(shí)間、日期、系統(tǒng)和轉(zhuǎn)換函數(shù)。要使用這些函數(shù)，可使用如下轉(zhuǎn)義語法：關(guān)鍵字 fn 后跟所需的函數(shù)名及其參數(shù)。例如，下列代碼調(diào)用函數(shù) concat 將兩個(gè)參數(shù)連接在一起：

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


可用下列語法獲得當(dāng)前數(shù)據(jù)庫用戶名：

{fn user()};


標(biāo)量函數(shù)可能由語法稍有不同的 DBMS 支持，而它們可能不被所有驅(qū)動(dòng)程序支持。各種 DatabaseMetaData 方法將列出所支持的函數(shù)。例如，方法 getNumericFunctions 返回用逗號(hào)分隔的數(shù)值函數(shù)列表，而方法 getStringFunctions 將返回字符串函數(shù)，等等。

驅(qū)動(dòng)程序?qū)⑥D(zhuǎn)義函數(shù)調(diào)用映射為相應(yīng)的語法，或直接實(shí)現(xiàn)該函數(shù)。


d、t 和 ts 表示日期和時(shí)間文字


DBMS 用于日期、時(shí)間和時(shí)間標(biāo)記文字的語法各不相同。JDBC 使用轉(zhuǎn)義子句支持這些文字的語法的 ISO 標(biāo)準(zhǔn)格式。驅(qū)動(dòng)程序必須將轉(zhuǎn)義子句轉(zhuǎn)換成 DBMS 表示。

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

{d `yyyy-mm-dd'}


在該語法中，yyyy 為年代，mm 為月份，而 dd 則為日期。驅(qū)動(dòng)程序?qū)⒂玫葍r(jià)的特定于 DBMS 的表示替換這個(gè)轉(zhuǎn)義子句。例如，如果 '28- FEB-99' 符合基本數(shù)據(jù)庫的格式，則驅(qū)動(dòng)程序?qū)⒂盟�替換 {d 1999-02-28}。

對(duì)于 TIME 和 TIMESTAMP 也有類似的轉(zhuǎn)義子句：

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


TIMESTAMP 中的小數(shù)點(diǎn)后的秒（.f . . .）部分可忽略。


call 或 ? = call 表示已存儲(chǔ)過程



如果數(shù)據(jù)庫支持已存儲(chǔ)過程，則可從 JDBC 中調(diào)用它們，語法為：

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


或（其中過程返回結(jié)果參數(shù)）：

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


方括號(hào)指示其中的內(nèi)容是可選的。它們不是語法的必要部分。

輸入?yún)��?shù)可以為文字或參數(shù)。有關(guān)詳細(xì)信息，參見 JDBC 指南中第 7 節(jié)，“CallableStatement”。

可通過調(diào)用方法 DatabaseMetaData.supportsStoredProcedures 檢查數(shù)據(jù)庫是否支持已存儲(chǔ)過程。



oj 表示外部連接



外部連接的語法為

{oj outer-join}


其中 outer-join 形式為

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


外部連接屬于高級(jí)功能。有關(guān)它們的解釋可參見 SQL 語法。JDBC 提供了三種 DatabaseMetaData 方法用于確定驅(qū)動(dòng)程序支持哪些外部連接類型：supportsOuterJoins、supportsFullOuterJoins 和 supportsLimitedOuterJoins。


方法 Statement.setEscapeProcessing 可打開或關(guān)閉轉(zhuǎn)義處理；缺省狀態(tài)為打開。當(dāng)性能極為重要時(shí)，程序員可能想關(guān)閉它以減少處理時(shí)間。但通常它將出于打開狀態(tài)。應(yīng)注意： setEscapeProcessing 不適用于 PreparedStatement 對(duì)象，因?yàn)樵谡{(diào)用該語句前它就可能已被發(fā)送到數(shù)據(jù)庫。有關(guān)預(yù)編譯的信息，參見 PreparedStatement。


4.1.6 使用方法 execute
execute 方法應(yīng)該僅在語句能返回多個(gè) ResultSet 對(duì)象、多個(gè)更新計(jì)數(shù)或 ResultSet 對(duì)象與更新計(jì)數(shù)的組合時(shí)使用。當(dāng)執(zhí)行某個(gè)已存儲(chǔ)過程或動(dòng)態(tài)執(zhí)行未知 SQL 字符串（即應(yīng)用程序程序員在編譯時(shí)未知）時(shí)，有可能出現(xiàn)多個(gè)結(jié)果的情況，盡管這種情況很少見。例如，用戶可能執(zhí)行一個(gè)已存儲(chǔ)過程（使用 CallableStatement 對(duì)象 - 參見第 135 頁的 CallableStatement），并且該已存儲(chǔ)過程可執(zhí)行更新，然后執(zhí)行選擇，再進(jìn)行更新，再進(jìn)行選擇，等等。通常使用已存儲(chǔ)過程的人應(yīng)知道它所返回的內(nèi)容。

因?yàn)榉椒?execute 處理非常規(guī)情況，所以獲取其結(jié)果需要一些特殊處理并不足為怪。例如，假定已知某個(gè)過程返回兩個(gè)結(jié)果集，則在使用方法 execute 執(zhí)行該過程后，必須調(diào)用方法 getResultSet 獲得第一個(gè)結(jié)果集，然后調(diào)用適當(dāng)?shù)?getXXX 方法獲取其中的值。要獲得第二個(gè)結(jié)果集，需要先調(diào)用 getMoreResults 方法，然后再調(diào)用 getResultSet 方法。如果已知某個(gè)過程返回兩個(gè)更新計(jì)數(shù)，則首先調(diào)用方法 getUpdateCount，然后調(diào)用 getMoreResults，并再次調(diào)用 getUpdateCount。

對(duì)于不知道返回內(nèi)容，則情況更為復(fù)雜。如果結(jié)果是 ResultSet 對(duì)象，則方法 execute 返回 true；如果結(jié)果是 Java int，則返回 false。如果返回 int，則意味著結(jié)果是更新計(jì)數(shù)或執(zhí)行的語句是 DDL 命令。在調(diào)用方法 execute 之后要做的第一件事情是調(diào)用 getResultSet 或 getUpdateCount。調(diào)用方法 getResultSet 可以獲得兩個(gè)或多個(gè) ResultSet 對(duì)象中第一個(gè)對(duì)象；或調(diào)用方法 getUpdateCount 可以獲得兩個(gè)或多個(gè)更新計(jì)數(shù)中第一個(gè)更新計(jì)數(shù)的內(nèi)容。

當(dāng) SQL 語句的結(jié)果不是結(jié)果集時(shí)，則方法 getResultSet 將返回 null。這可能意味著結(jié)果是一個(gè)更新計(jì)數(shù)或沒有其它結(jié)果。在這種情況下，判斷 null 真正含義的唯一方法是調(diào)用方法 getUpdateCount，它將返回一個(gè)整數(shù)。這個(gè)整數(shù)為調(diào)用語句所影響的行數(shù)；如果為 -1 則表示結(jié)果是結(jié)果集或沒有結(jié)果。如果方法 getResultSet 已返回 null（表示結(jié)果不是 ResultSet 對(duì)象），則返回值 -1 表示沒有其它結(jié)果。也就是說，當(dāng)下列條件為真時(shí)表示沒有結(jié)果（或沒有其它結(jié)果）：

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

如果已經(jīng)調(diào)用方法 getResultSet 并處理了它返回的 ResultSet 對(duì)象，則有必要調(diào)用方法 getMoreResults 以確定是否有其它結(jié)果集或更新計(jì)數(shù)。如果 getMoreResults 返回 true，則需要再次調(diào)用 getResultSet 來檢索下一個(gè)結(jié)果集。如上所述，如果 getResultSet 返回 null，則需要調(diào)用 getUpdateCount 來檢查 null 是表示結(jié)果為更新計(jì)數(shù)還是表示沒有其它結(jié)果。

當(dāng) getMoreResults 返回 false 時(shí)，它表示該 SQL 語句返回一個(gè)更新計(jì)數(shù)或沒有其它結(jié)果。因此需要調(diào)用方法 getUpdateCount 來檢查它是哪一種情況。在這種情況下，當(dāng)下列條件為真時(shí)表示沒有其它結(jié)果：

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

下面的代碼演示了一種方法用來確認(rèn)已訪問調(diào)用方法 execute 所產(chǎn)生的全部結(jié)果集和更新計(jì)數(shù)：


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

// 執(zhí)行到這里，證明有一個(gè)結(jié)果集
// 或沒有其它結(jié)果

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