您的位置：首页 > 编程语言 > Java开发

java.sql.resultset方法与使用技巧

2013-05-26 09:27 417 查看

原网址

接口ResultSet

publicinterfaceResultSet

表示数据库结果集的数据表，通常通过执行查询数据库的语句生成。

ResultSet

对象具有指向其当前数据行的指针。最初，指针被置于第一行之前。

next

方法将指针移动到下一行；因为该方法在

ResultSet

对象中没有下一行时返回

false

，所以可以在

while

循环中使用它来迭代结果集。

默认的

ResultSet

对象不可更新，仅有一个向前移动的指针。因此，只能迭代它一次，并且只能按从第一行到最后一行的顺序进行。可以生成可滚动和/或可更新的

ResultSet

对象。以下代码片段（其中

con

为有效的

Connection

对象）演示了如何生成可滚动且不受其他更新影响的、可更新的结果集。请参阅

ResultSet

字段以了解其他选项。

Statementstmt=con.createStatement(
ResultSet.TYPE_SCROLL_INSENSITIVE,
ResultSet.CONCUR_UPDATABLE);
ResultSetrs=stmt.executeQuery("SELECTa,bFROMTABLE2");
//rswillbescrollable,willnotshowchangesmadebyothers,
//andwillbeupdatable

ResultSet

接口提供用于从当前行检索列值的获取方法（

getBoolean

、

getLong

等）。可以使用列的索引编号或列的名称检索值。一般情况下，使用列索引较为高效。列从1开始编号。为了获得最大的可移植性，应该按从左到右的顺序读取每行中的结果集列，而且每列只能读取一次。
对于获取方法，JDBC驱动程序尝试将基础数据转换为在获取方法中指定的Java类型，并返回适当的Java值。JDBC规范有一个表，显示允许的从SQL类型到供

ResultSet

获取方法使用的Java类型的映射关系。

用作获取方法的输入的列名称不区分大小写。用列名称调用获取方法时，如果多个列具有这一名称，则返回第一个匹配列的值。列名称选项在生成结果集的SQL查询中使用列名称时使用。对于没有在查询中显式命名的列，最好使用列编号。如果使用列名称，程序员无法保证名称实际所指的就是预期的列。

在JDBC2.0API(JDK1.2)中，此接口添加了一组更新方法。关于获取方法参数的注释同样适用于更新方法的参数。

可以用以下两种方式使用更新方法：

更新当前行中的列值。在可滚动的

ResultSet

对象中，可以向前和向后移动指针，将其置于绝对位置或相对于当前行的位置。以下代码片段更新

ResultSet

对象

rs

的第五行中的

NAME

列，然后使用方法

updateRow

更新用于派生

rs

的数据源表。

rs.absolute(5);//movesthecursortothefifthrowofrs
rs.updateString("NAME","AINSWORTH");//updatesthe
//[code]NAME

columnofrow5tobe

AINSWORTH

rs.updateRow();//updatestherowinthedatasource

[/code]

将列值插入到插入行中。可更新的

ResultSet

对象具有一个与其关联的特殊行，该行用作构建要插入的行的暂存区域(stagingarea)。以下代码片段将指针移动到插入行，构建一个三列的行，并使用方法

insertRow

将其插入到

rs

和数据源表中。

rs.moveToInsertRow();//movescursortotheinsertrow
rs.updateString(1,"AINSWORTH");//updatesthe
//firstcolumnoftheinsertrowtobe[code]AINSWORTH

rs.updateInt(2,35);//updatesthesecondcolumntobe

rs.updateBoolean(3,true);//updatesthethirdcolumnto

true

rs.insertRow();
rs.moveToCurrentRow();

[/code]

当生成

ResultSet

对象的

Statement

对象关闭、重新执行或用来从多个结果的序列检索下一个结果时，

ResultSet

对象会自动关闭。

ResultSet

对象的列的编号、类型和属性由

ResultSet.getMetaData

方法返回的

ResulSetMetaData

对象提供。

另请参见：

Statement.executeQuery(java.lang.String)

Statement.getResultSet()

ResultSetMetaData

字段摘要
staticint	CLOSE_CURSORS_AT_COMMIT 该常量指示调用 Connection.commit 方法时应该关闭 ResultSet 对象。
staticint	CONCUR_READ_ONLY 该常量指示不可以更新的 ResultSet 对象的并发模式。
staticint	CONCUR_UPDATABLE 该常量指示可以更新的 ResultSet 对象的并发模式。
staticint	FETCH_FORWARD 该常量指示将按正向（即从第一个到最后一个）处理结果集中的行。
staticint	FETCH_REVERSE 该常量指示将按反向（即从最后一个到第一个）处理结果集中的行处理。
staticint	FETCH_UNKNOWN 该常量指示结果集中的行的处理顺序未知。
staticint	HOLD_CURSORS_OVER_COMMIT 该常量指示调用 Connection.commit 方法时不应关闭 ResultSet 对象。
staticint	TYPE_FORWARD_ONLY 该常量指示指针只能向前移动的 ResultSet 对象的类型。
staticint	TYPE_SCROLL_INSENSITIVE 该常量指示可滚动但通常不受其他的更改影响的 ResultSet 对象的类型。
staticint	TYPE_SCROLL_SENSITIVE 该常量指示可滚动并且通常受其他的更改影响的 ResultSet 对象的类型。

