-
- All Superinterfaces:
-
AutoCloseable
,Wrapper
- All Known Subinterfaces:
-
CachedRowSet
,FilteredRowSet
,JdbcRowSet
,JoinRowSet
,RowSet
,SyncResolver
,WebRowSet
public interface ResultSet extends Wrapper, AutoCloseable
表示数据库结果集的数据表,通常通过执行查询数据库的语句生成。ResultSet
对象维护指向其当前数据行的游标。 最初,光标位于第一行之前。next
方法将光标移动到下一行,并且因为当ResultSet
对象中没有更多行时它返回false
,它可以在while
循环中用于迭代结果集。默认的
ResultSet
对象不可更新,并且只有一个向前移动的游标。 因此,您只能迭代一次,并且只能从第一行到最后一行。 可以生成可滚动和/或可更新的ResultSet
对象。 以下代码片段(其中con
是有效的Connection
对象)说明了如何创建可滚动且对其他人更新不敏感且可更新的结果集。 有关其他选项,请参见ResultSet
字段。Statement stmt = con.createStatement( ResultSet.TYPE_SCROLL_INSENSITIVE, ResultSet.CONCUR_UPDATABLE); ResultSet rs = stmt.executeQuery("SELECT a, b FROM TABLE2"); // rs will be scrollable, will not show changes made by others, // and will be updatable
所述ResultSet
接口提供getter方法(getBoolean
,getLong
用于从当前行检索列值,等等)。 可以使用列的索引号或列的名称来检索值。 通常,使用列索引会更有效。 列从1开始编号。为了获得最大的可移植性,每行中的结果集列应按从左到右的顺序读取,每列应只读一次。对于getter方法,JDBC驱动程序尝试将基础数据转换为getter方法中指定的Java类型,并返回合适的Java值。 JDBC规范有一个表,显示了从SQL类型到Java类型的允许映射,可以由
ResultSet
getter方法使用。用作getter方法输入的列名不区分大小写。 当使用列名调用getter方法并且多个列具有相同名称时,将返回第一个匹配列的值。 列名选项设计用于在生成结果集的SQL查询中使用列名时使用。 对于未在查询中明确命名的列,最好使用列号。 如果使用了列名,程序员应该注意保证它们唯一地引用预期的列,这可以通过SQL AS子句得到保证。
JDBC 2.0 API(Java™2 SDK,标准版,1.2版)中的一个更新程序方法添加到此接口。 关于getter方法的参数的注释也适用于updater方法的参数。
更新程序方法可以以两种方式使用:
- 更新当前行中的列值。 在可滚动
ResultSet
对象,光标可以向前和向后移动时,到一个绝对位置,或相对于当前行的位置。 下面的代码段更新NAME
所述的第五行中列ResultSet
对象rs
,然后使用方法updateRow
来更新该数据的源表rs
推导。rs.absolute(5); // moves the cursor to the fifth row of rs rs.updateString("NAME", "AINSWORTH"); // updates the //
NAME
column of row 5 to beAINSWORTH
rs.updateRow(); // updates the row in the data source - 将列值插入插入行。 可更新的
ResultSet
对象具有与之关联的特殊行,该行用作构建要插入的行的临时区域。 以下代码片段将光标移动到插入行,构建三列行,并使用方法insertRow
将其插入到rs
和数据源表中。rs.moveToInsertRow(); // moves cursor to the insert row rs.updateString(1, "AINSWORTH"); // updates the // first column of the insert row to be
AINSWORTH
rs.updateInt(2,35); // updates the second column to be35
rs.updateBoolean(3, true); // updates the third column totrue
rs.insertRow(); rs.moveToCurrentRow();
甲
ResultSet
当对象将自动关闭Statement
生成它对象被关闭时,重新执行,或用于检索从多个结果的序列中的下一结果。ResultSet
对象列的数量,类型和属性由ResultSet.getMetaData
方法返回的ResultSetMetaData
对象提供。- 从以下版本开始:
- 1.1
- 另请参见:
-
Statement.executeQuery(java.lang.String)
,Statement.getResultSet()
,ResultSetMetaData
-
-
字段汇总
字段 变量和类型 字段 描述 static int
CLOSE_CURSORS_AT_COMMIT
该常量指示在提交当前事务时将关闭具有此可保持性的打开的ResultSet
对象。static int
CONCUR_READ_ONLY
该常量指示可能未更新的ResultSet
对象的并发模式。static int
CONCUR_UPDATABLE
该常量指示可以更新的ResultSet
对象的并发模式。static int
FETCH_FORWARD
该常量指示结果集中的行将在向前方向上处理; 第一个到最后。static int
FETCH_REVERSE
该常量表示结果集中的行将以反方向处理; 最后到第一位。static int
FETCH_UNKNOWN
该常量指示将处理结果集中的行的顺序未知。static int
HOLD_CURSORS_OVER_COMMIT
该常量指示在提交当前事务时,打开具有此可保持性的ResultSet
对象将保持打开状态。static int
TYPE_FORWARD_ONLY
常量,指示ResultSet
对象的类型,其光标可以仅向前移动。static int
TYPE_SCROLL_INSENSITIVE
该常量指示ResultSet
对象的类型,该对象可滚动但通常对ResultSet
基础数据的更改不敏感。static int
TYPE_SCROLL_SENSITIVE
该常量指示ResultSet
对象的类型,该对象可滚动且通常对ResultSet
所基于的数据的更改敏感。
-
方法摘要
所有方法 实例方法 抽象方法 Default Methods 弃用的方法 变量和类型 方法 描述 boolean
absolute(int row)
将光标移动到此ResultSet
对象中的给定行号。void
afterLast()
将光标移动到此ResultSet
对象的末尾,ResultSet
在最后一行之后。void
beforeFirst()
将光标移动到此ResultSet
对象的前面,就在第一行之前。void
cancelRowUpdates()
取消对此ResultSet
对象中当前行所做的更新。void
clearWarnings()
清除此ResultSet
对象上报告的所有警告。void
close()
立即释放此ResultSet
对象的数据库和JDBC资源,而不是等待它自动关闭时发生。void
deleteRow()
从此ResultSet
对象和基础数据库中删除当前行。int
findColumn(String columnLabel)
将给定的ResultSet
列标签映射到其ResultSet
列索引。boolean
first()
将光标移动到此ResultSet
对象中的第一行。Array
getArray(int columnIndex)
以Java编程语言中ResultSet
对象的形式Array
此ResultSet
对象的当前行中指定列的值。Array
getArray(String columnLabel)
以Java编程语言中ResultSet
对象的形式Array
此ResultSet
对象的当前行中指定列的值。InputStream
getAsciiStream(int columnIndex)
以ASCII字符流的形式检索此ResultSet
对象的当前行中指定列的值。InputStream
getAsciiStream(String columnLabel)
以ASCII字符流的形式检索此ResultSet
对象的当前行中指定列的值。BigDecimal
getBigDecimal(int columnIndex)
以java.math.BigDecimal
的全精度检索此ResultSet
对象的当前行中指定列的值。BigDecimal
getBigDecimal(int columnIndex, int scale)
已过时。使用getBigDecimal(int columnIndex)
或getBigDecimal(String columnLabel)
BigDecimal
getBigDecimal(String columnLabel)
以java.math.BigDecimal
的全精度检索此ResultSet
对象的当前行中指定列的值。BigDecimal
getBigDecimal(String columnLabel, int scale)
已过时。使用getBigDecimal(int columnIndex)
或getBigDecimal(String columnLabel)
InputStream
getBinaryStream(int columnIndex)
检索此ResultSet
对象的当前行中指定列的值,作为未解释字节流。InputStream
getBinaryStream(String columnLabel)
以未解释的byte
流的形式byte
此ResultSet
对象的当前行中指定列的值。Blob
getBlob(int columnIndex)
以Java编程语言中ResultSet
对象的形式Blob
此ResultSet
对象的当前行中指定列的值。Blob
getBlob(String columnLabel)
以Java编程语言中ResultSet
对象的形式Blob
此ResultSet
对象的当前行中指定列的值。boolean
getBoolean(int columnIndex)
以Java编程语言中boolean
此ResultSet
对象的当前行中指定列的值。boolean
getBoolean(String columnLabel)
以Java编程语言中boolean
此ResultSet
对象的当前行中指定列的值。byte
getByte(int columnIndex)
以Java编程语言中byte
此ResultSet
对象的当前行中指定列的值。byte
getByte(String columnLabel)
以Java编程语言中byte
此ResultSet
对象的当前行中指定列的值。byte[]
getBytes(int columnIndex)
以Java编程语言中byte
数组的形式byte
此ResultSet
对象的当前行中指定列的值。byte[]
getBytes(String columnLabel)
以Java编程语言中byte
数组的形式byte
此ResultSet
对象的当前行中指定列的值。Reader
getCharacterStream(int columnIndex)
以ResultSet
对象的形式java.io.Reader
此ResultSet
对象的当前行中指定列的值。Reader
getCharacterStream(String columnLabel)
以ResultSet
对象的形式java.io.Reader
此ResultSet
对象的当前行中指定列的值。Clob
getClob(int columnIndex)
以Java编程语言中ResultSet
对象的形式Clob
此ResultSet
对象的当前行中指定列的值。Clob
getClob(String columnLabel)
以Java编程语言中ResultSet
对象的形式Clob
此ResultSet
对象的当前行中指定列的值。int
getConcurrency()
检索此ResultSet
对象的并发模式。String
getCursorName()
检索此ResultSet
对象使用的SQL游标的名称。Date
getDate(int columnIndex)
以Java编程语言中ResultSet
对象的形式java.sql.Date
此ResultSet
对象的当前行中指定列的值。Date
getDate(int columnIndex, Calendar cal)
以Java编程语言中ResultSet
对象的形式java.sql.Date
此ResultSet
对象的当前行中指定列的值。Date
getDate(String columnLabel)
以Java编程语言中ResultSet
对象的形式java.sql.Date
此ResultSet
对象的当前行中指定列的值。Date
getDate(String columnLabel, Calendar cal)
以Java编程语言中ResultSet
对象的形式java.sql.Date
此ResultSet
对象的当前行中指定列的值。double
getDouble(int columnIndex)
以Java编程语言中double
此ResultSet
对象的当前行中指定列的值。double
getDouble(String columnLabel)
以Java编程语言中double
此ResultSet
对象的当前行中指定列的值。int
getFetchDirection()
检索此ResultSet
对象的获取方向。int
getFetchSize()
检索此ResultSet
对象的提取大小。float
getFloat(int columnIndex)
以Java编程语言中float
此ResultSet
对象的当前行中指定列的值。float
getFloat(String columnLabel)
以Java编程语言中float
此ResultSet
对象的当前行中指定列的值。int
getHoldability()
检索此ResultSet
对象的可保存性int
getInt(int columnIndex)
以Java编程语言中int
此ResultSet
对象的当前行中指定列的值。int
getInt(String columnLabel)
以Java编程语言中int
此ResultSet
对象的当前行中指定列的值。long
getLong(int columnIndex)
以Java编程语言中long
此ResultSet
对象的当前行中指定列的值。long
getLong(String columnLabel)
以Java编程语言中long
此ResultSet
对象的当前行中指定列的值。ResultSetMetaData
getMetaData()
检索此ResultSet
对象列的数量,类型和属性。Reader
getNCharacterStream(int columnIndex)
以ResultSet
对象的形式java.io.Reader
此ResultSet
对象的当前行中指定列的值。Reader
getNCharacterStream(String columnLabel)
以ResultSet
对象的形式java.io.Reader
此ResultSet
对象的当前行中指定列的值。NClob
getNClob(int columnIndex)
以Java编程语言中ResultSet
对象的形式NClob
此ResultSet
对象的当前行中指定列的值。NClob
getNClob(String columnLabel)
以Java编程语言中ResultSet
对象的形式NClob
此ResultSet
对象的当前行中指定列的值。String
getNString(int columnIndex)
以Java编程语言中String
此ResultSet
对象的当前行中指定列的值。String
getNString(String columnLabel)
以Java编程语言中String
此ResultSet
对象的当前行中指定列的值。Object
getObject(int columnIndex)
获取此ResultSet
对象的当前行中指定列的值,作为Java编程语言中的Object
。<T> T
getObject(int columnIndex, 类<T> type)
如果支持转换,则检索此ResultSet
对象的当前行中指定列的值,并将从列的SQL类型转换为请求的Java数据类型。Object
getObject(int columnIndex, Map<String,类<?>> map)
以Java编程语言中Object
此ResultSet
对象的当前行中指定列的值。Object
getObject(String columnLabel)
获取此ResultSet
对象的当前行中指定列的值,作为Java编程语言中的Object
。<T> T
getObject(String columnLabel, 类<T> type)
如果支持转换,则检索此ResultSet
对象的当前行中指定列的值,并将从列的SQL类型转换为请求的Java数据类型。Object
getObject(String columnLabel, Map<String,类<?>> map)
以Java编程语言中Object
此ResultSet
对象的当前行中指定列的值。Ref
getRef(int columnIndex)
以Java编程语言中ResultSet
对象的形式Ref
此ResultSet
对象的当前行中指定列的值。Ref
getRef(String columnLabel)
以Java编程语言中ResultSet
对象的形式Ref
此ResultSet
对象的当前行中指定列的值。int
getRow()
检索当前行号。RowId
getRowId(int columnIndex)
以Java编程语言中ResultSet
对象的形式java.sql.RowId
此ResultSet
对象的当前行中指定列的值。RowId
getRowId(String columnLabel)
以Java编程语言中ResultSet
对象的形式java.sql.RowId
此ResultSet
对象的当前行中指定列的值。short
getShort(int columnIndex)
以Java编程语言中short
此ResultSet
对象的当前行中指定列的值。short
getShort(String columnLabel)
以Java编程语言中short
此ResultSet
对象的当前行中指定列的值。SQLXML
getSQLXML(int columnIndex)
以Java编程语言中java.sql.SQLXML
对象的形式java.sql.SQLXML
此ResultSet
的当前行中指定列的值。SQLXML
getSQLXML(String columnLabel)
以Java编程语言中java.sql.SQLXML
对象的形式java.sql.SQLXML
此ResultSet
的当前行中指定列的值。Statement
getStatement()
检索Statement
生成此对象ResultSet
对象。String
getString(int columnIndex)
以Java编程语言中String
此ResultSet
对象的当前行中指定列的值。String
getString(String columnLabel)
以Java编程语言中String
此ResultSet
对象的当前行中指定列的值。Time
getTime(int columnIndex)
以Java编程语言中ResultSet
对象的形式java.sql.Time
此ResultSet
对象的当前行中指定列的值。Time
getTime(int columnIndex, Calendar cal)
以Java编程语言中ResultSet
对象的形式java.sql.Time
此ResultSet
对象的当前行中指定列的值。Time
getTime(String columnLabel)
以Java编程语言中ResultSet
对象的形式java.sql.Time
此ResultSet
对象的当前行中指定列的值。Time
getTime(String columnLabel, Calendar cal)
以Java编程语言中ResultSet
对象的形式java.sql.Time
此ResultSet
对象的当前行中指定列的值。Timestamp
getTimestamp(int columnIndex)
以Java编程语言中ResultSet
对象的形式java.sql.Timestamp
此ResultSet
对象的当前行中指定列的值。Timestamp
getTimestamp(int columnIndex, Calendar cal)
以Java编程语言中ResultSet
对象的形式java.sql.Timestamp
此ResultSet
对象的当前行中指定列的值。Timestamp
getTimestamp(String columnLabel)
以Java编程语言中ResultSet
对象的形式java.sql.Timestamp
此ResultSet
对象的当前行中指定列的值。Timestamp
getTimestamp(String columnLabel, Calendar cal)
以Java编程语言中ResultSet
对象的形式java.sql.Timestamp
此ResultSet
对象的当前行中指定列的值。int
getType()
检索此ResultSet
对象的类型。InputStream
getUnicodeStream(int columnIndex)
已过时。用getCharacterStream
代替getUnicodeStream
InputStream
getUnicodeStream(String columnLabel)
已过时。请改用getCharacterStream
URL
getURL(int columnIndex)
以Java编程语言中ResultSet
对象的形式java.net.URL
此ResultSet
对象的当前行中指定列的值。URL
getURL(String columnLabel)
以Java编程语言中ResultSet
对象的形式java.net.URL
此ResultSet
对象的当前行中指定列的值。SQLWarning
getWarnings()
检索此ResultSet
对象上的调用报告的第一个警告。void
insertRow()
将插入行的内容插入此ResultSet
对象并插入数据库。boolean
isAfterLast()
检索光标是否在此ResultSet
对象的最后一行之后。boolean
isBeforeFirst()
检索光标是否在此ResultSet
对象的第一行之前。boolean
isClosed()
检索此ResultSet
对象是否已关闭。boolean
isFirst()
检索光标是否位于此ResultSet
对象的第一行。boolean
isLast()
检索光标是否在此ResultSet
对象的最后一行。boolean
last()
将光标移动到此ResultSet
对象中的最后一行。void
moveToCurrentRow()
将光标移动到记住的光标位置,通常是当前行。void
moveToInsertRow()
将光标移动到插入行。boolean
next()
将光标从当前位置向前移动一行。boolean
previous()
将光标移动到此ResultSet
对象中的上一行。void
refreshRow()
使用数据库中的最新值刷新当前行。boolean
relative(int rows)
将光标移动相对的行数(正数或负数)。boolean
rowDeleted()
检索是否已删除行。boolean
rowInserted()
检索当前行是否已插入。boolean
rowUpdated()
检索当前行是否已更新。void
setFetchDirection(int direction)
提供有关此ResultSet
对象中的行的处理方向的提示。void
setFetchSize(int rows)
为JDBC驱动程序提供有关此ResultSet
对象需要更多行时应从数据库中提取的行数的提示。void
updateArray(int columnIndex, Array x)
使用java.sql.Array
值更新指定的列。void
updateArray(String columnLabel, Array x)
使用值java.sql.Array
更新指定列。void
updateAsciiStream(int columnIndex, InputStream x)
使用ascii流值更新指定的列。void
updateAsciiStream(int columnIndex, InputStream x, int length)
使用ascii流值更新指定列,该值将具有指定的字节数。void
updateAsciiStream(int columnIndex, InputStream x, long length)
使用ascii流值更新指定列,该值将具有指定的字节数。void
updateAsciiStream(String columnLabel, InputStream x)
使用ascii流值更新指定的列。void
updateAsciiStream(String columnLabel, InputStream x, int length)
使用ascii流值更新指定列,该值将具有指定的字节数。void
updateAsciiStream(String columnLabel, InputStream x, long length)
使用ascii流值更新指定列,该值将具有指定的字节数。void
updateBigDecimal(int columnIndex, BigDecimal x)
使用java.math.BigDecimal
值更新指定的列。void
updateBigDecimal(String columnLabel, BigDecimal x)
使用值java.sql.BigDecimal
更新指定的列。void
updateBinaryStream(int columnIndex, InputStream x)
使用二进制流值更新指定的列。void
updateBinaryStream(int columnIndex, InputStream x, int length)
使用二进制流值更新指定列,该值将具有指定的字节数。void
updateBinaryStream(int columnIndex, InputStream x, long length)
使用二进制流值更新指定列,该值将具有指定的字节数。void
updateBinaryStream(String columnLabel, InputStream x)
使用二进制流值更新指定的列。void
updateBinaryStream(String columnLabel, InputStream x, int length)
使用二进制流值更新指定列,该值将具有指定的字节数。void
updateBinaryStream(String columnLabel, InputStream x, long length)
使用二进制流值更新指定列,该值将具有指定的字节数。void
updateBlob(int columnIndex, InputStream inputStream)
使用给定的输入流更新指定的列。void
updateBlob(int columnIndex, InputStream inputStream, long length)
使用给定输入流更新指定列,该输入流将具有指定的字节数。void
updateBlob(int columnIndex, Blob x)
使用java.sql.Blob
值更新指定的列。void
updateBlob(String columnLabel, InputStream inputStream)
使用给定的输入流更新指定的列。void
updateBlob(String columnLabel, InputStream inputStream, long length)
使用给定输入流更新指定列,该输入流将具有指定的字节数。void
updateBlob(String columnLabel, Blob x)
使用java.sql.Blob
值更新指定的列。void
updateBoolean(int columnIndex, boolean x)
使用boolean
值更新指定的列。void
updateBoolean(String columnLabel, boolean x)
使用值boolean
更新指定列。void
updateByte(int columnIndex, byte x)
使用值byte
更新指定列。void
updateByte(String columnLabel, byte x)
使用byte
值更新指定的列。void
updateBytes(int columnIndex, byte[] x)
使用byte
数组值更新指定的列。void
updateBytes(String columnLabel, byte[] x)
使用字节数组值更新指定的列。void
updateCharacterStream(int columnIndex, Reader x)
使用字符流值更新指定的列。void
updateCharacterStream(int columnIndex, Reader x, int length)
使用字符流值更新指定的列,该值将具有指定的字节数。void
updateCharacterStream(int columnIndex, Reader x, long length)
使用字符流值更新指定的列,该值将具有指定的字节数。void
updateCharacterStream(String columnLabel, Reader reader)
使用字符流值更新指定的列。void
updateCharacterStream(String columnLabel, Reader reader, int length)
使用字符流值更新指定的列,该值将具有指定的字节数。void
updateCharacterStream(String columnLabel, Reader reader, long length)
使用字符流值更新指定的列,该值将具有指定的字节数。void
updateClob(int columnIndex, Reader reader)
使用给定的Reader
对象更新指定的列。void
updateClob(int columnIndex, Reader reader, long length)
使用给定的Reader
对象更新指定的列,该对象是给定的字符长度。void
updateClob(int columnIndex, Clob x)
使用java.sql.Clob
值更新指定的列。void
updateClob(String columnLabel, Reader reader)
使用给定的Reader
对象更新指定的列。void
updateClob(String columnLabel, Reader reader, long length)
使用给定的Reader
对象更新指定的列,该对象是给定的字符长度。void
updateClob(String columnLabel, Clob x)
使用值java.sql.Clob
更新指定列。void
updateDate(int columnIndex, Date x)
使用值java.sql.Date
更新指定的列。void
updateDate(String columnLabel, Date x)
使用值java.sql.Date
更新指定的列。void
updateDouble(int columnIndex, double x)
使用double
值更新指定的列。void
updateDouble(String columnLabel, double x)
使用double
值更新指定的列。void
updateFloat(int columnIndex, float x)
使用值float
更新指定列。void
updateFloat(String columnLabel, float x)
使用值float
更新指定列。void
updateInt(int columnIndex, int x)
使用int
值更新指定的列。void
updateInt(String columnLabel, int x)
使用值int
更新指定列。void
updateLong(int columnIndex, long x)
使用long
值更新指定的列。void
updateLong(String columnLabel, long x)
使用long
值更新指定的列。void
updateNCharacterStream(int columnIndex, Reader x)
使用字符流值更新指定的列。void
updateNCharacterStream(int columnIndex, Reader x, long length)
使用字符流值更新指定的列,该值将具有指定的字节数。void
updateNCharacterStream(String columnLabel, Reader reader)
使用字符流值更新指定的列。void
updateNCharacterStream(String columnLabel, Reader reader, long length)
使用字符流值更新指定的列,该值将具有指定的字节数。void
updateNClob(int columnIndex, Reader reader)
使用给定的Reader
更新指定的列。将根据需要从流中读取数据,直到达到流末尾。void
updateNClob(int columnIndex, Reader reader, long length)
使用给定的Reader
对象更新指定的列,该对象是给定的字符长度。void
updateNClob(int columnIndex, NClob nClob)
使用java.sql.NClob
值更新指定的列。void
updateNClob(String columnLabel, Reader reader)
使用给定的Reader
对象更新指定的列。void
updateNClob(String columnLabel, Reader reader, long length)
使用给定的Reader
对象更新指定的列,该对象是给定的字符长度。void
updateNClob(String columnLabel, NClob nClob)
使用java.sql.NClob
值更新指定列。void
updateNString(int columnIndex, String nString)
使用String
值更新指定的列。void
updateNString(String columnLabel, String nString)
使用String
值更新指定的列。void
updateNull(int columnIndex)
使用null
值更新指定的列。void
updateNull(String columnLabel)
使用null
值更新指定的列。void
updateObject(int columnIndex, Object x)
使用Object
值更新指定列。void
updateObject(int columnIndex, Object x, int scaleOrLength)
使用Object
值更新指定的列。default void
updateObject(int columnIndex, Object x, SQLType targetSqlType)
使用Object
值更新指定列。default void
updateObject(int columnIndex, Object x, SQLType targetSqlType, int scaleOrLength)
使用Object
值更新指定列。void
updateObject(String columnLabel, Object x)
使用值Object
更新指定列。void
updateObject(String columnLabel, Object x, int scaleOrLength)
使用值Object
更新指定列。default void
updateObject(String columnLabel, Object x, SQLType targetSqlType)
使用值Object
更新指定列。default void
updateObject(String columnLabel, Object x, SQLType targetSqlType, int scaleOrLength)
使用Object
值更新指定的列。void
updateRef(int columnIndex, Ref x)
使用值java.sql.Ref
更新指定列。void
updateRef(String columnLabel, Ref x)
使用值java.sql.Ref
更新指定列。void
updateRow()
使用此ResultSet
对象的当前行的新内容更新基础数据库。void
updateRowId(int columnIndex, RowId x)
使用值RowId
更新指定列。void
updateRowId(String columnLabel, RowId x)
使用值RowId
更新指定列。void
updateShort(int columnIndex, short x)
使用值short
更新指定列。void
updateShort(String columnLabel, short x)
使用值short
更新指定列。void
updateSQLXML(int columnIndex, SQLXML xmlObject)
使用值java.sql.SQLXML
更新指定列。void
updateSQLXML(String columnLabel, SQLXML xmlObject)
使用java.sql.SQLXML
值更新指定的列。void
updateString(int columnIndex, String x)
使用值String
更新指定列。void
updateString(String columnLabel, String x)
使用值String
更新指定列。void
updateTime(int columnIndex, Time x)
使用值java.sql.Time
更新指定列。void
updateTime(String columnLabel, Time x)
使用值java.sql.Time
更新指定的列。void
updateTimestamp(int columnIndex, Timestamp x)
使用值java.sql.Timestamp
更新指定列。void
updateTimestamp(String columnLabel, Timestamp x)
使用值java.sql.Timestamp
更新指定列。boolean
wasNull()
报告最后一列读取的值是否为SQLNULL
。-
声明方法的接口 java.sql.Wrapper
isWrapperFor, unwrap
-
-
-
-
字段详细信息
-
FETCH_FORWARD
static final int FETCH_FORWARD
该常量指示结果集中的行将在向前方向上处理; 第一个到最后。 方法setFetchDirection
使用该常数作为驱动程序的提示,驱动程序可以忽略该提示。- 从以下版本开始:
- 1.2
- 另请参见:
- 常数字段值
-
FETCH_REVERSE
static final int FETCH_REVERSE
该常量表示结果集中的行将以反方向处理; 最后到第一位。 方法setFetchDirection
使用该常数作为驱动程序的提示,驱动程序可以忽略该提示。- 从以下版本开始:
- 1.2
- 另请参见:
- 常数字段值
-
FETCH_UNKNOWN
static final int FETCH_UNKNOWN
该常量指示将处理结果集中的行的顺序未知。 方法setFetchDirection
使用该常数作为对驾驶员的提示,驾驶员可以忽略该提示。- 另请参见:
- 常数字段值
-
TYPE_FORWARD_ONLY
static final int TYPE_FORWARD_ONLY
常量,指示ResultSet
对象的类型,其光标可以仅向前移动。- 从以下版本开始:
- 1.2
- 另请参见:
- 常数字段值
-
TYPE_SCROLL_INSENSITIVE
static final int TYPE_SCROLL_INSENSITIVE
该常量指示ResultSet
对象的类型,该对象可滚动但通常对ResultSet
基础数据的更改不敏感。- 从以下版本开始:
- 1.2
- 另请参见:
- 常数字段值
-
TYPE_SCROLL_SENSITIVE
static final int TYPE_SCROLL_SENSITIVE
该常量指示ResultSet
对象的类型,该对象可滚动且通常对ResultSet
所基于的数据的更改敏感。- 从以下版本开始:
- 1.2
- 另请参见:
- 常数字段值
-
CONCUR_READ_ONLY
static final int CONCUR_READ_ONLY
该常量指示可能未更新的ResultSet
对象的并发模式。- 从以下版本开始:
- 1.2
- 另请参见:
- 常数字段值
-
CONCUR_UPDATABLE
static final int CONCUR_UPDATABLE
该常量指示可以更新的ResultSet
对象的并发模式。- 从以下版本开始:
- 1.2
- 另请参见:
- 常数字段值
-
HOLD_CURSORS_OVER_COMMIT
static final int HOLD_CURSORS_OVER_COMMIT
该常量指示在提交当前事务时,具有此可保持性的打开的ResultSet
对象将保持打开状态。- 从以下版本开始:
- 1.4
- 另请参见:
- 常数字段值
-
CLOSE_CURSORS_AT_COMMIT
static final int CLOSE_CURSORS_AT_COMMIT
该常量指示在提交当前事务时将关闭具有此可保持性的打开的ResultSet
对象。- 从以下版本开始:
- 1.4
- 另请参见:
- 常数字段值
-
-
方法详细信息
-
next
boolean next() throws SQLException
将光标从当前位置向前移动一行。ResultSet
光标最初位于第一行之前; 第一次调用方法next
使第一行成为当前行; 第二个调用使第二行成为当前行,依此类推。当对
next
方法的调用返回false
,光标位于最后一行之后。 任何需要当前行的ResultSet
方法的调用都将导致抛出SQLException
。 如果结果集类型为TYPE_FORWARD_ONLY
,它是指定的JDBC驱动程序实现是否会返回供应商false
或抛出SQLException
上的后续调用next
。如果为当前行打开输入流,则对方法
next
的调用将隐式关闭它。 读取新行时,将清除ResultSet
对象的警告链。- 结果
-
true
如果新的当前行有效;false
如果没有更多行 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
close
void close() throws SQLException
立即释放此ResultSet
对象的数据库和JDBC资源,而不是等待它自动关闭时发生。一个的闭合
ResultSet
对象不关闭Blob
,Clob
或NClob
由创建的对象ResultSet
。Blob
,Clob
或NClob
对象在它们被创建的,除非他们的交易的至少持续时间保持有效free
被调用方法。当
ResultSet
关闭时,通过调用getMetaData
方法创建的任何ResultSetMetaData
实例仍可访问。注意:
ResultSet
目的是通过自动关闭Statement
生成它时该对象Statement
对象被关闭时,重新执行,或用于检索从多个结果的序列中的下一结果。在已关闭的
ResultSet
对象上调用方法close
是无操作。- Specified by:
-
close
,界面AutoCloseable
- 异常
-
SQLException
- 如果发生数据库访问错误
-
wasNull
boolean wasNull() throws SQLException
报告最后一列读取的值是否为SQLNULL
。 请注意,必须首先调用列上的其中一个getter方法以尝试读取其值,然后调用方法wasNull
以查看读取的值是否为SQLNULL
。- 结果
-
true
如果读取的最后一列值为SQLNULL
,false
- 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getString
String getString(int columnIndex) throws SQLException
以Java编程语言中String
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为null
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getBoolean
boolean getBoolean(int columnIndex) throws SQLException
以Java编程语言中boolean
此ResultSet
对象的当前行中指定列的值。如果指定列的数据类型为CHAR或VARCHAR且包含“0”或数据类型为BIT,TINYINT,SMALLINT,INTEGER或BIGINT且包含0,则返回值
false
。 如果指定列的数据类型为CHAR或VARCHAR且包含“1”或数据类型为BIT,TINYINT,SMALLINT,INTEGER或BIGINT且包含1,则返回值true
。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为false
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getByte
byte getByte(int columnIndex) throws SQLException
以Java编程语言中byte
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为0
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getShort
short getShort(int columnIndex) throws SQLException
以Java编程语言中short
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为0
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getInt
int getInt(int columnIndex) throws SQLException
以Java编程语言中int
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为0
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getLong
long getLong(int columnIndex) throws SQLException
以Java编程语言中long
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为0
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getFloat
float getFloat(int columnIndex) throws SQLException
以Java编程语言中float
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为0
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getDouble
double getDouble(int columnIndex) throws SQLException
以Java编程语言中double
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为0
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getBigDecimal
@Deprecated(since="1.2") BigDecimal getBigDecimal(int columnIndex, int scale) throws SQLException
Deprecated.UsegetBigDecimal(int columnIndex)
orgetBigDecimal(String columnLabel)
以Java编程语言中java.sql.BigDecimal
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
scale
- 小数点右边的位数 - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为null
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
-
getBytes
byte[] getBytes(int columnIndex) throws SQLException
以Java编程语言中byte
数组的形式byte
此ResultSet
对象的当前行中指定列的值。 字节表示驱动程序返回的原始值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为null
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getDate
Date getDate(int columnIndex) throws SQLException
以Java编程语言中ResultSet
对象的形式java.sql.Date
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为null
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getTime
Time getTime(int columnIndex) throws SQLException
以Java编程语言中ResultSet
对象的形式java.sql.Time
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为null
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getTimestamp
Timestamp getTimestamp(int columnIndex) throws SQLException
以Java编程语言中ResultSet
对象的形式java.sql.Timestamp
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为null
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getAsciiStream
InputStream getAsciiStream(int columnIndex) throws SQLException
以ASCII字符流的形式检索此ResultSet
对象的当前行中指定列的值。 然后可以从流中读取块的值。 此方法特别适用于检索大的LONGVARCHAR
值。 JDBC驱动程序将执行从数据库格式到ASCII的任何必要转换。注意:必须在获取任何其他列的值之前读取返回流中的所有数据。 下一次调用getter方法会隐式关闭流。 此外,当调用方法
InputStream.available
是否存在可用数据时,流可以返回0
。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
一个Java输入流,它将数据库列值作为一个字节的ASCII字符流提供;
如果值为SQL
NULL
,则返回的值为null
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getUnicodeStream
@Deprecated(since="1.2") InputStream getUnicodeStream(int columnIndex) throws SQLException
Deprecated.usegetCharacterStream
in place ofgetUnicodeStream
检索此ResultSet
对象的当前行中指定列的值,作为双字节3个字符的流。 第一个字节是高字节; 第二个字节是低字节。 然后可以从流中读取块的值。 此方法特别适用于检索大的LONGVARCHAR
值。 JDBC驱动程序将执行从数据库格式到Unicode的任何必要转换。注意:必须在获取任何其他列的值之前读取返回流中的所有数据。 下一次调用getter方法会隐式关闭流。 此外,一个流可以返回
0
当方法InputStream.available
被调用时,是否有数据可用。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
一个Java输入流,它将数据库列值作为双字节Unicode字符流提供;
如果值为SQL
NULL
,则返回的值为null
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
-
getBinaryStream
InputStream getBinaryStream(int columnIndex) throws SQLException
检索此ResultSet
对象的当前行中指定列的值,作为未解释字节流。 然后可以从流中读取块的值。 此方法特别适用于检索大的LONGVARBINARY
值。注意:必须在获取任何其他列的值之前读取返回流中的所有数据。 下一次调用getter方法会隐式关闭流。 此外,当调用方法
InputStream.available
是否存在可用数据时,流可以返回0
。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
一个Java输入流,它将数据库列值作为未解释的字节流提供;
如果值为SQL
NULL
,则返回的值为null
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getString
String getString(String columnLabel) throws SQLException
以Java编程语言中String
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为null
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getBoolean
boolean getBoolean(String columnLabel) throws SQLException
以Java编程语言中boolean
此ResultSet
对象的当前行中指定列的值。如果指定列的数据类型为CHAR或VARCHAR且包含“0”或数据类型为BIT,TINYINT,SMALLINT,INTEGER或BIGINT且包含0,则返回值
false
。 如果指定列的数据类型为CHAR或VARCHAR且包含“1”或数据类型为BIT,TINYINT,SMALLINT,INTEGER或BIGINT且包含1,则返回值true
。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为false
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getByte
byte getByte(String columnLabel) throws SQLException
以Java编程语言中byte
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为0
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getShort
short getShort(String columnLabel) throws SQLException
以Java编程语言中short
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为0
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getInt
int getInt(String columnLabel) throws SQLException
以Java编程语言中int
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为0
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getLong
long getLong(String columnLabel) throws SQLException
以Java编程语言中long
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为0
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getFloat
float getFloat(String columnLabel) throws SQLException
以Java编程语言中float
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为0
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getDouble
double getDouble(String columnLabel) throws SQLException
以Java编程语言中double
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为0
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getBigDecimal
@Deprecated(since="1.2") BigDecimal getBigDecimal(String columnLabel, int scale) throws SQLException
Deprecated.UsegetBigDecimal(int columnIndex)
orgetBigDecimal(String columnLabel)
以Java编程语言中java.math.BigDecimal
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
scale
- 小数点右边的位数 - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为null
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
-
getBytes
byte[] getBytes(String columnLabel) throws SQLException
以Java编程语言中byte
数组的形式byte
此ResultSet
对象的当前行中指定列的值。 字节表示驱动程序返回的原始值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为null
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getDate
Date getDate(String columnLabel) throws SQLException
以Java编程语言中ResultSet
对象的形式java.sql.Date
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为null
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getTime
Time getTime(String columnLabel) throws SQLException
以Java编程语言中ResultSet
对象的形式java.sql.Time
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为null
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getTimestamp
Timestamp getTimestamp(String columnLabel) throws SQLException
以Java编程语言中ResultSet
对象的形式java.sql.Timestamp
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为null
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getAsciiStream
InputStream getAsciiStream(String columnLabel) throws SQLException
以ASCII字符流的形式检索此ResultSet
对象的当前行中指定列的值。 然后可以从流中读取块的值。 此方法特别适用于检索大的LONGVARCHAR
值。 JDBC驱动程序将执行从数据库格式到ASCII的任何必要转换。注意:必须在获取任何其他列的值之前读取返回流中的所有数据。 下一次调用getter方法会隐式关闭流。 此外,当调用方法
available
是否存在可用数据时,流可以返回0
。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
一个Java输入流,它将数据库列值作为单字节ASCII字符流传递。
如果值为SQL
NULL
,则返回的值为null
。 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getUnicodeStream
@Deprecated(since="1.2") InputStream getUnicodeStream(String columnLabel) throws SQLException
Deprecated.usegetCharacterStream
instead以双字节Unicode字符流的形式检索此ResultSet
对象的当前行中指定列的值。 第一个字节是高字节; 第二个字节是低字节。 然后可以从流中读取块的值。 此方法特别适用于检索大的LONGVARCHAR
值。 启用JDBC技术的驱动程序将执行从数据库格式到Unicode的任何必要转换。注意:必须在获取任何其他列的值之前读取返回流中的所有数据。 下一次调用getter方法会隐式关闭流。 此外,一个流可以返回
0
当方法InputStream.available
被调用时,是否有数据可用。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
一个Java输入流,它将数据库列值作为双字节Unicode字符流传递。
如果值为SQL
NULL
,则返回的值为null
。 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
-
getBinaryStream
InputStream getBinaryStream(String columnLabel) throws SQLException
以未解释的byte
流的形式byte
此ResultSet
对象的当前行中指定列的值。 然后可以从流中读取块的值。 此方法特别适用于检索大的LONGVARBINARY
值。注意:必须在获取任何其他列的值之前读取返回流中的所有数据。 下一次调用getter方法会隐式关闭流。 此外,当调用方法
available
是否存在可用数据时,流可以返回0
。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
一个Java输入流,它将数据库列值作为未解释的字节流提供;
如果值为SQL
NULL
,则结果为null
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getWarnings
SQLWarning getWarnings() throws SQLException
检索此ResultSet
对象上的调用报告的第一个警告。 此ResultSet
对象的后续警告将链接到此方法返回的SQLWarning
对象。每次读取新行时都会自动清除警告链。 可能无法在已关闭的
ResultSet
对象上调用此方法; 这样做会导致抛出SQLException
。注意:此警告链仅涵盖由
ResultSet
方法引起的警告。 由Statement
方法引起的任何警告(例如读取OUT参数)都将链接在Statement
对象上。- 结果
-
报告的第一个
SQLWarning
对象或null
如果没有) - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
clearWarnings
void clearWarnings() throws SQLException
清除此ResultSet
对象上报告的所有警告。 调用此方法后,方法getWarnings
返回null
直到为此ResultSet
对象报告新警告。- 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getCursorName
String getCursorName() throws SQLException
检索此ResultSet
对象使用的SQL游标的名称。在SQL中,通过命名的游标检索结果表。 可以使用引用游标名称的定位更新/删除语句来更新或删除结果集的当前行。 为确保游标具有适当的隔离级别以支持更新,游标的
SELECT
语句的格式应为SELECT FOR UPDATE
。 如果省略FOR UPDATE
,则定位的更新可能会失败。JDBC API通过提供
ResultSet
对象使用的SQL游标的名称来支持此SQL功能。ResultSet
对象的当前行也是此SQL游标的当前行。- 结果
-
此
ResultSet
对象的游标的SQL名称 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
-
getMetaData
ResultSetMetaData getMetaData() throws SQLException
检索此ResultSet
对象列的数量,类型和属性。- 结果
-
这个
ResultSet
对象列的描述 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getObject
Object getObject(int columnIndex) throws SQLException
以Java编程语言中
Object
获取此ResultSet
对象的当前行中指定列的值。此方法将返回给定列的值作为Java对象。 Java对象的类型将是与列的SQL类型对应的缺省Java对象类型,遵循JDBC规范中指定的内置类型的映射。 如果值为SQL
NULL
,则驱动程序返回Javanull
。此方法还可用于读取特定于数据库的抽象数据类型。 在JDBC 2.0 API中,方法
getObject
的行为已扩展为实现SQL用户定义类型的数据。如果
Connection.getTypeMap
未抛出SQLFeatureNotSupportedException
,则当列包含结构化或不同的值时,此方法的行为就像是对以下内容的调用:getObject(columnIndex, this.getStatement().getConnection().getTypeMap())
。 如果Connection.getTypeMap
确实抛出了SQLFeatureNotSupportedException
,则不支持结构化值,并且不同的值将映射到默认Java类,这由DISTINCT类型的基础SQL类型确定。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
a
java.lang.Object
保留列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getObject
Object getObject(String columnLabel) throws SQLException
获取此
ResultSet
对象的当前行中指定列的值,作为Java编程语言中的Object
。此方法将返回给定列的值作为Java对象。 Java对象的类型将是与列的SQL类型对应的缺省Java对象类型,遵循JDBC规范中指定的内置类型的映射。 如果值为SQL
NULL
,则驱动程序返回Javanull
。此方法还可用于读取特定于数据库的抽象数据类型。
在JDBC 2.0 API中,方法
getObject
的行为被扩展为具体化SQL用户定义类型的数据。 当列包含结构化或不同的值时,此方法的行为就像是对以下内容的调用:getObject(columnIndex, this.getStatement().getConnection().getTypeMap())
。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
a
java.lang.Object
保持列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
findColumn
int findColumn(String columnLabel) throws SQLException
将给定的ResultSet
列标签映射到其ResultSet
列索引。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
- 给定列名的列索引
- 异常
-
SQLException
- 如果ResultSet
对象不包含标记为columnLabel
的列,则会发生数据库访问错误或在关闭的结果集上调用此方法
-
getCharacterStream
Reader getCharacterStream(int columnIndex) throws SQLException
以ResultSet
对象的形式java.io.Reader
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
包含列值的
java.io.Reader
对象; 如果值为SQLNULL
,则返回的值为Java编程语言中的null
。 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 从以下版本开始:
- 1.2
-
getCharacterStream
Reader getCharacterStream(String columnLabel) throws SQLException
以ResultSet
对象的形式java.io.Reader
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
包含列值的
java.io.Reader
对象; 如果值为SQLNULL
,则返回的值为Java编程语言中的null
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 从以下版本开始:
- 1.2
-
getBigDecimal
BigDecimal getBigDecimal(int columnIndex) throws SQLException
以java.math.BigDecimal
的全精度检索此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值(全精度);
如果值为SQL
NULL
,则返回的值为Java编程语言中的null
。 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 从以下版本开始:
- 1.2
-
getBigDecimal
BigDecimal getBigDecimal(String columnLabel) throws SQLException
以java.math.BigDecimal
的全精度检索此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
列值(全精度);
如果值为SQL
NULL
,则返回的值为Java编程语言中的null
。 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 从以下版本开始:
- 1.2
-
isBeforeFirst
boolean isBeforeFirst() throws SQLException
检索光标是否在此ResultSet
对象的第一行之前。注意:对于
ResultSet
s,支持isBeforeFirst
方法是可选的,结果集类型为TYPE_FORWARD_ONLY
- 结果
-
true
如果光标在第一行之前;false
如果光标位于任何其他位置或结果集不包含任何行 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
isAfterLast
boolean isAfterLast() throws SQLException
检索光标是否在此ResultSet
对象的最后一行之后。注意:对于
ResultSet
s,支持isAfterLast
方法是可选的,结果集类型为TYPE_FORWARD_ONLY
- 结果
-
true
如果光标在最后一行之后;false
如果光标位于任何其他位置或结果集不包含任何行 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
isFirst
boolean isFirst() throws SQLException
检索光标是否位于此ResultSet
对象的第一行。注意:对于
ResultSet
s,isFirst
方法的支持是可选的,结果集类型为TYPE_FORWARD_ONLY
- 结果
-
true
如果光标在第一行; 否则为false
- 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
isLast
boolean isLast() throws SQLException
检索光标是否位于此ResultSet
对象的最后一行。 注意:调用方法isLast
可能很昂贵,因为JDBC驱动程序可能需要提取一行以确定当前行是否是结果集中的最后一行。注意:对于
ResultSet
s,isLast
方法的支持是可选的,结果集类型为TYPE_FORWARD_ONLY
- 结果
-
true
如果光标在最后一行; 否则为false
- 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
beforeFirst
void beforeFirst() throws SQLException
将光标移动到此ResultSet
对象的前面,就在第一行之前。 如果结果集不包含任何行,则此方法无效。- 异常
-
SQLException
- 如果发生数据库访问错误; 在闭合的结果集上调用此方法,或者结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
afterLast
void afterLast() throws SQLException
将光标移动到此ResultSet
对象的末尾,ResultSet
在最后一行之后。 如果结果集不包含任何行,则此方法无效。- 异常
-
SQLException
- 如果发生数据库访问错误; 在闭合的结果集上调用此方法,或者结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
first
boolean first() throws SQLException
将光标移动到此ResultSet
对象中的第一行。- 结果
-
true
如果光标在有效行上;false
如果结果集中没有行 - 异常
-
SQLException
- 如果发生数据库访问错误; 在闭合的结果集上调用此方法,或者结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
last
boolean last() throws SQLException
将光标移动到此ResultSet
对象中的最后一行。- 结果
-
true
如果光标在有效行上;false
如果结果集中没有行 - 异常
-
SQLException
- 如果发生数据库访问错误; 在闭合的结果集上调用此方法,或者结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getRow
int getRow() throws SQLException
检索当前行号。 第一行是数字1,第二行是数字2,依此类推。注意:对于
ResultSet
s,支持getRow
方法是可选的,结果集类型为TYPE_FORWARD_ONLY
- 结果
-
当前行号;
0
如果没有当前行 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
absolute
boolean absolute(int row) throws SQLException
将光标移动到此ResultSet
对象中的给定行号。如果行号为正,则光标相对于结果集的开头移动到给定的行号。 第一行是第1行,第二行是第2行,依此类推。
如果给定的行号为负,则光标移动到相对于结果集末尾的绝对行位置。 例如,调用方法
absolute(-1)
将光标定位在最后一行; 调用方法absolute(-2)
将光标移动到倒数第二行,依此类推。如果指定的行号为零,则光标移动到第一行之前。
将光标定位在结果集中的第一行/最后一行之外的尝试将光标留在第一行之前或最后一行之后。
注意:致电
absolute(1)
与致电first()
相同。 呼叫absolute(-1)
与呼叫last()
相同。- 参数
-
row
- 光标应移动到的行的编号。 值为零表示光标将位于第一行之前; 正数表示从结果集开头计数的行号; 负数表示从结果集的末尾开始计数的行号 - 结果
-
true
如果光标移动到此ResultSet
对象中的某个位置;false
如果光标位于第一行之前或最后一行之后 - 异常
-
SQLException
- 如果发生数据库访问错误; 在闭合的结果集上调用此方法,或者结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
relative
boolean relative(int rows) throws SQLException
将光标移动相对的行数(正数或负数)。 尝试超出结果集中的第一行/最后一行将光标定位在第一行/最后一行之前/之后。 调用relative(0)
有效,但不会更改光标位置。注:调用方法
relative(1)
是相同的调用方法next()
并调用方法relative(-1)
是相同的调用方法previous()
。- 参数
-
rows
- 一个int
指定从当前行移动的行数; 正数会向前移动光标; 负数会向后移动光标 - 结果
-
true
如果光标在一行上; 否则为false
- 异常
-
SQLException
- 如果发生数据库访问错误; 在闭合的结果集上调用此方法,或者结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
previous
boolean previous() throws SQLException
将光标移动到此ResultSet
对象中的上一行。当对
previous
方法的调用返回false
,光标位于第一行之前。 任何需要当前行的ResultSet
方法的调用都将导致抛出SQLException
。如果为当前行打开输入流,则对方法
previous
的调用将隐式关闭它。 读取新行时,将清除ResultSet
对象的警告更改。- 结果
-
true
如果光标现在位于有效行上;false
如果光标位于第一行之前 - 异常
-
SQLException
- 如果发生数据库访问错误; 在关闭的结果集上调用此方法,或者结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
setFetchDirection
void setFetchDirection(int direction) throws SQLException
提供有关此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
int getFetchDirection() throws SQLException
检索此ResultSet
对象的获取方向。- 结果
-
此
ResultSet
对象的当前获取方向 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 从以下版本开始:
- 1.2
- 另请参见:
-
setFetchDirection(int)
-
setFetchSize
void setFetchSize(int rows) throws SQLException
为JDBC驱动程序提供有关此ResultSet
对象需要更多行时应从数据库中提取的行数的提示。 如果指定的提取大小为零,则JDBC驱动程序会忽略该值,并可以自由地猜测提取大小应该是什么。 默认值由创建结果集的Statement
对象设置。 可以随时更改提取大小。- 参数
-
rows
- 要获取的行数 - 异常
-
SQLException
- 如果发生数据库访问错误; 在关闭的结果集上调用此方法或不满足条件rows >= 0
- 从以下版本开始:
- 1.2
- 另请参见:
-
getFetchSize()
-
getFetchSize
int getFetchSize() throws SQLException
检索此ResultSet
对象的提取大小。- 结果
-
此
ResultSet
对象的当前提取大小 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 从以下版本开始:
- 1.2
- 另请参见:
-
setFetchSize(int)
-
getType
int getType() throws SQLException
检索此ResultSet
对象的类型。 类型由创建结果集的Statement
对象确定。- 结果
-
ResultSet.TYPE_FORWARD_ONLY
,ResultSet.TYPE_SCROLL_INSENSITIVE
,或ResultSet.TYPE_SCROLL_SENSITIVE
- 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 从以下版本开始:
- 1.2
-
getConcurrency
int getConcurrency() throws SQLException
检索此ResultSet
对象的并发模式。 使用的并发性由创建结果集的Statement
对象确定。- 结果
-
并发类型,
ResultSet.CONCUR_READ_ONLY
或ResultSet.CONCUR_UPDATABLE
- 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 从以下版本开始:
- 1.2
-
rowUpdated
boolean rowUpdated() throws SQLException
检索当前行是否已更新。 返回的值取决于结果集是否可以检测更新。注意:对
rowUpdated
方法的支持是可选的,结果集并发为CONCUR_READ_ONLY
- 结果
-
true
如果检测到当前行已被所有者或其他人明显更新; 否则为false
- 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
- 另请参见:
-
DatabaseMetaData.updatesAreDetected(int)
-
rowInserted
boolean rowInserted() throws SQLException
检索当前行是否已插入。 返回的值取决于此ResultSet
对象是否可以检测可见插入。注意:支持
rowInserted
方法是可选的,结果集并发为CONCUR_READ_ONLY
- 结果
-
true
如果检测到当前行已被插入; 否则为false
- 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
- 另请参见:
-
DatabaseMetaData.insertsAreDetected(int)
-
rowDeleted
boolean rowDeleted() throws SQLException
检索是否已删除行。 删除的行可能会在结果集中留下可见的“洞”。 此方法可用于检测结果集中的孔。 返回的值取决于此ResultSet
对象是否可以检测到删除。注意:对
rowDeleted
方法的支持是可选的,结果集并发为CONCUR_READ_ONLY
- 结果
-
true
如果检测到当前行已被所有者或其他人删除; 否则为false
- 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
- 另请参见:
-
DatabaseMetaData.deletesAreDetected(int)
-
updateNull
void updateNull(int columnIndex) throws SQLException
使用null
值更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateBoolean
void updateBoolean(int columnIndex, boolean x) throws SQLException
使用值boolean
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateByte
void updateByte(int columnIndex, byte x) throws SQLException
使用值byte
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateShort
void updateShort(int columnIndex, short x) throws SQLException
使用short
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateInt
void updateInt(int columnIndex, int x) throws SQLException
使用int
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateLong
void updateLong(int columnIndex, long x) throws SQLException
使用值long
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateFloat
void updateFloat(int columnIndex, float x) throws SQLException
使用float
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateDouble
void updateDouble(int columnIndex, double x) throws SQLException
使用值double
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateBigDecimal
void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException
使用java.math.BigDecimal
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateString
void updateString(int columnIndex, String x) throws SQLException
使用String
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateBytes
void updateBytes(int columnIndex, byte[] x) throws SQLException
使用byte
数组值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateDate
void updateDate(int columnIndex, Date x) throws SQLException
使用java.sql.Date
值更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateTime
void updateTime(int columnIndex, Time x) throws SQLException
使用值java.sql.Time
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateTimestamp
void updateTimestamp(int columnIndex, Timestamp x) throws SQLException
使用java.sql.Timestamp
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateAsciiStream
void updateAsciiStream(int columnIndex, InputStream x, int length) throws SQLException
使用ascii流值更新指定列,该值将具有指定的字节数。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 -
length
- 流的长度 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateBinaryStream
void updateBinaryStream(int columnIndex, InputStream x, int length) throws SQLException
使用二进制流值更新指定列,该值将具有指定的字节数。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 -
length
- 流的长度 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateCharacterStream
void updateCharacterStream(int columnIndex, Reader x, int length) throws SQLException
使用字符流值更新指定的列,该值将具有指定的字节数。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 -
length
- 流的长度 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateObject
void updateObject(int columnIndex, Object x, int scaleOrLength) throws SQLException
使用值Object
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。如果第二个参数是
InputStream
则流必须包含scaleOrLength指定的字节数。 如果第二个参数是Reader
则读者必须包含scaleOrLength指定的字符数。 如果这些条件不成立,则在执行语句时,驱动程序将生成SQLException
。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 -
scaleOrLength
-为的目的java.math.BigDecimal
,这是数字的小数点后的位数。 对于Java对象类型InputStream
和Reader
,这是流或读取器中数据的长度。 对于所有其他类型,将忽略此值。 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateObject
void updateObject(int columnIndex, Object x) throws SQLException
使用Object
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateNull
void updateNull(String columnLabel) throws SQLException
使用null
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateBoolean
void updateBoolean(String columnLabel, boolean x) throws SQLException
使用值boolean
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateByte
void updateByte(String columnLabel, byte x) throws SQLException
使用值byte
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateShort
void updateShort(String columnLabel, short x) throws SQLException
使用值short
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateInt
void updateInt(String columnLabel, int x) throws SQLException
使用int
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateLong
void updateLong(String columnLabel, long x) throws SQLException
使用值long
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateFloat
void updateFloat(String columnLabel, float x) throws SQLException
使用值float
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateDouble
void updateDouble(String columnLabel, double x) throws SQLException
使用double
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateBigDecimal
void updateBigDecimal(String columnLabel, BigDecimal x) throws SQLException
使用java.sql.BigDecimal
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateString
void updateString(String columnLabel, String x) throws SQLException
使用值String
更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateBytes
void updateBytes(String columnLabel, byte[] x) throws SQLException
使用字节数组值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateDate
void updateDate(String columnLabel, Date x) throws SQLException
使用值java.sql.Date
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateTime
void updateTime(String columnLabel, Time x) throws SQLException
使用值java.sql.Time
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateTimestamp
void updateTimestamp(String columnLabel, Timestamp x) throws SQLException
使用java.sql.Timestamp
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateAsciiStream
void updateAsciiStream(String columnLabel, InputStream x, int length) throws SQLException
使用ascii流值更新指定列,该值将具有指定的字节数。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 -
length
- 流的长度 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateBinaryStream
void updateBinaryStream(String columnLabel, InputStream x, int length) throws SQLException
使用二进制流值更新指定列,该值将具有指定的字节数。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 -
length
- 流的长度 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateCharacterStream
void updateCharacterStream(String columnLabel, Reader reader, int length) throws SQLException
使用字符流值更新指定的列,该值将具有指定的字节数。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
reader
- 包含新列值的java.io.Reader
对象 -
length
- 流的长度 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateObject
void updateObject(String columnLabel, Object x, int scaleOrLength) throws SQLException
使用值Object
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。如果第二个参数是
InputStream
则流必须包含scaleOrLength指定的字节数。 如果第二个参数是Reader
则读者必须包含scaleOrLength指定的字符数。 如果这些条件不成立,则在执行语句时,驱动程序将生成SQLException
。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 -
scaleOrLength
-为的目的java.math.BigDecimal
,这是数字的小数点后的位数。 对于Java对象类型InputStream
和Reader
,这是流或读取器中数据的长度。 对于所有其他类型,将忽略此值。 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateObject
void updateObject(String columnLabel, Object x) throws SQLException
使用Object
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
insertRow
void insertRow() throws SQLException
将插入行的内容插入此ResultSet
对象并插入数据库。 调用此方法时,游标必须位于插入行上。- 异常
-
SQLException
- 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
,如果在游标不在插入行上时调用此方法,或者如果插入行中的所有非可空列都未赋予非结果集,则调用此方法 - 空值 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateRow
void updateRow() throws SQLException
使用此ResultSet
对象的当前行的新内容更新基础数据库。 当光标位于插入行上时,无法调用此方法。- 异常
-
SQLException
- 如果发生数据库访问错误; 结果集并发为CONCUR_READ_ONLY
; 在闭合的结果集上调用此方法,或者在光标位于插入行上时调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
deleteRow
void deleteRow() throws SQLException
从此ResultSet
对象和基础数据库中删除当前行。 当光标位于插入行上时,无法调用此方法。- 异常
-
SQLException
- 如果发生数据库访问错误; 结果集并发为CONCUR_READ_ONLY
; 在闭合的结果集上调用此方法,或者在光标位于插入行上时调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
refreshRow
void refreshRow() throws SQLException
使用数据库中的最新值刷新当前行。 当光标位于插入行上时,无法调用此方法。refreshRow
方法为应用程序提供了一种方法,可以显式地告诉JDBC驱动程序从数据库中重新获取行。 当JDBC驱动程序执行缓存或预取以从数据库中获取行的最新值时,应用程序可能希望调用refreshRow
。 如果提取大小大于1,则JDBC驱动程序实际上可以一次刷新多行。根据事务隔离级别和游标敏感性,重新获取所有值。 如果在调用updater方法之后调用
refreshRow
,但在调用方法updateRow
之前,则对该行所做的更新将丢失。 经常调用方法refreshRow
可能会降低性能。- 异常
-
SQLException
- 如果发生数据库访问错误; 在闭合的结果集上调用此方法; 结果集类型为TYPE_FORWARD_ONLY
或者当光标位于插入行上时调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法,或者指定的结果集类型和结果集并发不支持此方法。 - 从以下版本开始:
- 1.2
-
cancelRowUpdates
void cancelRowUpdates() throws SQLException
取消对此ResultSet
对象中当前行所做的更新。 可以在调用更新器方法之后并且在调用方法updateRow
以回滚对行进行的更新之前调用该方法。 如果尚未进行更新或已调用updateRow
,则此方法无效。- 异常
-
SQLException
- 如果发生数据库访问错误; 在闭合的结果集上调用此方法; 结果集并发性为CONCUR_READ_ONLY
或者当光标位于插入行上时调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
moveToInsertRow
void moveToInsertRow() throws SQLException
将光标移动到插入行。 当光标位于插入行上时,将记住当前光标位置。 插入行是与可更新结果集关联的特殊行。 它本质上是一个缓冲区,可以通过在将行插入结果集之前调用updater方法来构造新行。 当光标位于插入行上时,只能调用updater,getter和insertRow
方法。 每次调用此方法之前,必须为结果集中的所有列指定值,然后再调用insertRow
。 必须先调用updater方法,然后才能在列值上调用getter方法。- 异常
-
SQLException
- 如果发生数据库访问错误; 在闭合的结果集上调用此方法,或者结果集并发性为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
moveToCurrentRow
void moveToCurrentRow() throws SQLException
将光标移动到记住的光标位置,通常是当前行。 如果光标不在插入行上,则此方法无效。- 异常
-
SQLException
- 如果发生数据库访问错误; 在闭合的结果集上调用此方法,或者结果集并发性为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getStatement
Statement getStatement() throws SQLException
检索Statement
生成此对象ResultSet
对象。 如果结果集是以某种其他方式生成的,例如通过DatabaseMetaData
方法生成,则此方法可能返回null
。- 结果
-
所述
Statement
生成此对象ResultSet
对象或null
如果结果集制作一些其他的方式 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 从以下版本开始:
- 1.2
-
getObject
Object getObject(int columnIndex, Map<String,类<?>> map) throws SQLException
以Java编程语言中Object
此ResultSet
对象的当前行中指定列的值。 如果值为SQLNULL
,则驱动程序返回Javanull
。 此方法使用给定的Map
对象来自定义正在检索的SQL结构化或不同类型的映射。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
map
- 一个java.util.Map
对象,包含从Java类型名称到Java编程语言中的类的映射 - 结果
-
表示SQL值的Java编程语言中的
Object
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getRef
Ref getRef(int columnIndex) throws SQLException
以Java编程语言中ResultSet
对象的形式Ref
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
表示SQL
REF
值的Ref
对象 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getBlob
Blob getBlob(int columnIndex) throws SQLException
以Java编程语言中ResultSet
对象的形式Blob
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
一个
Blob
对象,表示指定列中的SQLBLOB
值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getClob
Clob getClob(int columnIndex) throws SQLException
以Java编程语言中ResultSet
对象的形式Clob
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
一个
Clob
对象,表示指定列中的SQLCLOB
值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getArray
Array getArray(int columnIndex) throws SQLException
以Java编程语言中ResultSet
对象的形式Array
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
一个
Array
对象,表示指定列中的SQLARRAY
值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getObject
Object getObject(String columnLabel, Map<String,类<?>> map) throws SQLException
以Java编程语言中Object
此ResultSet
对象的当前行中指定列的值。 如果值为SQLNULL
,则驱动程序返回Javanull
。 如果适用,此方法使用指定的Map
对象进行自定义映射。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
map
- 包含从Java类型名称到Java编程语言中的类的映射的java.util.Map
对象 - 结果
-
Object
表示指定列中的SQL值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getRef
Ref getRef(String columnLabel) throws SQLException
以Java编程语言中ResultSet
对象的形式Ref
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
一个
Ref
对象,表示指定列中的SQLREF
值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getBlob
Blob getBlob(String columnLabel) throws SQLException
以Java编程语言中ResultSet
对象的形式Blob
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
Blob
对象,表示指定列中的SQLBLOB
值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getClob
Clob getClob(String columnLabel) throws SQLException
以Java编程语言中ResultSet
对象的形式Clob
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
一个
Clob
对象,表示指定列中的SQLCLOB
值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getArray
Array getArray(String columnLabel) throws SQLException
以Java编程语言中ResultSet
对象的形式Array
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
一个
Array
对象,表示指定列中的SQLARRAY
值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getDate
Date getDate(int columnIndex, Calendar cal) throws SQLException
以Java编程语言中ResultSet
对象的形式java.sql.Date
此ResultSet
对象的当前行中指定列的值。 如果基础数据库不存储时区信息,则此方法使用给定日历为日期构造适当的毫秒值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
cal
- 用于构造日期的java.util.Calendar
对象 - 结果
-
列值为
java.sql.Date
对象; 如果值为SQLNULL
,则返回的值为Java编程语言中的null
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 从以下版本开始:
- 1.2
-
getDate
Date getDate(String columnLabel, Calendar cal) throws SQLException
以Java编程语言中ResultSet
对象的形式java.sql.Date
此ResultSet
对象的当前行中指定列的值。 如果基础数据库不存储时区信息,则此方法使用给定日历为日期构造适当的毫秒值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
cal
- 用于构造日期的java.util.Calendar
对象 - 结果
-
列值为
java.sql.Date
对象; 如果值为SQLNULL
,则返回的值为Java编程语言中的null
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 从以下版本开始:
- 1.2
-
getTime
Time getTime(int columnIndex, Calendar cal) throws SQLException
以Java编程语言中ResultSet
对象的形式java.sql.Time
此ResultSet
对象的当前行中指定列的值。 如果基础数据库不存储时区信息,则此方法使用给定日历构造适当的毫秒值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
cal
- 用于构造时间的java.util.Calendar
对象 - 结果
-
列值为
java.sql.Time
对象; 如果值为SQLNULL
,则返回的值为Java编程语言中的null
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 从以下版本开始:
- 1.2
-
getTime
Time getTime(String columnLabel, Calendar cal) throws SQLException
以Java编程语言中ResultSet
对象的形式java.sql.Time
此ResultSet
对象的当前行中指定列的值。 如果基础数据库不存储时区信息,则此方法使用给定日历构造适当的毫秒值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
cal
- 用于构造时间的java.util.Calendar
对象 - 结果
-
列值为
java.sql.Time
对象; 如果值为SQLNULL
,则返回的值为Java编程语言中的null
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 从以下版本开始:
- 1.2
-
getTimestamp
Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException
以Java编程语言中ResultSet
对象的形式java.sql.Timestamp
此ResultSet
对象的当前行中指定列的值。 如果基础数据库不存储时区信息,则此方法使用给定日历为时间戳构造适当的毫秒值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
cal
- 用于构造时间戳的java.util.Calendar
对象 - 结果
-
列值为
java.sql.Timestamp
对象; 如果值为SQLNULL
,则返回的值为Java编程语言中的null
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 从以下版本开始:
- 1.2
-
getTimestamp
Timestamp getTimestamp(String columnLabel, Calendar cal) throws SQLException
以Java编程语言中ResultSet
对象的形式java.sql.Timestamp
此ResultSet
对象的当前行中指定列的值。 如果基础数据库不存储时区信息,则此方法使用给定日历为时间戳构造适当的毫秒值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
cal
- 用于构造日期的java.util.Calendar
对象 - 结果
-
列值为
java.sql.Timestamp
对象; 如果值为SQLNULL
,则返回的值为Java编程语言中的null
- 异常
-
SQLException
- 如果columnLabel无效或发生数据库访问错误或在关闭的结果集上调用此方法 - 从以下版本开始:
- 1.2
-
getURL
URL getURL(int columnIndex) throws SQLException
以Java编程语言中ResultSet
对象的形式java.net.URL
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 列1的索引是第一个,2是第二个,... - 结果
-
列值为
java.net.URL
对象; 如果值为SQLNULL
,则返回的值为Java编程语言中的null
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 在封闭的结果集上调用此方法,或者如果URL格式错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
getURL
URL getURL(String columnLabel) throws SQLException
以Java编程语言中ResultSet
对象的形式java.net.URL
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
列值为
java.net.URL
对象; 如果值为SQLNULL
,则返回的值为Java编程语言中的null
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 在封闭的结果集上调用此方法,或者如果URL格式错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
updateRef
void updateRef(int columnIndex, Ref x) throws SQLException
使用java.sql.Ref
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
updateRef
void updateRef(String columnLabel, Ref x) throws SQLException
使用值java.sql.Ref
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
updateBlob
void updateBlob(int columnIndex, Blob x) throws SQLException
使用值java.sql.Blob
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
updateBlob
void updateBlob(String columnLabel, Blob x) throws SQLException
使用值java.sql.Blob
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
updateClob
void updateClob(int columnIndex, Clob x) throws SQLException
使用值java.sql.Clob
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
updateClob
void updateClob(String columnLabel, Clob x) throws SQLException
使用值java.sql.Clob
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
updateArray
void updateArray(int columnIndex, Array x) throws SQLException
使用java.sql.Array
值更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
updateArray
void updateArray(String columnLabel, Array x) throws SQLException
使用java.sql.Array
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
getRowId
RowId getRowId(int columnIndex) throws SQLException
以Java编程语言中ResultSet
对象的形式java.sql.RowId
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值;
如果值为SQL
NULL
则返回的值为null
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
getRowId
RowId getRowId(String columnLabel) throws SQLException
以Java编程语言中ResultSet
对象的形式java.sql.RowId
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
列值;
如果值为SQL
NULL
则返回的值为null
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateRowId
void updateRowId(int columnIndex, RowId x) throws SQLException
使用RowId
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateRowId
void updateRowId(String columnLabel, RowId x) throws SQLException
使用RowId
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
getHoldability
int getHoldability() throws SQLException
检索此ResultSet
对象的可保存性- 结果
-
ResultSet.HOLD_CURSORS_OVER_COMMIT
或ResultSet.CLOSE_CURSORS_AT_COMMIT
- 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 从以下版本开始:
- 1.6
-
isClosed
boolean isClosed() throws SQLException
检索此ResultSet
对象是否已关闭。 如果已在其上调用方法close,或者它已自动关闭,则关闭ResultSet
。- 结果
-
如果此
ResultSet
对象已关闭,ResultSet
true;否则为ResultSet
。 如果它仍然打开则为false - 异常
-
SQLException
- 如果发生数据库访问错误 - 从以下版本开始:
- 1.6
-
updateNString
void updateNString(int columnIndex, String nString) throws SQLException
使用String
值更新指定的列。 更新时,它适用于使用NCHAR
,NVARCHAR
和LONGNVARCHAR
列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
nString
- 要更新的列的值 - 异常
-
SQLException
- 如果columnIndex无效; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 在闭合的结果集上调用此方法; 结果集并发是CONCUR_READ_ONLY
或者是否发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateNString
void updateNString(String columnLabel, String nString) throws SQLException
使用String
值更新指定的列。 更新时,它适用于使用NCHAR
,NVARCHAR
和LONGNVARCHAR
列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
nString
- 要更新的列的值 - 异常
-
SQLException
- 如果columnLabel无效; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 在闭合的结果集上调用此方法; 结果集并发是CONCUR_READ_ONLY
或者是否发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateNClob
void updateNClob(int columnIndex, NClob nClob) throws SQLException
使用java.sql.NClob
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
nClob
- 要更新的列的值 - 异常
-
SQLException
- 如果columnIndex无效; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 在闭合的结果集上调用此方法; 如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateNClob
void updateNClob(String columnLabel, NClob nClob) throws SQLException
使用值java.sql.NClob
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
nClob
- 要更新的列的值 - 异常
-
SQLException
- 如果columnLabel无效; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 在闭合的结果集上调用此方法; 如果发生数据库访问错误或结果集并发是CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
getNClob
NClob getNClob(int columnIndex) throws SQLException
以Java编程语言中ResultSet
对象的形式NClob
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
一个
NClob
对象,表示指定列中的SQLNCLOB
值 - 异常
-
SQLException
- 如果columnIndex无效; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 在关闭的结果集上调用此方法,或者如果发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
getNClob
NClob getNClob(String columnLabel) throws SQLException
以Java编程语言中ResultSet
对象的形式NClob
此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
一个
NClob
对象,表示指定列中的SQLNCLOB
值 - 异常
-
SQLException
- 如果columnLabel无效; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 在关闭的结果集上调用此方法,或者如果发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
getSQLXML
SQLXML getSQLXML(int columnIndex) throws SQLException
以Java编程语言中java.sql.SQLXML
对象的形式java.sql.SQLXML
此ResultSet
的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
映射
SQL XML
值的SQLXML
对象 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
getSQLXML
SQLXML getSQLXML(String columnLabel) throws SQLException
以Java编程语言中java.sql.SQLXML
对象的形式java.sql.SQLXML
此ResultSet
的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
映射
SQL XML
值的SQLXML
对象 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateSQLXML
void updateSQLXML(int columnIndex, SQLXML xmlObject) throws SQLException
使用java.sql.SQLXML
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
xmlObject
- 要更新的列的值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 在闭合的结果集上调用此方法; 的java.xml.transform.Result
,Writer
或OutputStream
尚未收为SQLXML
对象; 如果处理XML值或结果集并发时CONCUR_READ_ONLY
。 异常的getCause
方法可能会提供更详细的异常,例如,如果流不包含有效的XML。 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateSQLXML
void updateSQLXML(String columnLabel, SQLXML xmlObject) throws SQLException
使用java.sql.SQLXML
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
xmlObject
- 列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 在闭合的结果集上调用此方法; 的java.xml.transform.Result
,Writer
或OutputStream
尚未收为SQLXML
对象; 如果处理XML值或结果集并发时CONCUR_READ_ONLY
。 异常的getCause
方法可能提供更详细的异常,例如,如果流不包含有效的XML。 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
getNString
String getNString(int columnIndex) throws SQLException
以Java编程语言中String
此ResultSet
对象的当前行中指定列的值。 访问时,它适用于使用NCHAR
,NVARCHAR
和LONGNVARCHAR
列。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为null
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
getNString
String getNString(String columnLabel) throws SQLException
以Java编程语言中String
此ResultSet
对象的当前行中指定列的值。 访问时,它适用于使用NCHAR
,NVARCHAR
和LONGNVARCHAR
列。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
列值;
如果值为SQL
NULL
,则返回的值为null
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
getNCharacterStream
Reader getNCharacterStream(int columnIndex) throws SQLException
以ResultSet
对象的形式java.io.Reader
此ResultSet
对象的当前行中指定列的值。 访问时,它适用于使用NCHAR
,NVARCHAR
和LONGNVARCHAR
列。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
包含列值的
java.io.Reader
对象; 如果值为SQLNULL
,则返回的值为Java编程语言中的null
。 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
getNCharacterStream
Reader getNCharacterStream(String columnLabel) throws SQLException
以ResultSet
对象的形式java.io.Reader
此ResultSet
对象的当前行中指定列的值。 访问时,它适用于使用NCHAR
,NVARCHAR
和LONGNVARCHAR
列。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 - 结果
-
包含列值的
java.io.Reader
对象; 如果值为SQLNULL
,则返回的值为Java编程语言中的null
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateNCharacterStream
void updateNCharacterStream(int columnIndex, Reader x, long length) throws SQLException
使用字符流值更新指定的列,该值将具有指定的字节数。 驱动程序执行从Java字符格式到数据库中的国家字符集的必要转换。 更新时,它适用于使用NCHAR
,NVARCHAR
和LONGNVARCHAR
列。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 -
length
- 流的长度 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateNCharacterStream
void updateNCharacterStream(String columnLabel, Reader reader, long length) throws SQLException
使用字符流值更新指定的列,该值将具有指定的字节数。 驱动程序执行从Java字符格式到数据库中的国家字符集的必要转换。 更新时,它适用于使用NCHAR
,NVARCHAR
和LONGNVARCHAR
列。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
reader
- 包含新列值的java.io.Reader
对象 -
length
- 流的长度 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateAsciiStream
void updateAsciiStream(int columnIndex, InputStream x, long length) throws SQLException
使用ascii流值更新指定列,该值将具有指定的字节数。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 -
length
- 流的长度 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateBinaryStream
void updateBinaryStream(int columnIndex, InputStream x, long length) throws SQLException
使用二进制流值更新指定列,该值将具有指定的字节数。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 -
length
- 流的长度 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateCharacterStream
void updateCharacterStream(int columnIndex, Reader x, long length) throws SQLException
使用字符流值更新指定的列,该值将具有指定的字节数。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 -
length
- 流的长度 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateAsciiStream
void updateAsciiStream(String columnLabel, InputStream x, long length) throws SQLException
使用ascii流值更新指定列,该值将具有指定的字节数。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 -
length
- 流的长度 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateBinaryStream
void updateBinaryStream(String columnLabel, InputStream x, long length) throws SQLException
使用二进制流值更新指定列,该值将具有指定的字节数。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 -
length
- 流的长度 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateCharacterStream
void updateCharacterStream(String columnLabel, Reader reader, long length) throws SQLException
使用字符流值更新指定的列,该值将具有指定的字节数。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
reader
- 包含新列值的java.io.Reader
对象 -
length
- 流的长度 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateBlob
void updateBlob(int columnIndex, InputStream inputStream, long length) throws SQLException
使用给定输入流更新指定列,该输入流将具有指定的字节数。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
inputStream
- 包含要将参数值设置为的数据的对象。 -
length
- 参数数据中的字节数。 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateBlob
void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException
使用给定输入流更新指定列,该输入流将具有指定的字节数。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
inputStream
- 包含要将参数值设置为的数据的对象。 -
length
- 参数数据中的字节数。 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateClob
void updateClob(int columnIndex, Reader reader, long length) throws SQLException
使用给定的Reader
对象更新指定的列,该对象是给定的字符长度。 当将非常大的UNICODE值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更实际。 JDBC驱动程序将执行从UNICODE到数据库char格式的任何必要转换。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
reader
- 包含要将参数值设置为的数据的对象。 -
length
- 参数数据中的字符数。 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateClob
void updateClob(String columnLabel, Reader reader, long length) throws SQLException
使用给定的Reader
对象更新指定的列,该对象是给定的字符长度。 当将非常大的UNICODE值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更实际。 JDBC驱动程序将执行从UNICODE到数据库char格式的任何必要转换。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
reader
- 包含要将参数值设置为的数据的对象。 -
length
- 参数数据中的字符数。 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateNClob
void updateNClob(int columnIndex, Reader reader, long length) throws SQLException
使用给定的Reader
对象更新指定的列,该对象是给定的字符长度。 当将非常大的UNICODE值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更实际。 JDBC驱动程序将执行从UNICODE到数据库char格式的任何必要转换。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
reader
- 包含要将参数值设置为的数据的对象。 -
length
- 参数数据中的字符数。 - 异常
-
SQLException
- 如果columnIndex无效; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误或结果集并发为CONCUR_READ_ONLY
,则在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateNClob
void updateNClob(String columnLabel, Reader reader, long length) throws SQLException
使用给定的Reader
对象更新指定的列,该对象是给定的字符长度。 当将非常大的UNICODE值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更实用。 JDBC驱动程序将执行从UNICODE到数据库char格式的任何必要转换。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
reader
- 包含要将参数值设置为的数据的对象。 -
length
- 参数数据中的字符数。 - 异常
-
SQLException
- 如果columnLabel无效; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 在闭合的结果集上调用此方法; 如果发生数据库访问错误或结果集并发为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateNCharacterStream
void updateNCharacterStream(int columnIndex, Reader x) throws SQLException
使用字符流值更新指定的列。 将根据需要从流中读取数据,直到达到流末尾。 驱动程序执行从Java字符格式到数据库中的国家字符集的必要转换。 更新时,它适用于使用NCHAR
,NVARCHAR
和LONGNVARCHAR
列。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。注意:请参阅JDBC驱动程序文档,以确定使用带有长度参数的
updateNCharacterStream
版本是否更有效。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateNCharacterStream
void updateNCharacterStream(String columnLabel, Reader reader) throws SQLException
使用字符流值更新指定的列。 将根据需要从流中读取数据,直到达到流末尾。 驱动程序执行从Java字符格式到数据库中的国家字符集的必要转换。 更新时,它适用于使用NCHAR
,NVARCHAR
和LONGNVARCHAR
列。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。注意:请参阅JDBC驱动程序文档以确定使用带有长度参数的
updateNCharacterStream
版本是否更有效。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
reader
- 包含新列值的java.io.Reader
对象 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateAsciiStream
void updateAsciiStream(int columnIndex, InputStream x) throws SQLException
使用ascii流值更新指定的列。 将根据需要从流中读取数据,直到达到流末尾。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。注意:请参阅JDBC驱动程序文档以确定使用带有长度参数的
updateAsciiStream
版本是否更有效。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateBinaryStream
void updateBinaryStream(int columnIndex, InputStream x) throws SQLException
使用二进制流值更新指定的列。 将根据需要从流中读取数据,直到达到流末尾。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。注意:请参阅JDBC驱动程序文档,以确定使用带有长度参数的
updateBinaryStream
版本是否更有效。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateCharacterStream
void updateCharacterStream(int columnIndex, Reader x) throws SQLException
使用字符流值更新指定的列。 将根据需要从流中读取数据,直到达到流末尾。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。注意:请参阅JDBC驱动程序文档,以确定使用带有长度参数的
updateCharacterStream
版本是否更有效。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateAsciiStream
void updateAsciiStream(String columnLabel, InputStream x) throws SQLException
使用ascii流值更新指定的列。 将根据需要从流中读取数据,直到达到流末尾。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。注意:请参阅JDBC驱动程序文档,以确定使用带有长度参数的
updateAsciiStream
版本是否更有效。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateBinaryStream
void updateBinaryStream(String columnLabel, InputStream x) throws SQLException
使用二进制流值更新指定的列。 将根据需要从流中读取数据,直到达到流末尾。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。注意:请参阅JDBC驱动程序文档以确定使用带有长度参数的
updateBinaryStream
版本是否更有效。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateCharacterStream
void updateCharacterStream(String columnLabel, Reader reader) throws SQLException
使用字符流值更新指定的列。 将根据需要从流中读取数据,直到达到流末尾。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。注意:请参阅JDBC驱动程序文档,以确定使用带有长度参数的
updateCharacterStream
版本是否更有效。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
reader
- 包含新列值的java.io.Reader
对象 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateBlob
void updateBlob(int columnIndex, InputStream inputStream) throws SQLException
使用给定的输入流更新指定的列。 将根据需要从流中读取数据,直到达到流末尾。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。注意:请参阅JDBC驱动程序文档,以确定使用带有长度参数的
updateBlob
版本是否更有效。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
inputStream
- 包含要将参数值设置为的数据的对象。 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateBlob
void updateBlob(String columnLabel, InputStream inputStream) throws SQLException
使用给定的输入流更新指定的列。 将根据需要从流中读取数据,直到达到流末尾。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。注意:请参阅JDBC驱动程序文档,以确定使用带有长度参数的
updateBlob
版本是否更有效。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
inputStream
- 包含要将参数值设置为的数据的对象。 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateClob
void updateClob(int columnIndex, Reader reader) throws SQLException
使用给定的Reader
对象更新指定的列。 将根据需要从流中读取数据,直到达到流末尾。 JDBC驱动程序将执行从UNICODE到数据库char格式的任何必要转换。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。注意:请参阅JDBC驱动程序文档,以确定使用带有length参数的
updateClob
版本是否更有效。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
reader
- 包含要将参数值设置为的数据的对象。 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateClob
void updateClob(String columnLabel, Reader reader) throws SQLException
使用给定的Reader
对象更新指定的列。 将根据需要从流中读取数据,直到达到流末尾。 JDBC驱动程序将执行从UNICODE到数据库char格式的任何必要转换。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。注意:请参阅JDBC驱动程序文档以确定使用带有长度参数的
updateClob
版本是否更有效。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
reader
- 包含要将参数值设置为的数据的对象。 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateNClob
void updateNClob(int columnIndex, Reader reader) throws SQLException
使用给定的Reader
更新指定的列。将根据需要从流中读取数据,直到达到流末尾。 JDBC驱动程序将执行从UNICODE到数据库char格式的任何必要转换。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。注意:请参阅JDBC驱动程序文档以确定使用带有长度参数的
updateNClob
版本是否更有效。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
reader
- 包含要将参数值设置为的数据的对象。 - 异常
-
SQLException
- 如果columnIndex无效; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误或结果集并发为CONCUR_READ_ONLY
,则在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateNClob
void updateNClob(String columnLabel, Reader reader) throws SQLException
使用给定的Reader
对象更新指定的列。 将根据需要从流中读取数据,直到达到流末尾。 JDBC驱动程序将执行从UNICODE到数据库char格式的任何必要转换。updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。注意:请参阅JDBC驱动程序文档,以确定使用带有长度参数的
updateNClob
版本是否更有效。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
reader
- 包含要将参数值设置为的数据的对象。 - 异常
-
SQLException
- 如果columnLabel无效; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 在闭合的结果集上调用此方法; 如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
getObject
<T> T getObject(int columnIndex, 类<T> type) throws SQLException
如果支持转换,则检索此
ResultSet
对象的当前行中指定列的值,并将从列的SQL类型转换为请求的Java数据类型。 如果不支持转换或为类型指定null,则抛出SQLException
。实现必须至少支持附录B,表B-3中定义的转换以及将适当的用户定义的SQL类型转换为实现
SQLData
或Struct
的Java类型。 可能支持其他转换,并且是供应商定义的。- 参数类型
-
T
- 此Class对象建模的类的类型 - 参数
-
columnIndex
- 第一列是1,第二列是2,... -
type
- 表示要将指定列转换为的Java数据类型的类。 - 结果
-
保存列值的
type
的实例 - 异常
-
SQLException
- 如果不支持转换,则键入null或发生其他错误。 异常的getCause()方法可能会提供更详细的异常,例如,如果发生转换错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.7
-
getObject
<T> T getObject(String columnLabel, 类<T> type) throws SQLException
如果支持转换,则检索此
ResultSet
对象的当前行中指定列的值,并将从列的SQL类型转换为请求的Java数据类型。 如果不支持转换或为类型指定null,则抛出SQLException
。实现必须至少支持附录B,表B-3中定义的转换以及将适当的用户定义的SQL类型转换为实现
SQLData
或Struct
的Java类型。 可能支持其他转换,并且是供应商定义的。- 参数类型
-
T
- 此Class对象建模的类的类型 - 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
type
- 表示要将指定列转换为的Java数据类型的类。 - 结果
-
保存列值的
type
的实例 - 异常
-
SQLException
- 如果不支持转换,则键入null或发生其他错误。 异常的getCause()方法可能会提供更详细的异常,例如,如果发生转换错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.7
-
updateObject
default void updateObject(int columnIndex, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException
使用值Object
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。如果第二个参数是
InputStream
则流必须包含scaleOrLength指定的字节数。 如果第二个参数是Reader
则读者必须包含scaleOrLength指定的字符数。 如果这些条件不成立,驱动程序将在执行语句时生成SQLException
。默认实现将抛出
SQLFeatureNotSupportedException
- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 -
targetSqlType
- 要发送到数据库的SQL类型 -
scaleOrLength
-为的目的java.math.BigDecimal
,这是数字的小数点后的位数。 对于Java对象类型InputStream
和Reader
,这是流或读取器中数据的长度。 对于所有其他类型,将忽略此值。 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法; 如果JDBC驱动程序不支持指定的targetSqlType - 从以下版本开始:
- 1.8
- 另请参见:
-
JDBCType
,SQLType
-
updateObject
default void updateObject(String columnLabel, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException
使用Object
值更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。如果第二个参数是
InputStream
则流必须包含scaleOrLength指定的字节数。 如果第二个参数是Reader
则阅读器必须包含scaleOrLength指定的字符数。 如果这些条件不成立,则在执行语句时,驱动程序将生成SQLException
。默认实现将抛出
SQLFeatureNotSupportedException
- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 -
targetSqlType
- 要发送到数据库的SQL类型 -
scaleOrLength
-为的目的java.math.BigDecimal
,这是数字的小数点后的位数。 对于Java对象类型InputStream
和Reader
,这是流或读取器中数据的长度。 对于所有其他类型,将忽略此值。 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法; 如果JDBC驱动程序不支持指定的targetSqlType - 从以下版本开始:
- 1.8
- 另请参见:
-
JDBCType
,SQLType
-
updateObject
default void updateObject(int columnIndex, Object x, SQLType targetSqlType) throws SQLException
使用Object
值更新指定的列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。默认实现将抛出
SQLFeatureNotSupportedException
- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新列值 -
targetSqlType
- 要发送到数据库的SQL类型 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法; 如果JDBC驱动程序不支持指定的targetSqlType - 从以下版本开始:
- 1.8
- 另请参见:
-
JDBCType
,SQLType
-
updateObject
default void updateObject(String columnLabel, Object x, SQLType targetSqlType) throws SQLException
使用值Object
更新指定列。 updater方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。默认实现将抛出
SQLFeatureNotSupportedException
- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则标签是列的名称 -
x
- 新列值 -
targetSqlType
- 要发送到数据库的SQL类型 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法; 如果JDBC驱动程序不支持指定的targetSqlType - 从以下版本开始:
- 1.8
- 另请参见:
-
JDBCType
,SQLType
-
-