- 所有父级接口:
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 will be scrollable, will not show changes made by others,
// and will be updatable
ResultSet 接口提供吸气剂用于从当前行检索列值的方法(getBoolean、getLong 等)。可以使用列的索引号或列的名称来检索值。一般来说,使用列索引会更有效率。列从 1 开始编号。为了获得最大的可移植性,每行中的结果集列应按从左到右的顺序读取,并且每列应仅读取一次。
对于 getter 方法,JDBC 驱动程序尝试将底层数据转换为 getter 方法中指定的 Java 类型,并返回合适的 Java 值。 JDBC 规范有一个表,显示了从 SQL 类型到 Java 类型的允许映射,这些映射可以由 ResultSet getter 方法使用。
用作 getter 方法输入的列名不区分大小写。当使用列名调用 getter 方法并且多个列具有相同的名称时,将返回第一个匹配列的值。列名选项旨在在生成结果集的 SQL 查询中使用列名时使用。对于查询中未明确命名的列,最好使用列号。如果使用列名,程序员应该注意保证它们唯一地引用预期的列,SQL 可以保证这一点AS条款。
在 JDBC 2.0 API(Java 2 SDK,标准版,1.2 版)中,已将一组更新程序方法添加到此接口。关于 getter 方法参数的注解也适用于 updater 方法的参数。
可以通过两种方式使用更新程序方法:
- 更新当前行中的列值。在可滚动的
ResultSet对象中,光标可以前后移动,可以移动到绝对位置,也可以移动到相对于当前行的位置。以下代码片段更新ResultSet对象rs第五行中的NAME列,然后使用方法updateRow更新派生rs的数据源表。rs.absolute(5); // moves the cursor to the fifth row of rs rs.updateString("NAME", "AINSWORTH"); // updates the //NAMEcolumn of row 5 to beAINSWORTHrs.updateRow(); // updates the row in the data source - 将列值插入到插入行中。可更新的
ResultSet对象有一个与之关联的特殊行,用作构建要插入的行的临时区域。以下代码片段将光标移动到插入行,构建一个三列行,并使用方法insertRow将其插入到rs和数据源表中。rs.moveToInsertRow(); // moves cursor to the insert row rs.updateString(1, "AINSWORTH"); // updates the // first column of the insert row to beAINSWORTHrs.updateInt(2,35); // updates the second column to be35rs.updateBoolean(3, true); // updates the third column totruers.insertRow(); rs.moveToCurrentRow();
当生成它的 Statement 对象关闭、重新执行或用于从多个结果序列中检索下一个结果时,ResultSet 对象将自动关闭。
ResultSet 对象列的数量、类型和属性由 ResultSet.getMetaData 方法返回的 ResultSetMetaData 对象提供。
- 自从:
- 1.1
- 参见:
-
字段摘要
字段修饰符和类型Field描述static 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对象类型的常量,该对象可滚动但通常对ResultSet基础数据的更改不敏感。static final int指示ResultSet对象类型的常量,该对象可滚动并且通常对ResultSet基础数据的更改敏感。 -
方法总结
修饰符和类型方法描述booleanabsolute(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) 检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的Array对象。检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的Array对象。getAsciiStream(int columnIndex) 检索此ResultSet对象当前行中指定列的值作为 ASCII 字符流。getAsciiStream(String columnLabel) 检索此ResultSet对象当前行中指定列的值作为 ASCII 字符流。getBigDecimal(int columnIndex) 以全精度检索此ResultSet对象当前行中指定列的值作为java.math.BigDecimal。getBigDecimal(int columnIndex, int scale) 已弃用。getBigDecimal(String columnLabel) 以全精度检索此ResultSet对象当前行中指定列的值作为java.math.BigDecimal。getBigDecimal(String columnLabel, int scale) 已弃用。使用getBigDecimal(int columnIndex)或getBigDecimal(String columnLabel)getBinaryStream(int columnIndex) 检索此ResultSet对象当前行中指定列的值作为未解释字节流。getBinaryStream(String columnLabel) 检索此ResultSet对象的当前行中指定列的值作为未解释的bytes 的流。getBlob(int columnIndex) 检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的Blob对象。检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的Blob对象。booleangetBoolean(int columnIndex) 检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的boolean。booleangetBoolean(String columnLabel) 检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的boolean。bytegetByte(int columnIndex) 检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的byte。byte检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的byte。byte[]getBytes(int columnIndex) 检索此ResultSet对象当前行中指定列的值,作为 Java 编程语言中的byte数组。byte[]检索此ResultSet对象当前行中指定列的值,作为 Java 编程语言中的byte数组。getCharacterStream(int columnIndex) 检索此ResultSet对象的当前行中指定列的值作为java.io.Reader对象。getCharacterStream(String columnLabel) 检索此ResultSet对象的当前行中指定列的值作为java.io.Reader对象。getClob(int columnIndex) 检索此ResultSet对象当前行中指定列的值作为 Java 编程语言中的Clob对象。检索此ResultSet对象当前行中指定列的值作为 Java 编程语言中的Clob对象。int检索此ResultSet对象的并发模式。检索此ResultSet对象使用的 SQL 游标的名称。getDate(int columnIndex) 检索此ResultSet对象当前行中指定列的值作为 Java 编程语言中的java.sql.Date对象。检索此ResultSet对象当前行中指定列的值作为 Java 编程语言中的java.sql.Date对象。检索此ResultSet对象当前行中指定列的值作为 Java 编程语言中的java.sql.Date对象。检索此ResultSet对象当前行中指定列的值作为 Java 编程语言中的java.sql.Date对象。doublegetDouble(int columnIndex) 检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的double。double检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的double。int检索此ResultSet对象的提取方向。int检索此ResultSet对象的提取大小。floatgetFloat(int columnIndex) 检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的float。float检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的float。int检索此ResultSet对象的可持有性intgetInt(int columnIndex) 检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的int。int检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的int。longgetLong(int columnIndex) 检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的long。long检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的long。检索此ResultSet对象的列的数量、类型和属性。getNCharacterStream(int columnIndex) 检索此ResultSet对象的当前行中指定列的值作为java.io.Reader对象。getNCharacterStream(String columnLabel) 检索此ResultSet对象的当前行中指定列的值作为java.io.Reader对象。getNClob(int columnIndex) 检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的NClob对象。检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的NClob对象。getNString(int columnIndex) 检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的String。getNString(String columnLabel) 检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的String。getObject(int columnIndex) 获取此ResultSet对象当前行中指定列的值,作为 Java 编程语言中的Object。<T> T检索此ResultSet对象的当前行中指定列的值,如果支持转换,则将该列的 SQL 类型转换为请求的 Java 数据类型。检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的Object。获取此ResultSet对象当前行中指定列的值,作为 Java 编程语言中的Object。<T> T检索此ResultSet对象的当前行中指定列的值,如果支持转换,则将该列的 SQL 类型转换为请求的 Java 数据类型。检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的Object。getRef(int columnIndex) 检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的Ref对象。检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的Ref对象。intgetRow()检索当前行号。getRowId(int columnIndex) 检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.sql.RowId对象。检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.sql.RowId对象。shortgetShort(int columnIndex) 检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的short。short检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的short。getSQLXML(int columnIndex) 检索此ResultSet当前行中指定列的值作为 Java 编程语言中的java.sql.SQLXML对象。检索此ResultSet当前行中指定列的值作为 Java 编程语言中的java.sql.SQLXML对象。检索生成此ResultSet对象的Statement对象。getString(int columnIndex) 检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的String。检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的String。getTime(int columnIndex) 检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.sql.Time对象。检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.sql.Time对象。检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.sql.Time对象。检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.sql.Time对象。getTimestamp(int columnIndex) 检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.sql.Timestamp对象。getTimestamp(int columnIndex, Calendar cal) 检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.sql.Timestamp对象。getTimestamp(String columnLabel) 检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.sql.Timestamp对象。getTimestamp(String columnLabel, Calendar cal) 检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.sql.Timestamp对象。intgetType()检索此ResultSet对象的类型。getUnicodeStream(int columnIndex) 已弃用。使用getCharacterStream代替getUnicodeStreamgetUnicodeStream(String columnLabel) 已弃用。使用getCharacterStream代替getURL(int columnIndex) 检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.net.URL对象。检索此ResultSet对象的当前行中指定列的值作为 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) 当此ResultSet对象需要更多行时,向 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) 使用byte数组值更新指定列。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值。在接口 java.sql.Wrapper 中声明的方法
isWrapperFor, unwrap
-
字段详细信息
-
FETCH_FORWARD
static final int FETCH_FORWARD指示结果集中的行将按正向处理的常量;从头到尾。方法setFetchDirection使用此常量作为对驱动程序的提示,驱动程序可能会忽略它。- 自从:
- 1.2
- 参见:
-
FETCH_REVERSE
static final int FETCH_REVERSE指示结果集中的行将按相反方向处理的常量;倒数第一。方法setFetchDirection使用此常量作为对驱动程序的提示,驱动程序可能会忽略它。- 自从:
- 1.2
- 参见:
-
FETCH_UNKNOWN
static final int FETCH_UNKNOWN指示处理结果集中行的顺序的常量是未知的。方法setFetchDirection使用此常量作为对驱动程序的提示,驱动程序可能会忽略它。- 参见:
-
TYPE_FORWARD_ONLY
static final int TYPE_FORWARD_ONLY指示ResultSet对象类型的常量,其光标只能向前移动。- 自从:
- 1.2
- 参见:
-
TYPE_SCROLL_INSENSITIVE
static final int TYPE_SCROLL_INSENSITIVE指示ResultSet对象类型的常量,该对象可滚动但通常对ResultSet基础数据的更改不敏感。- 自从:
- 1.2
- 参见:
-
TYPE_SCROLL_SENSITIVE
static final int TYPE_SCROLL_SENSITIVE指示ResultSet对象类型的常量,该对象可滚动并且通常对ResultSet基础数据的更改敏感。- 自从:
- 1.2
- 参见:
-
CONCUR_READ_ONLY
static final int CONCUR_READ_ONLY指示ResultSet对象的并发模式的常量可能不会被更新。- 自从:
- 1.2
- 参见:
-
CONCUR_UPDATABLE
static final int CONCUR_UPDATABLE指示可更新的ResultSet对象的并发模式的常量。- 自从:
- 1.2
- 参见:
-
HOLD_CURSORS_OVER_COMMIT
static final int HOLD_CURSORS_OVER_COMMIT该常量指示具有此可持有性的打开的ResultSet对象在提交当前事务时将保持打开状态。- 自从:
- 1.4
- 参见:
-
CLOSE_CURSORS_AT_COMMIT
static final int CLOSE_CURSORS_AT_COMMIT该常量指示具有此可持有性的打开的ResultSet对象将在提交当前事务时关闭。- 自从:
- 1.4
- 参见:
-
-
方法详情
-
next
将光标从当前位置向前移动一行。ResultSet游标最初位于第一行之前;第一次调用方法next使第一行成为当前行;第二次调用使第二行成为当前行,依此类推。当对
next方法的调用返回false时,游标位于最后一行之后。任何需要当前行的ResultSet方法调用都将导致抛出SQLException。如果结果集类型是TYPE_FORWARD_ONLY,则由供应商指定他们的 JDBC 驱动程序实现是返回false还是在后续调用next时抛出SQLException。如果当前行的输入流打开,则调用方法
next将隐式关闭它。ResultSet对象的警告链在读取新行时被清除。- 返回:
true如果新的当前行有效;false如果没有更多的行- 抛出:
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
close
立即释放此ResultSet对象的数据库和 JDBC 资源,而不是等待它自动关闭时发生这种情况。ResultSet对象的关闭会not 关闭由ResultSet创建的Blob、Clob或NClob对象。Blob、Clob或NClob对象至少在创建它们的事务期间保持有效,除非调用它们的free方法。当
ResultSet关闭时,通过调用getMetaData方法创建的任何ResultSetMetaData实例仍然可以访问。笔记:当
Statement对象关闭、重新执行或用于从多个结果序列中检索下一个结果时,生成它的Statement对象会自动关闭ResultSet对象。在已关闭的
ResultSet对象上调用方法close是空操作。- 指定者:
close在接口AutoCloseable中- 抛出:
SQLException- 如果发生数据库访问错误
-
wasNull
报告读取的最后一列是否具有 SQLNULL值。请注意,您必须首先调用列上的一种 getter 方法来尝试读取其值,然后调用方法wasNull以查看读取的值是否为 SQLNULL。- 返回:
true如果最后读取的列值是 SQLNULL和false否则- 抛出:
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getString
检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的String。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
列值;如果值为 SQL
NULL,则返回值为null - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getBoolean
检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的boolean。如果指定列的数据类型为 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
检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的byte。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
列值;如果值为 SQL
NULL,则返回值为0 - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getShort
检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的short。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
列值;如果值为 SQL
NULL,则返回值为0 - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getInt
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的int。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
列值;如果值为 SQL
NULL,则返回值为0 - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getLong
检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的long。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
列值;如果值为 SQL
NULL,则返回值为0 - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getFloat
检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的float。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
列值;如果值为 SQL
NULL,则返回值为0 - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getDouble
检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的double。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
列值;如果值为 SQL
NULL,则返回值为0 - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getBigDecimal
已弃用。使用getBigDecimal(int columnIndex)或getBigDecimal(String columnLabel)检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的java.sql.BigDecimal。- 参数:
columnIndex- 第一列是 1,第二列是 2,...scale- 小数点右边的位数- 返回:
-
列值;如果值为 SQL
NULL,则返回值为null - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法
-
getBytes
检索此ResultSet对象当前行中指定列的值,作为 Java 编程语言中的byte数组。字节表示驱动程序返回的原始值。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
列值;如果值为 SQL
NULL,则返回值为null - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getDate
检索此ResultSet对象当前行中指定列的值作为 Java 编程语言中的java.sql.Date对象。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
列值;如果值为 SQL
NULL,则返回值为null - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getTime
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.sql.Time对象。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
列值;如果值为 SQL
NULL,则返回值为null - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getTimestamp
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.sql.Timestamp对象。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
列值;如果值为 SQL
NULL,则返回值为null - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getAsciiStream
检索此ResultSet对象当前行中指定列的值作为 ASCII 字符流。然后可以从流中分块读取该值。此方法特别适用于检索较大的LONGVARCHAR值。 JDBC 驱动程序将执行从数据库格式到 ASCII 的任何必要转换。笔记:在获取任何其他列的值之前,必须读取返回流中的所有数据。对 getter 方法的下一次调用隐式关闭流。此外,当调用方法
InputStream.available时,无论是否有可用数据,流都可能返回0。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
一个 Java 输入流,它以单字节 ASCII 字符流的形式传递数据库列值;如果值为 SQL
NULL,则返回值为null - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getUnicodeStream
已弃用。使用getCharacterStream代替getUnicodeStream检索此ResultSet对象当前行中指定列的值,作为两字节 3 个字符的流。第一个字节为高字节;第二个字节是低字节。然后可以从流中分块读取该值。此方法特别适用于检索较大的LONGVARCHAR值。 JDBC 驱动程序将执行从数据库格式到 Unicode 的任何必要转换。笔记:在获取任何其他列的值之前,必须读取返回流中的所有数据。对 getter 方法的下一次调用隐式关闭流。此外,当调用方法
InputStream.available时,无论是否有数据可用,流都可能返回0。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
Java 输入流,将数据库列值作为两字节 Unicode 字符流传递;如果值为 SQL
NULL,则返回值为null - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法
-
getBinaryStream
检索此ResultSet对象当前行中指定列的值作为未解释字节流。然后可以从流中分块读取该值。此方法特别适用于检索较大的LONGVARBINARY值。笔记:在获取任何其他列的值之前,必须读取返回流中的所有数据。对 getter 方法的下一次调用隐式关闭流。此外,当调用方法
InputStream.available时,无论是否有可用数据,流都可能返回0。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
一个 Java 输入流,它将数据库列值作为未解释的字节流传递;如果值为 SQL
NULL,则返回值为null - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getString
检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的String。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
列值;如果值为 SQL
NULL,则返回值为null - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getBoolean
检索此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
检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的byte。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
列值;如果值为 SQL
NULL,则返回值为0 - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getShort
检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的short。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
列值;如果值为 SQL
NULL,则返回值为0 - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getInt
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的int。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
列值;如果值为 SQL
NULL,则返回值为0 - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getLong
检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的long。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
列值;如果值为 SQL
NULL,则返回值为0 - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getFloat
检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的float。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
列值;如果值为 SQL
NULL,则返回值为0 - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getDouble
检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的double。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
列值;如果值为 SQL
NULL,则返回值为0 - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getBigDecimal
已弃用。使用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
检索此ResultSet对象当前行中指定列的值,作为 Java 编程语言中的byte数组。字节表示驱动程序返回的原始值。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
列值;如果值为 SQL
NULL,则返回值为null - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getDate
检索此ResultSet对象当前行中指定列的值作为 Java 编程语言中的java.sql.Date对象。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
列值;如果值为 SQL
NULL,则返回值为null - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getTime
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.sql.Time对象。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
列值;如果值为 SQL
NULL,则返回值为null - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getTimestamp
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.sql.Timestamp对象。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
列值;如果值为 SQL
NULL,则返回值为null - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getAsciiStream
检索此ResultSet对象当前行中指定列的值作为 ASCII 字符流。然后可以从流中分块读取该值。此方法特别适用于检索较大的LONGVARCHAR值。 JDBC 驱动程序将执行从数据库格式到 ASCII 的任何必要转换。笔记:在获取任何其他列的值之前,必须读取返回流中的所有数据。对 getter 方法的下一次调用隐式关闭流。此外,当调用方法
available时,无论是否有可用数据,流都可能返回0。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
将数据库列值作为单字节 ASCII 字符流传递的 Java 输入流。如果值为 SQL
NULL,则返回值为null。 - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
-
getUnicodeStream
已弃用。使用getCharacterStream代替检索此ResultSet对象当前行中指定列的值作为两字节 Unicode 字符流。第一个字节为高字节;第二个字节是低字节。然后可以从流中分块读取该值。此方法特别适用于检索较大的LONGVARCHAR值。启用 JDBC 技术的驱动程序将执行从数据库格式到 Unicode 的任何必要转换。笔记:在获取任何其他列的值之前,必须读取返回流中的所有数据。对 getter 方法的下一次调用隐式关闭流。此外,当调用方法
InputStream.available时,无论是否有数据可用,流都可能返回0。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
一个 Java 输入流,它将数据库列值作为两字节 Unicode 字符流传递。如果值为 SQL
NULL,则返回值为null。 - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法
-
getBinaryStream
检索此ResultSet对象的当前行中指定列的值作为未解释的bytes 的流。然后可以从流中分块读取该值。此方法特别适用于检索较大的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
获取此
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
获取此
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
将给定的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
以全精度检索此ResultSet对象当前行中指定列的值作为java.math.BigDecimal。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
列值(全精度);如果值为 SQL
NULL,则返回值为 Java 编程语言中的null。 - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法- 自从:
- 1.2
-
getBigDecimal
以全精度检索此ResultSet对象当前行中指定列的值作为java.math.BigDecimal。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
列值(全精度);如果值为 SQL
NULL,则返回值为 Java 编程语言中的null。 - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法- 自从:
- 1.2
-
isBeforeFirst
检索光标是否在此ResultSet对象的第一行之前。Note: 对
isBeforeFirst方法的支持对于结果集类型为TYPE_FORWARD_ONLY的ResultSet是可选的- 返回:
true如果光标在第一行之前;false如果游标在任何其他位置或结果集不包含任何行- 抛出:
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
isAfterLast
检索光标是否在此ResultSet对象的最后一行之后。Note: 对
isAfterLast方法的支持对于结果集类型为TYPE_FORWARD_ONLY的ResultSet是可选的- 返回:
true如果光标在最后一行之后;false如果游标在任何其他位置或结果集不包含任何行- 抛出:
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
isFirst
检索光标是否位于此ResultSet对象的第一行。Note: 对
isFirst方法的支持对于结果集类型为TYPE_FORWARD_ONLY的ResultSet是可选的- 返回:
true如果光标在第一行;false否则- 抛出:
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
isLast
检索光标是否位于此ResultSet对象的最后一行。 Note: 调用方法isLast可能开销很大,因为 JDBC 驱动程序可能需要提前获取一行以确定当前行是否是结果集中的最后一行。Note: 对
isLast方法的支持对于结果集类型为TYPE_FORWARD_ONLY的ResultSet是可选的- 返回:
true如果光标在最后一行;false否则- 抛出:
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
beforeFirst
将光标移动到此ResultSet对象的前面,就在第一行之前。如果结果集不包含任何行,则此方法无效。- 抛出:
SQLException- 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLYSQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
afterLast
将光标移动到此ResultSet对象的末尾,就在最后一行之后。如果结果集不包含任何行,则此方法无效。- 抛出:
SQLException- 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLYSQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
first
将光标移动到此ResultSet对象的第一行。- 返回:
true如果游标在有效行上;false如果结果集中没有行- 抛出:
SQLException- 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLYSQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
last
将光标移动到此ResultSet对象的最后一行。- 返回:
true如果游标在有效行上;false如果结果集中没有行- 抛出:
SQLException- 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLYSQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
getRow
检索当前行号。第一行是数字 1,第二行是数字 2,依此类推。Note: 对
getRow方法的支持对于结果集类型为TYPE_FORWARD_ONLY的ResultSet是可选的- 返回:
-
当前行号;
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_ONLYSQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
relative
将光标移动相对行数,正数或负数。尝试移动到结果集中的第一行/最后一行之外时,会将游标定位在第一行/最后一行之前/之后。调用relative(0)有效,但不会更改光标位置。注意:调用方法
relative(1)与调用方法next()相同,调用方法relative(-1)与调用方法previous()相同。- 参数:
rows- 一个int指定要从当前行移动的行数;正数使光标向前移动;负数向后移动光标- 返回:
true如果光标在一行上;false否则- 抛出:
SQLException- 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLYSQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
previous
将光标移动到此ResultSet对象的上一行。当对
previous方法的调用返回false时,游标位于第一行之前。任何需要当前行的ResultSet方法调用都将导致抛出SQLException。如果当前行的输入流是打开的,则调用方法
previous将隐式关闭它。ResultSet对象的警告更改在读取新行时被清除。- 返回:
true如果游标现在位于有效行上;false如果游标位于第一行之前- 抛出:
SQLException- 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLYSQLFeatureNotSupportedException- 如果 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
当此ResultSet对象需要更多行时,向 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
检索当前行是否已更新。返回的值取决于结果集是否可以检测到更新。Note: 对
rowUpdated方法的支持是可选的,结果集并发性为CONCUR_READ_ONLY- 返回:
true如果检测到当前行已被所有者或其他人明显更新;false否则- 抛出:
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
- 参见:
-
rowInserted
检索当前行是否有插入。返回值取决于此ResultSet对象是否可以检测到可见插入。Note: 对
rowInserted方法的支持是可选的,结果集并发性为CONCUR_READ_ONLY- 返回:
true如果检测到当前行已被插入;false否则- 抛出:
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
- 参见:
-
rowDeleted
检索一行是否已被删除。删除的行可能会在结果集中留下可见的“漏洞”。此方法可用于检测结果集中的漏洞。返回的值取决于此ResultSet对象是否可以检测到删除。Note: 对
rowDeleted方法的支持是可选的,结果集并发性为CONCUR_READ_ONLY- 返回:
true如果检测到当前行已被所有者或其他人删除;false否则- 抛出:
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
- 参见:
-
updateNull
使用null值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateBoolean
使用boolean值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateByte
使用byte值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateShort
使用short值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateInt
使用int值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateLong
使用long值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateFloat
使用float值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateDouble
使用double值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateBigDecimal
使用java.math.BigDecimal值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateString
使用String值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateBytes
使用byte数组值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateDate
使用java.sql.Date值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateTime
使用java.sql.Time值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateTimestamp
使用java.sql.Timestamp值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateAsciiStream
使用具有指定字节数的 ascii 流值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值length- 流的长度- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateBinaryStream
使用二进制流值更新指定的列,该值将具有指定的字节数。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值length- 流的长度- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateCharacterStream
使用具有指定字节数的字符流值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值length- 流的长度- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateObject
使用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
使用Object值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateNull
使用null值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateBoolean
使用boolean值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateByte
使用byte值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateShort
使用short值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateInt
使用int值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateLong
使用long值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateFloat
使用float值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateDouble
使用double值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateBigDecimal
使用java.sql.BigDecimal值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateString
使用String值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateBytes
使用字节数组值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateDate
使用java.sql.Date值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateTime
使用java.sql.Time值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateTimestamp
使用java.sql.Timestamp值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateAsciiStream
使用具有指定字节数的 ascii 流值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值length- 流的长度- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateBinaryStream
使用二进制流值更新指定的列,该值将具有指定的字节数。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值length- 流的长度- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateCharacterStream
使用具有指定字节数的字符流值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称reader- 包含新列值的java.io.Reader对象length- 流的长度- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateObject
使用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
使用Object值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
insertRow
将插入行的内容插入到此ResultSet对象和数据库中。调用此方法时,光标必须在插入行上。- 抛出:
SQLException- 如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY,如果在游标不在插入行上时调用此方法,或者插入行中并非所有不可为空的列都没有被赋予非-空值SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
updateRow
使用此ResultSet对象的当前行的新内容更新基础数据库。当光标在插入行上时不能调用此方法。- 抛出:
SQLException- 如果发生数据库访问错误;结果集并发度为CONCUR_READ_ONLY;在关闭的结果集上调用此方法,或者当游标位于插入行上时调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
deleteRow
从此ResultSet对象和基础数据库中删除当前行。当光标在插入行上时不能调用此方法。- 抛出:
SQLException- 如果发生数据库访问错误;结果集并发度为CONCUR_READ_ONLY;在关闭的结果集上调用此方法,或者当游标位于插入行上时调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
refreshRow
用数据库中的最新值刷新当前行。当光标在插入行上时不能调用此方法。refreshRow方法为应用程序提供了一种显式告诉 JDBC 驱动程序从数据库中重新获取行的方法。应用程序可能希望在 JDBC 驱动程序进行缓存或预取时调用refreshRow以从数据库中获取行的最新值。如果提取大小大于一,JDBC 驱动程序实际上可能一次刷新多行。根据事务隔离级别和游标敏感性重新获取所有值。如果
refreshRow在调用更新程序方法之后但在调用方法updateRow之前被调用,则对该行所做的更新将丢失。频繁调用方法refreshRow可能会降低性能。- 抛出:
SQLException- 如果发生数据库访问错误;在封闭的结果集上调用此方法;结果集类型为TYPE_FORWARD_ONLY或者当光标位于插入行时调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法或指定的结果集类型和结果集并发不支持此方法。- 自从:
- 1.2
-
cancelRowUpdates
取消对此ResultSet对象中的当前行所做的更新。可以在调用更新程序方法之后和调用方法updateRow回滚对行所做的更新之前调用此方法。如果未进行任何更新或已调用updateRow,则此方法无效。- 抛出:
SQLException- 如果发生数据库访问错误;在封闭的结果集上调用此方法;结果集并发度为CONCUR_READ_ONLY或者当游标在插入行上时调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
moveToInsertRow
将光标移动到插入行。当光标位于插入行上时,会记住当前光标位置。插入行是与可更新结果集关联的特殊行。它本质上是一个缓冲区,在将行插入结果集中之前,可以通过调用更新程序方法来构造新行。当光标位于插入行上时,只能调用 updater、getter 和insertRow方法。每次在调用insertRow之前调用此方法时,结果集中的所有列都必须赋值。在对列值调用 getter 方法之前,必须先调用 updater 方法。- 抛出:
SQLException- 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集并发性为CONCUR_READ_ONLYSQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
moveToCurrentRow
将光标移动到记住的光标位置,通常是当前行。如果光标不在插入行上,则此方法无效。- 抛出:
SQLException- 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集并发性为CONCUR_READ_ONLYSQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
getStatement
检索生成此ResultSet对象的Statement对象。如果结果集是通过其他方式生成的,例如通过DatabaseMetaData方法,则此方法可能返回null。- 返回:
-
生成此
ResultSet对象的Statement对象或null(如果结果集是通过其他方式生成的) - 抛出:
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法- 自从:
- 1.2
-
getObject
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的Object。如果该值为 SQLNULL,则驱动程序返回 Javanull。此方法将给定的Map对象用于正在检索的 SQL 结构化或不同类型的自定义映射。- 参数:
columnIndex- 第一列是 1,第二列是 2,...map- 一个java.util.Map对象,它包含从 SQL 类型名称到 Java 编程语言中的类的映射- 返回:
-
Java 编程语言中表示 SQL 值的
Object - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
getRef
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的Ref对象。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
代表 SQL
REF值的Ref对象 - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
getBlob
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的Blob对象。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
代表指定列中 SQL
BLOB值的Blob对象 - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
getClob
检索此ResultSet对象当前行中指定列的值作为 Java 编程语言中的Clob对象。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
代表指定列中 SQL
CLOB值的Clob对象 - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
getArray
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的Array对象。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
代表指定列中 SQL
ARRAY值的Array对象 - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
getObject
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的Object。如果该值为 SQLNULL,则驱动程序返回 Javanull。如果合适,此方法使用指定的Map对象进行自定义映射。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称map- 一个java.util.Map对象,它包含从 SQL 类型名称到 Java 编程语言中的类的映射- 返回:
-
一个
Object表示指定列中的 SQL 值 - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
getRef
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的Ref对象。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
代表指定列中 SQL
REF值的Ref对象 - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
getBlob
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的Blob对象。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
代表指定列中 SQL
BLOB值的Blob对象 - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
getClob
检索此ResultSet对象当前行中指定列的值作为 Java 编程语言中的Clob对象。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
代表指定列中 SQL
CLOB值的Clob对象 - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
getArray
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的Array对象。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
代表指定列中 SQL
ARRAY值的Array对象 - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
getDate
检索此ResultSet对象当前行中指定列的值作为 Java 编程语言中的java.sql.Date对象。如果基础数据库不存储时区信息,此方法使用给定的日历为日期构造适当的毫秒值。- 参数:
columnIndex- 第一列是 1,第二列是 2,...cal- 用于构造日期的java.util.Calendar对象- 返回:
-
作为
java.sql.Date对象的列值;如果值为 SQLNULL,则返回值为 Java 编程语言中的null - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法- 自从:
- 1.2
-
getDate
检索此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
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.sql.Time对象。如果底层数据库不存储时区信息,此方法使用给定的日历为时间构造适当的毫秒值。- 参数:
columnIndex- 第一列是 1,第二列是 2,...cal- 用于构建时间的java.util.Calendar对象- 返回:
-
作为
java.sql.Time对象的列值;如果值为 SQLNULL,则返回值为 Java 编程语言中的null - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法- 自从:
- 1.2
-
getTime
检索此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
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.sql.Timestamp对象。如果底层数据库不存储时区信息,此方法使用给定的日历为时间戳构造适当的毫秒值。- 参数:
columnIndex- 第一列是 1,第二列是 2,...cal- 用于构造时间戳的java.util.Calendar对象- 返回:
-
作为
java.sql.Timestamp对象的列值;如果值为 SQLNULL,则返回值为 Java 编程语言中的null - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法- 自从:
- 1.2
-
getTimestamp
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.sql.Timestamp对象。如果底层数据库不存储时区信息,此方法使用给定的日历为时间戳构造适当的毫秒值。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称cal- 用于构造日期的java.util.Calendar对象- 返回:
-
作为
java.sql.Timestamp对象的列值;如果值为 SQLNULL,则返回值为 Java 编程语言中的null - 抛出:
SQLException- 如果 columnLabel 无效或发生数据库访问错误或在关闭的结果集上调用此方法- 自从:
- 1.2
-
getURL
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.net.URL对象。- 参数:
columnIndex- 列 1 的索引是第一个,2 是第二个,...- 返回:
-
作为
java.net.URL对象的列值;如果值为 SQLNULL,则返回值为 Java 编程语言中的null - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;在封闭的结果集上或 URL 格式错误时调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
-
getURL
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.net.URL对象。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
作为
java.net.URL对象的列值;如果值为 SQLNULL,则返回值为 Java 编程语言中的null - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;在封闭的结果集上或 URL 格式错误时调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
-
updateRef
使用java.sql.Ref值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
-
updateRef
使用java.sql.Ref值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
-
updateBlob
使用java.sql.Blob值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
-
updateBlob
使用java.sql.Blob值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
-
updateClob
使用java.sql.Clob值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
-
updateClob
使用java.sql.Clob值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
-
updateArray
使用java.sql.Array值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
-
updateArray
使用java.sql.Array值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
-
getRowId
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.sql.RowId对象。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
列值;如果该值为 SQL
NULL,则返回的值为null - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
getRowId
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的java.sql.RowId对象。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
列值;如果该值为 SQL
NULL,则返回的值为null - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateRowId
使用RowId值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateRowId
使用RowId值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
getHoldability
检索此ResultSet对象的可持有性- 返回:
ResultSet.HOLD_CURSORS_OVER_COMMIT或ResultSet.CLOSE_CURSORS_AT_COMMIT- 抛出:
SQLException- 如果发生数据库访问错误或在关闭的结果集上调用此方法- 自从:
- 1.6
-
isClosed
检索此ResultSet对象是否已关闭。如果ResultSet已调用 close 方法,或者自动关闭,则ResultSet将关闭。- 返回:
-
如果此
ResultSet对象已关闭,则为真;如果它仍然打开则为 false - 抛出:
SQLException- 如果发生数据库访问错误- 自从:
- 1.6
-
updateNString
使用String值更新指定列。它旨在用于更新NCHAR、NVARCHAR和LONGNVARCHAR列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...nString- 要更新的列的值- 抛出:
SQLException- 如果 columnIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在封闭的结果集上调用此方法;结果集并发度为CONCUR_READ_ONLY或者发生数据库访问错误SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateNString
使用String值更新指定列。它旨在用于更新NCHAR、NVARCHAR和LONGNVARCHAR列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称nString- 要更新的列的值- 抛出:
SQLException- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在封闭的结果集上调用此方法;结果集并发度为CONCUR_READ_ONLY或者发生数据库访问错误SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateNClob
使用java.sql.NClob值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...nClob- 要更新的列的值- 抛出:
SQLException- 如果 columnIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在封闭的结果集上调用此方法;如果出现数据库访问错误或者结果集并发为CONCUR_READ_ONLYSQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateNClob
使用java.sql.NClob值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称nClob- 要更新的列的值- 抛出:
SQLException- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在封闭的结果集上调用此方法;如果出现数据库访问错误或者结果集并发为CONCUR_READ_ONLYSQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
getNClob
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的NClob对象。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
代表指定列中 SQL
NCLOB值的NClob对象 - 抛出:
SQLException- 如果 columnIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭的结果集上或发生数据库访问错误时调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
getNClob
检索此ResultSet对象的当前行中指定列的值作为 Java 编程语言中的NClob对象。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
代表指定列中 SQL
NCLOB值的NClob对象 - 抛出:
SQLException- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭的结果集上或发生数据库访问错误时调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
getSQLXML
检索此ResultSet当前行中指定列的值作为 Java 编程语言中的java.sql.SQLXML对象。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
映射
SQL XML值的SQLXML对象 - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
getSQLXML
检索此ResultSet当前行中指定列的值作为 Java 编程语言中的java.sql.SQLXML对象。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
映射
SQL XML值的SQLXML对象 - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateSQLXML
使用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
使用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
检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的String。它旨在用于访问NCHAR、NVARCHAR和LONGNVARCHAR列时使用。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
列值;如果值为 SQL
NULL,则返回值为null - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
getNString
检索此ResultSet对象的当前行中指定列的值,作为 Java 编程语言中的String。它旨在用于访问NCHAR、NVARCHAR和LONGNVARCHAR列时使用。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
列值;如果值为 SQL
NULL,则返回值为null - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
getNCharacterStream
检索此ResultSet对象的当前行中指定列的值作为java.io.Reader对象。它旨在用于访问NCHAR、NVARCHAR和LONGNVARCHAR列时使用。- 参数:
columnIndex- 第一列是 1,第二列是 2,...- 返回:
-
包含列值的
java.io.Reader对象;如果值为 SQLNULL,则返回值为 Java 编程语言中的null。 - 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
getNCharacterStream
检索此ResultSet对象的当前行中指定列的值作为java.io.Reader对象。它旨在用于访问NCHAR、NVARCHAR和LONGNVARCHAR列时使用。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称- 返回:
-
包含列值的
java.io.Reader对象;如果值为 SQLNULL,则返回值为 Java 编程语言中的null - 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateNCharacterStream
使用具有指定字节数的字符流值更新指定列。驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。它旨在用于更新NCHAR、NVARCHAR和LONGNVARCHAR列。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值length- 流的长度- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateNCharacterStream
使用具有指定字节数的字符流值更新指定列。驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。它旨在用于更新NCHAR、NVARCHAR和LONGNVARCHAR列。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称reader- 包含新列值的java.io.Reader对象length- 流的长度- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateAsciiStream
使用具有指定字节数的 ascii 流值更新指定列。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值length- 流的长度- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateBinaryStream
使用二进制流值更新指定的列,该值将具有指定的字节数。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值length- 流的长度- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateCharacterStream
使用具有指定字节数的字符流值更新指定列。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值length- 流的长度- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateAsciiStream
使用具有指定字节数的 ascii 流值更新指定列。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值length- 流的长度- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateBinaryStream
使用二进制流值更新指定的列,该值将具有指定的字节数。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值length- 流的长度- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateCharacterStream
使用具有指定字节数的字符流值更新指定列。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称reader- 包含新列值的java.io.Reader对象length- 流的长度- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateBlob
使用给定的输入流更新指定的列,该列将具有指定的字节数。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
columnIndex- 第一列是 1,第二列是 2,...inputStream- 包含要将参数值设置到的数据的对象。length- 参数数据中的字节数。- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateBlob
使用给定的输入流更新指定的列,该列将具有指定的字节数。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
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 到数据库字符格式的任何必要转换。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
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 到数据库字符格式的任何必要转换。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
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 到数据库字符格式的任何必要转换。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
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 到数据库字符格式的任何必要转换。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称reader- 包含要将参数值设置到的数据的对象。length- 参数数据中的字符数。- 抛出:
SQLException- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在封闭的结果集上调用此方法;如果出现数据库访问错误或者结果集并发为CONCUR_READ_ONLYSQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateNCharacterStream
用字符流值更新指定的列。数据将根据需要从流中读取,直到到达流结尾。驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。它旨在用于更新NCHAR、NVARCHAR和LONGNVARCHAR列。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。笔记:请查阅您的 JDBC 驱动程序文档以确定使用带长度参数的
updateNCharacterStream版本是否更有效。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateNCharacterStream
用字符流值更新指定的列。数据将根据需要从流中读取,直到到达流结尾。驱动程序执行从 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
使用 ascii 流值更新指定列。数据将根据需要从流中读取,直到到达流结尾。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。笔记:请查阅您的 JDBC 驱动程序文档,以确定使用带长度参数的
updateAsciiStream版本是否更有效。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateBinaryStream
使用二进制流值更新指定列。数据将根据需要从流中读取,直到到达流结尾。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。笔记:请查阅您的 JDBC 驱动程序文档以确定使用带长度参数的
updateBinaryStream版本是否更有效。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateCharacterStream
用字符流值更新指定的列。数据将根据需要从流中读取,直到到达流结尾。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。笔记:请查阅您的 JDBC 驱动程序文档以确定使用带长度参数的
updateCharacterStream版本是否更有效。- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateAsciiStream
使用 ascii 流值更新指定列。数据将根据需要从流中读取,直到到达流结尾。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。笔记:请查阅您的 JDBC 驱动程序文档,以确定使用带长度参数的
updateAsciiStream版本是否更有效。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateBinaryStream
使用二进制流值更新指定列。数据将根据需要从流中读取,直到到达流结尾。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。笔记:请查阅您的 JDBC 驱动程序文档以确定使用带长度参数的
updateBinaryStream版本是否更有效。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称x- 新列值- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateCharacterStream
用字符流值更新指定的列。数据将根据需要从流中读取,直到到达流结尾。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。笔记:请查阅您的 JDBC 驱动程序文档以确定使用带长度参数的
updateCharacterStream版本是否更有效。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称reader- 包含新列值的java.io.Reader对象- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateBlob
使用给定的输入流更新指定的列。数据将根据需要从流中读取,直到到达流结尾。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。笔记:请查阅您的 JDBC 驱动程序文档以确定使用带长度参数的
updateBlob版本是否更有效。- 参数:
columnIndex- 第一列是 1,第二列是 2,...inputStream- 包含要将参数值设置到的数据的对象。- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateBlob
使用给定的输入流更新指定的列。数据将根据需要从流中读取,直到到达流结尾。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。笔记:请查阅您的 JDBC 驱动程序文档以确定使用带长度参数的
updateBlob版本是否更有效。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称inputStream- 包含要将参数值设置到的数据的对象。- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateClob
使用给定的Reader对象更新指定的列。数据将根据需要从流中读取,直到到达流结尾。 JDBC 驱动程序将执行从 UNICODE 到数据库字符格式的任何必要转换。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。笔记:请查阅您的 JDBC 驱动程序文档以确定使用带长度参数的
updateClob版本是否更有效。- 参数:
columnIndex- 第一列是 1,第二列是 2,...reader- 包含要将参数值设置到的数据的对象。- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateClob
使用给定的Reader对象更新指定的列。数据将根据需要从流中读取,直到到达流结尾。 JDBC 驱动程序将执行从 UNICODE 到数据库字符格式的任何必要转换。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。笔记:请查阅您的 JDBC 驱动程序文档以确定使用带长度参数的
updateClob版本是否更有效。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称reader- 包含要将参数值设置到的数据的对象。- 抛出:
SQLException- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateNClob
使用给定的Reader更新指定的列。数据将根据需要从流中读取,直到到达流末尾。 JDBC 驱动程序将执行从 UNICODE 到数据库字符格式的任何必要转换。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。笔记:请查阅您的 JDBC 驱动程序文档以确定使用带长度参数的
updateNClob版本是否更有效。- 参数:
columnIndex- 第一列是 1,第二列是 2,...reader- 包含要将参数值设置到的数据的对象。- 抛出:
SQLException- 如果 columnIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY,则在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
updateNClob
使用给定的Reader对象更新指定的列。数据将根据需要从流中读取,直到到达流结尾。 JDBC 驱动程序将执行从 UNICODE 到数据库字符格式的任何必要转换。updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用
updateRow或insertRow方法来更新数据库。笔记:请查阅您的 JDBC 驱动程序文档以确定使用带长度参数的
updateNClob版本是否更有效。- 参数:
columnLabel- 使用 SQL AS 子句指定的列的标签。如果未指定 SQL AS 子句,则标签是列的名称reader- 包含要将参数值设置到的数据的对象。- 抛出:
SQLException- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在封闭的结果集上调用此方法;如果出现数据库访问错误或者结果集并发为CONCUR_READ_ONLYSQLFeatureNotSupportedException- 如果 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- 如果不支持转换,则类型为空或发生其他错误。异常的 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- 如果不支持转换,则类型为空或发生其他错误。异常的 getCause() 方法可能会提供更详细的异常,例如,如果发生转换错误SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.7
-
updateObject
default void updateObject(int columnIndex, Object x, SQLType targetSqlType, int scaleOrLength) throws SQL异常 使用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
- 参见:
-
updateObject
default void updateObject(String columnLabel, Object x, SQLType targetSqlType, int scaleOrLength) throws SQL异常 使用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
- 参见:
-
updateObject
使用Object值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用updateRow或insertRow方法来更新数据库。默认实现会抛出
SQLFeatureNotSupportedException- 参数:
columnIndex- 第一列是 1,第二列是 2,...x- 新列值targetSqlType- 要发送到数据库的 SQL 类型- 抛出:
SQLException- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法;如果 JDBC 驱动不支持指定的 targetSqlType- 自从:
- 1.8
- 参见:
-
updateObject
使用Object值更新指定列。 updater 方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;而是调用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)