方法摘要
boolean	absolute(introw) 将指针移动到此 ResultSet 对象的给定行编号。
void	afterLast() 将指针移动到此 ResultSet 对象的末尾，正好位于最后一行之后。
void	beforeFirst() 将指针移动到此 ResultSet 对象的开头，正好位于第一行之前。
void	cancelRowUpdates() 取消对 ResultSet 对象中的当前行所作的更新。
void	clearWarnings() 清除在此 ResultSet 对象上报告的所有警告。
void	close() 立即释放此 ResultSet 对象的数据库和JDBC资源，而不是等待该对象自动关闭时发生此操作。
void	deleteRow() 从此 ResultSet 对象和底层数据库中删除当前行。
int	findColumn(StringcolumnName) 将给定的 ResultSet 列名称映射到其 ResultSet 列索引。
boolean	first() 将指针移动到此 ResultSet 对象的第一行。
Array	getArray(inti) 以Java编程语言中 Array 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
Array	getArray(StringcolName) 以Java编程语言中 Array 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
InputStream	getAsciiStream(intcolumnIndex) 以ASCII字符流的形式检索此 ResultSet 对象的当前行中指定列的值。
InputStream	getAsciiStream(StringcolumnName) 以ASCII字符流的形式检索此 ResultSet 对象的当前行中指定列的值。
BigDecimal	getBigDecimal(intcolumnIndex) 以具有全精度的 java.math.BigDecimal 的形式检索此 ResultSet 对象的当前行中指定列的值。
BigDecimal	getBigDecimal(intcolumnIndex,intscale) 已过时。
BigDecimal	getBigDecimal(StringcolumnName) 以具有全精度的 java.math.BigDecimal 的形式检索此 ResultSet 对象的当前行中指定列的值。
BigDecimal	getBigDecimal(StringcolumnName,intscale) 已过时。
InputStream	getBinaryStream(intcolumnIndex) 以未解释字节的二进制流的形式检索此 ResultSet 对象的当前行中指定列的值。
InputStream	getBinaryStream(StringcolumnName) 以未解释的 byte 流的形式检索此 ResultSet 对象的当前行中指定列的值。
Blob	getBlob(inti) 以Java编程语言中 Blob 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
Blob	getBlob(StringcolName) 以Java编程语言中 Blob 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
boolean	getBoolean(intcolumnIndex) 以Java编程语言中 boolean 的形式检索此 ResultSet 对象的当前行中指定列的值。
boolean	getBoolean(StringcolumnName) 以Java编程语言中 boolean 的形式检索此 ResultSet 对象的当前行中指定列的值。
byte	getByte(intcolumnIndex) 以Java编程语言中 byte 的形式检索此 ResultSet 对象的当前行中指定列的值。
byte	getByte(StringcolumnName) 以Java编程语言中 byte 的形式检索此 ResultSet 对象的当前行中指定列的值。
byte[]	getBytes(intcolumnIndex) 以Java编程语言中 byte 数组的形式检索此 ResultSet 对象的当前行中指定列的值。
byte[]	getBytes(StringcolumnName) 以Java编程语言中 byte 数组的形式检索此 ResultSet 对象的当前行中指定列的值。
Reader	getCharacterStream(intcolumnIndex) 以 java.io.Reader 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
Reader	getCharacterStream(StringcolumnName) 以 java.io.Reader 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
Clob	getClob(inti) 以Java编程语言中 Clob 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
Clob	getClob(StringcolName) 以Java编程语言中 Clob 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
int	getConcurrency() 检索此 ResultSet 对象的并发模式。
String	getCursorName() 检索此 ResultSet 对象使用的SQL指针的名称。
Date	getDate(intcolumnIndex) 以Java编程语言中 java.sql.Date 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
Date	getDate(intcolumnIndex, Calendarcal) 以Java编程语言中 java.sql.Date 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
Date	getDate(StringcolumnName) 以Java编程语言中的 java.sql.Date 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
Date	getDate(StringcolumnName,Calendarcal) 以Java编程语言中 java.sql.Date 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
double	getDouble(intcolumnIndex) 以Java编程语言中 double 的形式检索此 ResultSet 对象的当前行中指定列的值。
double	getDouble(StringcolumnName) 以Java编程语言中 double 的形式检索此 ResultSet 对象的当前行中指定列的值。
int	getFetchDirection() 检索此 ResultSet 对象的获取方向。
int	getFetchSize() 检索此 ResultSet 对象的获取大小。
float	getFloat(intcolumnIndex) 以Java编程语言中 float 的形式检索此 ResultSet 对象的当前行中指定列的值。
float	getFloat(StringcolumnName) 以Java编程语言中 float 的形式检索此 ResultSet 对象的当前行中指定列的值。
int	getInt(intcolumnIndex) 以Java编程语言中 int 的形式检索此 ResultSet 对象的当前行中指定列的值。
int	getInt(StringcolumnName) 以Java编程语言中 int 的形式检索此 ResultSet 对象的当前行中指定列的值。
long	getLong(intcolumnIndex) 以Java编程语言中 long 的形式检索此 ResultSet 对象的当前行中指定列的值。
long	getLong(StringcolumnName) 以Java编程语言中 long 的形式检索此 ResultSet 对象的当前行中指定列的值。
ResultSetMetaData	getMetaData() 检索此 ResultSet 对象的列的编号、类型和属性。
Object	getObject(intcolumnIndex) 以Java编程语言中 Object 的形式获取此 ResultSet 对象的当前行中指定列的值。
Object	getObject(inti,Map<String,Class<?>>map) 以Java编程语言中 Object 的形式检索此 ResultSet 对象的当前行中指定列的值。
Object	getObject(StringcolumnName) 以Java编程语言中 Object 的形式获取此 ResultSet 对象的当前行中指定列的值。
Object	getObject(StringcolName,Map<String,Class<?>>map) 以Java编程语言中 Object 的形式检索此 ResultSet 对象的当前行中指定列的值。
Ref	getRef(inti) 以Java编程语言中 Ref 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
Ref	getRef(StringcolName) 以Java编程语言中 Ref 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
int	getRow() 检索当前行编号。
short	getShort(intcolumnIndex) 以Java编程语言中 short 的形式检索此 ResultSet 对象的当前行中指定列的值。
short	getShort(StringcolumnName) 以Java编程语言中 short 的形式检索此 ResultSet 对象的当前行中指定列的值。
Statement	getStatement() 检索生成此 ResultSet 对象的 Statement 对象。
String	getString(intcolumnIndex) 以Java编程语言中 String 的形式检索此 ResultSet 对象的当前行中指定列的值。
String	getString(StringcolumnName) 以Java编程语言中 String 的形式检索此 ResultSet 对象的当前行中指定列的值。
Time	getTime(intcolumnIndex) 以Java编程语言中 java.sql.Time 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
Time	getTime(intcolumnIndex, Calendarcal) 以Java编程语言中 java.sql.Time 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
Time	getTime(StringcolumnName) 以Java编程语言中 java.sql.Time 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
Time	getTime(StringcolumnName,Calendarcal) 以Java编程语言中 java.sql.Time 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
Timestamp	getTimestamp(intcolumnIndex) 以Java编程语言中 java.sql.Timestamp 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
Timestamp	getTimestamp(intcolumnIndex, Calendarcal) 以Java编程语言中 java.sql.Timestamp 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
Timestamp	getTimestamp(StringcolumnName) 以 java.sql.Timestamp 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
Timestamp	getTimestamp(StringcolumnName,Calendarcal) 以Java编程语言中 java.sql.Timestamp 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
int	getType() 检索此 ResultSet 对象的类型。
InputStream	getUnicodeStream(intcolumnIndex) 已过时。使用 getCharacterStream 取代 getUnicodeStream
InputStream	getUnicodeStream(StringcolumnName) 已过时。使用 getCharacterStream 代替
URL	getURL(intcolumnIndex) 以Java编程语言中 java.net.URL 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
URL	getURL(StringcolumnName) 以Java编程语言中 java.net.URL 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
SQLWarning	getWarnings() 检索此 ResultSet 对象上的调用报告的第一个警告。
void	insertRow() 将插入行的内容插入到此 ResultSet 对象和数据库中。
boolean	isAfterLast() 检索指针是否位于此 ResultSet 对象的最后一行之后。
boolean	isBeforeFirst() 检索指针是否位于此 ResultSet 对象的第一行之前。
boolean	isFirst() 检索指针是否位于此 ResultSet 对象的第一行。
boolean	isLast() 检索指针是否位于此 ResultSet 对象的最后一行。
boolean	last() 将指针移动到此 ResultSet 对象的最后一行。
void	moveToCurrentRow() 将指针移动到记住的指针位置，通常为当前行。
void	moveToInsertRow() 将指针移动到插入行。
boolean	next() 将指针从当前位置下移一行。
boolean	previous() 将指针移动到此 ResultSet 对象的上一行。
void	refreshRow() 用数据库中的最近值刷新当前行。
boolean	relative(introws) 按相对行数（或正或负）移动指针。
boolean	rowDeleted() 检索是否已删除某行。
boolean	rowInserted() 检索当前行是否已有插入。
boolean	rowUpdated() 检索是否已更新当前行。
void	setFetchDirection(intdirection) 设置此 ResultSet 对象中行的处理方向。
void	setFetchSize(introws) 为JDBC驱动程序设置此 ResultSet 对象需要更多行时应该从数据库获取的行数。
void	updateArray(intcolumnIndex, Arrayx) 用 java.sql.Array 值更新指定列。
void	updateArray(StringcolumnName,Arrayx) 用 java.sql.Array 值更新指定列。
void	updateAsciiStream(intcolumnIndex, InputStreamx,intlength) 用ascii流值更新指定列。
void	updateAsciiStream(StringcolumnName,InputStreamx,intlength) 用ascii流值更新指定列。
void	updateBigDecimal(intcolumnIndex, BigDecimalx) 用 java.math.BigDecimal 值更新指定列。
void	updateBigDecimal(StringcolumnName,BigDecimalx) 用 java.sql.BigDecimal 值更新指定列。
void	updateBinaryStream(intcolumnIndex, InputStreamx,intlength) 用二进制流值更新指定列。
void	updateBinaryStream(StringcolumnName,InputStreamx,intlength) 用二进制流值更新指定列。
void	updateBlob(intcolumnIndex, Blobx) 用 java.sql.Blob 值更新指定列。
void	updateBlob(StringcolumnName,Blobx) 用 java.sql.Blob 值更新指定列。
void	updateBoolean(intcolumnIndex,booleanx) 用 boolean 值更新指定列。
void	updateBoolean(StringcolumnName,booleanx) 用 boolean 值更新指定列。
void	updateByte(intcolumnIndex,bytex) 用 byte 值更新指定列。
void	updateByte(StringcolumnName,bytex) 用 byte 值更新指定列。
void	updateBytes(intcolumnIndex,byte[]x) 用 byte 数组值更新指定列。
void	updateBytes(StringcolumnName,byte[]x) 用字节数组值更新指定列。
void	updateCharacterStream(intcolumnIndex, Readerx,intlength) 用字符流值更新指定列。
void	updateCharacterStream(StringcolumnName,Readerreader,intlength) 用字符流值更新指定列。
void	updateClob(intcolumnIndex, Clobx) 用 java.sql.Clob 值更新指定列。
void	updateClob(StringcolumnName,Clobx) 用 java.sql.Clob 值更新指定列。
void	updateDate(intcolumnIndex, Datex) 用 java.sql.Date 值更新指定列。
void	updateDate(StringcolumnName,Datex) 用 java.sql.Date 值更新指定列。
void	updateDouble(intcolumnIndex,doublex) 用 double 值更新指定列。
void	updateDouble(StringcolumnName,doublex) 用 double 值更新指定列。
void	updateFloat(intcolumnIndex,floatx) 用 float 值更新指定列。
void	updateFloat(StringcolumnName,floatx) 用 float 值更新指定列。
void	updateInt(intcolumnIndex,intx) 用 int 值更新指定列。
void	updateInt(StringcolumnName,intx) 用 int 值更新指定列。
void	updateLong(intcolumnIndex,longx) 用 long 值更新指定列。
void	updateLong(StringcolumnName,longx) 用 long 值更新指定列。
void	updateNull(intcolumnIndex) 为可以为null的列提供null值。
void	updateNull(StringcolumnName) 用 null 值更新指定列。
void	updateObject(intcolumnIndex, Objectx) 用 Object 值更新指定列。
void	updateObject(intcolumnIndex, Objectx,intscale) 用 Object 值更新指定列。
void	updateObject(StringcolumnName,Objectx) 用 Object 值更新指定列。
void	updateObject(StringcolumnName,Objectx,intscale) 用 Object 值更新指定列。
void	updateRef(intcolumnIndex, Refx) 用 java.sql.Ref 值更新指定列。
void	updateRef(StringcolumnName,Refx) 用 java.sql.Ref 值更新指定列。
void	updateRow() 用此 ResultSet 对象的当前行的新内容更新底层数据库。
void	updateShort(intcolumnIndex,shortx) 用 short 值更新指定列。
void	updateShort(StringcolumnName,shortx) 用 short 值更新指定列。
void	updateString(intcolumnIndex, Stringx) 用 String 值更新指定列。
void	updateString(StringcolumnName,Stringx) 用 String 值更新指定列。
void	updateTime(intcolumnIndex, Timex) 用 java.sql.Time 值更新指定列。
void	updateTime(StringcolumnName,Timex) 用 java.sql.Time 值更新指定列。
void	updateTimestamp(intcolumnIndex, Timestampx) 用 java.sql.Timestamp 值更新指定列。
void	updateTimestamp(StringcolumnName,Timestampx) 用 java.sql.Timestamp 值更新指定列。
boolean	wasNull() 报告最后一个读取的列是否具有值SQL NULL 。

