JDBC系列教程（五）---預(yù)備語句

PReparedStatement

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

6.1 概述
該 PreparedStatement 接口繼續(xù) Statement，并與之在兩方面有所不同： 

PreparedStatement 實(shí)例包含已編譯的 SQL 語句。這就是使語句“預(yù)備好”。 
包含于 PreparedStatement 對(duì)象中的 SQL 語句可具有一個(gè)或多個(gè) IN 參數(shù)。IN 參數(shù)的值在 SQL 語句創(chuàng)建時(shí)未被指定。相反的，該語句為每個(gè) IN 參數(shù)保留一個(gè)問號(hào)（“？”）作為占位符。每個(gè)問號(hào)的值必須在該語句執(zhí)行之前，通過適當(dāng)?shù)?setXXX 方法來提供。 

由于 PreparedStatement 對(duì)象已預(yù)編譯過，所以其執(zhí)行速度要快于 Statement 對(duì)象。因此，多次執(zhí)行的 SQL 語句經(jīng)常創(chuàng)建為 PreparedStatement 對(duì)象，以提高效率。

作為 Statement 的子類，PreparedStatement 繼續(xù)了 Statement 的所有功能。另外它還添加了一整套方法，用于設(shè)置發(fā)送給數(shù)據(jù)庫以取代 IN 參數(shù)占位符的值。同時(shí)，三種方法 execute、 executeQuery 和 executeUpdate 已被更改以使之不再需要參數(shù)。這些方法的 Statement 形式（接受 SQL 語句參數(shù)的形式）不應(yīng)該用于 PreparedStatement 對(duì)象。

6.1.1 創(chuàng)建 PreparedStatement 對(duì)象
以下的代碼段（其中 con 是 Connection 對(duì)象）創(chuàng)建包含帶兩個(gè) IN 參數(shù)占位符的 SQL 語句的 PreparedStatement 對(duì)象： 

PreparedStatement pstmt = con.prepareStatement(
"UPDATE table4 SET m = ? WHERE x = ?");

pstmt 對(duì)象包含語句 "UPDATE table4 SET m = ? WHERE x = ?"，它已發(fā)送給 DBMS，并為執(zhí)行作好了預(yù)備。

6.1.2 傳遞 IN 參數(shù)
在執(zhí)行 PreparedStatement 對(duì)象之前，必須設(shè)置每個(gè) ? 參數(shù)的值。這可通過調(diào)用 setXXX 方法來完成，其中 XXX 是與該參數(shù)相應(yīng)的類型。例如，假如參數(shù)具有 Java 類型 long，則使用的方法就是 setLong。setXXX 方法的第一個(gè)參數(shù)是要設(shè)置的參數(shù)的序數(shù)位置，第二個(gè)參數(shù)是設(shè)置給該參數(shù)的值。例如，以下代碼將第一個(gè)參數(shù)設(shè)為 123456789，第二個(gè)參數(shù)設(shè)為 100000000： 

pstmt.setLong(1, 123456789);
pstmt.setLong(2, 100000000);

一旦設(shè)置了給定語句的參數(shù)值，就可用它多次執(zhí)行該語句，直到調(diào)用 clearParameters 方法清除它為止。

在連接的缺省模式下（啟用自動(dòng)提交），當(dāng)語句完成時(shí)將自動(dòng)提交或還原該語句。

假如基本數(shù)據(jù)庫和驅(qū)動(dòng)程序在語句提交之后仍保持這些語句的打開狀態(tài)，則同一個(gè) PreparedStatement 可執(zhí)行多次。假如這一點(diǎn)不成立，那么試圖通過使用 PreparedStatement 對(duì)象代替 Statement 對(duì)象來提高性能是沒有意義的。

利用 pstmt（前面創(chuàng)建的 PreparedStatement 對(duì)象），以下代碼例示了如何設(shè)置兩個(gè)參數(shù)占位符的值并執(zhí)行 pstmt 10 次。如上所述，為做到這一點(diǎn)，數(shù)據(jù)庫不能關(guān)閉 pstmt。在該示例中，第一個(gè)參數(shù)被設(shè)置為 "Hi"并保持為常數(shù)。在 for 循環(huán)中，每次都將第二個(gè)參數(shù)設(shè)置為不同的值：從 0 開始，到 9 結(jié)束。

pstmt.setString(1, "Hi");
for (int i = 0; i < 10; i++) {
pstmt.setInt(2, i);
int rowCount = pstmt.executeUpdate();
}

6.1.3 IN 參數(shù)中數(shù)據(jù)類型的一致性
setXXX 方法中的 XXX 是 Java 類型。它是一種隱含的 JDBC 類型（一般 SQL 類型），因?yàn)轵?qū)動(dòng)程序?qū)?Java 類型映射為相應(yīng)的 JDBC 類型（遵循該 JDBC Guide中§8.6.2 “映射 Java 和 JDBC 類型”表中所指定的映射），并將該 JDBC 類型發(fā)送給數(shù)據(jù)庫。例如，以下代碼段將 PreparedStatement 對(duì)象 pstmt 的第二個(gè)參數(shù)設(shè)置為 44，Java 類型為 short： 

pstmt.setShort(2, 44);

驅(qū)動(dòng)程序?qū)?44 作為 JDBC SMALLINT 發(fā)送給數(shù)據(jù)庫，它是 Java short 類型的標(biāo)準(zhǔn)映射。

程序員的責(zé)任是確保將每個(gè) IN 參數(shù)的 Java 類型映射為與數(shù)據(jù)庫所需的 JDBC 數(shù)據(jù)類型兼容的 JDBC 類型。不妨考慮數(shù)據(jù)庫需要 JDBC SMALLINT 的情況。假如使用方法 setByte ，則驅(qū)動(dòng)程序?qū)?JDBC TINYINT 發(fā)送給數(shù)據(jù)庫。這是可行的，因?yàn)樵S多數(shù)據(jù)庫可從一種相關(guān)的類型轉(zhuǎn)換為另一種類型，并且通常 TINYINT 可用于 SMALLINT 適用的任何地方。然而，對(duì)于要適用于盡可能多的數(shù)據(jù)庫的應(yīng)用程序，最好使用與數(shù)據(jù)庫所需的確切的 JDBC 類型相應(yīng)的 Java 類型。假如所需的 JDBC 類型是 SMALLINT，則使用 setShort 代替 setByte 將使應(yīng)用程序的可移植性更好。