ResultSet 提供了通過執(zhí)行一條語句訪問所生成的數(shù)據(jù)表的功能。按順序獲取表中的行。在一行內(nèi)它的列值可以以任意順序訪問。
ResultSet 控制一個(gè)指向當(dāng)前數(shù)據(jù)行的游標(biāo)。初始,游標(biāo)定位于第一行之前。用 'next' 方法可把游標(biāo)移到下一行。
getXXX 方法獲取當(dāng)前行的列值??赏ㄟ^使用列的索引或名字來獲取值。通常使用列索引會(huì)更有效。列索引從 1 開始。
最大概率下,每行的 ResultSet 列應(yīng)按照從左到右的順序獲取,并且每列只讀一次。
對(duì) getXXX 方法,JDBC 驅(qū)動(dòng)程序試圖把基礎(chǔ)數(shù)據(jù)轉(zhuǎn)換為指定的 Java 類型并返回一個(gè)合適的 Java 值。參見關(guān)于使用 ResultSet.getXXX 方法從 SQL 類型到 Java 類型進(jìn)行映射的 JDBC 規(guī)范。
輸入到 getXXX 方法的列名是大小寫敏感的。當(dāng)使用列名執(zhí)行一個(gè) getXXX 方法時(shí),如果幾個(gè)列有同樣的名字,則返回第一個(gè)匹配的列。當(dāng)列名用于 SQL 查詢時(shí),指定使用列名選項(xiàng)。對(duì)在查詢中沒有明確命名的列,最好使用列編號(hào)。如果使用列名,則無法對(duì)編程者保證他們實(shí)際使用了所想要的列。
ResultSet 由生成它的語句自動(dòng)關(guān)閉、再執(zhí)行或從多個(gè)結(jié)果的序列中獲取下一個(gè)結(jié)果。
ResultSet 列的編號(hào)、類型和特性由 getMetaData 方法返回的 ResulSetMetaData 對(duì)象提供。
接口 java.sql.ResultSet
- public interface ResultSet
- 參見:
- executeQuery, getResultSet, ResultSetMetaData
方法索引
- clearWarnings()
- 此調(diào)用完成之后,getWarnings 返回 null 直到為該 ResultSet 報(bào)告了一個(gè)新的警告為止。
- close()
- 在很多情況下,在語句自動(dòng)關(guān)閉時(shí)立即釋放該語句的數(shù)據(jù)庫(kù)和 JDBC
資源是需要的;close 方法既就是這種立即釋放的方法。
- findColumn(String)
- 映射一個(gè) Resultset 列名到 ResultSet 列索引號(hào)。
- getAsciiStream(int)
- 把列值作為一個(gè) ASCII 字符流獲取,然后成批地從流中讀出。
- getAsciiStream(String)
- 把列值作為一個(gè) ASCII 字符流獲取,然后成批地從流中讀出。
- getBigDecimal(int, int)
- 把當(dāng)前行的列值作為 java.lang.BigDecimal 對(duì)象獲取。
- getBigDecimal(String, int)
- 把當(dāng)前行的列值作為 java.lang.BigDecimal 對(duì)象獲取。
- getBinaryStream(int)
- 把列值作為一個(gè)未解釋的字節(jié)流來獲取,然后再?gòu)牧髦谐膳x出。
- getBinaryStream(String)
- 把列值作為一個(gè)未解釋的字節(jié)流來獲取,然后再?gòu)牧髦谐膳x出。
- getBoolean(int)
- 把當(dāng)前行的列值作為一個(gè) Java boolean 獲取。
- getBoolean(String)
- 把當(dāng)前行的列值作為一個(gè) Java boolean 獲取。
- getByte(int)
- 把當(dāng)前行的列值作為一個(gè) Java byte 獲取。
- getByte(String)
- 把當(dāng)前行的列值作為一個(gè) Java byte 獲取。
- getBytes(int)
- 把當(dāng)前行的列值作為一個(gè) Java byte 數(shù)組獲取。
- getBytes(String)
- 把當(dāng)前行的列值作為一個(gè) Java byte 數(shù)組獲取。
- getCursorName()
- 獲取 ResultSet 的 SQL 游標(biāo)名。
- getDate(int)
- 把當(dāng)前行的列值作為一個(gè) java.sql.Date 對(duì)象獲取。
- getDate(String)
- 把當(dāng)前行的列值作為一個(gè) java.sql.Date 對(duì)象獲取。
- getDouble(int)
- 把當(dāng)前行的列值作為一個(gè) Java double 獲取。
- getDouble(String)
- 把當(dāng)前行的列值作為一個(gè) Java double 獲取。
- getFloat(int)
- 把當(dāng)前行的列值作為一個(gè) Java float 獲取。
- getFloat(String)
- 把當(dāng)前行的列值作為一個(gè) Java float 獲取。
- getInt(int)
- 把當(dāng)前行的列值作為一個(gè) Java int 獲取。
- getInt(String)
- 把當(dāng)前行的列值作為一個(gè) Java int 獲取。
- getLong(int)
- 把當(dāng)前行的列值作為一個(gè) Java long 獲取。
- getLong(String)
- 把當(dāng)前行的列值作為一個(gè) Java long 獲取。
- getMetaData()
- ResultSet 的列編號(hào)、類型和特性由 getMetaData 方法提供。
- getObject(int)
- 把當(dāng)前行的列值作為一個(gè) Java 對(duì)象獲取。
- getObject(String)
- 把當(dāng)前行的列值作為一個(gè) Java 對(duì)象獲取。
- getShort(int)
- 把當(dāng)前行的列值作為一個(gè) Java short 獲取。
- getShort(String)
- 把當(dāng)前行的列值作為一個(gè) Java short 獲取。
- getString(int)
- 把當(dāng)前行的列值作為一個(gè) Java String 獲取。
- getString(String)
- 把當(dāng)前行的列值作為一個(gè) Java String 獲取。
- getTime(int)
- 把當(dāng)前行的列值作為一個(gè) java.sql.Time 對(duì)象獲取。
- getTime(String)
- 把當(dāng)前行的列值作為一個(gè) java.sql.Time 對(duì)象獲取。
- getTimestamp(int)
- 把當(dāng)前行的列值作為一個(gè) java.sql.Timestamp 對(duì)象獲取。
- getTimestamp(String)
- 把當(dāng)前行的列值作為一個(gè) java.sql.Timestamp 對(duì)象獲取。
- getUnicodeStream(int)
- 列值可作為一個(gè) Unicode 字符流來獲取,然后從流中成批讀出。
- getUnicodeStream(String)
- 列值可作為一個(gè) Unicode 字符流來獲取,然后從流中成批讀出。
- getWarnings()
- 返回在這個(gè) ResultSet 上的調(diào)用報(bào)告的第一個(gè)警告。
- next()
- ResultSet 初始定位于它的第一行之前;對(duì) next 的第一個(gè)調(diào)用使得第一行成為當(dāng)前行;第二個(gè)調(diào)用使得第二行成為當(dāng)前行,等等。
- wasNull()
- 列可能有值 SQL NULL ;wasNull 報(bào)告是否所讀的最后一列有這個(gè)特殊的值。
方法
next
public abstract boolean next() throws SQLException
- ResultSet 初始定位于它的第一行之前;對(duì) next 的第一個(gè)調(diào)用使得第一行成為當(dāng)前行;第二個(gè)調(diào)用使得第二行成為當(dāng)前行,等等。
如果來自先前行的輸入流是打開的,則它被隱含地關(guān)閉。當(dāng)讀一個(gè)新行時(shí),ResultSet 的警告鏈被清除。
- 返回值:
- 如果當(dāng)前行有效,返回 true ;如果沒有更多的行則返回 false
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
close
public abstract void close() throws SQLException
- 在多情況下,在語句自動(dòng)關(guān)閉時(shí)立即釋放該語句的數(shù)據(jù)庫(kù)和 JDBC 資源是需要的;close 方法提供了這種立即釋放方法。
注意: ResultSet 由生成它的語句自動(dòng)關(guān)閉、再執(zhí)行或用于從多個(gè)結(jié)果的序列中獲取下一個(gè)結(jié)果。
ResultSet 被垃圾箱收集時(shí)也自動(dòng)關(guān)閉。
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
wasNull
public abstract boolean wasNull() throws SQLException
- 列可能有值 SQL NULL ;wasNull 報(bào)告是否讀的最后一列有這個(gè)特殊的值。
注意,您必須先對(duì)列調(diào)用 getXXX 方法來盡量讀它的值并調(diào)用 wasNull() 方法來查找值是否為 SQL NULL 。
- 返回值:
- 如果讀的最后列為 SQL NULL 返回 true
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getString
public abstract String getString(int columnIndex) throws SQLException
- 把當(dāng)前行的列值作為一個(gè) Java String 獲取。
- 參數(shù):
- columnIndex - 第一個(gè)列是 1, 第二個(gè)列是 2, ...
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 null
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getBoolean
public abstract boolean getBoolean(int columnIndex) throws SQLException
- 把當(dāng)前行的列值作為一個(gè) Java boolean 獲取。
- 參數(shù):
- columnIndex - 第一個(gè)列是 1, 第二個(gè)列是 2, ...
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 false
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getByte
public abstract byte getByte(int columnIndex) throws SQLException
- 把當(dāng)前行的列值作為一個(gè) Java byte 獲取。
- 參數(shù):
- columnIndex - 第一個(gè)列是 1, 第二個(gè)列是 2, ...
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 0
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getShort
public abstract short getShort(int columnIndex) throws SQLException
- 把當(dāng)前行的列值作為一個(gè) Java short 獲取。
- 參數(shù):
- columnIndex - 第一個(gè)列是 1, 第二個(gè)列是 2, ...
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 0
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getInt
public abstract int getInt(int columnIndex) throws SQLException
- 把當(dāng)前行的列值作為 Java int 獲取。
- 參數(shù):
- columnIndex - 第一個(gè)列是 1, 第二個(gè)列是 2, ...
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 0
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getLong
public abstract long getLong(int columnIndex) throws SQLException
- 把當(dāng)前行的列值作為 Java long 獲取。
- 參數(shù):
- columnIndex - 第一個(gè)列是 1, 第二個(gè)列是 2, ...
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 0
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getFloat
public abstract float getFloat(int columnIndex) throws SQLException
- 把當(dāng)前行的列值作為 Java float 獲取。
- 參數(shù):
- columnIndex - 第一個(gè)列是 1, 第二個(gè)列是 2, ...
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 0
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getDouble
public abstract double getDouble(int columnIndex) throws SQLException
- 把當(dāng)前行的列值作為 Java double 獲取。
- 參數(shù):
- columnIndex - 第一個(gè)列是 1, 第二個(gè)列是 2, ...
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 0
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getBigDecimal
public abstract BigDecimal getBigDecimal(int columnIndex,
int scale) throws SQLException
- 獲取當(dāng)前行的列值作為 java.lang.BigDecimal 對(duì)象。
- 參數(shù):
- columnIndex - 第一個(gè)列是 1, 第二個(gè)列是 2, ...
- scale - 小數(shù)點(diǎn)右邊的數(shù)字?jǐn)?shù)目
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 null
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getBytes
public abstract byte[] getBytes(int columnIndex) throws SQLException
- 把當(dāng)前行的列值作為一個(gè) Java byte 數(shù)組獲取。
字節(jié)描述了驅(qū)動(dòng)程序返回的未加工的值。
- 參數(shù):
- columnIndex - 第一個(gè)列是 1, 第二個(gè)列是 2, ...
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 null
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getDate
public abstract Date getDate(int columnIndex) throws SQLException
- 把當(dāng)前行的列值作為一個(gè) java.sql.Date 對(duì)象獲取。
- 參數(shù):
- columnIndex - 第一個(gè)列是 1, 第二個(gè)列是 2, ...
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 null
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getTime
public abstract Time getTime(int columnIndex) throws SQLException
- 把當(dāng)前行的列值作為 java.sql.Time 對(duì)象獲取。
- 參數(shù):
- columnIndex - 第一個(gè)列是 1, 第二個(gè)列是 2, ...
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 null
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getTimestamp
public abstract Timestamp getTimestamp(int columnIndex) throws SQLException
- 把當(dāng)前行的列值作為 java.sql.Timestamp 對(duì)象獲取。
- 參數(shù):
- columnIndex - 第一個(gè)列是 1, 第二個(gè)列是 2, ...
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 null
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getAsciiStream
public abstract InputStream getAsciiStream(int columnIndex) throws SQLException
- 列值可作為 ASCII 字符流獲取,然后成批從流中讀出。 該方法特別適合于獲取大的 LONGVARCHAR 值。
JDBC 驅(qū)動(dòng)程序?qū)⒆鰪臄?shù)據(jù)庫(kù)格式到 ASCII 的任何必要的轉(zhuǎn)換。
注意: 返回流的所有數(shù)據(jù)必須在獲取任何其它列的值之前先讀。下一個(gè)對(duì) get 方法的調(diào)用隱含地關(guān)閉了流。. 而且,一個(gè)流可能為 available() 方法返回 0 ,不管數(shù)據(jù)是否可用。
- 參數(shù):
- columnIndex - 第一個(gè)列是 1, 第二個(gè)列是 2, ...
- 返回值:
- 把數(shù)據(jù)庫(kù)列值作為單字節(jié)的 ASCII 字符流釋放的 Java 輸入流。如果值是 SQL NULL 則結(jié)果是 null。
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getUnicodeStream
public abstract InputStream getUnicodeStream(int columnIndex) throws SQLException
- 列值可作為一個(gè) Unicode 字符流來獲取,然后從流中成批讀出。該方法特別適用于獲取大的 LONGVARCHAR 值。
JDBC 驅(qū)動(dòng)程序?qū)⒆鰪臄?shù)據(jù)庫(kù)格式到 Unicode 的任何必要的轉(zhuǎn)換。
注意: 返回流的所有數(shù)據(jù)必須在獲取任何其它列的值之前先讀。下一個(gè)對(duì) get 方法的調(diào)用隱含地關(guān)閉了流。. 而且,一個(gè)流可能為 available() 方法返回 0 ,不管數(shù)據(jù)是否可用。
- 參數(shù):
- columnIndex - 第一個(gè)列是 1, 第二個(gè)列是 2, ...
- 返回值:
- 把數(shù)據(jù)庫(kù)列值作為一個(gè)兩字節(jié)的 Unicode 字符流釋放的 Java 輸入流。 如果值是 SQL NULL 則結(jié)果是 null。
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getBinaryStream
public abstract InputStream getBinaryStream(int columnIndex) throws SQLException
- 列值可作為一個(gè)未解釋的字節(jié)流來獲取,然后從流中成批讀出。該方法特別適用于獲取大的 LONGVARBINARY 值。
注意: 返回流的所有數(shù)據(jù)必須在獲取任何其它列的值之前先讀。下一個(gè)對(duì) get 方法的調(diào)用隱含地關(guān)閉了流。而且,一個(gè)流可能為 available() 方法返回 0 ,不管數(shù)據(jù)是否可用。
- 參數(shù):
- columnIndex - 第一個(gè)列是 1, 第二個(gè)列是 2, ...
- 返回值:
- 把數(shù)據(jù)庫(kù)列值作為一個(gè)未解釋的字節(jié)流釋放的 Java 輸入流。如果值是 SQL NULL 則結(jié)果是 null。
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getString
public abstract String getString(String columnName) throws SQLException
- 獲取當(dāng)前行的列值作為一個(gè) Java String 。
- 參數(shù):
- columnName - 列的 SQL 名
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 null
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getBoolean
public abstract boolean getBoolean(String columnName) throws SQLException
- 把當(dāng)前行的列值作為 Java boolean 獲取。
- 參數(shù):
- columnName - 列的 SQL 名
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 false
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getByte
public abstract byte getByte(String columnName) throws SQLException
- 把當(dāng)前行的列值作為 Java byte 獲取。
- 參數(shù):
- columnName - 列的 SQL 名
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 0
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getShort
public abstract short getShort(String columnName) throws SQLException
- 把當(dāng)前行的列值作為 Java short 獲取。
- 參數(shù):
- columnName - 列的 SQL 名
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 0
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getInt
public abstract int getInt(String columnName) throws SQLException
- 把當(dāng)前行的列值作為 Java int 獲取。
- 參數(shù):
- columnName - 列的 SQL 名
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 0
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getLong
public abstract long getLong(String columnName) throws SQLException
- 把當(dāng)前行的列值作為 Java long 獲取。
- 參數(shù):
- columnName - 列的 SQL 名
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 0
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getFloat
public abstract float getFloat(String columnName) throws SQLException
- 把當(dāng)前行的列值作為 Java float 獲取。
- 參數(shù):
- columnName - 列的 SQL 名
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 0
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getDouble
public abstract double getDouble(String columnName) throws SQLException
- 把當(dāng)前行的列值作為 Java double 獲取。
- 參數(shù):
- columnName - 列的 SQL 名
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 0
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getBigDecimal
public abstract BigDecimal getBigDecimal(String columnName,
int scale) throws SQLException
- 把當(dāng)前行的列值作為 java.lang.BigDecimal 對(duì)象獲取。
- 參數(shù):
- columnName - 列的 SQL 名
- scale - 小數(shù)點(diǎn)右邊的數(shù)字?jǐn)?shù)目
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 null
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getBytes
public abstract byte[] getBytes(String columnName) throws SQLException
- 把當(dāng)前行的列值作為 Java byte 數(shù)組獲取。
字節(jié)描述了驅(qū)動(dòng)程序返回的未加工的值。
- 參數(shù):
- columnName - 列的 SQL 名
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 null
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getDate
public abstract Date getDate(String columnName) throws SQLException
- 把當(dāng)前行的列值作為一個(gè) java.sql.Date 對(duì)象獲取。
- 參數(shù):
- columnName - 列的 SQL 名
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 null
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getTime
public abstract Time getTime(String columnName) throws SQLException
- 把當(dāng)前行的列值作為 java.sql.Time 對(duì)象獲取。
- 參數(shù):
- columnName - 列的 SQL 名
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 null
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getTimestamp
public abstract Timestamp getTimestamp(String columnName) throws SQLException
- 把當(dāng)前行的列值作為 java.sql.Timestamp 對(duì)象獲取。
- 參數(shù):
- columnName - 列的 SQL 名
- 返回值:
- 列值;如果值是 SQL NULL, 結(jié)果為 null
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getAsciiStream
public abstract InputStream getAsciiStream(String columnName) throws SQLException
- 列值可作為 ASCII 字符流獲取,然后從流中讀入到塊中。 該方法特別適合于獲取大的 LONGVARCHAR 值。
JDBC 驅(qū)動(dòng)程序?qū)⒆鰪臄?shù)據(jù)庫(kù)格式到 ASCII 的任何必要的轉(zhuǎn)換。
注意: 返回流的所有數(shù)據(jù)必須在獲取任何其它列的值之前先讀。下一個(gè)對(duì) get 方法的調(diào)用隱含地關(guān)閉了流。
- 參數(shù):
- columnName - 列的 SQL 名
- 返回值:
- 把數(shù)據(jù)庫(kù)列值作為一個(gè)一字節(jié)的 ASCII 字符流釋放的 Java 輸入流。如果值是 SQL NULL 則結(jié)果是 null。
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getUnicodeStream
public abstract InputStream getUnicodeStream(String columnName) throws SQLException
- 列值可作為一個(gè) Unicode 字符流來獲取,然后從流中成批讀出。 該方法特別適用于獲取大的 LONGVARCHAR 值。
JDBC 驅(qū)動(dòng)程序?qū)⒆鰪臄?shù)據(jù)庫(kù)格式到 Unicode 的任何必要的轉(zhuǎn)換。
注意: 返回流的所有數(shù)據(jù)必須在獲取任何其它列的值之前先讀。下一個(gè)對(duì) get 方法的調(diào)用隱含地關(guān)閉了流。
- 參數(shù):
- columnName - 列的 SQL 名
- 返回值:
- 把數(shù)據(jù)庫(kù)列值作為一個(gè)兩字節(jié)的 Unicode 字符流釋放的 Java 輸入流。 如果值是 SQL NULL 則結(jié)果是 null。
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getBinaryStream
public abstract InputStream getBinaryStream(String columnName) throws SQLException
- 列值可作為一個(gè)未解釋的字節(jié)流來獲取,然后從流中成批讀出。該方法特別適用于獲取大的 LONGVARBINARY 值。
注意: 返回流的所有數(shù)據(jù)必須在獲取任何其它列的值之前先讀。下一個(gè)對(duì) get 方法的調(diào)用隱含地關(guān)閉了流。
- 參數(shù):
- columnName - 列的 SQL 名
- 返回值:
- 把數(shù)據(jù)庫(kù)列值作為一個(gè)未解釋字節(jié)流釋放的 Java 輸入流。 如果值是 SQL NULL 則結(jié)果是 null。
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getWarnings
public abstract SQLWarning getWarnings() throws SQLException
-
返回由在這個(gè) ResultSet 上的調(diào)用報(bào)告的第一個(gè)警告。后繼的 ResultSet 警告將被鏈接到這個(gè) SQLWarning 上。
每次讀一個(gè)新行時(shí),警告鏈被自動(dòng)清除。
注意: 該警告鏈僅包含了由 ResultSet 方法引起的警告。由語句方法(如讀 OUT 參數(shù))引起的任何警告將被鏈接到語句對(duì)象上。
- 返回值:
- 第一個(gè) SQLWarning 或 null
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
clearWarnings
public abstract void clearWarnings() throws SQLException
- 此調(diào)用完成之后,getWarnings 返回 null 直到為該 ResultSet 報(bào)告了一個(gè)新的警告為止。
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getCursorName
public abstract String getCursorName() throws SQLException
- 獲取 ResultSet 的 SQL 游標(biāo)名。
在 SQL 中, 一個(gè)結(jié)果表可以通過命名的游標(biāo)來讀取。結(jié)果的當(dāng)前行可通過使用引用游標(biāo)名的已經(jīng)定位的更新/刪除語句來更新或刪除。
JDBC 通過提供 ResultSet 使用的 SQL 游標(biāo)名支持這個(gè) SQL 特征。
ResultSet 的當(dāng)前行也是這個(gè) SQL 游標(biāo)的當(dāng)前行。
注意: 如果不支持定位的更新,則拋出 SQLException
- 返回值:
- ResultSet 的 SQL 游標(biāo)名
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getMetaData
public abstract ResultSetMetaData getMetaData() throws SQLException
- ResultSet 的列編號(hào)、類型和特性由 getMetaData 方法提供。
- 返回值:
- ResultSet 的列的描述
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getObject
public abstract Object getObject(int columnIndex) throws SQLException
-
獲取當(dāng)前行的列值作為一個(gè) Java 對(duì)象 。
該方法將返回給定的列的值作為一個(gè) Java 對(duì)象。Java 對(duì)象的類型將是對(duì)應(yīng)于列的 SQL 類型的缺省的 Java 對(duì)象類型,依附于 JDBC spec 中指定的映射。
該方法也可用于讀特定于數(shù)據(jù)庫(kù)的抽象數(shù)據(jù)類型。
- 參數(shù):
- columnIndex - 第一個(gè)列是 1, 第二個(gè)列是 2, ...
- 返回值:
- 保持列值的 java.lang.Object 。
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
getObject
public abstract Object getObject(String columnName) throws SQLException
-
把當(dāng)前行的列值作為 Java 對(duì)象獲取。
該方法將返回給定的列的值作為一個(gè) Java 對(duì)象。Java 對(duì)象的類型將是對(duì)應(yīng)于列的 SQL 類型的缺省的 Java 對(duì)象類型,依附于 JDBC spec 中指定的映射。
該方法也可用于讀特定于數(shù)據(jù)庫(kù)的抽象數(shù)據(jù)類型。
- 參數(shù):
- columnName - 列的 SQL 名
- 返回值:
- 保持列值的 java.lang.Object 。
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。
findColumn
public abstract int findColumn(String columnName) throws SQLException
- 映射一個(gè) Resultset 列名到 ResultSet 列號(hào)。
- 參數(shù):
- columnName - 列名
- 返回值:
- 列索引
- 拋出:
SQLException
- 如果發(fā)生了數(shù)據(jù)訪問錯(cuò)誤。