字段详细信息

FETCH_FORWARD

staticfinalintFETCH_FORWARD

该常量指示将按正向（即从第一个到最后一个）处理结果集中的行。

setFetchDirection

方法将此常量用作驱动程序的提示，驱动程序可能忽略它。

从以下版本开始：1.2另请参见：常量字段值

FETCH_REVERSE

staticfinalintFETCH_REVERSE

该常量指示将按反向（即从最后一个到第一个）处理结果集中的行处理。

setFetchDirection

方法将此常量用作驱动程序的提示，驱动程序可能忽略它。

从以下版本开始：1.2另请参见：常量字段值

FETCH_UNKNOWN

staticfinalintFETCH_UNKNOWN

该常量指示结果集中的行的处理顺序未知。

setFetchDirection

方法将此常量用作驱动程序的提示，驱动程序可能忽略它。

另请参见：常量字段值

TYPE_FORWARD_ONLY

staticfinalintTYPE_FORWARD_ONLY

该常量指示指针只能向前移动的

ResultSet

对象的类型。

从以下版本开始：1.2另请参见：常量字段值

TYPE_SCROLL_INSENSITIVE

staticfinalintTYPE_SCROLL_INSENSITIVE

该常量指示可滚动但通常不受其他的更改影响的

ResultSet

对象的类型。

从以下版本开始：1.2另请参见：常量字段值

TYPE_SCROLL_SENSITIVE

staticfinalintTYPE_SCROLL_SENSITIVE

该常量指示可滚动并且通常受其他的更改影响的

ResultSet

对象的类型。

从以下版本开始：1.2另请参见：常量字段值

CONCUR_READ_ONLY

staticfinalintCONCUR_READ_ONLY

该常量指示不可以更新的

ResultSet

对象的并发模式。

从以下版本开始：1.2另请参见：常量字段值

CONCUR_UPDATABLE

staticfinalintCONCUR_UPDATABLE

该常量指示可以更新的

ResultSet

对象的并发模式。

从以下版本开始：1.2另请参见：常量字段值

HOLD_CURSORS_OVER_COMMIT

staticfinalintHOLD_CURSORS_OVER_COMMIT

该常量指示调用

Connection.commit

方法时不应关闭

ResultSet

对象。

从以下版本开始：1.4另请参见：常量字段值

CLOSE_CURSORS_AT_COMMIT

staticfinalintCLOSE_CURSORS_AT_COMMIT

该常量指示调用

Connection.commit

方法时应该关闭

ResultSet

对象。

从以下版本开始：1.4另请参见：常量字段值

方法详细信息

booleannext()
throwsSQLException

将指针从当前位置下移一行。

ResultSet

指针最初位于第一行之前；第一次调用

next

方法使第一行成为当前行；第二次调用使第二行成为当前行，依此类推。
如果开启了对当前行的输入流，则调用

next

方法将隐式关闭它。读取新行时，将清除

ResultSet

对象的警告链。

返回：如果新的当前行有效，则返回

true

；如果不存在下一行，则返回

false

抛出：

SQLException

-如果发生数据库访问错误

close

voidclose()
throwsSQLException

立即释放此

ResultSet

对象的数据库和JDBC资源，而不是等待该对象自动关闭时发生此操作。
注：当生成

ResultSet

对象的

Statement

对象关闭、重新执行或用来从多个结果的序列检索下一个结果时，该

Statement

对象会自动关闭

ResultSet

对象。垃圾回收

ResultSet

对象时它也会自动关闭。

抛出：

SQLException

-如果发生数据库访问错误

wasNull

booleanwasNull()
throwsSQLException

报告最后一个读取的列是否具有值SQL

NULL

。注意，必须首先对列调用一个获取方法来尝试读取其值，然后调用

wasNull

方法查看读取的值是否为SQL

NULL

。

返回：如果最后一个读取的列值为SQL

NULL

，则返回

true

；否则返回

false

抛出：

SQLException

-如果发生数据库访问错误

getString

StringgetString(intcolumnIndex)
throwsSQLException

以Java编程语言中

String

的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnIndex

-第一个列是1，第二个列是2，……返回：列值；如果值为SQL

NULL

，则返回值为

null

抛出：

SQLException

-如果发生数据库访问错误

getBoolean

booleangetBoolean(intcolumnIndex)
throwsSQLException

以Java编程语言中

boolean

的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnIndex

-第一个列是1，第二个列是2，……返回：列值；如果值为SQL

NULL

，则返回值为

false

抛出：

SQLException

-如果发生数据库访问错误

getByte

bytegetByte(intcolumnIndex)
throwsSQLException

以Java编程语言中

byte

的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnIndex

-第一个列是1，第二个列是2，……返回：列值；如果值为SQL

NULL

，则返回值为

抛出：

SQLException

-如果发生数据库访问错误

getShort

shortgetShort(intcolumnIndex)
throwsSQLException

以Java编程语言中

short

的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnIndex

-第一个列是1，第二个列是2，……返回：列值；如果值为SQL

NULL

，则返回值为

抛出：

SQLException

-如果发生数据库访问错误

getInt

intgetInt(intcolumnIndex)
throwsSQLException

以Java编程语言中

int

的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnIndex

-第一个列是1，第二个列是2，……返回：列值；如果值为SQL

NULL

，则返回值为

抛出：

SQLException

-如果发生数据库访问错误

