JDBC系列教程（五）---預備語句

PReparedStatement

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

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

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

由于 PreparedStatement 對象已預編譯過，所以其執行速度要快于 Statement 對象。因此，多次執行的 SQL 語句經常創建為 PreparedStatement 對象，以提高效率。

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

6.1.1 創建 PreparedStatement 對象
以下的代碼段（其中 con 是 Connection 對象）創建包含帶兩個 IN 參數占位符的 SQL 語句的 PreparedStatement 對象： 

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

pstmt 對象包含語句 "UPDATE table4 SET m = ? WHERE x = ?"，它已發送給 DBMS，并為執行作好了預備。

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

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

一旦設置了給定語句的參數值，就可用它多次執行該語句，直到調用 clearParameters 方法清除它為止。

在連接的缺省模式下（啟用自動提交），當語句完成時將自動提交或還原該語句。

假如基本數據庫和驅動程序在語句提交之后仍保持這些語句的打開狀態，則同一個 PreparedStatement 可執行多次。假如這一點不成立，那么試圖通過使用 PreparedStatement 對象代替 Statement 對象來提高性能是沒有意義的。

利用 pstmt（前面創建的 PreparedStatement 對象），以下代碼例示了如何設置兩個參數占位符的值并執行 pstmt 10 次。如上所述，為做到這一點，數據庫不能關閉 pstmt。在該示例中，第一個參數被設置為 "Hi"并保持為常數。在 for 循環中，每次都將第二個參數設置為不同的值：從 0 開始，到 9 結束。

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

6.1.3 IN 參數中數據類型的一致性
setXXX 方法中的 XXX 是 Java 類型。它是一種隱含的 JDBC 類型（一般 SQL 類型），因為驅動程序將把 Java 類型映射為相應的 JDBC 類型（遵循該 JDBC Guide中§8.6.2 “映射 Java 和 JDBC 類型”表中所指定的映射），并將該 JDBC 類型發送給數據庫。例如，以下代碼段將 PreparedStatement 對象 pstmt 的第二個參數設置為 44，Java 類型為 short： 

pstmt.setShort(2, 44);

驅動程序將 44 作為 JDBC SMALLINT 發送給數據庫，它是 Java short 類型的標準映射。

程序員的責任是確保將每個 IN 參數的 Java 類型映射為與數據庫所需的 JDBC 數據類型兼容的 JDBC 類型。不妨考慮數據庫需要 JDBC SMALLINT 的情況。假如使用方法 setByte ，則驅動程序將 JDBC TINYINT 發送給數據庫。這是可行的，因為許多數據庫可從一種相關的類型轉換為另一種類型，并且通常 TINYINT 可用于 SMALLINT 適用的任何地方。然而，對于要適用于盡可能多的數據庫的應用程序，最好使用與數據庫所需的確切的 JDBC 類型相應的 Java 類型。假如所需的 JDBC 類型是 SMALLINT，則使用 setShort 代替 setByte 將使應用程序的可移植性更好。