JDBCTM 指南：入門5 - ResultSet

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


5.1 概述
ResultSet 包含符合 SQL 陳述式中條件的所有行，並且它通過一套 get 方法（這些 get 方法可以訪問當前行中的不同列）提供了對這些行中資料的訪問。ResultSet.next 方法用於移動到 ResultSet 中的下一行，使下一行成為當前行。

結果集一般是一個表，其中有查詢所返回的欄位標題及相應的值。例如，如果查詢為 SELECT a, b, c FROM Table1，則結果集將具有如下形式：


a b c
-------- --------- --------
12345 Cupertino CA
83472 Redmond WA
83492 Boston MA


下面的程式碼片段是執行 SQL 陳述式的樣本。該 SQL 陳述式將返回行集合，其中列 1 為 int，列 2 為 String，而列 3 則為位元組數組：


java.sql.Statement stmt = conn.createStatement();
ResultSet r = stmt.executeQuery("SELECT a, b, c FROM Table1");
while (r.next())
{
// 列印當前行的值。
int i = r.getInt("a");
String s = r.getString("b");
float f = r.getFloat("c");
System.out.println("ROW = " + i + " " + s + " " + f);
}

5.1.1 行和游標
ResultSet 維護指向其當前資料行的游標。每調用一次 next 方法，游標向下移動一行。最初它位於第一行之前，因此第一次調用 next 將把游標置於第一行上，使它成為當前行。隨著每次調用 next 導致游標向下移動一行，按照從上至下的次序擷取 ResultSet 行。

在 ResultSet 對象或其父輩 Statement 對象關閉之前，游標一直保持有效。

在 SQL 中，結果表的游標是有名字的。如果資料庫允許定點更新或定位刪除，則需要將游標的名字作為參數提供給更新或刪除命令。可通過調用方法 getCursorName 獲得游標名。

注意：不是所有的 DBMS 都支援定點更新和刪除。可使用 DatabaseMetaData.supportsPositionedDelete 和 supportsPositionedUpdate 方法來檢查特定串連是否支援這些操作。當支援這些操作時，DBMS/驅動程式必須確保適當鎖定選定行，以使定點更新不會導致更新異常或其它並發問題。


5.1.2 列
方法 getXXX 提供了擷取當前行中某列值的途徑。在每一行內，可按任何次序擷取列值。但為了保證可移植性，應該從左至右擷取列值，並且一次性地讀取列值。

列名或列號可用於標識要從中擷取資料的列。例如，如果 ResultSet 對象 rs 的第二列名為“title”，並將值儲存為字串，則下列任一代碼將擷取儲存在該列中的值：

String s = rs.getString("title");
String s = rs.getString(2);

注意列是從左至右編號的，並且從列 1 開始。同時，用作 getXXX 方法的輸入的列名不區分大小寫。

提供使用列名這個選項的目的是為了讓在查詢中指定列名的使用者可使用相同的名字作為 getXXX 方法的參數。另一方面，如果 select 語句未指定列名（例如在“select * from table1”中或列是匯出的時），則應該使用列號。這些情況下，使用者將無法確切知道列名。

有些情況下，SQL 查詢返回的結果集中可能有多個列具有相同的名字。如果列名用作 getXXX 方法的參數，則 getXXX 將返回第一個匹配列名的值。因而，如果多個列具有相同的名字，則需要使用列索引來確保檢索了正確的列值。這時，使用列號效率要稍微高一些。

關於 ResultSet 中列的資訊，可通過調用方法 ResultSet.getMetaData 得到。返回的 ResultSetMetaData 對象將給出其 ResultSet 對象各列的編號、類型和屬性。

如果列名已知，但不知其索引，則可用方法 findColumn 得到其列號。


5.1.3 資料類型和轉換
對於 getXXX 方法，JDBC 驅動程式試圖將基本資料轉換成指定 Java 類型，然後返回適合的 Java 值。例如，如果 getXXX 方法為 getString，而基本資料庫中資料類型為 VARCHAR，則 JDBC 驅動程式將把 VARCHAR 轉換成 Java String。getString 的傳回值將為 Java String 對象。

下表顯示了允許用 getXXX 擷取的 JDBC 類型及推薦用它擷取的 JDBC 類型（通用 SQL 類型）。小寫 x 表示允許 getXXX 方法擷取該資料類型；大寫的 X 表示對該資料類型推薦使用 getXXX 方法。例如，除了 getBytes 和 getBinaryStream 之外的任何 getXXX 方法都可用來擷取 LONGVARCHAR 值，但是推薦根據返回的資料類型使用 getAsciiStream 或 getUnicodeStream 方法。方法 getObject 將任何資料類型返回為 Java Object。當基礎資料型別 (Elementary Data Type)是特定於資料庫的抽象類別型或當跨平台 app程式需要接受任何資料類型時，它是非常有用的。

可使用 ResultSet.getXXX 方法擷取常見的 JDBC 資料類型。

“x”表示該 getXXX 方法可合法地用於擷取給定 JDBC 類型。

“X”表示推薦使用該 getXXX 方法來擷取給定 JDBC 類型。

　 T
I
N
Y
I
N
T S
M
A
L
L
I
N
T I
N
T
E
G
E
R B
I
G