getLong

longgetLong(intcolumnIndex)
throwsSQLException

以Java编程语言中

long

的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnIndex

-第一个列是1，第二个列是2，……返回：列值；如果值为SQL

NULL

，则返回值为

抛出：

SQLException

-如果发生数据库访问错误

getFloat

floatgetFloat(intcolumnIndex)
throwsSQLException

以Java编程语言中

float

的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnIndex

-第一个列是1，第二个列是2，……返回：列值；如果值为SQL

NULL

，则返回值为

抛出：

SQLException

-如果发生数据库访问错误

getDouble

doublegetDouble(intcolumnIndex)
throwsSQLException

以Java编程语言中

double

的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnIndex

-第一个列是1，第二个列是2，……返回：列值；如果值为SQL

NULL

，则返回值为

抛出：

SQLException

-如果发生数据库访问错误

getBigDecimal

@Deprecated
BigDecimalgetBigDecimal(intcolumnIndex,
intscale)
throwsSQLException

已过时。

以Java编程语言中

java.sql.BigDecimal

的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnIndex

-第一个列是1，第二个列是2，……

scale

-小数点右边的位数返回：列值；如果值为SQL

NULL

，则返回值为

null

抛出：

SQLException

-如果发生数据库访问错误

getBytes

byte[]getBytes(intcolumnIndex)
throwsSQLException

以Java编程语言中

byte

数组的形式检索此

ResultSet

对象的当前行中指定列的值。这些字节表示驱动程序返回的原始值。

参数：

columnIndex

-第一个列是1，第二个列是2，……返回：列值；如果值为SQL

NULL

，则返回值为

null

抛出：

SQLException

-如果发生数据库访问错误

getDate

DategetDate(intcolumnIndex)
throwsSQLException

以Java编程语言中

java.sql.Date

对象的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnIndex

-第一个列是1，第二个列是2，……返回：列值；如果值为SQL

NULL

，则返回值为

null

抛出：

SQLException

-如果发生数据库访问错误

getTime

TimegetTime(intcolumnIndex)
throwsSQLException

以Java编程语言中

java.sql.Time

对象的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnIndex

-第一个列是1，第二个列是2，……返回：列值；如果值为SQL

NULL

，则返回值为

null

抛出：

SQLException

-如果发生数据库访问错误

getTimestamp

TimestampgetTimestamp(intcolumnIndex)
throwsSQLException

以Java编程语言中

java.sql.Timestamp

对象的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnIndex

-第一个列是1，第二个列是2，……返回：列值；如果值为SQL

NULL

，则返回值为

null

抛出：

SQLException

-如果发生数据库访问错误

getAsciiStream

InputStreamgetAsciiStream(intcolumnIndex)
throwsSQLException

以ASCII字符流的形式检索此

ResultSet

对象的当前行中指定列的值。然后，可以按块从流中读取值。此方法尤其适合于检索很大的LONGVARCHAR值。JDBC驱动程序将执行从数据库格式到ASCII的任何必要转换。
注：在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外，当调用

InputStream.available

方法时，不管是否存在可用数据，流都可能返回

。

参数：

columnIndex

-第一个列是1，第二个列是2，……返回：以一字节ASCII字符流的形式返回传递数据库列值的Java输入流；如果值为SQL

NULL

，则返回值为

null

抛出：

SQLException

-如果发生数据库访问错误

getUnicodeStream

@Deprecated
InputStreamgetUnicodeStream(intcolumnIndex)
throwsSQLException

已过时。使用

getCharacterStream

取代

getUnicodeStream

以两字节Unicode字符流的形式检索此

ResultSet

对象的当前行中指定列的值。第一个字节是高字节；第二个字节是低字节。然后，可以按块从流中读取值。此方法尤其适合于检索很大的

LONGVARCHAR

值。JDBC驱动程序将执行从数据库格式到Unicode的任何必要转换。
注：在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外，当调用

InputStream.available

方法时，不管是否存在可用数据，流都可能返回

。

参数：

columnIndex

-第一个列是1，第二个列是2，……返回：以两字节Unicode字符流的形式返回传递数据库列值的Java输入流；如果值为SQL

NULL

，则返回值为

null

抛出：

SQLException

-如果发生数据库访问错误

getBinaryStream

InputStreamgetBinaryStream(intcolumnIndex)
throwsSQLException

以未解释字节的二进制流的形式检索此

ResultSet

对象的当前行中指定列的值。然后，可以按块从流中读取值。此方法尤其适合于检索很大的

LONGVARBINARY

值。
注：在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外，当调用

InputStream.available

方法时，不管是否存在可用数据，流都可能返回

。

参数：

columnIndex

-第一个列是1，第二个列是2，……返回：以未解释字节的流的形式返回传递数据库列值的Java输入流；如果值为SQL

NULL

，则返回值为

null

抛出：

SQLException

-如果发生数据库访问错误

getString

StringgetString(StringcolumnName)
throwsSQLException

以Java编程语言中

String

的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnName

-列的SQL名称返回：列值；如果值为SQL

NULL

，则返回值为

null

抛出：

SQLException

-如果发生数据库访问错误

getBoolean

booleangetBoolean(StringcolumnName)
throwsSQLException

以Java编程语言中

boolean

的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnName

-列的SQL名称返回：列值；如果值为SQL

NULL

，则返回值为

false

抛出：

SQLException

-如果发生数据库访问错误

getByte

bytegetByte(StringcolumnName)
throwsSQLException

以Java编程语言中

byte

的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnName

-列的SQL名称返回：列值；如果值为SQL

NULL

，则返回值为

抛出：

SQLException

-如果发生数据库访问错误

getShort

shortgetShort(StringcolumnName)
throwsSQLException

以Java编程语言中

short

的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnName

-列的SQL名称返回：列值；如果值为SQL

NULL

，则返回值为

抛出：

SQLException

-如果发生数据库访问错误

getInt

intgetInt(StringcolumnName)
throwsSQLException

以Java编程语言中

int

的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnName

-列的SQL名称返回：列值；如果值为SQL

NULL

，则返回值为

抛出：

SQLException

-如果发生数据库访问错误

getLong

longgetLong(StringcolumnName)
throwsSQLException

以Java编程语言中

long

的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnName

-列的SQL名称返回：列值；如果值为SQL

NULL

，则返回值为

抛出：

SQLException

-如果发生数据库访问错误

getFloat

floatgetFloat(StringcolumnName)
throwsSQLException

以Java编程语言中

float

的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnName

-列的SQL名称返回：列值；如果值为SQL

NULL

，则返回值为

抛出：

SQLException

-如果发生数据库访问错误

getDouble

doublegetDouble(StringcolumnName)
throwsSQLException

以Java编程语言中

double

的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnName

-列的SQL名称返回：列值；如果值为SQL

NULL

，则返回值为

抛出：

SQLException

-如果发生数据库访问错误

getBigDecimal

@Deprecated
BigDecimalgetBigDecimal(StringcolumnName,
intscale)
throwsSQLException

已过时。

以Java编程语言中

java.math.BigDecimal

的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnName

-列的SQL名称

scale

-小数点右边的位数返回：列值；如果值为SQL

NULL

，则返回值为

null

抛出：

SQLException

-如果发生数据库访问错误

getBytes

byte[]getBytes(StringcolumnName)
throwsSQLException

以Java编程语言中

byte

数组的形式检索此

ResultSet

对象的当前行中指定列的值。这些字节表示驱动程序返回的原始值。

参数：

columnName

-列的SQL名称返回：列值；如果值为SQL

NULL

，则返回值为

null

抛出：

SQLException

-如果发生数据库访问错误

getDate

DategetDate(StringcolumnName)
throwsSQLException

以Java编程语言中的

java.sql.Date

对象的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnName

-列的SQL名称返回：列值；如果值为SQL

NULL

，则返回值为

null

抛出：

SQLException

-如果发生数据库访问错误

getTime

TimegetTime(StringcolumnName)
throwsSQLException

以Java编程语言中

java.sql.Time

对象的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnName

-列的SQL名称返回：列值；如果值为SQL

NULL

，则返回值为

null

抛出：

SQLException

-如果发生数据库访问错误

getTimestamp

