5 - resultset
本概述是從《jdbctm database access from javatm: a tutorial and annotated reference 》這本書中摘引來的。javasoft 目前正在準備這本書。這是一本教程，同時也是 jdbc 的重要參考手冊，它將作為 java 系列的組成部份在 1997 年春季由 addison-wesley 出版公司出版。


5.1 概述
resultset 包含符合 sql 語句中條件的所有行，并且它通過一套 get 方法（這些 get 方法可以訪問當前行中的不同列）提供了對這些行中數(shù)據(jù)的訪問。resultset.next 方法用于移動到 resultset 中的下一行，使下一行成為當前行。

結(jié)果集一般是一個表，其中有查詢所返回的列標題及相應的值。例如，如果查詢?yōu)?select a, b, c from table1，則結(jié)果集將具有如下形式：


a b c
-------- --------- --------
12345 cupertino ca
83472 redmond wa
83492 boston ma


下面的代碼段是執(zhí)行 sql 語句的示例。該 sql 語句將返回行集合，其中列 1 為 int，列 2 為 string，而列 3 則為字節(jié)數(shù)組：


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 維護指向其當前數(shù)據(jù)行的光標。每調(diào)用一次 next 方法，光標向下移動一行。最初它位于第一行之前，因此第一次調(diào)用 next 將把光標置于第一行上，使它成為當前行。隨著每次調(diào)用 next 導致光標向下移動一行，按照從上至下的次序獲取 resultset 行。

在 resultset 對象或其父輩 statement 對象關(guān)閉之前，光標一直保持有效。

在 sql 中，結(jié)果表的光標是有名字的。如果數(shù)據(jù)庫允許定位更新或定位刪除，則需要將光標的名字作為參數(shù)提供給更新或刪除命令。可通過調(diào)用方法 getcursorname 獲得光標名。

注意：不是所有的 dbms 都支持定位更新和刪除。可使用 databasemetadata.supportspositioneddelete 和 supportspositionedupdate 方法來檢查特定連接是否支持這些操作。當支持這些操作時，dbms/驅(qū)動程序必須確保適當鎖定選定行，以使定位更新不會導致更新異常或其它并發(fā)問題。


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

列名或列號可用于標識要從中獲取數(shù)據(jù)的列。例如，如果 resultset 對象 rs 的第二列名為“title”，并將值存儲為字符串，則下列任一代碼將獲取存儲在該列中的值：

string s = rs.getstring("title");
string s = rs.getstring(2);

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

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

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

關(guān)于 resultset 中列的信息，可通過調(diào)用方法 resultset.getmetadata 得到。返回的 resultsetmetadata 對象將給出其 resultset 對象各列的編號、類型和屬性。

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


5.1.3 數(shù)據(jù)類型和轉(zhuǎn)換
對于 getxxx 方法，jdbc 驅(qū)動程序試圖將基本數(shù)據(jù)轉(zhuǎn)換成指定 java 類型，然后返回適合的 java 值。例如，如果 getxxx 方法為 getstring，而基本數(shù)據(jù)庫中數(shù)據(jù)類型為 varchar，則 jdbc 驅(qū)動程序?qū)?varchar 轉(zhuǎn)換成 java string。getstring 的返回值將為 java string 對象。

下表顯示了允許用 getxxx 獲取的 jdbc 類型及推薦用它獲取的 jdbc 類型（通用 sql 類型）。小寫的 x 表示允許 getxxx 方法獲取該數(shù)據(jù)類型；大寫的 x 表示對該數(shù)據(jù)類型推薦使用 getxxx 方法。例如，除了 getbytes 和 getbinarystream 之外的任何 getxxx 方法都可用來獲取 longvarchar 值，但是推薦根據(jù)返回的數(shù)據(jù)類型使用 getasciistream 或 getunicodestream 方法。方法 getobject 將任何數(shù)據(jù)類型返回為 java object。當基本數(shù)據(jù)類型是特定于數(shù)據(jù)庫的抽象類型或當通用應用程序需要接受任何數(shù)據(jù)類型時，它是非常有用的。

可使用 resultset.getxxx 方法獲取常見的 jdbc 數(shù)據(jù)類型。

“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 數(shù)據(jù)。方法 getbytes 和 getstring 將數(shù)據(jù)返回為大的塊（最大為 statement.getmaxfieldsize 的返回值）。但是，以較小的固定塊獲取非常大的數(shù)據(jù)可能會更方便，而這可通過讓 resultset 類返回 java.io.input 流來完成。從該流中可分塊讀取數(shù)據(jù)。注意：必須立即訪問這些流，因為在下一次對 resultset 調(diào)用 getxxx 時它們將自動關(guān)閉（這是由于基本實現(xiàn)對大塊數(shù)據(jù)訪問有限制）。

jdbc api 具有三個獲取流的方法，分別具有不同的返回值：


getbinarystream 返回只提供數(shù)據(jù)庫原字節(jié)而不進行任何轉(zhuǎn)換的流。


getasciistream 返回提供單字節(jié) ascii 字符的流。


getunicodestream 返回提供雙字節(jié) unicode 字符的流。


注意：它不同于 java 流，后者返回無類型字節(jié)并可（例如）通用于 ascii 和 unicode 字符。

下列代碼演示了 getasciistream 的用法：

java.sql.statement stmt = con.createstatement();
resultset r = stmt.executequery("select x from table2");
// 現(xiàn)在以 4k 塊大小獲取列 1 結(jié)果：
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;
}
// 將新填充的緩沖區(qū)發(fā)送到 ascii 輸出流：
output.write(buff, 0, size);
}
}

5.1.5 null 結(jié)果值
要確定給定結(jié)果值是否是 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 可選結(jié)果集或多結(jié)果集
通常使用 executequery（它返回單個 resultset）或 executeupdate（它可用于任何數(shù)據(jù)庫修改語句，并返回更新行數(shù)）可執(zhí)行 sql 語句。但有些情況下，應用程序在執(zhí)行語句之前不知道該語句是否返回結(jié)果集。此外，有些已存儲過程可能返回幾個不同的結(jié)果集和/或更新計數(shù)。

為了適應這些情況，jdbc 提供了一種機制，允許應用程序執(zhí)行語句，然后處理由結(jié)果集和更新計數(shù)組成的任意集合。這種機制的原理是首先調(diào)用一個完全通用的 execute 方法，然后調(diào)用另外三個方法，getresultset、getupdatecount 和 getmoreresults。這些方法允許應用程序一次一個地研究語句結(jié)果，并確定給定結(jié)果是 resultset 還是更新計數(shù)。

用戶不必關(guān)閉 resultset；當產(chǎn)生它的 statement 關(guān)閉、重新執(zhí)行或用于從多結(jié)果序列中獲取下一個結(jié)果時，該 resultset 將被 statement 自動關(guān)閉。