- 所有超接口:
-
AutoCloseable,Wrapper
- 所有已知子接口:
-
CachedRowSet,FilteredRowSet,JdbcRowSet,JoinRowSet,RowSet,SyncResolver,WebRowSet
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将是可滚动的,不会显示其他人所做的更改,
// 并且是可更新的
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,标准版,版本1.2)中向此接口添加了一组更新器方法。关于getter方法的参数的注释也适用于更新器方法的参数。
更新器方法可以以两种方式使用:
- 更新当前行中的列值。在可滚动的
ResultSet对象中,游标可以向前和向后移动,到绝对位置或相对于当前行的位置。以下代码片段更新rs对象的第五行中的NAME列,然后使用updateRow方法更新从中派生rs的数据源表。rs.absolute(5); // 将游标移动到rs的第五行 rs.updateString("NAME", "AINSWORTH"); // 更新第5行的NAME列为AINSWORTHrs.updateRow(); // 更新数据源中的行 - 将列值插入插入行。可更新的
ResultSet对象有一个特殊的与之关联的行,用作构建要插入的行的临时区域。以下代码片段将游标移动到插入行,构建一个三列行,并使用insertRow方法将其插入rs和数据源表。rs.moveToInsertRow(); // 将游标移动到插入行 rs.updateString(1, "AINSWORTH"); // 更新插入行的第一列为AINSWORTHrs.updateInt(2,35); // 更新第二列为35rs.updateBoolean(3, true); // 更新第三列为truers.insertRow(); rs.moveToCurrentRow();
当生成它的Statement对象关闭、重新执行或用于从多个结果序列中检索下一个结果时,ResultSet对象会自动关闭。
ResultSet对象的列数、类型和属性由ResultSet.getMetaData方法返回的ResultSetMetaData对象提供。
- 自版本:
- 1.1
- 参见:
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final int表示当当前事务提交时,具有此保持性的打开ResultSet对象将被关闭的常量。static final int表示不可更新的ResultSet对象的并发模式的常量。static final int表示可更新的ResultSet对象的并发模式的常量。static final int表示结果集中的行将以向前方向处理的常量;从第一个到最后一个。static final int表示结果集中的行将以向后方向处理的常量;从最后一个到第一个。static final int表示结果集中的行将以未知顺序处理的常量。static final int表示具有此保持性的打开ResultSet对象将在当前事务提交时保持打开的常量。static final int表示只能向前移动的ResultSet对象的类型的常量。static final int表示可滚动但通常不敏感于底层数据更改的ResultSet对象的类型的常量。static final int表示可滚动且通常敏感于底层数据更改的ResultSet对象的类型的常量。 -
Method Summary
Modifier and TypeMethodDescriptionbooleanabsolute(int row) 将游标移动到此ResultSet对象中给定行号。void将游标移动到此ResultSet对象的末尾,即最后一行之后。void将游标移动到此ResultSet对象的开头,即第一行之前。void取消在此ResultSet对象中当前行所做的更新。void清除在此ResultSet对象上报告的所有警告。voidclose()立即释放此ResultSet对象的数据库和JDBC资源,而不是等待自动关闭时释放。void从此ResultSet对象和底层数据库中删除当前行。intfindColumn(String columnLabel) 将给定的ResultSet列标签映射到其ResultSet列索引。booleanfirst()将游标移动到此ResultSet对象中的第一行。getArray(int columnIndex) 以Java编程语言中的Array对象形式检索此ResultSet对象当前行中指定列的值。以Java编程语言中的Array对象形式检索此ResultSet对象当前行中指定列的值。getAsciiStream(int columnIndex) 以ASCII字符流形式检索此ResultSet对象当前行中指定列的值。getAsciiStream(String columnLabel) 以ASCII字符流形式检索此ResultSet对象当前行中指定列的值。getBigDecimal(int columnIndex) 以完整精度的java.math.BigDecimal形式检索此ResultSet对象当前行中指定列的值。getBigDecimal(int columnIndex, int scale) 已弃用。getBigDecimal(String columnLabel) 以完整精度的java.math.BigDecimal形式检索此ResultSet对象当前行中指定列的值。getBigDecimal(String columnLabel, int scale) 已弃用。使用getBigDecimal(int columnIndex)或getBigDecimal(String columnLabel)getBinaryStream(int columnIndex) 以未解释字节流形式检索此ResultSet对象当前行中指定列的值。getBinaryStream(String columnLabel) 以未解释byte流形式检索此ResultSet对象当前行中指定列的值。getBlob(int columnIndex) 以Java编程语言中的Blob对象形式检索此ResultSet对象当前行中指定列的值。检索当前行中指定列的值作为Java编程语言中的Blob对象。booleangetBoolean(int columnIndex) 检索当前行中指定列的值作为Java编程语言中的布尔值。booleangetBoolean(String columnLabel) 检索当前行中指定列的值作为Java编程语言中的布尔值。bytegetByte(int columnIndex) 检索当前行中指定列的值作为Java编程语言中的字节。byte检索当前行中指定列的值作为Java编程语言中的字节。byte[]getBytes(int columnIndex) 检索当前行中指定列的值作为Java编程语言中的字节数组。byte[]检索当前行中指定列的值作为Java编程语言中的字节数组。getCharacterStream(int columnIndex) 检索当前行中指定列的值作为java.io.Reader对象。getCharacterStream(String columnLabel) 检索当前行中指定列的值作为java.io.Reader对象。getClob(int columnIndex) 检索当前行中指定列的值作为Java编程语言中的Clob对象。检索当前行中指定列的值作为Java编程语言中的Clob对象。int检索此ResultSet对象的并发模式。检索此ResultSet对象使用的SQL游标的名称。getDate(int columnIndex) 检索当前行中指定列的值作为Java编程语言中的java.sql.Date对象。检索当前行中指定列的值作为Java编程语言中的java.sql.Date对象。检索当前行中指定列的值作为Java编程语言中的java.sql.Date对象。检索当前行中指定列的值作为Java编程语言中的java.sql.Date对象。doublegetDouble(int columnIndex) 检索当前行中指定列的值作为Java编程语言中的双精度浮点数。double检索当前行中指定列的值作为Java编程语言中的双精度浮点数。int检索此ResultSet对象的获取方向。int检索此ResultSet对象的获取大小。floatgetFloat(int columnIndex) 检索当前行中指定列的值作为Java编程语言中的浮点数。float检索当前行中指定列的值作为Java编程语言中的浮点数。int检索此ResultSet对象的可保持性。intgetInt(int columnIndex) 检索当前行中指定列的值作为Java编程语言中的整数。int检索当前行中指定列的值作为Java编程语言中的整数。longgetLong(int columnIndex) 检索当前行中指定列的值作为Java编程语言中的长整型。long检索当前行中指定列的值作为Java编程语言中的长整型。检索此ResultSet对象的列数、类型和属性。getNCharacterStream(int columnIndex) 检索当前行中指定列的值作为java.io.Reader对象。getNCharacterStream(String columnLabel) 检索当前行中指定列的值作为java.io.Reader对象。getNClob(int columnIndex) 检索当前行中指定列的值作为Java编程语言中的NClob对象。检索当前行中指定列的值作为Java编程语言中的NClob对象。getNString(int columnIndex) 检索当前行中指定列的值作为Java编程语言中的字符串。getNString(String columnLabel) 检索当前行中指定列的值作为Java编程语言中的字符串。getObject(int columnIndex) 获取当前行中指定列的值作为Java编程语言中的对象。<T> T检索当前行中指定列的值,并将其从列的SQL类型转换为请求的Java数据类型,如果支持转换。检索当前行中指定列的值作为Java编程语言中的对象。获取当前行中指定列的值作为Java编程语言中的对象。<T> T检索当前行中指定列的值,并将其从列的SQL类型转换为请求的Java数据类型,如果支持转换。检索当前行中指定列的值作为Java编程语言中的对象。getRef(int columnIndex) 检索当前行中指定列的值作为Java编程语言中的Ref对象。检索当前行中指定列的值作为Java编程语言中的Ref对象。intgetRow()检索当前行的行号。getRowId(int columnIndex) 检索当前行中指定列的值作为Java编程语言中的java.sql.RowId对象。检索当前行中指定列的值作为Java编程语言中的java.sql.RowId对象。shortgetShort(int columnIndex) 检索当前行中指定列的值作为Java编程语言中的短整型。short检索当前行中指定列的值作为Java编程语言中的短整型。getSQLXML(int columnIndex) 检索当前行中指定列的值作为Java编程语言中的java.sql.SQLXML对象。检索当前行中指定列的值作为Java编程语言中的java.sql.SQLXML对象。检索生成此ResultSet对象的Statement对象。getString(int columnIndex) 检索当前行中指定列的值作为Java编程语言中的字符串。检索当前行中指定列的值作为Java编程语言中的字符串。getTime(int columnIndex) 检索当前行中指定列的值作为Java编程语言中的java.sql.Time对象。检索当前行中指定列的值作为Java编程语言中的java.sql.Time对象。检索当前行中指定列的值作为Java编程语言中的java.sql.Time对象。检索当前行中指定列的值作为Java编程语言中的java.sql.Time对象。getTimestamp(int columnIndex) 检索当前行中指定列的值作为Java编程语言中的java.sql.Timestamp对象。getTimestamp(int columnIndex, Calendar cal) 检索当前行中指定列的值作为Java编程语言中的java.sql.Timestamp对象。getTimestamp(String columnLabel) 检索当前行中指定列的值作为Java编程语言中的java.sql.Timestamp对象。getTimestamp(String columnLabel, Calendar cal) 检索当前行中指定列的值作为Java编程语言中的java.sql.Timestamp对象。intgetType()检索此ResultSet对象的类型。getUnicodeStream(int columnIndex) 已弃用。使用getCharacterStream代替getUnicodeStreamgetUnicodeStream(String columnLabel) 已弃用。使用getCharacterStream代替getURL(int columnIndex) 检索当前行中指定列的值作为Java编程语言中的java.net.URL对象。检索当前行中指定列的值作为Java编程语言中的java.net.URL对象。检索此ResultSet对象上调用报告的第一个警告。void将插入行的内容插入到此ResultSet对象和数据库中。boolean检索光标是否位于此ResultSet对象中的最后一行之后。boolean检索光标是否位于此ResultSet对象中的第一行之前。booleanisClosed()检索此ResultSet对象是否已关闭。booleanisFirst()检索光标是否位于此ResultSet对象的第一行。booleanisLast()检索光标是否位于此ResultSet对象的最后一行。booleanlast()将光标移动到此ResultSet对象中的最后一行。void将光标移动到记住的光标位置,通常是当前行。void将光标移动到插入行。booleannext()将光标从当前位置向前移动一行。booleanprevious()将光标移动到此ResultSet对象中的上一行。void使用数据库中最新值刷新当前行。booleanrelative(int rows) 移动相对数量的行,可以是正数也可以是负数。boolean检索是否已删除行。boolean检索当前行是否已插入。boolean检索当前行是否已更新。voidsetFetchDirection(int direction) 给出在处理此ResultSet对象中的行时的方向提示。voidsetFetchSize(int rows) 给JDBC驱动程序一个提示,指示在需要更多行时应从数据库中获取的行数。voidupdateArray(int columnIndex, Array x) 使用java.sql.Array值更新指定列。voidupdateArray(String columnLabel, Array x) 使用java.sql.Array值更新指定列。voidupdateAsciiStream(int columnIndex, InputStream x) 使用ascii流值更新指定列。voidupdateAsciiStream(int columnIndex, InputStream x, int length) 使用指定字节数的ascii流值更新指定列。voidupdateAsciiStream(int columnIndex, InputStream x, long length) 使用指定字节数的ascii流值更新指定列。voidupdateAsciiStream(String columnLabel, InputStream x) 使用ascii流值更新指定列。voidupdateAsciiStream(String columnLabel, InputStream x, int length) 使用指定字节数的ascii流值更新指定列。voidupdateAsciiStream(String columnLabel, InputStream x, long length) 使用指定字节数的ascii流值更新指定列。voidupdateBigDecimal(int columnIndex, BigDecimal x) 使用java.math.BigDecimal值更新指定列。voidupdateBigDecimal(String columnLabel, BigDecimal x) 使用java.sql.BigDecimal值更新指定列。voidupdateBinaryStream(int columnIndex, InputStream x) 使用二进制流值更新指定列。voidupdateBinaryStream(int columnIndex, InputStream x, int length) 使用指定字节数的二进制流值更新指定列。voidupdateBinaryStream(int columnIndex, InputStream x, long length) 使用指定字节数的二进制流值更新指定列。voidupdateBinaryStream(String columnLabel, InputStream x) 使用二进制流值更新指定列。voidupdateBinaryStream(String columnLabel, InputStream x, int length) 使用指定字节数的二进制流值更新指定列。voidupdateBinaryStream(String columnLabel, InputStream x, long length) 使用指定字节数的二进制流值更新指定列。voidupdateBlob(int columnIndex, InputStream inputStream) 使用给定的输入流更新指定列。voidupdateBlob(int columnIndex, InputStream inputStream, long length) 使用指定字节数的给定输入流更新指定列。voidupdateBlob(int columnIndex, Blob x) 使用java.sql.Blob值更新指定列。voidupdateBlob(String columnLabel, InputStream inputStream) 使用给定的输入流更新指定列。voidupdateBlob(String columnLabel, InputStream inputStream, long length) 使用指定字节数的给定输入流更新指定列。voidupdateBlob(String columnLabel, Blob x) 使用java.sql.Blob值更新指定列。voidupdateBoolean(int columnIndex, boolean x) 使用boolean值更新指定列。voidupdateBoolean(String columnLabel, boolean x) 使用boolean值更新指定列。voidupdateByte(int columnIndex, byte x) 使用byte值更新指定列。voidupdateByte(String columnLabel, byte x) 使用byte值更新指定列。voidupdateBytes(int columnIndex, byte[] x) 使用字节数组值更新指定列。voidupdateBytes(String columnLabel, byte[] x) 使用字节数组值更新指定列。voidupdateCharacterStream(int columnIndex, Reader x) 使用字符流值更新指定列。voidupdateCharacterStream(int columnIndex, Reader x, int length) 使用指定字节数的字符流值更新指定列。voidupdateCharacterStream(int columnIndex, Reader x, long length) 使用指定字节数的字符流值更新指定列。voidupdateCharacterStream(String columnLabel, Reader reader) 使用字符流值更新指定列。voidupdateCharacterStream(String columnLabel, Reader reader, int length) 使用指定字节数的字符流值更新指定列。voidupdateCharacterStream(String columnLabel, Reader reader, long length) 使用指定字节数的字符流值更新指定列。voidupdateClob(int columnIndex, Reader reader) 使用给定的Reader对象更新指定列。voidupdateClob(int columnIndex, Reader reader, long length) 使用给定的Reader对象更新指定列,其长度为给定的字符数。voidupdateClob(int columnIndex, Clob x) 使用java.sql.Clob值更新指定列。voidupdateClob(String columnLabel, Reader reader) 使用给定的Reader对象更新指定列。voidupdateClob(String columnLabel, Reader reader, long length) 使用给定的Reader对象更新指定列,其长度为给定的字符数。voidupdateClob(String columnLabel, Clob x) 使用java.sql.Clob值更新指定列。voidupdateDate(int columnIndex, Date x) 使用java.sql.Date值更新指定列。voidupdateDate(String columnLabel, Date x) 使用java.sql.Date值更新指定列。voidupdateDouble(int columnIndex, double x) 使用double值更新指定列。voidupdateDouble(String columnLabel, double x) 使用double值更新指定列。voidupdateFloat(int columnIndex, float x) 使用float值更新指定列。voidupdateFloat(String columnLabel, float x) 使用float值更新指定列。voidupdateInt(int columnIndex, int x) 使用int值更新指定列。void使用int值更新指定列。voidupdateLong(int columnIndex, long x) 使用long值更新指定列。voidupdateLong(String columnLabel, long x) 使用long值更新指定列。voidupdateNCharacterStream(int columnIndex, Reader x) 使用字符流值更新指定列。voidupdateNCharacterStream(int columnIndex, Reader x, long length) 使用指定字节数的字符流值更新指定列。voidupdateNCharacterStream(String columnLabel, Reader reader) 使用字符流值更新指定列。voidupdateNCharacterStream(String columnLabel, Reader reader, long length) 使用指定字节数的字符流值更新指定列。voidupdateNClob(int columnIndex, Reader reader) 使用给定的Reader对象更新指定列。数据将根据需要从流中读取,直到达到流的末尾。voidupdateNClob(int columnIndex, Reader reader, long length) 使用给定的Reader对象更新指定列,其长度为给定的字符数。voidupdateNClob(int columnIndex, NClob nClob) 使用java.sql.NClob值更新指定列。voidupdateNClob(String columnLabel, Reader reader) 使用给定的Reader对象更新指定列。voidupdateNClob(String columnLabel, Reader reader, long length) 使用给定的Reader对象更新指定列,其长度为给定的字符数。voidupdateNClob(String columnLabel, NClob nClob) 使用java.sql.NClob值更新指定列。voidupdateNString(int columnIndex, String nString) 使用String值更新指定列。voidupdateNString(String columnLabel, String nString) 使用String值更新指定列。voidupdateNull(int columnIndex) 使用null值更新指定列。voidupdateNull(String columnLabel) 使用null值更新指定列。voidupdateObject(int columnIndex, Object x) 使用Object值更新指定列。voidupdateObject(int columnIndex, Object x, int scaleOrLength) 使用Object值更新指定列。default voidupdateObject(int columnIndex, Object x, SQLType targetSqlType) 使用Object值更新指定列。default voidupdateObject(int columnIndex, Object x, SQLType targetSqlType, int scaleOrLength) 使用Object值更新指定列。voidupdateObject(String columnLabel, Object x) 使用Object值更新指定列。voidupdateObject(String columnLabel, Object x, int scaleOrLength) 使用Object值更新指定列。default voidupdateObject(String columnLabel, Object x, SQLType targetSqlType) 使用Object值更新指定列。default voidupdateObject(String columnLabel, Object x, SQLType targetSqlType, int scaleOrLength) 使用Object值更新指定列。void使用java.sql.Ref值更新指定列。void使用java.sql.Ref值更新指定列。void使用此ResultSet对象的当前行的新内容更新底层数据库。voidupdateRowId(int columnIndex, RowId x) 使用RowId值更新指定列。voidupdateRowId(String columnLabel, RowId x) 使用RowId值更新指定列。voidupdateShort(int columnIndex, short x) 使用short值更新指定列。voidupdateShort(String columnLabel, short x) 使用short值更新指定列。voidupdateSQLXML(int columnIndex, SQLXML xmlObject) 使用java.sql.SQLXML值更新指定列。voidupdateSQLXML(String columnLabel, SQLXML xmlObject) 使用java.sql.SQLXML值更新指定列。voidupdateString(int columnIndex, String x) 使用String值更新指定列。voidupdateString(String columnLabel, String x) 使用String值更新指定列。voidupdateTime(int columnIndex, Time x) 使用java.sql.Time值更新指定列。voidupdateTime(String columnLabel, Time x) 使用java.sql.Time值更新指定列。voidupdateTimestamp(int columnIndex, Timestamp x) 使用java.sql.Timestamp值更新指定列。voidupdateTimestamp(String columnLabel, Timestamp x) 使用java.sql.Timestamp值更新指定列。booleanwasNull()报告最后读取的列是否具有SQLNULL值。Methods declared in interface java.sql.Wrapper
isWrapperFor, unwrap
-
Field Details
-
FETCH_FORWARD
static final int FETCH_FORWARD表示结果集中的行将按照正向顺序处理;从第一个到最后一个。此常量由方法setFetchDirection使用,作为对驱动程序的提示,驱动程序可能会忽略该提示。- 自:
- 1.2
- 另请参见:
-
FETCH_REVERSE
static final int FETCH_REVERSE表示结果集中的行将按照反向顺序处理;从最后一个到第一个。此常量由方法setFetchDirection使用,作为对驱动程序的提示,驱动程序可能会忽略该提示。- 自:
- 1.2
- 另请参见:
-
FETCH_UNKNOWN
static final int FETCH_UNKNOWN表示结果集中的行将以未知顺序处理。此常量由方法setFetchDirection使用,作为对驱动程序的提示,驱动程序可能会忽略该提示。- 另请参见:
-
TYPE_FORWARD_ONLY
static final int TYPE_FORWARD_ONLY表示ResultSet对象的游标只能向前移动的类型。- 自:
- 1.2
- 另请参见:
-
TYPE_SCROLL_INSENSITIVE
static final int TYPE_SCROLL_INSENSITIVE表示ResultSet对象的类型为可滚动但通常不敏感于底层ResultSet数据更改的类型。- 自:
- 1.2
- 另请参见:
-
TYPE_SCROLL_SENSITIVE
static final int TYPE_SCROLL_SENSITIVE表示ResultSet对象的类型为可滚动且通常对底层ResultSet数据更改敏感的类型。- 自:
- 1.2
- 另请参见:
-
CONCUR_READ_ONLY
static final int CONCUR_READ_ONLY表示ResultSet对象的并发模式为不可更新。- 自:
- 1.2
- 另请参见:
-
CONCUR_UPDATABLE
static final int CONCUR_UPDATABLE表示ResultSet对象的并发模式为可更新。- 自:
- 1.2
- 另请参见:
-
HOLD_CURSORS_OVER_COMMIT
static final int HOLD_CURSORS_OVER_COMMIT表示具有此保持性的打开ResultSet对象将在当前事务提交时保持打开状态。- 自:
- 1.4
- 另请参见:
-
CLOSE_CURSORS_AT_COMMIT
static final int CLOSE_CURSORS_AT_COMMIT表示具有此保持性的打开ResultSet对象将在当前事务提交时关闭。- 自:
- 1.4
- 另请参见:
-
-
Method Details
-
next
从当前位置将游标向前移动一行。ResultSet游标最初定位在第一行之前;第一次调用方法next将第一行设为当前行;第二次调用将第二行设为当前行,依此类推。当调用
next方法返回false时,游标定位在最后一行之后。任何需要当前行的ResultSet方法的调用将导致抛出SQLException。如果结果集类型为TYPE_FORWARD_ONLY,则由供应商指定其JDBC驱动程序实现在随后调用next时返回false或抛出SQLException。如果当前行有打开的输入流,调用
next方法将隐式关闭它。读取新行时,ResultSet对象的警告链将被清除。- 返回:
-
如果新的当前行有效,则返回
true;如果没有更多行,则返回false - 抛出:
-
SQLException- 如果发生数据库访问错误或在关闭结果集上调用此方法
-
close
立即释放此ResultSet对象的数据库和JDBC资源,而不是等待自动关闭。关闭
ResultSet对象不会关闭由ResultSet创建的Blob、Clob或NClob对象。除非调用它们的free方法,否则Blob、Clob或NClob对象在创建它们的事务持续时间内保持有效。关闭
ResultSet时,通过调用getMetaData方法创建的任何ResultSetMetaData实例仍然可访问。注意:当
Statement对象关闭、重新执行或用于检索多个结果序列中的下一个结果时,ResultSet对象会自动关闭。对已经关闭的
ResultSet对象调用close方法不会产生任何效果。- 指定者:
-
close在接口AutoCloseable中 - 抛出:
-
SQLException- 如果发生数据库访问错误
-
wasNull
报告上次读取的列是否具有SQLNULL值。请注意,必须首先调用列的getter方法尝试读取其值,然后调用方法wasNull查看读取的值是否为SQLNULL。- 返回:
-
如果上次读取的列值为SQL
NULL,则返回true;否则返回false - 抛出:
-
SQLException- 如果发生数据库访问错误或在关闭结果集上调用此方法
-
getString
以Java编程语言中的String形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
列值;如果值为SQL
NULL,则返回值为null - 抛出:
-
SQLException- 如果列索引无效;如果发生数据库访问错误或在关闭结果集上调用此方法
-
getBoolean
以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- 如果列索引无效;如果发生数据库访问错误或在关闭结果集上调用此方法
-
getByte
以Java编程语言中的byte形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
列值;如果值为SQL
NULL,则返回值为0 - 抛出:
-
SQLException- 如果列索引无效;如果发生数据库访问错误或在关闭结果集上调用此方法
-
getShort
以Java编程语言中的short形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
列值;如果值为SQL
NULL,则返回值为0 - 抛出:
-
SQLException- 如果列索引无效;如果发生数据库访问错误或在关闭结果集上调用此方法
-
getInt
以Java编程语言中的int形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
列的值;如果值为SQL
NULL,则返回值为0 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
-
getLong
以Java编程语言中的long形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
列的值;如果值为SQL
NULL,则返回值为0 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
-
getFloat
以Java编程语言中的float形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
列的值;如果值为SQL
NULL,则返回值为0 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
-
getDouble
以Java编程语言中的double形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
列的值;如果值为SQL
NULL,则返回值为0 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
-
getBigDecimal
Deprecated.UsegetBigDecimal(int columnIndex)orgetBigDecimal(String columnLabel)以Java编程语言中的java.sql.BigDecimal形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
scale- 小数点右侧的数字个数 - 返回:
-
列的值;如果值为SQL
NULL,则返回值为null - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法
-
getBytes
以Java编程语言中的byte数组形式检索此ResultSet对象当前行中指定列的值。字节表示驱动程序返回的原始值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
列的值;如果值为SQL
NULL,则返回值为null - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
-
getDate
以Java编程语言中的java.sql.Date对象形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
列的值;如果值为SQL
NULL,则返回值为null - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
-
getTime
以Java编程语言中的java.sql.Time对象形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
列的值;如果值为SQL
NULL,则返回值为null - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
-
getTimestamp
以Java编程语言中的java.sql.Timestamp对象形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
列的值;如果值为SQL
NULL,则返回值为null - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
-
getAsciiStream
以ASCII字符流形式检索此ResultSet对象当前行中指定列的值。然后可以从流中以块的形式读取值。此方法特别适用于检索大型LONGVARCHAR值。JDBC驱动程序将从数据库格式转换为ASCII。注意: 必须在获取任何其他列的值之前读取返回流中的所有数据。对getter方法的下一次调用将隐式关闭流。此外,当调用
InputStream.available方法时,流可能返回0,无论数据是否可用。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
作为一个字节ASCII字符流传递数据库列值的Java输入流;如果值为SQL
NULL,则返回值为null - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
-
getUnicodeStream
Deprecated.usegetCharacterStreamin place ofgetUnicodeStream以两字节Unicode字符流形式检索此ResultSet对象当前行中指定列的值。第一个字节是高字节;第二个字节是低字节。然后可以从流中以块的形式读取值。此方法特别适用于检索大型LONGVARCHAR值。JDBC驱动程序将从数据库格式转换为Unicode。注意: 必须在获取任何其他列的值之前读取返回流中的所有数据。对getter方法的下一次调用将隐式关闭流。此外,当调用
InputStream.available方法时,流可能返回0,无论数据是否可用。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
作为一个两字节Unicode字符流传递数据库列值的Java输入流;如果值为SQL
NULL,则返回值为null - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法
-
getBinaryStream
以未解释字节流形式检索此ResultSet对象当前行中指定列的值。然后可以从流中以块的形式读取值。此方法特别适用于检索大型LONGVARBINARY值。注意: 必须在获取任何其他列的值之前读取返回流中的所有数据。对getter方法的下一次调用将隐式关闭流。此外,当调用
InputStream.available方法时,流可能返回0,无论数据是否可用。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
作为一个未解释字节流传递数据库列值的Java输入流;如果值为SQL
NULL,则返回值为null - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
-
getString
以Java编程语言中的String形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
列的值;如果值为SQL
NULL,则返回值为null - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭结果集上调用此方法
-
getBoolean
检索当前行中指定列的值作为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
检索当前行中指定列的值作为Java编程语言中的byte。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
列的值;如果值为SQL
NULL,则返回值为0 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getShort
检索当前行中指定列的值作为Java编程语言中的short。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
列的值;如果值为SQL
NULL,则返回值为0 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getInt
检索当前行中指定列的值作为Java编程语言中的int。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
列的值;如果值为SQL
NULL,则返回值为0 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getLong
检索当前行中指定列的值作为Java编程语言中的long。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
列的值;如果值为SQL
NULL,则返回值为0 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getFloat
检索当前行中指定列的值作为Java编程语言中的float。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
列的值;如果值为SQL
NULL,则返回值为0 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getDouble
检索当前行中指定列的值作为Java编程语言中的double。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
列的值;如果值为SQL
NULL,则返回值为0 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getBigDecimal
@Deprecated(since="1.2") BigDecimal getBigDecimal(String columnLabel, int scale) throws SQLException Deprecated.UsegetBigDecimal(int columnIndex)orgetBigDecimal(String columnLabel)检索当前行中指定列的值作为Java编程语言中的java.math.BigDecimal。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
scale- 小数点右侧的位数 - 返回:
-
列的值;如果值为SQL
NULL,则返回值为null - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法
-
getBytes
检索当前行中指定列的值作为Java编程语言中的byte数组。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
列的值;如果值为SQL
NULL,则返回值为null - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getDate
检索当前行中指定列的值作为Java编程语言中的java.sql.Date对象。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
列的值;如果值为SQL
NULL,则返回值为null - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getTime
检索当前行中指定列的值作为Java编程语言中的java.sql.Time对象。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
列的值;如果值为SQL
NULL,则返回值为null - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getTimestamp
检索当前行中指定列的值作为Java编程语言中的java.sql.Timestamp对象。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
列的值;如果值为SQL
NULL,则返回值为null - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getAsciiStream
检索当前行中指定列的值作为ASCII字符流。这些字节代表驱动程序返回的原始值。注意: 必须在获取任何其他列的值之前读取返回流中的所有数据。对getter方法的下一次调用将隐式关闭流。此外,当调用
available方法时,流可能返回0,无论数据是否可用。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
作为一个字节ASCII字符流传递数据库列值的Java输入流。如果值为SQL
NULL,则返回值为null。 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getUnicodeStream
Deprecated.usegetCharacterStreaminstead检索此ResultSet对象当前行中指定列的值,作为两字节Unicode字符流。第一个字节是高字节;第二个字节是低字节。然后可以从流中以块的方式读取值。此方法特别适用于检索大型LONGVARCHAR值。JDBC技术启用的驱动程序将从数据库格式转换为Unicode。注意:必须在获取任何其他列的值之前读取返回流中的所有数据。对getter方法的下一次调用将隐式关闭流。此外,当调用方法
InputStream.available时,流可能返回0,无论是否有可用数据。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签是列的名称 - 返回:
-
作为两字节Unicode字符流传递数据库列值的Java输入流。如果值为SQL
NULL,则返回的值为null。 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法
-
getBinaryStream
检索此ResultSet对象当前行中指定列的值,作为未解释的byte流。然后可以从流中以块的方式读取值。此方法特别适用于检索大型LONGVARBINARY值。注意:必须在获取任何其他列的值之前读取返回流中的所有数据。对getter方法的下一次调用将隐式关闭流。此外,当调用方法
available时,流可能返回0,无论是否有可用数据。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签是列的名称 - 返回:
-
作为未解释的字节流传递数据库列值的Java输入流;如果值为SQL
NULL,则结果为null - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭结果集上调用此方法
-
getWarnings
检索此ResultSet对象调用时报告的第一个警告。此ResultSet对象上的后续警告将链接到此方法返回的SQLWarning对象。每次读取新行时,警告链都会自动清除。不得在已关闭的
ResultSet对象上调用此方法;这样做将导致抛出SQLException。注意:此警告链仅涵盖由
ResultSet方法引起的警告。由Statement方法引起的任何警告(例如读取OUT参数)将链接到Statement对象。- 返回:
-
报告的第一个
SQLWarning对象或如果没有则为null - 抛出:
-
SQLException- 如果发生数据库访问错误或在关闭结果集上调用此方法
-
clearWarnings
清除此ResultSet对象上报告的所有警告。调用此方法后,方法getWarnings将返回null,直到为此ResultSet对象报告新警告为止。- 抛出:
-
SQLException- 如果发生数据库访问错误或在关闭结果集上调用此方法
-
getCursorName
检索此ResultSet对象使用的SQL游标的名称。在SQL中,通过命名的游标检索结果表。可以使用引用游标名称的定位更新/删除语句更新或删除结果集的当前行。为确保游标具有适当的隔离级别以支持更新,游标的
SELECT语句应为SELECT FOR UPDATE的形式。如果省略了FOR UPDATE,则定位更新可能失败。JDBC API通过提供
ResultSet对象使用的SQL游标的名称来支持此SQL功能。ResultSet对象的当前行也是此SQL游标的当前行。- 返回:
-
此
ResultSet对象的游标的SQL名称 - 抛出:
-
SQLException- 如果发生数据库访问错误或在关闭结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法
-
getMetaData
检索此ResultSet对象的列的数量、类型和属性。- 返回:
-
此
ResultSet对象的列的描述 - 抛出:
-
SQLException- 如果发生数据库访问错误或在关闭结果集上调用此方法
-
getObject
以Java编程语言中的
Object形式获取此ResultSet对象当前行中指定列的值。此方法将以Java对象的形式返回给定列的值。Java对象的类型将是与列的SQL类型对应的默认Java对象类型,遵循JDBC规范中指定的内置类型的映射。如果值为SQL
NULL,驱动程序将返回Javanull。此方法还可用于读取特定于数据库的抽象数据类型。在JDBC 2.0 API中,方法
getObject的行为扩展到实例化SQL用户定义类型的数据。如果
Connection.getTypeMap不抛出SQLFeatureNotSupportedException,则当列包含结构化或不同值时,此方法的行为就像调用:getObject(columnIndex, this.getStatement().getConnection().getTypeMap())。如果Connection.getTypeMap抛出SQLFeatureNotSupportedException,则不支持结构化值,并且不同值将根据DISTINCT类型的基础SQL类型确定的默认Java类映射。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
包含列值的
java.lang.Object - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
-
getObject
以Java编程语言中的
Object形式获取此ResultSet对象当前行中指定列的值。此方法将以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
将给定的ResultSet列标签映射到其ResultSet列索引。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签是列的名称 - 返回:
- 给定列名的列索引
- 抛出:
-
SQLException- 如果ResultSet对象不包含标记为columnLabel的列,发生数据库访问错误或在关闭结果集上调用此方法
-
getCharacterStream
检索此ResultSet对象当前行中指定列的值,作为java.io.Reader对象。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
包含列值的
java.io.Reader对象;如果值为SQLNULL,则在Java编程语言中返回的值为null。 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法 - 自:
- 1.2
-
getCharacterStream
检索此ResultSet对象当前行中指定列的值,作为java.io.Reader对象。- 参数:
-
columnLabel- 使用SQL AS子句指定的列标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
包含列值的
java.io.Reader对象;如果值为SQLNULL,则在Java编程语言中返回的值为null - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 - 自版本:
- 1.2
-
getBigDecimal
以完整精度将当前行中指定列的值作为java.math.BigDecimal检索。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
列值(完整精度);如果值为SQL
NULL,则在Java编程语言中返回的值为null。 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 - 自版本:
- 1.2
-
getBigDecimal
以完整精度将当前行中指定列的值作为java.math.BigDecimal检索。- 参数:
-
columnLabel- 使用SQL AS子句指定的列标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
列值(完整精度);如果值为SQL
NULL,则在Java编程语言中返回的值为null。 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 - 自版本:
- 1.2
-
isBeforeFirst
检索此ResultSet对象中当前行中指定列的值,作为具有完整精度的java.math.BigDecimal。注意:对于结果集类型为
TYPE_FORWARD_ONLY的ResultSet,isBeforeFirst方法的支持是可选的- 返回:
-
如果光标位于第一行之前,则返回
true;如果光标位于任何其他位置或结果集不包含行,则返回false - 抛出:
-
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
isAfterLast
检索此ResultSet对象中光标是否位于最后一行之后。注意:对于结果集类型为
TYPE_FORWARD_ONLY的ResultSet,isAfterLast方法的支持是可选的- 返回:
-
如果光标位于最后一行之后,则返回
true;如果光标位于任何其他位置或结果集不包含行,则返回false - 抛出:
-
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
isFirst
检索此ResultSet对象中光标是否位于第一行。注意:对于结果集类型为
TYPE_FORWARD_ONLY的ResultSet,isFirst方法的支持是可选的- 返回:
-
如果光标位于第一行,则返回
true;否则返回false - 抛出:
-
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
isLast
检索此ResultSet对象中光标是否位于最后一行。 注意:调用isLast方法可能很昂贵,因为JDBC驱动程序可能需要提前获取一行,以确定当前行是否为结果集中的最后一行。注意:对于结果集类型为
TYPE_FORWARD_ONLY的ResultSet,isLast方法的支持是可选的- 返回:
-
如果光标位于最后一行,则返回
true;否则返回false - 抛出:
-
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
beforeFirst
将光标移动到此ResultSet对象的开头,即第一行之前。如果结果集不包含行,则此方法不起作用。- 抛出:
-
SQLException- 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
afterLast
将光标移动到此ResultSet对象的末尾,即最后一行之后。如果结果集不包含行,则此方法不起作用。- 抛出:
-
SQLException- 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
first
将光标移动到此ResultSet对象中的第一行。- 返回:
-
如果光标位于有效行上,则返回
true;如果结果集中没有行,则返回false - 抛出:
-
SQLException- 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
last
将光标移动到此ResultSet对象中的最后一行。- 返回:
-
如果光标位于有效行上,则返回
true;如果结果集中没有行,则返回false - 抛出:
-
SQLException- 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
getRow
检索当前行号。第一行为1,第二行为2,依此类推。注意:对于结果集类型为
TYPE_FORWARD_ONLY的ResultSet,getRow方法的支持是可选的- 返回:
-
当前行号;如果没有当前行,则为
0 - 抛出:
-
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
absolute
将光标移动到此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
将光标相对移动一定数量的行,可以是正数或负数。尝试移动到结果集中的第一行/最后一行之外的位置会将光标定位在第一行之前/最后一行之后。调用relative(0)是有效的,但不会更改光标位置。注意: 调用方法
relative(1)等同于调用方法next(),调用方法relative(-1)等同于调用方法previous()。- 参数:
-
rows- 指定要从当前行移动的行数;正数将光标向前移动;负数将光标向后移动 - 返回:
-
true如果光标在一行上;否则为false - 抛出:
-
SQLException- 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY时调用此方法 -
SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法 - 自版本:
- 1.2
-
previous
将光标移动到此ResultSet对象中的上一行。当调用
previous方法返回false时,光标定位在第一行之前。任何需要当前行的ResultSet方法的调用将导致抛出SQLException。如果为当前行打开了输入流,则调用方法
previous将隐式关闭它。当读取新行时,ResultSet对象的警告更改将被清除。- 返回:
-
true如果光标现在位于有效行上;false如果光标位于第一行之前 - 抛出:
-
SQLException- 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY时调用此方法 -
SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法 - 自版本:
- 1.2
-
setFetchDirection
给出此ResultSet对象中行的处理方向的提示。初始值由生成此ResultSet对象的Statement对象确定。可以随时更改提取方向。- 参数:
-
direction- 指定建议的提取方向的int;为ResultSet.FETCH_FORWARD、ResultSet.FETCH_REVERSE或ResultSet.FETCH_UNKNOWN之一 - 抛出:
-
SQLException- 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY且提取方向不是FETCH_FORWARD时调用此方法 - 自版本:
- 1.2
- 另请参阅:
-
getFetchDirection
检索此ResultSet对象的提取方向。- 返回:
-
此
ResultSet对象的当前提取方向 - 抛出:
-
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 自版本:
- 1.2
- 另请参阅:
-
setFetchSize
给 JDBC 驱动程序一个提示,指示在需要更多行时应从数据库中获取的行数。如果指定的提取大小为零,则 JDBC 驱动程序将忽略该值,并可以自行猜测提取大小。默认值由创建结果集的Statement对象设置。提取大小可以随时更改。- 参数:
-
rows- 要获取的行数 - 抛出:
-
SQLException- 如果发生数据库访问错误;在关闭的结果集上调用此方法或不满足条件rows >= 0时调用此方法 - 自版本:
- 1.2
- 另请参阅:
-
getFetchSize
检索此ResultSet对象的提取大小。- 返回:
-
此
ResultSet对象的当前提取大小 - 抛出:
-
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 自版本:
- 1.2
- 另请参阅:
-
getType
检索此ResultSet对象的类型。类型由创建结果集的Statement对象确定。- 返回:
-
ResultSet.TYPE_FORWARD_ONLY、ResultSet.TYPE_SCROLL_INSENSITIVE或ResultSet.TYPE_SCROLL_SENSITIVE - 抛出:
-
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 自版本:
- 1.2
-
getConcurrency
检索此ResultSet对象的并发模式。使用的并发性由创建结果集的Statement对象确定。- 返回:
-
并发类型,为
ResultSet.CONCUR_READ_ONLY或ResultSet.CONCUR_UPDATABLE - 抛出:
-
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 自版本:
- 1.2
-
rowUpdated
检索当前行是否已更新。返回的值取决于结果集是否能够检测更新。注意: 对于结果集并发性为
CONCUR_READ_ONLY的情况,对rowUpdated方法的支持是可选的- 返回:
-
true如果当前行被所有者或其他人明显更新;否则为false - 抛出:
-
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法 - 自版本:
- 1.2
- 另请参阅:
-
rowInserted
检索当前行是否已插入。返回的值取决于此ResultSet对象是否能够检测可见插入。注意: 对于结果集并发性为
CONCUR_READ_ONLY的情况,对rowInserted方法的支持是可选的- 返回:
-
true如果当前行被检测到已插入;否则为false - 抛出:
-
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法 - 自版本:
- 1.2
- 另请参阅:
-
rowDeleted
检索是否已删除行。删除的行可能在结果集中留下可见的“空洞”。此方法可用于检测结果集中的空洞。返回的值取决于此ResultSet对象是否能够检测删除。注意: 对于结果集并发性为
CONCUR_READ_ONLY的情况,对rowDeleted方法的支持是可选的- 返回:
-
true如果当前行被所有者或其他人删除,则返回true;否则返回false - 抛出:
-
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
- 参见:
-
updateNull
使用null值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 抛出:
-
SQLException- 如果列索引无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
updateBoolean
使用boolean值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果列索引无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
updateByte
使用byte值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果列索引无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
updateShort
使用short值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果列索引无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
updateInt
使用int值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果列索引无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
updateLong
使用long值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果列索引无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
updateFloat
使用float值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果列索引无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
updateDouble
使用double值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果列索引无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
updateBigDecimal
使用java.math.BigDecimal值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果列索引无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
updateString
使用String值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果列索引无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
updateBytes
使用byte数组值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateDate
使用java.sql.Date值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateTime
使用java.sql.Time值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateTimestamp
使用java.sql.Timestamp值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateAsciiStream
使用ascii流值更新指定的列,该值将具有指定的字节数。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 -
length- 流的长度 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateBinaryStream
使用二进制流值更新指定的列,该值将具有指定的字节数。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 -
length- 流的长度 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateCharacterStream
使用字符流值更新指定的列,该值将具有指定的字节数。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 -
length- 流的长度 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateObject
使用Object值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用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版本起:
- 1.2
-
updateObject
使用Object值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateNull
使用null值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateBoolean
使用boolean值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateByte
使用byte值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateShort
使用short值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateInt
使用int值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateLong
使用long值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateFloat
使用float值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateDouble
使用double值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateBigDecimal
使用java.sql.BigDecimal值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateString
使用String值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateBytes
使用字节数组值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateDate
使用java.sql.Date值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateTime
使用java.sql.Time值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateTimestamp
使用java.sql.Timestamp值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateAsciiStream
使用ascii流值更新指定的列,该值将具有指定的字节数。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 -
length- 流的长度 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateBinaryStream
使用二进制流值更新指定的列,该值将具有指定的字节数。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 -
length- 流的长度 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateCharacterStream
使用字符流值更新指定的列,该值将具有指定的字节数。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
reader- 包含新列值的java.io.Reader对象 -
length- 流的长度 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateObject
使用Object值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用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版本起:
- 1.2
-
updateObject
使用Object值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
insertRow
将插入行的内容插入此ResultSet对象和数据库中。调用此方法时,光标必须位于插入行上。- 抛出:
-
SQLException- 如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY;在关闭的结果集上调用此方法;当光标不在插入行上时调用此方法;或者如果插入行中的所有非空列未给定非空值 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
updateRow
使用此ResultSet对象当前行的新内容更新底层数据库。当光标位于插入行上时,无法调用此方法。- 抛出:
-
SQLException- 如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY;在关闭的结果集上调用此方法;或者当光标位于插入行上时调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.2版本起:
- 1.2
-
deleteRow
从此ResultSet对象和底层数据库中删除当前行。当光标位于插入行上时,无法调用此方法。- 抛出:
-
SQLException- 如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY;在关闭的结果集上调用此方法或在光标位于插入行时调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
refreshRow
刷新当前行以获取数据库中最新的值。当光标位于插入行时,无法调用此方法。refreshRow方法提供了一种应用程序明确告诉JDBC驱动程序从数据库重新获取一行或多行的方式。应用程序可能希望在JDBC驱动程序执行缓存或预取时调用refreshRow以从数据库获取行的最新值。如果获取大小大于一,则JDBC驱动程序实际上可能一次刷新多行。所有值都将根据事务隔离级别和光标敏感性重新获取。如果在调用更新程序方法后但在调用方法
updateRow之前调用refreshRow,则对行进行的更新将丢失。频繁调用方法refreshRow可能会降低性能。- 抛出:
-
SQLException- 如果发生数据库访问错误;在关闭的结果集上调用此方法;结果集类型为TYPE_FORWARD_ONLY或在光标位于插入行时调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法或不支持指定的结果集类型和结果集并发性 - 自版本:
- 1.2
-
cancelRowUpdates
取消在此ResultSet对象中对当前行所做的更新。可以在调用更新程序方法后但在调用方法updateRow之前调用此方法,以撤消对行所做的更新。如果没有进行更新或已经调用updateRow,则此方法不起作用。- 抛出:
-
SQLException- 如果发生数据库访问错误;在关闭的结果集上调用此方法;结果集并发性为CONCUR_READ_ONLY或在光标位于插入行时调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
moveToInsertRow
将光标移动到插入行。在光标位于插入行时,当前光标位置将被记住。插入行是与可更新结果集关联的特殊行。它本质上是一个缓冲区,可以通过在将行插入结果集之前调用更新程序方法来构造新行。只有在光标位于插入行时才能调用更新程序、获取程序和insertRow方法。每次调用此方法之前,必须为结果集中的所有列赋值,然后才能调用insertRow。在调用列值的获取程序方法之前必须调用更新程序方法。- 抛出:
-
SQLException- 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集并发性为CONCUR_READ_ONLY -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
moveToCurrentRow
将光标移动到记住的光标位置,通常是当前行。如果光标不在插入行上,则此方法不起作用。- 抛出:
-
SQLException- 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集并发性为CONCUR_READ_ONLY -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
getStatement
检索生成此ResultSet对象的Statement对象。如果结果集是以其他方式生成的,例如通过DatabaseMetaData方法生成的,则此方法可能返回null。- 返回:
-
生成此
ResultSet对象的Statement对象或如果结果集是以其他方式生成的则返回null - 抛出:
-
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 自版本:
- 1.2
-
getObject
以Java编程语言中的Object形式检索此ResultSet对象的当前行中指定列的值。如果值为SQLNULL,则驱动程序返回Javanull。如果适用,此方法使用给定的Map对象进行SQL结构化或不同类型的自定义映射。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
map- 包含SQL类型名称到Java编程语言中的类的映射的java.util.Map对象 - 返回:
-
以Java编程语言中的
Object形式表示的SQL值 - 抛出:
-
SQLException- 如果列索引无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
getRef
以Java编程语言中的Ref对象形式检索此ResultSet对象的当前行中指定列的值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
表示SQL
REF值的Ref对象 - 抛出:
-
SQLException- 如果列索引无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
getBlob
以Java编程语言中的Blob对象形式检索此ResultSet对象的当前行中指定列的值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
表示指定列中的SQL
BLOB值的Blob对象 - 抛出:
-
SQLException- 如果列索引无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
getClob
以Java编程语言中的Clob对象形式检索此ResultSet对象的当前行中指定列的值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
表示指定列中的SQL
CLOB值的Clob对象 - 抛出:
-
SQLException- 如果列索引无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
getArray
以Java编程语言中的Array对象形式检索此ResultSet对象的当前行中指定列的值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
表示指定列中的SQL
ARRAY值的Array对象 - 抛出:
-
SQLException- 如果列索引无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
getObject
以Java编程语言中的Object形式检索此ResultSet对象的当前行中指定列的值。如果值为SQLNULL,则驱动程序返回Javanull。如果适用,此方法使用指定的Map对象进行自定义映射。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
map- 一个包含从SQL类型名称到Java编程语言中的类的映射的java.util.Map对象 - 返回:
-
一个表示指定列中SQL值的
Object - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
getRef
以Java编程语言中的Ref对象的形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
一个表示指定列中SQL
REF值的Ref对象 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
getBlob
以Java编程语言中的Blob对象的形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
一个表示指定列中SQL
BLOB值的Blob对象 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
getClob
以Java编程语言中的Clob对象的形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
一个表示指定列中SQL
CLOB值的Clob对象 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
getArray
以Java编程语言中的Array对象的形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
一个表示指定列中SQL
ARRAY值的Array对象 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
getDate
以Java编程语言中的java.sql.Date对象的形式检索此ResultSet对象当前行中指定列的值。如果底层数据库不存储时区信息,则此方法使用给定的日历构造日期的适当毫秒值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
cal- 用于构造日期的java.util.Calendar对象 - 返回:
-
作为
java.sql.Date对象的列值;如果值为SQLNULL,则在Java编程语言中返回的值为null - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 - 自版本:
- 1.2
-
getDate
以Java编程语言中的java.sql.Date对象的形式检索此ResultSet对象当前行中指定列的值。如果底层数据库不存储时区信息,则此方法使用给定的日历构造日期的适当毫秒值。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
cal- 用于构造日期的java.util.Calendar对象 - 返回:
-
作为
java.sql.Date对象的列值;如果值为SQLNULL,则在Java编程语言中返回的值为null - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 - 自版本:
- 1.2
-
getTime
以Java编程语言中的java.sql.Time对象的形式检索此ResultSet对象当前行中指定列的值。如果底层数据库不存储时区信息,则此方法使用给定的日历构造时间的适当毫秒值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
cal- 用于构造时间的java.util.Calendar对象 - 返回:
-
作为
java.sql.Time对象的列值;如果值为SQLNULL,则在Java编程语言中返回的值为null - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 - 自版本:
- 1.2
-
getTime
以Java编程语言中的java.sql.Time对象的形式检索此ResultSet对象当前行中指定列的值。如果底层数据库不存储时区信息,则此方法使用给定的日历构造时间的适当毫秒值。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
cal- 用于构造时间的java.util.Calendar对象 - 返回:
-
作为
java.sql.Time对象的列值;如果值为SQLNULL,则在Java编程语言中返回的值为null - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 - 自版本:
- 1.2
-
getTimestamp
以Java编程语言中的java.sql.Timestamp对象的形式检索此ResultSet对象当前行中指定列的值。如果底层数据库不存储时区信息,则此方法使用给定的日历构造时间戳的适当毫秒值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
cal- 用于构造时间戳的java.util.Calendar对象 - 返回:
-
作为
java.sql.Timestamp对象的列值;如果值为SQLNULL,则在Java编程语言中返回的值为null - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 - 自版本:
- 1.2
-
getTimestamp
以Java编程语言中的java.sql.Timestamp对象的形式检索此ResultSet对象当前行中指定列的值。如果底层数据库不存储时区信息,则此方法使用给定的日历构造时间戳的适当毫秒值。- 参数:
-
columnLabel- 使用SQL AS子句指定的列标签。如果未指定SQL AS子句,则标签为列的名称 -
cal- 用于构造日期的java.util.Calendar对象 - 返回:
-
作为
java.sql.Timestamp对象的列值;如果值为SQLNULL,则在Java编程语言中返回的值为null - 抛出:
-
SQLException- 如果columnLabel无效或发生数据库访问错误或在关闭的结果集上调用此方法 - 自版本:
- 1.2
-
getURL
以Java编程语言中的java.net.URL对象的形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnIndex- 列的索引,1表示第一列,2表示第二列,... - 返回:
-
作为
java.net.URL对象的列值;如果值为SQLNULL,则在Java编程语言中返回的值为null - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;在关闭的结果集上调用此方法;或URL格式不正确 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.4
-
getURL
以Java编程语言中的java.net.URL对象的形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnLabel- 使用SQL AS子句指定的列标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
作为
java.net.URL对象的列值;如果值为SQLNULL,则在Java编程语言中返回的值为null - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;在关闭的结果集上调用此方法;或URL格式不正确 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.4
-
updateRef
使用java.sql.Ref值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY;或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.4
-
updateRef
使用java.sql.Ref值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY;或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.4
-
updateBlob
使用java.sql.Blob值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY;或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.4
-
updateBlob
使用java.sql.Blob值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY;或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.4
-
updateClob
使用java.sql.Clob值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY;或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.4
-
updateClob
使用java.sql.Clob值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY;或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.4
-
updateArray
使用java.sql.Array值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY;或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.4
-
updateArray
使用java.sql.Array值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.4版本起:
- 1.4
-
getRowId
以Java编程语言中的java.sql.RowId对象的形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
列值;如果值为SQL
NULL,则返回值为null - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.6版本起:
- 1.6
-
getRowId
以Java编程语言中的java.sql.RowId对象的形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
列值;如果值为SQL
NULL,则返回值为null - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.6版本起:
- 1.6
-
updateRowId
使用RowId值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 列值 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.6版本起:
- 1.6
-
updateRowId
使用RowId值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.6版本起:
- 1.6
-
getHoldability
检索此ResultSet对象的保持性- 返回:
-
ResultSet.HOLD_CURSORS_OVER_COMMIT或ResultSet.CLOSE_CURSORS_AT_COMMIT - 抛出:
-
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法 - 自1.6版本起:
- 1.6
-
isClosed
检索此ResultSet对象是否已关闭。如果在其上调用了close方法,或者它被自动关闭,则ResultSet已关闭。- 返回:
-
如果此
ResultSet对象已关闭,则为true;如果仍然打开,则为false - 抛出:
-
SQLException- 如果发生数据库访问错误 - 自1.6版本起:
- 1.6
-
updateNString
使用String值更新指定的列。用于更新NCHAR、NVARCHAR和LONGNVARCHAR列时使用。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
nString- 要更新的列的值 - 抛出:
-
SQLException- 如果columnIndex无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭的结果集上调用此方法;结果集并发性为CONCUR_READ_ONLY或如果发生数据库访问错误 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.6版本起:
- 1.6
-
updateNString
使用String值更新指定的列。用于更新NCHAR、NVARCHAR和LONGNVARCHAR列时使用。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
nString- 要更新的列的值 - 抛出:
-
SQLException- 如果columnLabel无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭的结果集上调用此方法;结果集并发性为CONCUR_READ_ONLY或如果发生数据库访问错误 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.6版本起:
- 1.6
-
updateNClob
使用java.sql.NClob值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
nClob- 要更新的列的值 - 抛出:
-
SQLException- 如果columnIndex无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.6版本起:
- 1.6
-
updateNClob
使用java.sql.NClob值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
nClob- 要更新的列的值 - 抛出:
-
SQLException- 如果columnLabel无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自1.6版本起:
- 1.6
-
getNClob
以Java编程语言中的NClob对象的形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
一个表示指定列中SQL
NCLOB值的NClob对象 - 抛出:
-
SQLException- 如果 columnIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭结果集上调用此方法或发生数据库访问错误时 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自从:
- 1.6
-
getNClob
以Java编程语言中的NClob对象的形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
一个表示指定列中SQL
NCLOB值的NClob对象 - 抛出:
-
SQLException- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭结果集上调用此方法或发生数据库访问错误时 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自从:
- 1.6
-
getSQLXML
以Java编程语言中的java.sql.SQLXML对象的形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnIndex- 第一列为1,第二列为2,... - 返回:
-
一个映射到
SQL XML值的SQLXML对象 - 抛出:
-
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自从:
- 1.6
-
getSQLXML
以Java编程语言中的java.sql.SQLXML对象的形式检索此ResultSet对象当前行中指定列的值。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
一个映射到
SQL XML值的SQLXML对象 - 抛出:
-
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自从:
- 1.6
-
updateSQLXML
使用java.sql.SQLXML值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用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
使用java.sql.SQLXML值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用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
以Java编程语言中的String对象的形式检索此ResultSet对象当前行中指定列的值。在访问NCHAR、NVARCHAR和LONGNVARCHAR列时使用。- 参数:
-
columnIndex- 第一列为1,第二为2,... - 返回:
-
列值;如果值为SQL
NULL,则返回值为null - 抛出:
-
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自从:
- 1.6
-
getNString
以Java编程语言中的String对象的形式检索此ResultSet对象当前行中指定列的值。在访问NCHAR、NVARCHAR和LONGNVARCHAR列时使用。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
列值;如果值为SQL
NULL,则返回值为null - 抛出:
-
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自从:
- 1.6
-
getNCharacterStream
以Java编程语言中的java.io.Reader对象的形式检索此ResultSet对象当前行中指定列的值。在访问NCHAR、NVARCHAR和LONGNVARCHAR列时使用。- 参数:
-
columnIndex- 第一列为1,第二为2,... - 返回:
-
一个包含列值的
java.io.Reader对象;如果值为SQLNULL,则返回值为null在Java编程语言中。 - 抛出:
-
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自从:
- 1.6
-
getNCharacterStream
以Java编程语言中的java.io.Reader对象的形式检索此ResultSet对象当前行中指定列的值。在访问NCHAR、NVARCHAR和LONGNVARCHAR列时使用。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 - 返回:
-
一个包含列值的
java.io.Reader对象;如果值为SQLNULL,则返回值为null在Java编程语言中 - 抛出:
-
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自从:
- 1.6
-
updateNCharacterStream
更新指定列的字符流值,该值将具有指定的字节数。驱动程序将从Java字符格式转换为数据库中的国家字符集。用于更新NCHAR、NVARCHAR和LONGNVARCHAR列时。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 -
length- 流的长度 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自:
- 1.6
-
updateNCharacterStream
更新指定列的字符流值,该值将具有指定的字节数。驱动程序将从Java字符格式转换为数据库中的国家字符集。用于更新NCHAR、NVARCHAR和LONGNVARCHAR列时。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
reader- 包含新列值的java.io.Reader对象 -
length- 流的长度 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自:
- 1.6
-
updateAsciiStream
更新指定列的ASCII流值,该值将具有指定的字节数。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 -
length- 流的长度 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自:
- 1.6
-
updateBinaryStream
更新指定列的二进制流值,该值将具有指定的字节数。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 -
length- 流的长度 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自:
- 1.6
-
updateCharacterStream
更新指定列的字符流值,该值将具有指定的字节数。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 -
length- 流的长度 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自:
- 1.6
-
updateAsciiStream
更新指定列的ASCII流值,该值将具有指定的字节数。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 -
length- 流的长度 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自:
- 1.6
-
updateBinaryStream
更新指定列的二进制流值,该值将具有指定的字节数。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 -
length- 流的长度 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自:
- 1.6
-
updateCharacterStream
更新指定列的字符流值,该值将具有指定的字节数。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
reader- 包含新列值的java.io.Reader对象 -
length- 流的长度 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自:
- 1.6
-
updateBlob
使用给定的输入流更新指定列,该值将具有指定的字节数。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
inputStream- 包含要设置参数值的数据的对象。 -
length- 参数数据中的字节数。 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自:
- 1.6
-
updateBlob
更新指定的列,使用给定的输入流,该输入流将具有指定的字节数。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称。 -
inputStream- 包含要设置参数值的数据的对象。 -
length- 参数数据中的字节数。 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.6
-
updateClob
使用给定的Reader对象更新指定的列,该对象的长度为给定的字符数。当将非常大的UNICODE值输入到LONGVARCHAR参数时,通过java.io.Reader对象发送可能更实用。JDBC驱动程序将从UNICODE转换为数据库字符格式。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
reader- 包含要设置参数值的数据的对象。 -
length- 参数数据中的字符数。 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.6
-
updateClob
使用给定的Reader对象更新指定的列,该对象的长度为给定的字符数。当将非常大的UNICODE值输入到LONGVARCHAR参数时,通过java.io.Reader对象发送可能更实用。JDBC驱动程序将从UNICODE转换为数据库字符格式。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称。 -
reader- 包含要设置参数值的数据的对象。 -
length- 参数数据中的字符数。 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.6
-
updateNClob
使用给定的Reader对象更新指定的列,该对象的长度为给定的字符数。当将非常大的UNICODE值输入到LONGVARCHAR参数时,通过java.io.Reader对象发送可能更实用。JDBC驱动程序将从UNICODE转换为数据库字符格式。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
-
columnIndex- 第一列为1,第二为2,... -
reader- 包含要设置参数值的数据的对象。 -
length- 参数数据中的字符数。 - 抛出:
-
SQLException- 如果columnIndex无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭的结果集上调用此方法,如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.6
-
updateNClob
使用给定的Reader对象更新指定的列,该对象的长度为给定的字符数。当将非常大的UNICODE值输入到LONGVARCHAR参数时,通过java.io.Reader对象发送可能更实用。JDBC驱动程序将从UNICODE转换为数据库字符格式。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称。 -
reader- 包含要设置参数值的数据的对象。 -
length- 参数数据中的字符数。 - 抛出:
-
SQLException- 如果columnLabel无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.6
-
updateNCharacterStream
使用字符流值更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。驱动程序将从Java字符格式转换为数据库中的国家字符集。用于更新NCHAR、NVARCHAR和LONGNVARCHAR列时。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的
updateNCharacterStream版本。- 参数:
-
columnIndex- 第一列为1,第二为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.6
-
updateNCharacterStream
使用字符流值更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。驱动程序将从Java字符格式转换为数据库中的国家字符集。用于更新NCHAR、NVARCHAR和LONGNVARCHAR列时。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的
updateNCharacterStream版本。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称。 -
reader- 包含新列值的java.io.Reader对象。 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.6
-
updateAsciiStream
使用ASCII流值更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的
updateAsciiStream版本。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.6
-
updateBinaryStream
使用二进制流值更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的
updateBinaryStream版本。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.6
-
updateCharacterStream
使用字符流值更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的
updateCharacterStream版本。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.6
-
updateAsciiStream
使用ASCII流值更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的
updateAsciiStream版本。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.6
-
updateBinaryStream
使用二进制流值更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的
updateBinaryStream版本。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.6
-
updateCharacterStream
使用字符流值更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的
updateCharacterStream版本。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
reader- 包含新列值的java.io.Reader对象 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.6
-
updateBlob
使用给定的输入流更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的
updateBlob版本。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
inputStream- 包含要设置参数值的数据的对象 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.6
-
updateBlob
使用给定的输入流更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的
updateBlob版本。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
inputStream- 包含要设置参数值的数据的对象 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.6
-
updateClob
使用给定的Reader对象更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。JDBC驱动程序将执行从UNICODE到数据库字符格式的任何必要转换。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的
updateClob版本。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
reader- 包含要设置参数值的数据的对象 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.6
-
updateClob
使用给定的Reader对象更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。JDBC驱动程序将执行从UNICODE到数据库字符格式的任何必要转换。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的
updateClob版本。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
reader- 包含要设置参数值的数据的对象 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.6
-
updateNClob
使用给定的Reader对象更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。JDBC驱动程序将执行从UNICODE到数据库字符格式的任何必要转换。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的
updateNClob版本。- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
reader- 包含要设置参数值的数据的对象 - 抛出:
-
SQLException- 如果columnIndex无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.6
-
updateNClob
使用给定的Reader对象更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。JDBC驱动程序将执行从UNICODE到数据库字符格式的任何必要转换。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的
updateNClob版本。- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
reader- 包含要设置参数值的数据的对象 - 抛出:
-
SQLException- 如果columnLabel无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.6
-
getObject
检索此
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
检索此
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值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用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
- 参见:
-
updateObject
default void updateObject(String columnLabel, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException 更新指定列的Object值。更新器方法用于更新当前行或插入行中的列值。更新器方法不会更新底层数据库;而是调用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
- 参见:
-
updateObject
更新指定列的Object值。更新器方法用于更新当前行或插入行中的列值。更新器方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。默认实现将抛出
SQLFeatureNotSupportedException- 参数:
-
columnIndex- 第一列为1,第二列为2,... -
x- 新的列值 -
targetSqlType- 要发送到数据库的SQL类型 - 抛出:
-
SQLException- 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法;如果JDBC驱动程序不支持指定的targetSqlType - 自从:
- 1.8
- 参见:
-
updateObject
更新指定列的Object值。更新器方法用于更新当前行或插入行中的列值。更新器方法不会更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。默认实现将抛出
SQLFeatureNotSupportedException- 参数:
-
columnLabel- 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称 -
x- 新的列值 -
targetSqlType- 要发送到数据库的SQL类型 - 抛出:
-
SQLException- 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法;如果JDBC驱动程序不支持指定的targetSqlType - 自从:
- 1.8
- 参见:
-
getBigDecimal(int columnIndex)或getBigDecimal(String columnLabel)