TimestampgetTimestamp(StringcolumnName)
throwsSQLException

以

java.sql.Timestamp

对象的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnName

-列的SQL名称返回：列值；如果值为SQL

NULL

，则返回值为

null

抛出：

SQLException

-如果发生数据库访问错误

getAsciiStream

InputStreamgetAsciiStream(StringcolumnName)
throwsSQLException

以ASCII字符流的形式检索此

ResultSet

对象的当前行中指定列的值。然后，可以按块从流中读取值。此方法尤其适合于检索很大的

LONGVARCHAR

值。JDBC驱动程序将执行从数据库格式到ASCII的任何必要转换。
注：在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外，当调用

available

方法时，不管是否存在可用数据，流都可能返回

。

参数：

columnName

-列的SQL名称返回：以一字节ASCII字符流的形式返回传递数据库列值的Java输入流。如果值为SQL

NULL

，则返回值为

null

。抛出：

SQLException

-如果发生数据库访问错误

getUnicodeStream

@Deprecated
InputStreamgetUnicodeStream(StringcolumnName)
throwsSQLException

已过时。使用

getCharacterStream

代替

以两字节Unicode字符流的形式检索此

ResultSet

对象的当前行中指定列的值。第一个字节是高字节；第二个字节是低字节。然后，可以按块从流中读取值。此方法尤其适合于检索很大的

LONGVARCHAR

值。采用JDBC技术的驱动程序将执行从数据库格式到Unicode的任何必要转换。
注：在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外，当调用

InputStream.available

方法时，不管是否存在可用数据，流都可能返回

。

参数：

columnName

-列的SQL名称返回：以两字节Unicode字符流的形式返回传递数据库列值的Java输入流。如果值为SQL

NULL

，则返回值为

null

。抛出：

SQLException

-如果发生数据库访问错误

getBinaryStream

InputStreamgetBinaryStream(StringcolumnName)
throwsSQLException

以未解释的

byte

流的形式检索此

ResultSet

对象的当前行中指定列的值。然后可以按块从流中读取该值。此方法尤其适合于检索很大的

LONGVARBINARY

值。
注：在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外，当调用

available

方法时，不管是否存在可用数据，流都可能返回

。

参数：

columnName

-列的SQL名称返回：以未解释字节流的形式返回传递数据库列值的Java输入流；如果值为SQL

NULL

，则返回值为

null

抛出：

SQLException

-如果发生数据库访问错误

getWarnings

SQLWarninggetWarnings()
throwsSQLException

检索此

ResultSet

对象上的调用报告的第一个警告。此

ResultSet

对象上的后续警告会被链接到此方法返回的

SQLWarning

对象。
每次读取新行时，都会自动清除警告链。不可以在已经关闭的

ResultSet

对象上调用此方法；这样做将导致抛出

SQLException

。

注：此警告链仅包含

ResultSet

方法产生的警告。

Statement

方法（如读取OUT参数）产生的任何警告都将链接在

Statement

对象上。

返回：报告的第一个

SQLWarning

对象；如果不存在，则返回

null

抛出：

SQLException

-如果发生数据库访问错误或者在关闭的结果集上调用此方法

clearWarnings

voidclearWarnings()
throwsSQLException

清除在此

ResultSet

对象上报告的所有警告。调用此方法后，在为此

ResultSet

对象报告新的警告之前，

getWarnings

方法将返回

null

。

抛出：

SQLException

-如果发生数据库访问错误

getCursorName

StringgetCursorName()
throwsSQLException

检索此

ResultSet

对象使用的SQL指针的名称。
在SQL中，通过命名的指针检索结果表。通过一个引用指针名称来确定位置的更新/删除语句，可以更新或删除结果集的当前行。为了确保指针具有支持更新的适当隔离级别，指针的

SELECT

语句的形式应该为

SELECTFORUPDATE

。如果省略

FORUPDATE

，则定位更新可能失败。

JDBCAPI通过提供

ResultSet

对象使用的SQL指针的名称支持此SQL功能。

ResultSet

对象的当前行也是此SQL指针的当前行。

注：如果不支持定位更新，则抛出

SQLException

。

返回：此

ResultSet

对象的指针的SQL名称抛出：

SQLException

-如果发生数据库访问错误

getMetaData

ResultSetMetaDatagetMetaData()
throwsSQLException

检索此

ResultSet

对象的列的编号、类型和属性。

返回：此

ResultSet

对象的列的描述抛出：

SQLException

-如果发生数据库访问错误

getObject

ObjectgetObject(intcolumnIndex)
throwsSQLException

以Java编程语言中

Object

的形式获取此

ResultSet

对象的当前行中指定列的值。

此方法将以Java对象的形式返回给定列的值。Java对象的类型将为与该列的SQL类型相对应的默认Java对象类型，它遵守在JDBC规范中指定的内置类型的映射关系。如果值为SQL

NULL

，则驱动程序返回一个Java

null

。

此方法还可用于读取特定于数据库的抽象数据类型。在JDBC2.0API中，可以扩展

getObject

方法的行为来实现SQL自定义类型的数据。当列包含结构化的或独特的值时，此方法的行为类似于调用：

getObject(columnIndex,this.getStatement().getConnection().getTypeMap())

。

参数：

columnIndex

-第一个列是1，第二个列是2，……返回：保存列值的

java.lang.Object

抛出：

SQLException

-如果发生数据库访问错误

getObject

ObjectgetObject(StringcolumnName)
throwsSQLException

以Java编程语言中

Object

的形式获取此

ResultSet

NULL

，则驱动程序返回一个Java

null

。

此方法还可用于读取特定于数据库的抽象数据类型。

在JDBC2.0API中，可以扩展

getObject

方法的行为来实现SQL自定义类型的数据。当列包含结构化的或独特的值时，此方法的行为类似于调用：

getObject(columnIndex,this.getStatement().getConnection().getTypeMap())

。

参数：

columnName

-列的SQL名称返回：保存列值的

java.lang.Object

抛出：

SQLException

-如果发生数据库访问错误

findColumn

intfindColumn(StringcolumnName)
throwsSQLException

将给定的

ResultSet

列名称映射到其

ResultSet

列索引。

参数：

columnName

-列的名称返回：给定列名称的列索引抛出：

SQLException

-如果

ResultSet

对象不包含

columnName

或者发生数据库访问错误

getCharacterStream

ReadergetCharacterStream(intcolumnIndex)
throwsSQLException

以

java.io.Reader

对象的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnIndex

-第一个列是1，第二个列是2，……返回：包含列值的

java.io.Reader

对象；如果值为SQL

NULL

，则返回值为Java编程语言中的

null

。抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getCharacterStream

ReadergetCharacterStream(StringcolumnName)
throwsSQLException

以

java.io.Reader

对象的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnName

-列的名称返回：包含列值的

java.io.Reader

对象；如果值为SQL

NULL

，则返回值为Java编程语言中的

null

抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getBigDecimal

BigDecimalgetBigDecimal(intcolumnIndex)
throwsSQLException

以具有全精度的

java.math.BigDecimal

的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnIndex

-第一个列是1，第二个列是2，……返回：列值（全精度）；如果值为SQL

NULL

，则返回值为Java编程语言中的

null

。抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getBigDecimal

BigDecimalgetBigDecimal(StringcolumnName)
throwsSQLException

以具有全精度的

java.math.BigDecimal

的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnName

-列名称返回：列值（全精度）；如果值为SQL

NULL

，则返回值为Java编程语言中的

null

。抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

isBeforeFirst

booleanisBeforeFirst()
throwsSQLException

检索指针是否位于此

ResultSet

对象的第一行之前。

返回：如果指针位于第一行之前，则返回

true

；如果指针位于任何其他位置或者结果集不包含任何行，则返回

false

抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

isAfterLast

booleanisAfterLast()
throwsSQLException

检索指针是否位于此

ResultSet

对象的最后一行之后。

返回：如果指针位于最后一行之后，则返回

true

；如果指针位于任何其他位置或者结果集不包含任何行，则返回

false

抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

isFirst

booleanisFirst()
throwsSQLException

检索指针是否位于此

ResultSet

对象的第一行。

返回：如果指针位于第一行，则返回

true

；否则返回

