-
- All Superinterfaces:
-
AutoCloseable
,Wrapper
- All Known Subinterfaces:
-
CachedRowSet
,FilteredRowSet
,JdbcRowSet
,JoinRowSet
,RowSet
,SyncResolver
,WebRowSet
public interface ResultSet extends Wrapper, AutoCloseable
表示数据库结果集的数据表,通常通过执行查询数据库的语句生成。A
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规范有一个表格,显示了可从
ResultSet
getter方法使用的SQL类型到Java类型的允许映射。用作getter方法输入的列名不区分大小写。 当使用列名称调用getter方法时,多个列具有相同的名称,将返回第一个匹配列的值。 列名称选项用于在生成结果集的SQL查询中使用列名时使用。 对于在查询中未明确命名的列,最好使用列号。 如果使用列名称,程序员应该小心保证它们唯一地引用预期的列,这可以通过SQL AS子句来确保。
JDBC 2.0 API(Java¢2 SDK,Standard Edition,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
对象具有与其相关联的特殊行,其用作构建要插入的行的暂存区域。 以下代码片段将光标移动到插入行,构建一个三列的行,并将其插入到rs
并进入使用该方法将数据源表insertRow
。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();
当生成它的
Statement
对象被关闭,重新执行或用于从多个结果序列中检索下一个结果时,一个ResultSet
对象将自动关闭。ResultSet
对象列的数量,类型和属性由ResultSet.getMetaData
方法返回的ResultSetMetaData
对象提供。- 从以下版本开始:
- 1.1
- 另请参见:
-
Statement.executeQuery(java.lang.String)
,Statement.getResultSet()
,ResultSetMetaData
-
-
Field Summary
Fields Modifier and Type Field 描述 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 弃用的方法 Modifier and Type 方法 描述 boolean
absolute(int row)
将光标移动到此ResultSet
对象中的给定行号。void
afterLast()
将光标移动到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)
检索此ResultSet
对象当前行中指定列的值为Java编程语言中的Array
对象。InputStream
getAsciiStream(int columnIndex)
将此ResultSet
对象的当前行中指定列的值作为ASCII字符流ResultSet
。InputStream
getAsciiStream(String columnLabel)
将此ResultSet
对象的当前行中指定列的值作为ASCII字符流ResultSet
。BigDecimal
getBigDecimal(int columnIndex)
在ResultSet
对象的当前行中的指定列的值作为java.math.BigDecimal
完全精确java.math.BigDecimal
。BigDecimal
getBigDecimal(int columnIndex, int scale)
已过时。使用getBigDecimal(int columnIndex)
或getBigDecimal(String columnLabel)
BigDecimal
getBigDecimal(String columnLabel)
在ResultSet
对象的当前行中的指定列的值作为java.math.BigDecimal
完全精确java.math.BigDecimal
。BigDecimal
getBigDecimal(String columnLabel, int scale)
已过时。使用getBigDecimal(int columnIndex)
或getBigDecimal(String columnLabel)
InputStream
getBinaryStream(int columnIndex)
将此ResultSet
对象的当前行中指定列的值作为未解释的字节流ResultSet
。InputStream
getBinaryStream(String columnLabel)
检索该ResultSet
对象的当前行中指定列的值,作为未解释的流byte
s。Blob
getBlob(int columnIndex)
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的Blob
对象。Blob
getBlob(String columnLabel)
以Java编程语言中的ResultSet
对象的形式Blob
此ResultSet
对象的当前行中指定列的值。boolean
getBoolean(int columnIndex)
检索该ResultSet
对象的当前行中指定列的值为Java编程语言中的boolean
。boolean
getBoolean(String columnLabel)
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的boolean
。byte
getByte(int columnIndex)
检索此ResultSet
对象当前行中指定列的值为Java编程语言中的byte
。byte
getByte(String columnLabel)
以Java编程语言中的byte
此ResultSet
对象的当前行中指定列的值。byte[]
getBytes(int columnIndex)
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的byte
数组。byte[]
getBytes(String columnLabel)
以Java编程语言中的byte
数组来检索此ResultSet
对象的当前行中指定列的值。Reader
getCharacterStream(int columnIndex)
以ResultSet
对象的形式java.io.Reader
此ResultSet
对象的当前行中指定列的值。Reader
getCharacterStream(String columnLabel)
以ResultSet
对象的形式java.io.Reader
此ResultSet
对象的当前行中指定列的值。Clob
getClob(int columnIndex)
检索此ResultSet
对象当前行中指定列的值为Java编程语言中的Clob
对象。Clob
getClob(String columnLabel)
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的Clob
对象。int
getConcurrency()
检索此ResultSet
对象的并发模式。String
getCursorName()
检索此ResultSet
对象使用的SQL游标的名称。Date
getDate(int columnIndex)
这个检索的当前行中指定列的值ResultSet
对象为java.sql.Date
的Java编程语言对象。Date
getDate(int columnIndex, Calendar cal)
检索该ResultSet
对象的当前行中指定列的值为Java编程语言中的java.sql.Date
对象。Date
getDate(String columnLabel)
以Java编程语言中的java.sql.Date
对象获取此ResultSet
对象的当前行中指定列的值。Date
getDate(String columnLabel, Calendar cal)
以Java编程语言中的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)
检索该ResultSet
对象的当前行中指定列的值为Java编程语言中的float
。float
getFloat(String columnLabel)
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的float
。int
getHoldability()
检索此ResultSet
对象的ResultSet
int
getInt(int columnIndex)
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的int
。int
getInt(String columnLabel)
以Java编程语言中的int
此ResultSet
对象的当前行中指定列的值。long
getLong(int columnIndex)
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的long
。long
getLong(String columnLabel)
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的long
。ResultSetMetaData
getMetaData()
检索此ResultSet
对象列的数量,类型和属性。Reader
getNCharacterStream(int columnIndex)
检索此ResultSet
对象的当前行中指定列的值作为java.io.Reader
对象。Reader
getNCharacterStream(String columnLabel)
以ResultSet
对象的形式java.io.Reader
此ResultSet
对象的当前行中指定列的值。NClob
getNClob(int columnIndex)
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的NClob
对象。NClob
getNClob(String columnLabel)
这个检索的当前行中指定列的值ResultSet
对象为NClob
的Java编程语言对象。String
getNString(int columnIndex)
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的String
。String
getNString(String columnLabel)
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的String
。Object
getObject(int columnIndex)
获取此ResultSet
对象的当前行中指定列的值为Java编程语言中的Object
。<T> T
getObject(int columnIndex, Class<T> type)
检索此ResultSet
对象的当前行中指定列的值,并将转换为SQL类型的列到所请求的Java数据类型,如果转换支持。Object
getObject(int columnIndex, Map<String,Class<?>> map)
以Java编程语言中的Object
此ResultSet
对象的当前行中指定列的值。Object
getObject(String columnLabel)
获取此ResultSet
对象的当前行中指定列的值为Java编程语言中的Object
。<T> T
getObject(String columnLabel, Class<T> type)
检索此ResultSet
对象的当前行中指定列的值,并将转换为SQL类型的列到所请求的Java数据类型,如果转换支持。Object
getObject(String columnLabel, Map<String,Class<?>> map)
以Java编程语言中的Object
此ResultSet
对象的当前行中指定列的值。Ref
getRef(int columnIndex)
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的Ref
对象。Ref
getRef(String columnLabel)
以Java编程语言中的Ref
对象的形式,检索此ResultSet
对象的当前行中指定列的值。int
getRow()
检索当前行号。RowId
getRowId(int columnIndex)
以该Java编程语言中的java.sql.RowId
对象的形式,检索此ResultSet
对象的当前行中指定列的值。RowId
getRowId(String columnLabel)
以Java编程语言中的java.sql.RowId
对象获取此ResultSet
对象的当前行中指定列的值。short
getShort(int columnIndex)
以Java编程语言中的short
此ResultSet
对象的当前行中指定列的值。short
getShort(String columnLabel)
以Java编程语言中的short
此ResultSet
对象的当前行中指定列的值。SQLXML
getSQLXML(int columnIndex)
检索此ResultSet
的当前行中指定列的值为Java编程语言中的java.sql.SQLXML
对象。SQLXML
getSQLXML(String columnLabel)
以Java编程语言中的java.sql.SQLXML
对象的形式获取此ResultSet
的当前行中指定列的值。Statement
getStatement()
检索Statement
生成此对象ResultSet
对象。String
getString(int columnIndex)
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的String
。String
getString(String columnLabel)
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的String
。Time
getTime(int columnIndex)
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的java.sql.Time
对象。Time
getTime(int columnIndex, Calendar cal)
检索此ResultSet
对象当前行中指定列的值为Java编程语言中的java.sql.Time
对象。Time
getTime(String columnLabel)
以Java编程语言的ResultSet
对象的形式java.sql.Time
此ResultSet
对象的当前行中指定列的值。Time
getTime(String columnLabel, Calendar cal)
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的java.sql.Time
对象。Timestamp
getTimestamp(int columnIndex)
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的java.sql.Timestamp
对象。Timestamp
getTimestamp(int columnIndex, Calendar cal)
以Java编程语言的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编程语言的java.net.URL
对象的形式,ResultSet
对象的当前行中指定列的值。URL
getURL(String columnLabel)
检索此ResultSet
对象当前行中指定列的值为Java编程语言中的java.net.URL
对象。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()
报告最后一列读取的值是否为NULL
。-
Methods inherited from interface java.sql.Wrapper
isWrapperFor, unwrap
-
-
-
-
字段详细信息
-
FETCH_FORWARD
static final int FETCH_FORWARD
指示结果集中的行将在向前方向处理的常数; 第一个到最后。 该常数由方法setFetchDirection
用作驱动程序的提示,驱动程序可以忽略该常量。- 从以下版本开始:
- 1.2
- 另请参见:
- Constant Field Values
-
FETCH_REVERSE
static final int FETCH_REVERSE
指示结果集中的行将以相反方向处理的常数; 最后到第一位。 该常数由方法setFetchDirection
用作驱动程序的提示,驱动程序可以忽略该常量。- 从以下版本开始:
- 1.2
- 另请参见:
- Constant Field Values
-
FETCH_UNKNOWN
static final int FETCH_UNKNOWN
指示结果集中的行将被处理的顺序的常量是未知的。 该常数由方法setFetchDirection
用作驱动程序的提示,驱动程序可以忽略该常量。- 另请参见:
- Constant Field Values
-
TYPE_FORWARD_ONLY
static final int TYPE_FORWARD_ONLY
指示其光标可以向前移动的ResultSet
对象的类型的常量。- 从以下版本开始:
- 1.2
- 另请参见:
- Constant Field Values
-
TYPE_SCROLL_INSENSITIVE
static final int TYPE_SCROLL_INSENSITIVE
该常量指示ResultSet
对象的类型,该对象是可滚动的,但对ResultSet
的数据更改通常不敏感。- 从以下版本开始:
- 1.2
- 另请参见:
- Constant Field Values
-
TYPE_SCROLL_SENSITIVE
static final int TYPE_SCROLL_SENSITIVE
该常量指示一个类型ResultSet
对象是可滚动的,并改变构成了这一数据一般敏感ResultSet
。- 从以下版本开始:
- 1.2
- 另请参见:
- Constant Field Values
-
CONCUR_READ_ONLY
static final int CONCUR_READ_ONLY
该常量指示可能不会更新的ResultSet
对象的并发模式。- 从以下版本开始:
- 1.2
- 另请参见:
- Constant Field Values
-
CONCUR_UPDATABLE
static final int CONCUR_UPDATABLE
该常量指示可能更新的ResultSet
对象的并发模式。- 从以下版本开始:
- 1.2
- 另请参见:
- Constant Field Values
-
HOLD_CURSORS_OVER_COMMIT
static final int HOLD_CURSORS_OVER_COMMIT
指示打开ResultSet
具有此可保持性的对象的常量将在当前事务提交时保持打开。- 从以下版本开始:
- 1.4
- 另请参见:
- Constant Field Values
-
CLOSE_CURSORS_AT_COMMIT
static final int CLOSE_CURSORS_AT_COMMIT
指示当前事务提交时,表示打开ResultSet
具有此可保持性的对象的常量将被关闭。- 从以下版本开始:
- 1.4
- 另请参见:
- Constant Field Values
-
-
方法详细信息
-
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
被关闭,任何ResultSetMetaData
通过调用中创建的实例getMetaData
方法仍然可以访问。注意:
ResultSet
目的是通过自动关闭Statement
生成它时该对象Statement
对象被关闭时,重新执行,或用于检索从多个结果的序列中的下一结果。调用已关闭的
ResultSet
对象上的方法close
是无操作的。- Specified by:
-
close
在接口AutoCloseable
- 异常
-
SQLException
- 如果发生数据库访问错误
-
wasNull
boolean wasNull() throws SQLException
报告最后一列读取的值是否为NULL
。 请注意,您必须先在列上调用其中一个getter方法来尝试读取其值,然后调用方法wasNull
以查看读取的值是否为SQLNULL
。- 结果
-
true
如果读取的最后一个列值为SQLNULL
,否则为false
- 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getString
String getString(int columnIndex) throws SQLException
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的String
。- 参数
-
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
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的byte
。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值;
如果值为SQL
NULL
,返回值为0
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getShort
short getShort(int columnIndex) throws SQLException
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的short
。- 参数
-
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
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的float
。- 参数
-
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
已过时。 使用getBigDecimal(int columnIndex)
或getBigDecimal(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
检索此ResultSet
对象当前行中指定列的值为Java编程语言中的java.sql.Date
对象。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值;
如果值为SQL
NULL
,则返回值为null
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getTime
Time getTime(int columnIndex) throws SQLException
以该Java编程语言中的java.sql.Time
对象的形式,检索该ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值;
如果值为SQL
NULL
,则返回值为null
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getTimestamp
Timestamp getTimestamp(int columnIndex) throws SQLException
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的java.sql.Timestamp
对象。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值;
如果值为SQL
NULL
,则返回值为null
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getAsciiStream
InputStream getAsciiStream(int columnIndex) throws SQLException
将此ResultSet
对象的当前行中指定列的值作为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
已过时。 使用getCharacterStream
代替getUnicodeStream
检索此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
检索此ResultSet
对象当前行中指定列的值为Java编程语言中的boolean
。如果指定列的数据类型为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
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的byte
。- 参数
-
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
已过时。 使用getBigDecimal(int columnIndex)
或getBigDecimal(String columnLabel)
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的java.math.BigDecimal
。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则该标签是列的名称 -
scale
- 小数点右侧的位数 - 结果
-
列值;
如果值为SQL
NULL
,则返回值为null
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
-
getBytes
byte[] getBytes(String columnLabel) throws SQLException
以该Java编程语言的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
检索此ResultSet
对象当前行中指定列的值为Java编程语言中的java.sql.Time
对象。- 参数
-
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
将此ResultSet
对象的当前行中指定列的值作为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
已过时。 使用getCharacterStream
代替检索此ResultSet
对象的当前行中指定列的值作为两字节Unicode字符流。 第一个字节是高字节; 第二个字节是低字节。 然后可以从流中读取大小写的值。 该方法特别适用于检索大量的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
将此ResultSet
对象的当前行中的指定列的值作为未解释的byte
s的流byte
。 然后可以从流中读取大小写的值。 该方法特别适用于获取大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
获取此
ResultSet
对象的当前行中指定列的值为Java编程语言中的Object
。此方法将以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
,那么不支持结构化值,并且将不同的值映射到由DISTINCT类型的底层SQL类型确定的默认Java类。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
一个
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子句,则该标签是列的名称 - 结果
-
一个
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
对象。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则该标签是列的名称 - 结果
-
一个包含列值的
java.io.Reader
对象; 如果值为SQLNULL
,返回值为Java编程语言中的null
- 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 从以下版本开始:
- 1.2
-
getBigDecimal
BigDecimal getBigDecimal(int columnIndex) throws SQLException
在ResultSet
对象的当前行中指定列的值作为java.math.BigDecimal
以完全精确的方式获取。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值(全精度);
如果值为SQL
NULL
,则返回的值为null
(在Java编程语言中)。 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 从以下版本开始:
- 1.2
-
getBigDecimal
BigDecimal getBigDecimal(String columnLabel) throws SQLException
以java.math.BigDecimal
的形式全面精确地ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则该标签是列的名称 - 结果
-
列值(全精度);
如果值为SQL
NULL
,则返回的值为null
(在Java编程语言中)。 - 异常
-
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
对象的末尾,就在最后一行之后。 如果结果集不包含行,则此方法不起作用。- 异常
-
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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
x
- 新的列值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在一个封闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
updateNull
void updateNull(String columnLabel) throws SQLException
使用null
值更新指定的列。 更新器方法用于更新当前行或插入行中的列值。 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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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,Class<?>> map) throws SQLException
以Java编程语言中的Object
此ResultSet
对象当前行中指定列的值。 如果该值为SQLNULL
,则驱动程序返回一个Javanull
。 此方法使用给定的Map
对象进行正在检索的SQL结构化或不同类型的自定义映射。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
map
- 一个java.util.Map
对象,其中包含从SQL类型名称到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编程语言中的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编程语言中的Array
对象获取此ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
一个
Array
对象,表示指定列中的SQLARRAY
值 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getObject
Object getObject(String columnLabel, Map<String,Class<?>> map) throws SQLException
以Java编程语言中的Object
此ResultSet
对象的当前行中指定列的值。 如果值为SQLNULL
,则驱动程序返回一个Javanull
。 如果适用,此方法使用指定的Map
对象进行自定义映射。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则该标签是列的名称 -
map
- 一个java.util.Map
对象,其中包含从SQL类型名称到Java编程语言中的类的映射 - 结果
-
一个
Object
表示指定列中的SQL值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getRef
Ref getRef(String columnLabel) throws SQLException
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的Ref
对象。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则该标签是列的名称 - 结果
-
一个
Ref
对象,表示指定列中的SQLREF
值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getBlob
Blob getBlob(String columnLabel) throws SQLException
以Java编程语言中的Blob
对象的形式,检索此ResultSet
对象的当前行中指定列的值。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则该标签是列的名称 - 结果
-
表示指定列中的SQL
BLOB
值的Blob
对象 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getClob
Clob getClob(String columnLabel) throws SQLException
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的Clob
对象。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则该标签是列的名称 - 结果
-
一个
Clob
对象,表示指定列中的SQLCLOB
值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getArray
Array getArray(String columnLabel) throws SQLException
检索此ResultSet
对象当前行中指定列的值为Java编程语言中的Array
对象。- 参数
-
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
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的java.sql.Date
对象。 如果基础数据库不存储时区信息,则此方法使用给定的日历为日期构造适当的毫秒值。- 参数
-
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
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的java.sql.Time
对象。 如果基础数据库不存储时区信息,则此方法使用给定的日历来构建适当的毫秒值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
cal
- 用于构建时间的java.util.Calendar
对象 - 结果
-
列值为
java.sql.Time
对象; 如果值为SQLNULL
,返回的值为null
,在Java编程语言 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 从以下版本开始:
- 1.2
-
getTime
Time getTime(String columnLabel, Calendar cal) throws SQLException
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的java.sql.Time
对象。 如果基础数据库不存储时区信息,则此方法使用给定的日历来构建适当的毫秒值。- 参数
-
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编程语言中的java.sql.Timestamp
对象的形式,检索此ResultSet
对象的当前行中指定列的值。 如果基础数据库不存储时区信息,则此方法使用给定的日历为时间戳创建适当的毫秒值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... -
cal
- 用于构建时间戳的java.util.Calendar
对象 - 结果
-
列值为
java.sql.Timestamp
对象; 如果值为SQLNULL
,返回的值为null
,在Java编程语言 - 异常
-
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
,返回的值为null
,在Java编程语言 - 异常
-
SQLException
- 如果columnLabel无效或者发生数据库访问错误或在关闭的结果集上调用此方法 - 从以下版本开始:
- 1.2
-
getURL
URL getURL(int columnIndex) throws SQLException
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的java.net.URL
对象。- 参数
-
columnIndex
- 列1的索引是第一个,第二个是第二个,... - 结果
-
列值为
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
,则返回的值为null
,在Java编程语言 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 这个方法在一个封闭的结果集上被调用,或者一个URL是格式错误的 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
updateRef
void updateRef(int columnIndex, Ref x) throws SQLException
使用java.sql.Ref
值更新指定的列。 更新器方法用于更新当前行或插入行中的列值。 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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则该标签是列的名称 -
x
- 新的列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性是CONCUR_READ_ONLY
或者在一个封闭的结果集上调用这个方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
getRowId
RowId getRowId(int columnIndex) throws SQLException
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的java.sql.RowId
对象。- 参数
-
columnIndex
- 第一列是1,第二列2,... - 结果
-
列值;
如果值为SQL
NULL
,返回值为null
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
getRowId
RowId getRowId(String columnLabel) throws SQLException
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的java.sql.RowId
对象。- 参数
-
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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则该标签是列的名称 -
x
- 列值 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
getHoldability
int getHoldability() throws SQLException
检索此ResultSet
对象的ResultSet
- 结果
-
ResultSet.HOLD_CURSORS_OVER_COMMIT
或ResultSet.CLOSE_CURSORS_AT_COMMIT
- 异常
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法 - 从以下版本开始:
- 1.6
-
isClosed
boolean isClosed() throws SQLException
检索此ResultSet
对象是否已关闭。 如果方法关闭已被调用或自动关闭,则关闭ResultSet
。- 结果
-
如果这个
ResultSet
对象关闭,ResultSet
true; 如果它仍然开放,则为false - 异常
-
SQLException
- 如果发生数据库访问错误 - 从以下版本开始:
- 1.6
-
updateNString
void updateNString(int columnIndex, String nString) throws SQLException
使用String
值更新指定的列。 更新时,它适用于使用NCHAR
,NVARCHAR
和LONGNVARCHAR
列。 更新器方法用于更新当前行或插入行中的列值。 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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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编程语言中的NClob
对象获取该ResultSet
对象的当前行中指定列的值。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
表示指定列中的SQL
NCLOB
值的NClob
对象 - 异常
-
SQLException
- 如果columnIndex无效; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 这个方法在一个封闭的结果集上被调用,或者发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
getNClob
NClob getNClob(String columnLabel) throws SQLException
检索此ResultSet
对象当前行中指定列的值为Java编程语言中的NClob
对象。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则该标签是列的名称 - 结果
-
一个表示指定列中的SQL
NCLOB
值的NClob
对象 - 异常
-
SQLException
- 如果columnLabel无效; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 这个方法在一个封闭的结果集上被调用,或者发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
getSQLXML
SQLXML getSQLXML(int columnIndex) throws SQLException
这个检索的当前行中指定列的值ResultSet
为java.sql.SQLXML
的Java编程语言对象。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
一个映射
SQL XML
值的SQLXML
对象 - 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
getSQLXML
SQLXML getSQLXML(String columnLabel) throws SQLException
以Java编程语言的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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的String
。 访问时,它适用于使用NCHAR
,NVARCHAR
和LONGNVARCHAR
列。- 参数
-
columnIndex
- 第一列是1,第二列是2,... - 结果
-
列值;
如果值为SQL
NULL
,返回值为null
- 异常
-
SQLException
- 如果columnIndex无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
getNString
String getNString(String columnLabel) throws SQLException
检索此ResultSet
对象的当前行中指定列的值为Java编程语言中的String
。 访问时,它适用于使用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
对象。 访问时,它适用于使用NCHAR
,NVARCHAR
和LONGNVARCHAR
列。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则该标签是列的名称 - 结果
-
一个包含列值的
java.io.Reader
对象; 如果值为SQLNULL
,则返回的值为null
,在Java编程语言 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateNCharacterStream
void updateNCharacterStream(int columnIndex, Reader x, long length) throws SQLException
使用字符流值更新指定的列,该值将具有指定的字节数。 驱动程序必须从Java字符格式转换为数据库中的国家字符集。 更新时,它适用于使用NCHAR
,NVARCHAR
和LONGNVARCHAR
列。更新器方法用于更新当前行或插入行中的列值。 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方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则该标签是列的名称 -
reader
- 包含新列值的java.io.Reader
对象 -
length
- 流的长度 - 异常
-
SQLException
如果发生数据库访问错误; 结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用 -
SQLFeatureNotSupportedException
: - 从以下版本开始:
- 1.6
-
updateAsciiStream
void updateAsciiStream(int columnIndex, InputStream x, long length) throws SQLException
使用ascii流值更新指定的列,该值将具有指定的字节数。更新器方法用于更新当前行或插入行中的列值。 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方法不更新底层数据库; 而是
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方法不更新底层数据库; 而是
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方法不更新底层数据库; 而是
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方法不更新底层数据库; 而是
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方法不更新底层数据库; 而是
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方法不更新底层数据库; 而是
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方法不更新底层数据库; 而是
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到数据库字符格式进行任何必要的转换。更新器方法用于更新当前行或插入行中的列值。 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到数据库字符格式进行任何必要的转换。更新器方法用于更新当前行或插入行中的列值。 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到数据库字符格式进行任何必要的转换。更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。- 参数
-
columnIndex
- 第一列是1,第二列2,... -
reader
- 包含用于设置参数值的数据的对象。 -
length
- 参数数据中的字符数。 - 异常
-
SQLException
- 如果columnIndex无效; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
,则此方法在关闭的结果集上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到数据库字符格式进行任何必要的转换。更新器方法用于更新当前行或插入行中的列值。 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方法不更新底层数据库; 而是
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方法不更新底层数据库; 而是
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方法不更新底层数据库; 而是
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方法不更新底层数据库; 而是
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方法不更新底层数据库; 而是
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方法不更新底层数据库; 而是
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方法不更新底层数据库; 而是
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方法不更新底层数据库; 而是
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方法不更新底层数据库; 而是
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方法不更新底层数据库; 而是
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到数据库字符格式进行任何必要的转换。更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。注意:请参阅您的JDBC驱动程序文档,以确定使用需要长度参数的版本的
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到数据库字符格式进行任何必要的转换。更新器方法用于更新当前行或插入行中的列值。 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到数据库字符格式进行任何必要的转换。更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是
updateRow
或insertRow
方法来更新数据库。注意:请参阅您的JDBC驱动程序文档,以确定使用需要长度参数的版本
updateNClob
是否更有效。- 参数
-
columnIndex
- 第一列是1,第二列2,... -
reader
- 包含用于设置参数值的数据的对象。 - 异常
-
SQLException
- 如果columnIndex无效; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
,则此方法在关闭的结果集上CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
updateNClob
void updateNClob(String columnLabel, Reader reader) throws SQLException
使用给定的Reader
对象更新指定的列。 数据将根据需要从流中读取,直到达到流出端。 JDBC驱动程序将从UNICODE到数据库字符格式进行任何必要的转换。更新器方法用于更新当前行或插入行中的列值。 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, Class<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
- 如果不支持转换,则type为null或发生其他错误。 异常的getCause()方法可能会提供更详细的异常,例如,如果发生转换错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.7
-
getObject
<T> T getObject(String columnLabel, Class<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
- 如果不支持转换,则type为null或发生其他错误。 异常的getCause()方法可能会提供更详细的异常,例如,如果发生转换错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.7
-
updateObject
default void updateObject(int columnIndex, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException
使用Object
值更新指定的列。 更新器方法用于更新当前行或插入行中的列值。 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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是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方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。默认实现将抛出
SQLFeatureNotSupportedException
- 参数
-
columnLabel
- 使用SQL AS子句指定的列的标签。 如果未指定SQL AS子句,则该标签是列的名称 -
x
- 新的列值 -
targetSqlType
- 要发送到数据库的SQL类型 - 异常
-
SQLException
- 如果columnLabel无效; 如果发生数据库访问错误; 结果集并发性为CONCUR_READ_ONLY
或者在一个封闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法; 如果JDBC驱动程序不支持指定的targetSqlType - 从以下版本开始:
- 1.8
- 另请参见:
-
JDBCType
,SQLType
-
-