JDBCTM 指南：入門6 - PreparedStatement

2019-11-18 13:59:46

字體：大中小

供稿：網(wǎng)友

　　6 - 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)用程序的可移植性更好。

6.1.4 使用 setObject
程序員可使用 setObject 方法顯式地將輸入?yún)?shù)轉(zhuǎn)換為特定的 JDBC 類型。該方法可以接受第三個(gè)參數(shù)，用來指定目標(biāo) JDBC 類型。將 Java Object 發(fā)送給數(shù)據(jù)庫之前，驅(qū)動(dòng)程序?qū)阉D(zhuǎn)換為指定的 JDBC 類型。

假如沒有指定 JDBC 類型，驅(qū)動(dòng)程序就會(huì)將 Java Object 映射到其缺省的 JDBC 類型（參見第 8.6.4 節(jié)中的表格），然后將它發(fā)送到數(shù)據(jù)庫。這與常規(guī)的 setXXX 方法類似；在這兩種情況下，驅(qū)動(dòng)程序在將值發(fā)送到數(shù)據(jù)庫之前，會(huì)將該值的 Java 類型映射為適當(dāng)?shù)?JDBC 類型。二者的差別在于 setXXX 方法使用從 Java 類型到 JDBC 類型的標(biāo)準(zhǔn)映射（參見第 8.6.2 節(jié)中的表格），而 setObject 方法使用從 Java Object 類型到 JDBC 類型的映射（參見第 8.6.4 節(jié)中的表格）。

方法 setObject 答應(yīng)接受所有 Java 對(duì)象的能力使應(yīng)用程序更為通用，并可在運(yùn)行時(shí)接受參數(shù)的輸入。這種情況下，應(yīng)用程序在編譯時(shí)并不清楚輸入類型。通過使用 setObject，應(yīng)用程序可接受所有 Java 對(duì)象類型作為輸入，并將其轉(zhuǎn)換為數(shù)據(jù)庫所需的 JDBC 類型。第 8.6.5 節(jié)中的表格顯示了 setObject 可執(zhí)行的所有可能轉(zhuǎn)換。

6.1.5 將 JDBC NULL 作為 IN 參數(shù)發(fā)送
setNull 方法答應(yīng)程序員將 JDBC NULL 值作為 IN 參數(shù)發(fā)送給數(shù)據(jù)庫。但要注重，仍然必須指定參數(shù)的 JDBC 類型。

當(dāng)把 Java null 值傳遞給 setXXX 方法時(shí)（假如它接受 Java 對(duì)象作為參數(shù)），也將同樣把 JDBC NULL 發(fā)送到數(shù)據(jù)庫。但僅當(dāng)指定 JDBC 類型時(shí)，方法 setObject 才能接受 null 值。

6.1.6 發(fā)送大的 IN 參數(shù)
setBytes 和 setString 方法能夠發(fā)送無限量的數(shù)據(jù)。但是，有時(shí)程序員更喜歡用較小的塊傳遞大型的數(shù)據(jù)。這可通過將 IN 參數(shù)設(shè)置為 Java 輸入流來完成。當(dāng)語句執(zhí)行時(shí)，JDBC 驅(qū)動(dòng)程序?qū)⒅貜?fù)調(diào)用該輸入流，讀取其內(nèi)容并將它們當(dāng)作實(shí)際參數(shù)數(shù)據(jù)傳輸。

JDBC 提供了三種將 IN 參數(shù)設(shè)置為輸入流的方法：setBinaryStream 用于含有未說明字節(jié)的流， setAsciiStream 用于含有 ASCII 字符的流，而 setUnicodeStream 用于含有 Unicode 字符的流。因?yàn)楸仨氈付鞯目傞L度，所以這些方法所采用的參數(shù)比其它的 setXXX 方法要多一個(gè)。這很有必要，因?yàn)橐恍?shù)據(jù)庫在發(fā)送數(shù)據(jù)之前需要知道其總的傳送大小。

以下代碼例示了使用流作為 IN 參數(shù)來發(fā)送文件內(nèi)容：

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();

當(dāng)語句執(zhí)行時(shí)，將反復(fù)調(diào)用輸入流 fin 以傳遞其數(shù)據(jù)。

上一篇：JDBCTM 指南：入門1 - 介紹

下一篇：JDBC2.0擴(kuò)展API(2)