false

抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

isLast

booleanisLast()
throwsSQLException

检索指针是否位于此

ResultSet

对象的最后一行。注：调用

isLast

方法可能开销很大，因为JDBC驱动程序可能需要再往后获取一行，以确定当前行是否为结果集中的最后一行。

返回：如果指针位于最后一行上，则返回

true

；否则返回

false

抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

beforeFirst

voidbeforeFirst()
throwsSQLException

将指针移动到此

ResultSet

对象的开头，正好位于第一行之前。如果结果集中不包含任何行，则此方法无效。

抛出：

SQLException

-如果发生数据库访问错误或者结果集类型为

TYPE_FORWARD_ONLY

从以下版本开始：1.2

afterLast

voidafterLast()
throwsSQLException

将指针移动到此

ResultSet

对象的末尾，正好位于最后一行之后。如果结果集中不包含任何行，则此方法无效。

抛出：

SQLException

-如果发生数据库访问错误或者结果集类型为

TYPE_FORWARD_ONLY

从以下版本开始：1.2

first

booleanfirst()
throwsSQLException

将指针移动到此

ResultSet

对象的第一行。

返回：如果指针位于有效行，则返回

true

；如果结果集中不存在任何行，则返回

false

抛出：

SQLException

-如果发生数据库访问错误或者结果集类型为

TYPE_FORWARD_ONLY

从以下版本开始：1.2

last

booleanlast()
throwsSQLException

将指针移动到此

ResultSet

对象的最后一行。

返回：如果指针位于有效行，则返回

true

；如果结果集中不存在任何行，则返回

false

抛出：

SQLException

-如果发生数据库访问错误或者结果集类型为

TYPE_FORWARD_ONLY

从以下版本开始：1.2

getRow

intgetRow()
throwsSQLException

检索当前行编号。第一行为1号，第二行为2号，依此类推。

返回：当前行的编号；如果不存在当前行，则返回

抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

absolute

booleanabsolute(introw)
throwsSQLException

将指针移动到此

ResultSet

对象的给定行编号。
如果行编号为正，则将指针移动到相对于结果集开头的给定行编号。第一行为行1，第二行为行2，依此类推。

如果给定行编号为负，则将指针移动到相对于结果集末尾的绝对行位置。例如，调用方法

absolute(-1)

将指针置于最后一行；调用方法

absolute(-2)

将指针移动到倒数第二行，依此类推。

试图将指针置于结果集的第一行/最后一行之外将导致指针位于第一行之前或最后一行之后。

注：调用

absolute(1)

等效于调用

first()

。调用

absolute(-1)

等效于调用

last()

。

参数：

row

-指针应该移动到的行的编号。正的编号指示从结果集开头开始计数的行编号；负的编号指示从结果集末尾开始计数的行编号返回：如果指针位于结果集上，则返回

true

；否则返回

false

抛出：

SQLException

-如果发生数据库访问错误或者结果集类型为

TYPE_FORWARD_ONLY

从以下版本开始：1.2

relative

booleanrelative(introws)
throwsSQLException

按相对行数（或正或负）移动指针。试图移动到结果集的第一行/最后一行之外，会将指针置于第一行之前或最后一行之后。调用

relative(0)

有效，但是不更改指针位置。
注：调用方法

relative(1)

等效于调用方法

next()

，而调用方法

relative(-1)

等效于调用方法

previous()

。

参数：

rows

-指定从当前行开始移动的行数的

int

；正数表示指针向前移动；负数表示指针向后移动返回：如果指针位于行上，则返回

true

；否则返回

false

抛出：

SQLException

-如果发生数据库访问错误、不存在当前行或者结果集类型为

TYPE_FORWARD_ONLY

从以下版本开始：1.2

booleanprevious()
throwsSQLException

将指针移动到此

ResultSet

对象的上一行。

返回：如果指针位于有效行上，则返回

true

；如果它不在结果集中，则返回

false

抛出：

SQLException

-如果发生数据库访问错误或者结果集类型为

TYPE_FORWARD_ONLY

从以下版本开始：1.2

setFetchDirection

voidsetFetchDirection(intdirection)
throwsSQLException

设置此

ResultSet

对象中行的处理方向。初始值由生成此

ResultSet

对象的

Statement

对象确定。获取方向可以在任何时间更改。

参数：

direction

-指定建议获取方向的

int

；

ResultSet.FETCH_FORWARD

、

ResultSet.FETCH_REVERSE

或

ResultSet.FETCH_UNKNOWN

之一抛出：

SQLException

-如果发生数据库访问错误，或者结果集类型为

TYPE_FORWARD_ONLY

但获取方向不是

FETCH_FORWARD

从以下版本开始：1.2另请参见：

Statement.setFetchDirection(int)

getFetchDirection()

getFetchDirection

intgetFetchDirection()
throwsSQLException

检索此

ResultSet

对象的获取方向。

返回：此

ResultSet

对象的当前获取方向抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2另请参见：

setFetchDirection(int)

setFetchSize

voidsetFetchSize(introws)
throwsSQLException

为JDBC驱动程序设置此

ResultSet

对象需要更多行时应该从数据库获取的行数。如果指定的获取大小为零，则JDBC驱动程序忽略该值，随意对获取大小作出它自己的最佳猜测。默认值由创建结果集的

Statement

对象设置。获取大小可以在任何时间更改。

参数：

rows

-要获取的行数抛出：

SQLException

-如果发生数据库访问错误或者不满足条件


0<=rows<=Statement.getMaxRows()

从以下版本开始：1.2另请参见：

getFetchSize()

getFetchSize

intgetFetchSize()
throwsSQLException

检索此

ResultSet

对象的获取大小。

返回：此

ResultSet

对象的当前获取大小抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2另请参见：

setFetchSize(int)

getType

intgetType()
throwsSQLException

检索此

ResultSet

对象的类型。类型由创建结果集的

Statement

对象确定。

返回：

ResultSet.TYPE_FORWARD_ONLY

、

ResultSet.TYPE_SCROLL_INSENSITIVE

或

ResultSet.TYPE_SCROLL_SENSITIVE

抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getConcurrency

intgetConcurrency()
throwsSQLException

检索此

ResultSet

对象的并发模式。使用的并发由创建结果集的

Statement

对象确定。

返回：并发类型，

ResultSet.CONCUR_READ_ONLY

或

ResultSet.CONCUR_UPDATABLE

抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

rowUpdated

booleanrowUpdated()
throwsSQLException

检索是否已更新当前行。返回值取决于结果集是否可以检测到更新。

返回：如果(1)所有者或其他人已对行进行可见更新(2)可以检测到更新都成立，则返回

true

抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2另请参见：

DatabaseMetaData.updatesAreDetected(int)

rowInserted

booleanrowInserted()
throwsSQLException

检索当前行是否已有插入。返回值取决于此

ResultSet

对象是否可以检测到可见插入。

返回：如果行已有插入并且检测到插入，则返回

true

；否则返回

false

抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2另请参见：

DatabaseMetaData.insertsAreDetected(int)

rowDeleted

booleanrowDeleted()
throwsSQLException

检索是否已删除某行。删除的行可能在结果集中留下一个可见的“洞”。此方法可用于检测结果集中的洞。返回值取决于此

ResultSet

对象是否可以检测到删除。

返回：如果删除了行并且检测到删除，则返回

true

；否则返回

false

抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2另请参见：

DatabaseMetaData.deletesAreDetected(int)

updateNull

voidupdateNull(intcolumnIndex)
throwsSQLException

为可以为null的列提供null值。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateBoolean

voidupdateBoolean(intcolumnIndex,
booleanx)
throwsSQLException

用

boolean

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateByte

voidupdateByte(intcolumnIndex,
bytex)
throwsSQLException

用

byte

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateShort

voidupdateShort(intcolumnIndex,
shortx)
throwsSQLException

用

short

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateInt

voidupdateInt(intcolumnIndex,
intx)
throwsSQLException

用

int

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateLong

voidupdateLong(intcolumnIndex,
longx)
throwsSQLException

用

long

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会不更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateFloat

voidupdateFloat(intcolumnIndex,
floatx)
throwsSQLException

用

float

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateDouble

