JDBC TM入門指南6--Parepared Statement (轉)

JDBC TM入門指南6--Parepared Statement (轉)[@more@]6 - PreparedStatement
本概述是從《JCTM Database Access from TM: A Tutorial and Annotated Reference 》這本書中摘引來的。JavaSoft 目前正在準備這本書。這是一本教程，同時也是 的重要參考手冊，它將作為 Java 系列的組成部份在 1997 年春季由 Addison-Wesley 出版公司出版。


6.1 概述
該 PreparedStatement 介面繼承 Statement，並與之在兩方面有所不同：


PreparedStatement 例項包含已編譯的 語句。這就是使語句“準備好”。
包含於 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);

一旦設定了給定語句的引數值，就可用它多次執行該語句，直到呼叫 clearameters 方法清除它為止。

在連線的預設下（啟用自動提交），當語句完成時將自動提交或還原該語句。

如果基本資料庫和在語句提交之後仍保持這些語句的開啟狀態，則同一個 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 Gu中§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 將使應用程式的可移植性更好。


6.1.4 使用 set
程式設計師可使用 setObject 方法顯式地將輸入引數轉換為特定的 JDBC 型別。該方法可以接受第三個引數，用來指定目標 JDBC 型別。將 Java Object 傳送給資料庫之前，驅動程式將把它轉換為指定的 JDBC 型別。

如果沒有指定 JDBC 型別，驅動程式就會將 Java Object 對映到其預設的 JDBC 型別（參見第 8.6.4 節中的表格），然後將它傳送到資料庫。這與常規的 setXXX 方法類似；在這兩種情況下，驅動程式在將值傳送到資料庫之前，會將該值的 Java 型別對映為適當的 JDBC 型別。二者的差別在於 setXXX 方法使用從 Java 型別到 JDBC 型別的標準對映（參見第 8.6.2 節中的表格），而 setObject 方法使用從 Java Object 型別到 JDBC 型別的對映（參見第 8.6.4 節中的表格）。

方法 setObject 允許接受所有 Java 物件的能力使應用程式更為通用，並可在執行時接受引數的輸入。這種情況下，應用程式在編譯時並不清楚輸入型別。透過使用 setObject，應用程式可接受所有 Java 物件型別作為輸入，並將其轉換為資料庫所需的 JDBC 型別。第 8.6.5 節中的表格顯示了 setObject 可執行的所有可能轉換。


6.1.5 將 JDBC NULL 作為 IN 引數傳送
setNull 方法允許程式設計師將 JDBC NULL 值作為 IN 引數傳送給資料庫。但要注意，仍然必須指定引數的 JDBC 型別。

當把 Java null 值傳遞給 setXXX 方法時（如果它接受 Java 物件作為引數），也將同樣把 JDBC NULL 傳送到資料庫。但僅當指定 JDBC 型別時，方法 setObject 才能接受 null 值。


6.1.6 傳送大的 IN 引數
setBytes 和 setString 方法能夠傳送無限量的資料。但是，有時程式設計師更喜歡用較小的塊傳遞大型的資料。這可透過將 IN 引數設定為 Java 輸入流來完成。當語句執行時，JDBC 驅動程式將重複呼叫該輸入流，讀取其內容並將它們當作實際引數資料傳輸。

JDBC 提供了三種將 IN 引數設定為輸入流的方法：setBinaryStream 用於含有未說明位元組的流， setAsciiStream 用於含有 ASCII 字元的流，而 setUnicodeStream 用於含有 Unicode 字元的流。因為必須指定流的總長度，所以這些方法所採用的引數比其它的 setXXX 方法要多一個。這很有必要，因為一些資料庫在傳送資料之前需要知道其總的傳送大小。

以下程式碼例示了使用流作為 IN 引數來傳送內容：

java.io.File file = new java.io.File("/tmp/data");
int fileLength = file.length();
java.io.InputStream fin = new java.io.FileInputStream(file);
java.sql.PreparedStatement pstmt = con.prepareStatement(
"UPDATE Table5 SET stuff = ? WHERE index = 4");
pstmt.setBinaryStream (1, fin, fileLength);
pstmt.executeUpdate();

當語句執行時，將反覆呼叫輸入流 fin 以傳遞其資料。