N
T R
E
A
L F
L
O
A
T D
O
U
B
L
E D
E
C
I
M
A
L N
U
M
E
R
I
C B
I
T C
H
A
R V
A
R
C
H
A
R
L
O
N
G
V
A
R
C
H
A
R B
I
N
A
R
Y V
A
R
B
I
N
A
R
Y L
O
N
G
V
A
R
B
I
N
A
R
Y D
A
T
E T
I
M
E T
I
M
E
S
T
A
M
P
getByte X x x x x x x x x x x x x 　 　 　 　 　 　
getShort x X x x x x x x x x x x x 　 　 　 　 　 　
getInt x x X x x x x x x x x x x 　 　 　 　 　 　
getLong x x x X x x x x x x x x x 　 　 　 　 　 　
getFloat x x x x X x x x x x x x x 　 　 　 　 　 　
getDouble x x x x x X X x x x x x x 　 　 　 　 　 　
getBigDecimal x x x x x x x X X x x x x 　 　 　 　 　 　
getBoolean x x x x x x x x x X x x x 　 　 　 　 　 　
getString x x x x x x x x x x X X x x x x x x x
getBytes 　 　 　 　 　 　 　 　 　 　 　 　 　 X X x 　 　 　
getDate 　 　 　 　 　 　 　 　 　 　 x x x 　 　 　 X 　 x
getTime 　 　 　 　 　 　 　 　 　 　 x x x 　 　 　 　 X x
getTimestamp 　 　 　 　 　 　 　 　 　 　 x x x 　 　 　 x 　 X
getAsciiStream 　 　 　 　 　 　 　 　 　 　 x x X x x x 　 　 　
getUnicodeStream 　 　 　 　 　 　 　 　 　 　 x x X x x x 　 　 　
getBinaryStream 　 　 　 　 　 　 　 　 　 　 　 　 　 x x X 　 　 　
getObject x x x x x x x x x x x x x x x x x x x



5.1.4 對非常大的行值使用流
ResultSet 可以擷取任意大的 LONGVARBINARY 或 LONGVARCHAR 資料。方法 getBytes 和 getString 將資料返回為大的塊（最大為 Statement.getMaxFieldSize 的傳回值）。但是，以較小的固定塊擷取非常大的資料可能會更方便，而這可通過讓 ResultSet 類返回 java.io.Input 流來完成。從該流中可分塊讀取資料。注意：必須立即訪問這些流，因為在下一次對 ResultSet 調用 getXXX 時它們將自動關閉（這是由於基本實現對大塊資料訪問有限制）。

JDBC API 具有三個擷取流的方法，分別具有不同的傳回值：


getBinaryStream 返回只提供資料庫原位元組而不進行任何轉換的流。


getAsciiStream 返回提供單位元組 ASCII 字元的流。


getUnicodeStream 返回提供雙位元組 Unicode 字元的流。


注意：它不同於 Java 流，後者返回無類型位元組並可（例如）通用於 ASCII 和 Unicode 字元。

下列代碼示範了 getAsciiStream 的用法：

java.sql.Statement stmt = con.createStatement();
ResultSet r = stmt.executeQuery("SELECT x FROM Table2");
// 現在以 4K 塊大小擷取列 1 結果：
byte buff = new byte[4096];
while (r.next()) {
Java.io.InputStream fin = r.getAsciiStream(1);
for (;;) {
int size = fin.read(buff);
if (size == -1) { // 到達流末尾
break;
}
// 將新填充的緩衝區發送到 ASCII 輸出資料流：
output.write(buff, 0, size);
}
}

5.1.5 NULL 結果值
要確定給定結果值是否是 JDBC NULL，必須先讀取該列，然後使用 ResultSet.wasNull 方法檢查該次讀取是否返回 JDBC NULL。

當使用 ResultSet.getXXX 方法讀取 JDBC NULL 時，方法 wasNull 將返回下列值之一：


Java null 值：對於返回 Java 對象的 getXXX 方法（例如 getString、getBigDecimal、getBytes、getDate、getTime、getTimestamp、getAsciiStream、getUnicodeStream、getBinaryStream、getObject 等）。


零值：對於 getByte、getShort、getInt、getLong、getFloat 和 getDouble。


false 值：對於 getBoolean。


5.1.6 可選結果集或多結果集
通常使用 executeQuery（它返回單個 ResultSet）或 executeUpdate（它可用於任何資料庫修改語句，並返回更新行數）可執行 SQL 陳述式。但有些情況下，應用程式在執行語句之前不知道該語句是否返回結果集。此外，有些已預存程序可能返回幾個不同的結果集和/或更新計數。

為了適應這些情況，JDBC 提供了一種機制，允許應用程式執行語句，然後處理由結果集和更新計數組成的任意集合。這種機制的原理是首先調用一個完全通用的 execute 方法，然後調用另外三個方法，getResultSet、getUpdateCount 和 getMoreResults。這些方法允許應用程式一次一個地研究語句結果，並確定給定結果是 ResultSet 還是更新計數。

使用者不必關閉 ResultSet；當產生它的 Statement 關閉、重新執行或用於從多結果序列中擷取下一個結果時，該 ResultSet 將被 Statement 自動關閉。