voidupdateDouble(intcolumnIndex,
doublex)
throwsSQLException

用

double

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateBigDecimal

voidupdateBigDecimal(intcolumnIndex,
BigDecimalx)
throwsSQLException

用

java.math.BigDecimal

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateString

voidupdateString(intcolumnIndex,
Stringx)
throwsSQLException

用

String

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateBytes

voidupdateBytes(intcolumnIndex,
byte[]x)
throwsSQLException

用

byte

数组值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateDate

voidupdateDate(intcolumnIndex,
Datex)
throwsSQLException

用

java.sql.Date

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateTime

voidupdateTime(intcolumnIndex,
Timex)
throwsSQLException

用

java.sql.Time

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateTimestamp

voidupdateTimestamp(intcolumnIndex,
Timestampx)
throwsSQLException

用

java.sql.Timestamp

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateAsciiStream

voidupdateAsciiStream(intcolumnIndex,
InputStreamx,
intlength)
throwsSQLException

用ascii流值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值

length

-流的长度抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateBinaryStream

voidupdateBinaryStream(intcolumnIndex,
InputStreamx,
intlength)
throwsSQLException

用二进制流值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值

length

-流的长度抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateCharacterStream

voidupdateCharacterStream(intcolumnIndex,
Readerx,
intlength)
throwsSQLException

用字符流值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值

length

-流的长度抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateObject

voidupdateObject(intcolumnIndex,
Objectx,
intscale)
throwsSQLException

用

Object

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值

scale

-对于

java.sql.Types.DECIMA

或

java.sql.Types.NUMERIC

类型，此参数是小数点后面的位数。对于其他所有类型，将忽略此值。抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateObject

voidupdateObject(intcolumnIndex,
Objectx)
throwsSQLException

用

Object

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateNull

voidupdateNull(StringcolumnName)
throwsSQLException

用

null

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateBoolean

voidupdateBoolean(StringcolumnName,
booleanx)
throwsSQLException

用

boolean

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateByte

voidupdateByte(StringcolumnName,
bytex)
throwsSQLException

用

byte

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateShort

voidupdateShort(StringcolumnName,
shortx)
throwsSQLException

用

short

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateInt

voidupdateInt(StringcolumnName,
intx)
throwsSQLException

用

int

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateLong

voidupdateLong(StringcolumnName,
longx)
throwsSQLException

用

long

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateFloat

voidupdateFloat(StringcolumnName,
floatx)
throwsSQLException

用

float

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateDouble

voidupdateDouble(StringcolumnName,
doublex)
throwsSQLException

用

double

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateBigDecimal

voidupdateBigDecimal(StringcolumnName,
BigDecimalx)
throwsSQLException

用

java.sql.BigDecimal

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateString

voidupdateString(StringcolumnName,
Stringx)
throwsSQLException

用

String

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateBytes

voidupdateBytes(StringcolumnName,
byte[]x)
throwsSQLException

用字节数组值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateDate

voidupdateDate(StringcolumnName,
Datex)
throwsSQLException

用

java.sql.Date

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateTime

voidupdateTime(StringcolumnName,
Timex)
throwsSQLException

用

java.sql.Time

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateTimestamp

voidupdateTimestamp(StringcolumnName,
Timestampx)
throwsSQLException

用

java.sql.Timestamp

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateAsciiStream

voidupdateAsciiStream(StringcolumnName,
InputStreamx,
intlength)
throwsSQLException

用ascii流值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值

length

-流的长度抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateBinaryStream

voidupdateBinaryStream(StringcolumnName,
InputStreamx,
intlength)
throwsSQLException

用二进制流值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值

length

-流的长度抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateCharacterStream

voidupdateCharacterStream(StringcolumnName,
Readerreader,
intlength)
throwsSQLException

用字符流值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

reader

-包含新列值的

java.io.Reader

对象

length

-流的长度抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateObject

voidupdateObject(StringcolumnName,
Objectx,
intscale)
throwsSQLException

用

Object

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值

scale

-对于

java.sql.Types.DECIMAL

或

java.sql.Types.NUMERIC

类型，此参数是小数点后面的位数。对于其他所有类型，将忽略此值。抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

updateObject

voidupdateObject(StringcolumnName,
Objectx)
throwsSQLException

用

Object

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

insertRow

voidinsertRow()
throwsSQLException

将插入行的内容插入到此

ResultSet

对象和数据库中。调用此方法时，指针必须位于插入行上。

抛出：

SQLException

-如果发生数据库访问错误，如果在指针不位于插入行上时调用此方法，或者插入行中所有不可为null的列中还存在未分配值的列从以下版本开始：1.2

updateRow

voidupdateRow()
throwsSQLException

用此

ResultSet

对象的当前行的新内容更新底层数据库。指针不位于插入行上时不能调用此方法。

抛出：

SQLException

-如果发生数据库访问错误或者在指针不位于插入行上时调用了此方法从以下版本开始：1.2

deleteRow

voiddeleteRow()
throwsSQLException

从此

ResultSet

对象和底层数据库中删除当前行。指针不位于插入行上时不能调用此方法。

抛出：

SQLException

-如果发生数据库访问错误或者在指针不位于插入行上时调用了此方法从以下版本开始：1.2

refreshRow

voidrefreshRow()
throwsSQLException

用数据库中的最近值刷新当前行。指针不位于插入行上时不能调用此方法。

refreshRow

方法提供一种让应用程序显式告知JDBC驱动程序从数据库重新获取行的方式。应用程序可能需要在JDBC驱动程序完成缓存或预获取操作后调用

refreshRow

，以便从数据库获取行的最新值。如果获取大小大于1，则JDBC驱动程序可以一次实际刷新多行。

应根据事务隔离级别和指针敏感度确定是否重新获取所有值。如果在调用更新方法之后，但在调用

updateRow

方法之前调用

refreshRow

，则会丢失对行所作的更新。频繁调用方法

refreshRow

可能导致性能下降。

抛出：

SQLException

-如果发生数据库访问错误或者在指针不位于插入行上时调用了此方法从以下版本开始：1.2

cancelRowUpdates

voidcancelRowUpdates()
throwsSQLException

取消对

ResultSet

对象中的当前行所作的更新。此方法在调用更新方法之后，但在调用

updateRow

方法之前调用才可以回滚对行所作的更新。如果没有进行任何更新或者已经调用

updateRow

方法，则此方法无效。

抛出：

SQLException

-如果发生数据库访问错误或者在指针不位于插入行上时调用了此方法从以下版本开始：1.2

moveToInsertRow

voidmoveToInsertRow()
throwsSQLException

将指针移动到插入行。将指针置于插入行上时，当前的指针位置会被记住。插入行是一个与可更新结果集相关联的特殊行。它实际上是一个缓冲区，在将行插入到结果集前可以通过调用更新方法在其中构造新行。当指针位于插入行上时，仅能调用更新方法、获取方法以及

insertRow

方法。每次在调用

insertRow

之前调用此方法时，必须为结果集中的所有列分配值。在对列值调用获取方法之前，必须调用更新方法。

抛出：

SQLException

-如果发生数据库访问错误或者结果集不可更新从以下版本开始：1.2

moveToCurrentRow

voidmoveToCurrentRow()
throwsSQLException

将指针移动到记住的指针位置，通常为当前行。如果指针不位于插入行上，则此方法无效。

抛出：

SQLException

-如果发生数据库访问错误或者结果集不可更新从以下版本开始：1.2

getStatement

StatementgetStatement()
throwsSQLException

检索生成此

ResultSet

对象的

Statement

对象。如果结果集是以其他方式生成的（如通过

DatabaseMetaData

方法），则此方法返回

null

。

返回：生成此

ResultSet

对象的

Statment

对象；如果结果集是以其他方法生成的，则返回

null

抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getObject

ObjectgetObject(inti,
Map<String,Class<?>>map)
throwsSQLException

以Java编程语言中

Object

的形式检索此

ResultSet

对象的当前行中指定列的值。如果值为SQL

NULL

，则驱动程序返回一个Java

null

。此方法使用给定的

Map

对象作为正在检索的SQL结构化或独特类型的自定义映射关系。

