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。當基本數據類型是特定於數據庫的抽象類型或當通用應用程序需要接受任何數據類型時，它是非常有用的。
可使用 ResultSet.getXXX 方法獲取常見的 JDBC 數據類型。
“x”表示該 getXXX 方法可合法地用於獲取給定 JDBC 類型。
“X”表示推薦使用該 getXXX 方法來獲取給定 JDBC 類型。
T
I
Y
I
T S
M
A
L
L
I
T I
T
E
G
E
R B
I
G
N
T R
E
A
L F
L
O
A
T D
O
U
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
G
V
A
R
C
H
A
R B
I
A
R
Y V
A
R
I
A
R
Y L
O
G
V
A
R
I
A
R
Y D
A
T
E T
I
M
E T
I
M
E
T
A
M
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 自動關閉。