参数：

-第一个列是1，第二个列是2，……

map

-一个

java.util.Map

对象，包含从SQL类型名称到Java编程语言中类的映射关系返回：表示SQL值的Java编程语言中的

Object

抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getRef

RefgetRef(inti)
throwsSQLException

以Java编程语言中

Ref

对象的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

-第一个列是1，第二个列是2，……返回：表示SQL

REF

值的

Ref

对象抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getBlob

BlobgetBlob(inti)
throwsSQLException

以Java编程语言中

Blob

对象的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

-第一个列是1，第二个列是2，……返回：表示指定列中的SQL

BLOB

值的

BLOB

对象抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getClob

ClobgetClob(inti)
throwsSQLException

以Java编程语言中

Clob

对象的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

-第一个列是1，第二个列是2，……返回：表示指定列中的SQL

Clob

值的

Clob

对象抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getArray

ArraygetArray(inti)
throwsSQLException

以Java编程语言中

Array

对象的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

-第一个列是1，第二个列是2，……返回：表示指定列中的SQL

Array

值的

Array

对象抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getObject

ObjectgetObject(StringcolName,
Map<String,Class<?>>map)
throwsSQLException

以Java编程语言中

Object

的形式检索此

ResultSet

对象的当前行中指定列的值。如果值为SQL

NULL

，则驱动程序返回一个Java

null

。此方法使用指定的

Map

对象自定义映射关系（如果合适）。

参数：

colName

-列的名称，根据它来检索值

map

-包含从SQL类型名称到Java编程语言中类的映射关系的

java.util.Map

对象返回：表示指定列中的SQL值的

Object

抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getRef

RefgetRef(StringcolName)
throwsSQLException

以Java编程语言中

Ref

对象的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

colName

-列名称返回：表示指定列中SQL

Ref

值的

Ref

对象抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getBlob

BlobgetBlob(StringcolName)
throwsSQLException

以Java编程语言中

Blob

对象的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

colName

-列的名称，根据它检索值返回：表示指定列中SQL

Blob

值的

Blob

对象抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getClob

ClobgetClob(StringcolName)
throwsSQLException

以Java编程语言中

Clob

对象的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

colName

-列的名称，根据它检索值返回：表示指定列中SQL

CLOB

值的

Clob

对象抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getArray

ArraygetArray(StringcolName)
throwsSQLException

以Java编程语言中

Array

对象的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

colName

-列的名称，根据它检索值返回：表示指定列中SQL

ARRAY

值的

ARRAY

对象抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getDate

DategetDate(intcolumnIndex,
Calendarcal)
throwsSQLException

以Java编程语言中

java.sql.Date

对象的形式检索此

ResultSet

对象的当前行中指定列的值。如果底层数据库未存储时区信息，则此方法使用给定日历构造日期的适当毫秒值。

参数：

columnIndex

-第一个列是1，第二个列是2，……

cal

-在构造日期时使用的

java.util.Calendar

对象返回：

java.sql.Date

对象形式的列值；如果值为SQL

NULL

，则返回值为Java编程语言中的

null

抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getDate

DategetDate(StringcolumnName,
Calendarcal)
throwsSQLException

以Java编程语言中

java.sql.Date

对象的形式检索此

ResultSet

对象的当前行中指定列的值。如果底层数据库未存储时区信息，则此方法使用给定日历构造日期的适当毫秒值。

参数：

columnName

-列的SQL名称，根据它检索值

cal

-在构造日期时使用的

java.util.Calendar

对象返回：

java.sql.Date

对象形式的列值；如果值为SQL

NULL

，则返回值为Java编程语言中的

null

抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getTime

TimegetTime(intcolumnIndex,
Calendarcal)
throwsSQLException

以Java编程语言中

java.sql.Time

对象的形式检索此

ResultSet

对象的当前行中指定列的值。如果底层数据库未存储时区信息，则此方法使用给定日历构造时间的适当毫秒值。

参数：

columnIndex

-第一个列是1，第二个列是2，……

cal

-在构造时间时使用的

java.util.Calendar

对象返回：

java.sql.Time

对象形式的列值；如果值为SQL

NULL

，则返回值为Java编程语言中的

null

抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getTime

TimegetTime(StringcolumnName,
Calendarcal)
throwsSQLException

以Java编程语言中

java.sql.Time

对象的形式检索此

ResultSet

对象的当前行中指定列的值。如果底层数据库未存储时区信息，则此方法使用给定日历构造时间的适当毫秒值。

参数：

columnName

-列的SQL名称

cal

-在构造时间时使用的

java.util.Calendar

对象返回：

java.sql.Time

对象形式的列值；如果值为SQL

NULL

，则返回值为Java编程语言中的

null

抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getTimestamp

TimestampgetTimestamp(intcolumnIndex,
Calendarcal)
throwsSQLException

以Java编程语言中

java.sql.Timestamp

对象的形式检索此

ResultSet

对象的当前行中指定列的值。如果底层数据库未存储时区信息，则此方法使用给定日历构造时间戳的适当毫秒值。

参数：

columnIndex

-第一个列是1，第二个列是2，……

cal

-在构造时间戳时使用的

java.util.Calendar

对象返回：

java.sql.Timestamp

对象形式的列值；如果值为SQL

NULL

，则返回值为Java编程语言中的

null

抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getTimestamp

TimestampgetTimestamp(StringcolumnName,
Calendarcal)
throwsSQLException

以Java编程语言中

java.sql.Timestamp

对象的形式检索此

ResultSet

对象的当前行中指定列的值。如果底层数据库未存储时区信息，则此方法使用给定日历构造时间戳的适当毫秒值。

参数：

columnName

-列的SQL名称

cal

-在构造日期时使用的

java.util.Calendar

对象返回：

java.sql.Timestamp

对象形式的列值；如果值为SQL

NULL

，则返回值为Java编程语言中的

null

抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.2

getURL

URLgetURL(intcolumnIndex)
throwsSQLException

以Java编程语言中

java.net.URL

对象的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnIndex

-索引，其中第一个列是1、第二个列是2，……返回：

java.net.URL

对象形式的列值；如果值为SQL

NULL

，则返回值为Java编程语言中的

null

抛出：

SQLException

-如果发生数据库访问错误或者URL是错误的从以下版本开始：1.4

getURL

URLgetURL(StringcolumnName)
throwsSQLException

以Java编程语言中

java.net.URL

对象的形式检索此

ResultSet

对象的当前行中指定列的值。

参数：

columnName

-列的SQL名称返回：

java.net.URL

对象形式的列值；如果值为SQL

NULL

，则返回值为Java编程语言中的

null

抛出：

SQLException

-如果发生数据库访问错误或者URL是错误的从以下版本开始：1.4

updateRef

voidupdateRef(intcolumnIndex,
Refx)
throwsSQLException

用

java.sql.Ref

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.4

updateRef

voidupdateRef(StringcolumnName,
Refx)
throwsSQLException

用

java.sql.Ref

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.4

updateBlob

voidupdateBlob(intcolumnIndex,
Blobx)
throwsSQLException

用

java.sql.Blob

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.4

updateBlob

voidupdateBlob(StringcolumnName,
Blobx)
throwsSQLException

用

java.sql.Blob

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.4

updateClob

voidupdateClob(intcolumnIndex,
Clobx)
throwsSQLException

用

java.sql.Clob

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.4

updateClob

voidupdateClob(StringcolumnName,
Clobx)
throwsSQLException

用

java.sql.Clob

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.4

updateArray

voidupdateArray(intcolumnIndex,
Arrayx)
throwsSQLException

用

java.sql.Array

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnIndex

-第一个列是1，第二个列是2，……

-新列值抛出：

SQLException

-如果发生数据库访问错误从以下版本开始：1.4

updateArray

voidupdateArray(StringcolumnName,
Arrayx)
throwsSQLException

用

java.sql.Array

值更新指定列。更新方法用于更新当前行或插入行中的列值，并不会更新底层数据库；更新数据库要调用

updateRow

或

insertRow

方法。

参数：

columnName

-列的名称

-新列值抛出：

SQLException

-如果发生数据库访问错误

内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理

标签：

相关文章推荐

新的分享

章节导航