java.sql.ResultSetMetaData.getColumnLabel和getColumnName的区别。
getColumnName返回的是sql语句中field的原始名字。getColumnLabel是field的SQL AS的值。
比如:select a.name as name,a.description as description,b.description as relatedDescription from a,b where ...
此时,getColumnName(3) == "description";而getColumnLabel(3) == "relatedDescription"。
如果你想将ResultSet的结果映射到HashMap中,注意一定使用getColumnLabel,而不要用getColumnName。
java.sql.ResultSetMetaData.getColumnLabel和getColumnName的区别。
PreparedStatement ps = null;
ResultSet rs=null;
ResultSetMetaData rms=null;
ps = conn.prepareStatement(sql);
rs=ps.executeQuery();//rs相当于一个表的视图结构
rms=rs.getMetaData();//有关整个数据库的信息:表名、表的索引、数据库产品的名称和版本、数据库支持的操作
DbUtil.getStringValue(rs.getObject(rms.getColumnLabel(i)), rms.getColumnType(i))
rs.getObject(int i or String cloumName);获取i列或列名是cloumName的数据
rms.getColumnLabel(i); //获取i行的字面量(columName)
rms.getColumnType(i) //获取字面量类型
GetMetaData()方法返回一个ResultSetMetaData类的对象,使用该类的方法,得到许多关于结果集的信息,下面给出几个常用的方法:
(1) getColumnCount()返回一个int值,指出结果集中的列数。
(2) getTableName(int column)返回一个字符串,指出参数中所代表列的表的名称。
(3) getColumnLabel(int column)返回一个String对象,该对象是column所指的列的显示标题。
(4) getColumnName(int column)返回的是该列在数据库中的名称。可以把此方法返回的String对象作为Resultset类的getXXX()方法的参数。不过,并没有太大的实际意义。
(5) getColumnType(int comlumn)返回指定列的SQL数据类型。他的返回值是一个int值。在java.sql.Types类中有关于各种SQL数据类型的定义。
(6) getColumnTypeName(int comlumn)返回指定列的数据类型在数据源中的名称。他的返回值是一个String对象。
(7) isReadOnly(int column) 返回一个boolean值,指出该列是否是只读的。
(8) isWriteable(int column) 返回一个boolean值,指出该列是否可写。
(9) isNullable(int column)返回一个boolean值,指出该列是否允许存入一个NULL 值。
java.sql
接口
java.sql
接口 ResultSet
所有超级接口:
-
Wrapper
所有已知子接口:
-
CachedRowSet, FilteredRowSet, JdbcRowSet, JoinRowSet, RowSet, SyncResolver, WebRowSet
public interface ResultSet
extends Wrapper
表示数据库结果集的数据表,通常通过执行查询数据库的语句生成。
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 开始编号。为了获得最大的可移植性,应该按从左到右的顺序读取每行中的结果集列,每列只能读取一次。
对于获取方法,JDBC 驱动程序尝试将底层数据转换为在获取方法中指定的 Java 类型,并返回适当的 Java 值。JDBC 规范有一个表,显示允许的从 SQL 类型到ResultSet
获取方法所使用的 Java 类型的映射关系。
用作获取方法的输入的列名称不区分大小写。用列名称调用获取方法时,如果多个列具有这一名称,则返回第一个匹配列的值。在生成结果集的 SQL 查询中使用列名称时,将使用列名称选项。对于没有在查询中显式指定的列,最好使用列编号。如果使用列名称,则程序员应该注意保证名称唯一引用预期的列,这可以使用 SQLAS 子句确定。
在 JDBC 2.0 API(JavaTM 2 SDK 标准版 1.2 版)中,此接口添加了一组更新方法。关于获取方法参数的注释同样适用于更新方法的参数。
可以用以下两种方式使用更新方法:
- 更新当前行中的列值。在可滚动的
ResultSet
对象中,可以向前和向后移动光标,将其置于绝对位置或相对于当前行的位置。以下代码片段更新ResultSet
对象 rs
第五行中的 NAME
列,然后使用方法 updateRow
更新导出 rs
的数据源表。 rs.absolute(5); // moves the cursor to the fifth row of rs
rs.updateString("NAME", "AINSWORTH"); // updates the
// NAME
column of row 5 to be AINSWORTH
rs.updateRow(); // updates the row in the data source
- 将列值插入到插入行中。可更新的
ResultSet
对象具有一个与其关联的特殊行,该行用作构建要插入的行的暂存区域 (staging area)。以下代码片段将光标移动到插入行,构建一个三列的行,并使用方法insertRow
将其插入到 rs
和数据源表中。 rs.moveToInsertRow(); // moves cursor to the insert row
rs.updateString(1, "AINSWORTH"); // updates the
// first column of the insert row to be AINSWORTH
rs.updateInt(2,35); // updates the second column to be 35
rs.updateBoolean(3, true); // updates the third column to true
rs.insertRow();
rs.moveToCurrentRow();
当生成 ResultSet
对象的 Statement
对象关闭、重新执行或用来从多个结果的序列获取下一个结果时,ResultSet
对象将自动关闭。
ResultSet
对象的列的编号、类型和属性由 ResultSet.getMetaData
方法返回的ResulSetMetaData
对象提供。
另请参见:
-
Statement.executeQuery(java.lang.String), Statement.getResultSet(), ResultSetMetaData
字段摘要 static int
CLOSE_CURSORS_AT_COMMIT
该常量指示提交当前事务时,具有此可保存性的打开的 ResultSet
对象将被关闭。static int
CONCUR_READ_ONLY
该常量指示不可以更新的 ResultSet
对象的并发模式。static int
CONCUR_UPDATABLE
该常量指示可以更新的 ResultSet
对象的并发模式。static int
FETCH_FORWARD
该常量指示将按正向(即从第一个到最后一个)处理结果集中的行。static int
FETCH_REVERSE
该常量指示将按逆向(即从最后一个到第一个)处理结果集中的行处理。static int
FETCH_UNKNOWN
该常量指示结果集中的行的处理顺序未知。static int
HOLD_CURSORS_OVER_COMMIT
该常量指示提交当前事务时,具有此可保存性的打开的 ResultSet
对象将保持开放。static int
TYPE_FORWARD_ONLY
该常量指示光标只能向前移动的 ResultSet
对象的类型。static int
TYPE_SCROLL_INSENSITIVE
该常量指示可滚动但通常不受 ResultSet
底层数据更改影响的 ResultSet
对象的类型。static int
TYPE_SCROLL_SENSITIVE
该常量指示可滚动并且通常受 ResultSet
底层数据更改影响的 ResultSet
对象的类型。
方法摘要 boolean
absolute(int row)
将光标移动到此 ResultSet
对象的给定行编号。 void
afterLast()
将光标移动到此 ResultSet
对象的末尾,正好位于最后一行之后。 void
beforeFirst()
将光标移动到此 ResultSet
对象的开头,正好位于第一行之前。 void
cancelRowUpdates()
取消对 ResultSet
对象中的当前行所作的更新。 void
clearWarnings()
清除在此 ResultSet
对象上报告的所有警告。 void
close()
立即释放此 ResultSet
对象的数据库和 JDBC 资源,而不是等待该对象自动关闭时发生此操作。 void
deleteRow()
从此 ResultSet
对象和底层数据库中删除当前行。 int
findColumn(String columnLabel)
将给定的 ResultSet
列标签映射到其 ResultSet
列索引。 boolean
first()
将光标移动到此 ResultSet
对象的第一行。 Array
getArray(int columnIndex)
以 Java 编程语言中 Array
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 Array
getArray(String columnLabel)
以 Java 编程语言中 Array
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 InputStream
getAsciiStream(int columnIndex)
以 ASCII 字符流的形式获取此 ResultSet
对象的当前行中指定列的值。 InputStream
getAsciiStream(String columnLabel)
以 ASCII 字符流的形式获取此 ResultSet
对象的当前行中指定列的值。 BigDecimal
getBigDecimal(int columnIndex)
以具有全精度的 java.math.BigDecimal
的形式获取此 ResultSet
对象的当前行中指定列的值。 BigDecimal
getBigDecimal(int columnIndex, int scale)
已过时。 BigDecimal
getBigDecimal(String columnLabel)
以具有全精度的 java.math.BigDecimal
的形式获取此 ResultSet
对象的当前行中指定列的值。 BigDecimal
getBigDecimal(String columnLabel, int scale)
已过时。 InputStream
getBinaryStream(int columnIndex)
以未解释字节的流的形式获取此 ResultSet
对象的当前行中指定列的值。 InputStream
getBinaryStream(String columnLabel)
以未解释的 byte
流的形式获取此 ResultSet
对象的当前行中指定列的值。 Blob
getBlob(int columnIndex)
以 Java 编程语言中 Blob
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 Blob
getBlob(String columnLabel)
以 Java 编程语言中 Blob
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 boolean
getBoolean(int columnIndex)
以 Java 编程语言中 boolean
的形式获取此 ResultSet
对象的当前行中指定列的值。 boolean
getBoolean(String columnLabel)
以 Java 编程语言中 boolean
的形式获取此 ResultSet
对象的当前行中指定列的值。 byte
getByte(int columnIndex)
以 Java 编程语言中 byte
的形式获取此 ResultSet
对象的当前行中指定列的值。 byte
getByte(String columnLabel)
以 Java 编程语言中 byte
的形式获取此 ResultSet
对象的当前行中指定列的值。 byte[]
getBytes(int columnIndex)
以 Java 编程语言中 byte
数组的形式获取此 ResultSet
对象的当前行中指定列的值。 byte[]
getBytes(String columnLabel)
以 Java 编程语言中 byte
数组的形式获取此 ResultSet
对象的当前行中指定列的值。 Reader
getCharacterStream(int columnIndex)
以 java.io.Reader
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 Reader
getCharacterStream(String columnLabel)
以 java.io.Reader
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 Clob
getClob(int columnIndex)
以 Java 编程语言中 Clob
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 Clob
getClob(String columnLabel)
以 Java 编程语言中 Clob
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 int
getConcurrency()
获取此 ResultSet
对象的并发模式。 String
getCursorName()
获取此 ResultSet
对象使用的 SQL 光标的名称。 Date
getDate(int columnIndex)
以 Java 编程语言中 java.sql.Date
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 Date
getDate(int columnIndex, Calendar cal)
以 Java 编程语言中 java.sql.Date
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 Date
getDate(String columnLabel)
以 Java 编程语言中的 java.sql.Date
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 Date
getDate(String columnLabel, Calendar cal)
以 Java 编程语言中 java.sql.Date
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 double
getDouble(int columnIndex)
以 Java 编程语言中 double
的形式获取此 ResultSet
对象的当前行中指定列的值。 double
getDouble(String columnLabel)
以 Java 编程语言中 double
的形式获取此 ResultSet
对象的当前行中指定列的值。 int
getFetchDirection()
获取此 ResultSet
对象的获取方向。 int
getFetchSize()
获取此 ResultSet
对象的获取大小。 float
getFloat(int columnIndex)
以 Java 编程语言中 float
的形式获取此 ResultSet
对象的当前行中指定列的值。 float
getFloat(String columnLabel)
以 Java 编程语言中 float
的形式获取此 ResultSet
对象的当前行中指定列的值。 int
getHoldability()
获取此 ResultSet
对象的可保存性 int
getInt(int columnIndex)
以 Java 编程语言中 int
的形式获取此 ResultSet
对象的当前行中指定列的值。 int
getInt(String columnLabel)
以 Java 编程语言中 int
的形式获取此 ResultSet
对象的当前行中指定列的值。 long
getLong(int columnIndex)
以 Java 编程语言中 long
的形式获取此 ResultSet
对象的当前行中指定列的值。 long
getLong(String columnLabel)
以 Java 编程语言中 long
的形式获取此 ResultSet
对象的当前行中指定列的值。 ResultSetMetaData
getMetaData()
获取此 ResultSet
对象的列的编号、类型和属性。 Reader
getNCharacterStream(int columnIndex)
以 java.io.Reader
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 Reader
getNCharacterStream(String columnLabel)
以 java.io.Reader
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 NClob
getNClob(int columnIndex)
以 Java 编程语言中 NClob
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 NClob
getNClob(String columnLabel)
以 Java 编程语言中 NClob
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 String
getNString(int columnIndex)
以 Java 编程语言中 String
的形式获取此 ResultSet
对象的当前行中指定列的值。 String
getNString(String columnLabel)
以 Java 编程语言中 String
的形式获取此 ResultSet
对象的当前行中指定列的值。 Object
getObject(int columnIndex)
以 Java 编程语言中 Object
的形式获取此 ResultSet
对象的当前行中指定列的值。 Object
getObject(int columnIndex, Map<String,Class<?>> map)
以 Java 编程语言中 Object
的形式获取此 ResultSet
对象的当前行中指定列的值。 Object
getObject(String columnLabel)
以 Java 编程语言中 Object
的形式获取此 ResultSet
对象的当前行中指定列的值。 Object
getObject(String columnLabel, Map<String,Class<?>> map)
以 Java 编程语言中 Object
的形式获取此 ResultSet
对象的当前行中指定列的值。 Ref
getRef(int columnIndex)
以 Java 编程语言中 Ref
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 Ref
getRef(String columnLabel)
以 Java 编程语言中 Ref
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 int
getRow()
获取当前行编号。 RowId
getRowId(int columnIndex)
以 Java 编程语言中 java.sql.RowId
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 RowId
getRowId(String columnLabel)
以 Java 编程语言中 java.sql.RowId
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 short
getShort(int columnIndex)
以 Java 编程语言中 short
的形式获取此 ResultSet
对象的当前行中指定列的值。 short
getShort(String columnLabel)
以 Java 编程语言中 short
的形式获取此 ResultSet
对象的当前行中指定列的值。 SQLXML
getSQLXML(int columnIndex)
以 Java 编程语言中 java.sql.SQLXML
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 SQLXML
getSQLXML(String columnLabel)
以 Java 编程语言中 java.sql.SQLXML
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 Statement
getStatement()
获取生成此 ResultSet
对象的 Statement
对象。 String
getString(int columnIndex)
以 Java 编程语言中 String
的形式获取此 ResultSet
对象的当前行中指定列的值。 String
getString(String columnLabel)
以 Java 编程语言中 String
的形式获取此 ResultSet
对象的当前行中指定列的值。 Time
getTime(int columnIndex)
以 Java 编程语言中 java.sql.Time
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 Time
getTime(int columnIndex, Calendar cal)
以 Java 编程语言中 java.sql.Time
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 Time
getTime(String columnLabel)
以 Java 编程语言中 java.sql.Time
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 Time
getTime(String columnLabel, Calendar cal)
以 Java 编程语言中 java.sql.Time
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 Timestamp
getTimestamp(int columnIndex)
以 Java 编程语言中 java.sql.Timestamp
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 Timestamp
getTimestamp(int columnIndex, Calendar cal)
以 Java 编程语言中 java.sql.Timestamp
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 Timestamp
getTimestamp(String columnLabel)
以 Java 编程语言中 java.sql.Timestamp
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 Timestamp
getTimestamp(String columnLabel, Calendar cal)
以 Java 编程语言中 java.sql.Timestamp
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 int
getType()
获取此 ResultSet
对象的类型。 InputStream
getUnicodeStream(int columnIndex)
已过时。 使用 getCharacterStream
取代 getUnicodeStream
InputStream
getUnicodeStream(String columnLabel)
已过时。 使用 getCharacterStream
代替 URL
getURL(int columnIndex)
以 Java 编程语言中 java.net.URL
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 URL
getURL(String columnLabel)
以 Java 编程语言中 java.net.URL
对象的形式获取此 ResultSet
对象的当前行中指定列的值。 SQLWarning
getWarnings()
获取此 ResultSet
对象上的调用报告的第一个警告。 void
insertRow()
将插入行的内容插入到此 ResultSet
对象和数据库中。 boolean
isAfterLast()
获取光标是否位于此 ResultSet
对象的最后一行之后。 boolean
isBeforeFirst()
获取光标是否位于此 ResultSet
对象的第一行之前。 boolean
isClosed()
获取此 ResultSet
对象是否已关闭。 boolean
isFirst()
获取光标是否位于此 ResultSet
对象的第一行。 boolean
isLast()
获取光标是否位于此 ResultSet
对象的最后一行。 boolean
last()
将光标移动到此 ResultSet
对象的最后一行。 void
moveToCurrentRow()
将光标移动到记住的光标位置,通常为当前行。 void
moveToInsertRow()
将光标移动到插入行。 boolean
next()
将光标从当前位置向前移一行。 boolean
previous()
将光标移动到此 ResultSet
对象的上一行。 void
refreshRow()
用数据库中的最近值刷新当前行。 boolean
relative(int rows)
按相对行数(或正或负)移动光标。 boolean
rowDeleted()
获取是否已删除某行。 boolean
rowInserted()
获取当前行是否已有插入。 boolean
rowUpdated()
获取是否已更新当前行。 void
setFetchDirection(int direction)
设置此 ResultSet
对象中行的处理方向。 void
setFetchSize(int rows)
为 JDBC 驱动程序设置此 ResultSet
对象需要更多行时应该从数据库获取的行数。 void
updateArray(int columnIndex, Array x)
用 java.sql.Array
值更新指定列。 void
updateArray(String columnLabel, Array x)
用 java.sql.Array
值更新指定列。 void
updateAsciiStream(int columnIndex, InputStream x)
用 ascii 流值更新指定的列。 void
updateAsciiStream(int columnIndex, InputStream x, int length)
用 ascii 流值更新指定列,该列将具有指定字节数。 void
updateAsciiStream(int columnIndex, InputStream x, long length)
用 ascii 流值更新指定的列,该值将具有指定的字节数。 void
updateAsciiStream(String columnLabel, InputStream x)
用 ascii 流值更新指定列。 void
updateAsciiStream(String columnLabel, InputStream x, int length)
用 ascii 流值更新指定列,该列具有指定的字节数。 void
updateAsciiStream(String columnLabel, InputStream x, long length)
用 ascii 流值更新指定的列,该值将具有指定的字节数。 void
updateBigDecimal(int columnIndex, BigDecimal x)
用 java.math.BigDecimal
值更新指定列。 void
updateBigDecimal(String columnLabel, BigDecimal x)
用 java.sql.BigDecimal
值更新指定列。 void
updateBinaryStream(int columnIndex, InputStream x)
用二进制流值更新指定的列。 void
updateBinaryStream(int columnIndex, InputStream x, int length)
用二进制流值更新指定列,该列将具有指定字节数。 void
updateBinaryStream(int columnIndex, InputStream x, long length)
用二进制流值更新指定的列,该值将具有指定的字节数。 void
updateBinaryStream(String columnLabel, InputStream x)
用二进制流值更新指定列。 void
updateBinaryStream(String columnLabel, InputStream x, int length)
用二进制流值更新指定列,该列具有指定的字节数。 void
updateBinaryStream(String columnLabel, InputStream x, long length)
用二进制流值更新指定的列,该值将具有指定的字节数。 void
updateBlob(int columnIndex, Blob x)
用 java.sql.Blob
值更新指定列。 void
updateBlob(int columnIndex, InputStream inputStream)
使用给定输入流值更新指定列。 void
updateBlob(int columnIndex, InputStream inputStream, long length)
使用给定输入流更新指定的列,该流将具有指定的字节数。 void
updateBlob(String columnLabel, Blob x)
用 java.sql.Blob
值更新指定列。 void
updateBlob(String columnLabel, InputStream inputStream)
使用给定输入流值更新指定列。 void
updateBlob(String columnLabel, InputStream inputStream, long length)
使用给定输入流更新指定列,该流将具有指定的字节数。 void
updateBoolean(int columnIndex, boolean x)
用 boolean
值更新指定列。 void
updateBoolean(String columnLabel, boolean x)
用 boolean
值更新指定列。 void
updateByte(int columnIndex, byte x)
用 byte
值更新指定列。 void
updateByte(String columnLabel, byte x)
用 byte
值更新指定列。 void
updateBytes(int columnIndex, byte[] x)
用 byte
数组值更新指定列。 void
updateBytes(String columnLabel, byte[] x)
用字节数组值更新指定列。 void
updateCharacterStream(int columnIndex, Reader x)
用字符流值更新指定的列。 void
updateCharacterStream(int columnIndex, Reader x, int length)
用字符流值更新指定列,该列将具有指定字节数。 void
updateCharacterStream(int columnIndex, Reader x, long length)
用字符流值更新指定的列,该值将具有指定的字节数。 void
updateCharacterStream(String columnLabel, Reader reader)
用字符流值更新指定列。 void
updateCharacterStream(String columnLabel, Reader reader, int length)
用字符流值更新指定列,该列具有指定的字节数。 void
updateCharacterStream(String columnLabel, Reader reader, long length)
用字符流值更新指定的列,该值将具有指定的字节数。 void
updateClob(int columnIndex, Clob x)
用 java.sql.Clob
值更新指定列。 void
updateClob(int columnIndex, Reader reader)
使用给定的 Reader
对象更新指定列。 void
updateClob(int columnIndex, Reader reader, long length)
使用给定的 Reader
对象更新指定列,该对象是给定的字符长度数目。 void
updateClob(String columnLabel, Clob x)
用 java.sql.Clob
值更新指定列。 void
updateClob(String columnLabel, Reader reader)
使用给定的 Reader
对象更新指定列。 void
updateClob(String columnLabel, Reader reader, long length)
使用给定的 Reader
对象更新指定列,该对象是给定的字符长度数目。 void
updateDate(int columnIndex, Date x)
用 java.sql.Date
值更新指定列。 void
updateDate(String columnLabel, Date x)
用 java.sql.Date
值更新指定列。 void
updateDouble(int columnIndex, double x)
用 double
值更新指定列。 void
updateDouble(String columnLabel, double x)
用 double
值更新指定列。 void
updateFloat(int columnIndex, float x)
用 float
值更新指定列。 void
updateFloat(String columnLabel, float x)
用 float
值更新指定列。 void
updateInt(int columnIndex, int x)
用 int
值更新指定列。 void
updateInt(String columnLabel, int x)
用 int
值更新指定列。 void
updateLong(int columnIndex, long x)
用 long
值更新指定列。 void
updateLong(String columnLabel, long x)
用 long
值更新指定列。 void
updateNCharacterStream(int columnIndex, Reader x)
用字符流值更新指定的列。 void
updateNCharacterStream(int columnIndex, Reader x, long length)
用字符流值更新指定的列,该值将具有指定的字节数。 void
updateNCharacterStream(String columnLabel, Reader reader)
用字符流值更新指定的列。 void
updateNCharacterStream(String columnLabel, Reader reader, long length)
用字符流值更新指定的列,该值将具有指定的字节数。 void
updateNClob(int columnIndex, NClob nClob)
用 java.sql.NClob
值更新指定的列。 void
updateNClob(int columnIndex, Reader reader)
使用给定的 Reader
对象更新指定列。 void
updateNClob(int columnIndex, Reader reader, long length)
使用给定的 Reader
对象更新指定的列,该对象是给定的字符长度数目。 void
updateNClob(String columnLabel, NClob nClob)
用 java.sql.NClob
值更新指定的列。 void
updateNClob(String columnLabel, Reader reader)
使用给定的 Reader
对象更新指定列。 void
updateNClob(String columnLabel, Reader reader, long length)
使用给定的 Reader
对象更新指定的列,该对象是给定的字符长度数目。 void
updateNString(int columnIndex, String nString)
用 String
值更新指定的列。 void
updateNString(String columnLabel, String nString)
用 String
值更新指定的列。 void
updateNull(int columnIndex)
用 null
值更新指定列。 void
updateNull(String columnLabel)
用 null
值更新指定列。 void
updateObject(int columnIndex, Object x)
用 Object
值更新指定列。 void
updateObject(int columnIndex, Object x, int scaleOrLength)
用 Object
值更新指定列。 void
updateObject(String columnLabel, Object x)
用 Object
值更新指定列。 void
updateObject(String columnLabel, Object x, int scaleOrLength)
用 Object
值更新指定列。 void
updateRef(int columnIndex, Ref x)
用 java.sql.Ref
值更新指定列。 void
updateRef(String columnLabel, Ref x)
用 java.sql.Ref
值更新指定列。 void
updateRow()
用此 ResultSet
对象的当前行的新内容更新底层数据库。 void
updateRowId(int columnIndex, RowId x)
用 RowId
值更新指定列。 void
updateRowId(String columnLabel, RowId x)
用 RowId
值更新指定的列。 void
updateShort(int columnIndex, short x)
用 short
值更新指定列。 void
updateShort(String columnLabel, short x)
用 short
值更新指定列。 void
updateSQLXML(int columnIndex, SQLXML xmlObject)
用 java.sql.SQLXML
值更新指定列。 void
updateSQLXML(String columnLabel, SQLXML xmlObject)
用 java.sql.SQLXML
值更新指定的列。 void
updateString(int columnIndex, String x)
用 String
值更新指定列。 void
updateString(String columnLabel, String x)
用 String
值更新指定列。 void
updateTime(int columnIndex, Time x)
用 java.sql.Time
值更新指定列。 void
updateTime(String columnLabel, Time x)
用 java.sql.Time
值更新指定列。 void
updateTimestamp(int columnIndex, Timestamp x)
用 java.sql.Timestamp
值更新指定列。 void
updateTimestamp(String columnLabel, Timestamp x)
用 java.sql.Timestamp
值更新指定列。 boolean
wasNull()
报告最后一个读取的列是否具有值 SQL NULL
。
从接口 java.sql.Wrapper 继承的方法 isWrapperFor, unwrap
字段详细信息
FETCH_FORWARD
static final int FETCH_FORWARD
-
该常量指示将按正向(即从第一个到最后一个)处理结果集中的行。
setFetchDirection
方法将此常量用作驱动程序的提示,驱动程序可能忽略它。
从以下版本开始:
-
1.2
另请参见:
-
常量字段值
FETCH_REVERSE
static final int FETCH_REVERSE
-
该常量指示将按逆向(即从最后一个到第一个)处理结果集中的行处理。
setFetchDirection
方法将此常量用作驱动程序的提示,驱动程序可能忽略它。
从以下版本开始:
-
1.2
另请参见:
-
常量字段值
FETCH_UNKNOWN
static final int FETCH_UNKNOWN
-
该常量指示结果集中的行的处理顺序未知。
setFetchDirection
方法将此常量用作驱动程序的提示,驱动程序可能忽略它。
另请参见:
-
常量字段值
TYPE_FORWARD_ONLY
static final int TYPE_FORWARD_ONLY
-
该常量指示光标只能向前移动的
ResultSet
对象的类型。
从以下版本开始:
-
1.2
另请参见:
-
常量字段值
TYPE_SCROLL_INSENSITIVE
static final int TYPE_SCROLL_INSENSITIVE
-
该常量指示可滚动但通常不受
ResultSet
底层数据更改影响的
ResultSet
对象的类型。
从以下版本开始:
-
1.2
另请参见:
-
常量字段值
TYPE_SCROLL_SENSITIVE
static final int TYPE_SCROLL_SENSITIVE
-
该常量指示可滚动并且通常受
ResultSet
底层数据更改影响的
ResultSet
对象的类型。
从以下版本开始:
-
1.2
另请参见:
-
常量字段值
CONCUR_READ_ONLY
static final int CONCUR_READ_ONLY
-
该常量指示不可以更新的
ResultSet
对象的并发模式。
从以下版本开始:
-
1.2
另请参见:
-
常量字段值
CONCUR_UPDATABLE
static final int CONCUR_UPDATABLE
-
该常量指示可以更新的
ResultSet
对象的并发模式。
从以下版本开始:
-
1.2
另请参见:
-
常量字段值
HOLD_CURSORS_OVER_COMMIT
static final int HOLD_CURSORS_OVER_COMMIT
-
该常量指示提交当前事务时,具有此可保存性的打开的
ResultSet
对象将保持开放。
从以下版本开始:
-
1.4
另请参见:
-
常量字段值
CLOSE_CURSORS_AT_COMMIT
static final int CLOSE_CURSORS_AT_COMMIT
-
该常量指示提交当前事务时,具有此可保存性的打开的
ResultSet
对象将被关闭。
从以下版本开始:
-
1.4
另请参见:
-
常量字段值
方法详细信息
next
boolean next()
throws SQLException
-
将光标从当前位置向前移一行。
ResultSet
光标最初位于第一行之前;第一次调用
next
方法使第一行成为当前行;第二次调用使第二行成为当前行,依此类推。
当调用 next
方法返回 false
时,光标位于最后一行的后面。任何要求当前行的 ResultSet
方法调用将导致抛出SQLException
。如果结果集的类型是 TYPE_FORWARD_ONLY
,则其 JDBC 驱动程序实现对后续next
调用是返回 false
还是抛出 SQLException
将由供应商指定。
如果对当前行开启了输入流,则调用 next
方法将隐式关闭它。读取新行时,将清除 ResultSet
对象的警告链。
-
-
返回:
-
如果新的当前行有效,则返回
true
;如果不存在下一行,则返回
false
抛出:
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
close
void close()
throws SQLException
-
立即释放此
ResultSet
对象的数据库和 JDBC 资源,而不是等待该对象自动关闭时发生此操作。
关闭 ResultSet
对象不会关闭 ResultSet
创建的 Blob
、Clob
或 NClob
对象。Blob
、Clob
或NClob
对象至少在创建它们的事务期间持续有效,除非调用了其 free
方法。
当关闭 ResultSet
时,所有通过调用 getMetaData
方法创建的 ResultSetMetaData
实例都可以访问。
注:当生成 ResultSet
对象的 Statement
对象关闭、重新执行或用来从多个结果的序列获取下一个结果时,该Statement
对象将自动关闭 ResultSet
对象。
在已关闭的 ResultSet
对象上调用 close
方法是无操作 (no-op)。
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误
wasNull
boolean wasNull()
throws SQLException
-
报告最后一个读取的列是否具有值 SQL
NULL
。注意,必须首先对列调用一个获取方法尝试读取其值,然后调用
wasNull
方法查看读取的值是否为 SQL
NULL
。
-
-
返回:
-
如果最后一个读取的列值为 SQL
NULL
,则返回
true
;否则返回
false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
getString
String getString(int columnIndex)
throws SQLException
-
以 Java 编程语言中
String
的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getBoolean
boolean getBoolean(int columnIndex)
throws SQLException
-
以 Java 编程语言中
boolean
的形式获取此
ResultSet
对象的当前行中指定列的值。
如果指定列的数据类型为 CHAR 或 VARCHAR 且包含 "0",或者数据类型为 BIT、TINYINT、SMALLINT、INTEGER 或 BIGINT 且包含 0,则返回false
值。如果指定列的数据类型为 CHAR 或 VARCHAR 且包含 "1",或者数据类型为 BIT、TINYINT、SMALLINT、INTEGER 或 BIGINT 且包含 1,则返回true
值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
false
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getByte
byte getByte(int columnIndex)
throws SQLException
-
以 Java 编程语言中
byte
的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
0
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getShort
short getShort(int columnIndex)
throws SQLException
-
以 Java 编程语言中
short
的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
0
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getInt
int getInt(int columnIndex)
throws SQLException
-
以 Java 编程语言中
int
的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
0
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getLong
long getLong(int columnIndex)
throws SQLException
-
以 Java 编程语言中
long
的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
0
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getFloat
float getFloat(int columnIndex)
throws SQLException
-
以 Java 编程语言中
float
的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
0
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getDouble
double getDouble(int columnIndex)
throws SQLException
-
以 Java 编程语言中
double
的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
0
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getBigDecimal
BigDecimal getBigDecimal(int columnIndex,
int scale)
throws SQLException
-
已过时。
-
以 Java 编程语言中
java.sql.BigDecimal
的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
scale
- 小数点右边的位数
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
getBytes
byte[] getBytes(int columnIndex)
throws SQLException
-
以 Java 编程语言中
byte
数组的形式获取此
ResultSet
对象的当前行中指定列的值。这些字节表示驱动程序返回的原始值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getDate
Date getDate(int columnIndex)
throws SQLException
-
以 Java 编程语言中
java.sql.Date
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getTime
Time getTime(int columnIndex)
throws SQLException
-
以 Java 编程语言中
java.sql.Time
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getTimestamp
Timestamp getTimestamp(int columnIndex)
throws SQLException
-
以 Java 编程语言中
java.sql.Timestamp
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getAsciiStream
InputStream getAsciiStream(int columnIndex)
throws SQLException
-
以 ASCII 字符流的形式获取此
ResultSet
对象的当前行中指定列的值。然后,可以按块从流中读取值。此方法尤其适合于获取很大的 LONGVARCHAR 值。JDBC 驱动程序将执行从数据库格式到 ASCII 的任何必要转换。
注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用 InputStream.available
方法时,不管是否存在可用数据,流都可能返回0
。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
以一字节 ASCII 字符流的形式返回传递数据库列值的 Java 输入流;如果值为 SQL
NULL
,则返回值为
null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getUnicodeStream
InputStream getUnicodeStream(int columnIndex)
throws SQLException
-
已过时。
使用
getCharacterStream
取代 getUnicodeStream
-
以两字节 3 字符流的形式获取此
ResultSet
对象的当前行中指定列的值。第一个字节是高字节;第二个字节是低字节。然后,可以按块从流中读取值。此方法尤其适合于获取很大的
LONGVARCHAR
值。JDBC 驱动程序将执行从数据库格式到 Unicode 的任何必要转换。
注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用 InputStream.available
方法时,不管是否存在可用数据,流都可能返回0
。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
以两字节 Unicode 字符流的形式返回传递数据库列值的 Java 输入流;如果值为 SQL
NULL
,则返回值为
null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
getBinaryStream
InputStream getBinaryStream(int columnIndex)
throws SQLException
-
以未解释字节的流的形式获取此
ResultSet
对象的当前行中指定列的值。然后,可以按块从流中读取值。此方法尤其适合于获取很大的
LONGVARBINARY
值。
注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用 InputStream.available
方法时,不管是否存在可用数据,流都可能返回0
。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
以未解释字节的流的形式返回传递数据库列值的 Java 输入流;如果值为 SQL
NULL
,则返回值为
null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getString
String getString(String columnLabel)
throws SQLException
-
以 Java 编程语言中
String
的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getBoolean
boolean getBoolean(String columnLabel)
throws SQLException
-
以 Java 编程语言中
boolean
的形式获取此
ResultSet
对象的当前行中指定列的值。
如果指定列的数据类型为 CHAR 或 VARCHAR 且包含 "0",或者数据类型为 BIT、TINYINT、SMALLINT、INTEGER 或 BIGINT 且包含 0,则返回false
值。如果指定列的数据类型为 CHAR 或 VARCHAR 且包含 "1",或者数据类型为 BIT、TINYINT、SMALLINT、INTEGER 或 BIGINT 且包含 1,则返回true
值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
false
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getByte
byte getByte(String columnLabel)
throws SQLException
-
以 Java 编程语言中
byte
的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
0
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getShort
short getShort(String columnLabel)
throws SQLException
-
以 Java 编程语言中
short
的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
0
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getInt
int getInt(String columnLabel)
throws SQLException
-
以 Java 编程语言中
int
的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
0
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getLong
long getLong(String columnLabel)
throws SQLException
-
以 Java 编程语言中
long
的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
0
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getFloat
float getFloat(String columnLabel)
throws SQLException
-
以 Java 编程语言中
float
的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
0
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getDouble
double getDouble(String columnLabel)
throws SQLException
-
以 Java 编程语言中
double
的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
0
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getBigDecimal
BigDecimal getBigDecimal(String columnLabel,
int scale)
throws SQLException
-
已过时。
-
以 Java 编程语言中
java.math.BigDecimal
的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
scale
- 小数点右边的位数
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
getBytes
byte[] getBytes(String columnLabel)
throws SQLException
-
以 Java 编程语言中
byte
数组的形式获取此
ResultSet
对象的当前行中指定列的值。这些字节表示驱动程序返回的原始值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getDate
Date getDate(String columnLabel)
throws SQLException
-
以 Java 编程语言中的
java.sql.Date
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getTime
Time getTime(String columnLabel)
throws SQLException
-
以 Java 编程语言中
java.sql.Time
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getTimestamp
Timestamp getTimestamp(String columnLabel)
throws SQLException
-
以 Java 编程语言中
java.sql.Timestamp
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为
null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getAsciiStream
InputStream getAsciiStream(String columnLabel)
throws SQLException
-
以 ASCII 字符流的形式获取此
ResultSet
对象的当前行中指定列的值。然后,可以按块从流中读取值。此方法尤其适合于获取很大的
LONGVARCHAR
值。JDBC 驱动程序将执行从数据库格式到 ASCII 的任何必要转换。
注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用 available
方法时,不管是否存在可用数据,流都可能返回0
。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
以一字节 ASCII 字符流的形式返回传递数据库列值的 Java 输入流。如果值为 SQL
NULL
,则返回值为
null
。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getUnicodeStream
InputStream getUnicodeStream(String columnLabel)
throws SQLException
-
已过时。
使用
getCharacterStream
代替
-
以两字节 Unicode 字符流的形式获取此
ResultSet
对象的当前行中指定列的值。第一个字节是高字节;第二个字节是低字节。然后,可以按块从流中读取值。此方法尤其适合于获取很大的
LONGVARCHAR
值。采用 JDBC 技术的驱动程序将执行从数据库格式到 Unicode 的任何必要转换。
注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用 InputStream.available
方法时,不管是否存在可用数据,流都可能返回0
。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
以两字节 Unicode 字符流的形式返回传递数据库列值的 Java 输入流。如果值为 SQL
NULL
,则返回值为
null
。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
getBinaryStream
InputStream getBinaryStream(String columnLabel)
throws SQLException
-
以未解释的
byte
流的形式获取此
ResultSet
对象的当前行中指定列的值。然后,可以按块从流中读取该值。此方法尤其适合于获取很大的
LONGVARBINARY
值。
注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用 available
方法时,不管是否存在可用数据,流都可能返回0
。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
以未解释字节流的形式返回传递数据库列值的 Java 输入流;如果值为 SQL
NULL
,则返回值为
null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getWarnings
SQLWarning getWarnings()
throws SQLException
-
获取此
ResultSet
对象上的调用报告的第一个警告。此
ResultSet
对象上的后续警告会被链接到此方法返回的
SQLWarning
对象。
每次读取新行时,都会自动清除警告链。不可以在已经关闭的 ResultSet
对象上调用此方法;这样做将导致抛出 SQLException
。
注:此警告链仅包含 ResultSet
方法产生的警告。Statement
方法(如读取 OUT 参数)产生的任何警告都将链接在Statement
对象上。
-
-
返回:
-
报告的第一个
SQLWarning
对象;如果不存在,则返回
null
抛出:
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
clearWarnings
void clearWarnings()
throws SQLException
-
清除在此
ResultSet
对象上报告的所有警告。调用此方法后,在为此
ResultSet
对象报告新的警告之前,
getWarnings
方法将返回
null
。
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
getCursorName
String getCursorName()
throws SQLException
-
获取此
ResultSet
对象使用的 SQL 光标的名称。
在 SQL 中,通过指定的光标获取结果表。通过一个引用光标名称来定位的更新/删除语句,可以更新或删除结果集的当前行。为了确保光标具有支持更新的适当隔离级别,光标的SELECT
语句的形式应该为 SELECT FOR UPDATE
。如果省略 FOR UPDATE
,则定位更新可能失败。
JDBC API 通过提供 ResultSet
对象使用的 SQL 光标的名称支持此 SQL 功能。ResultSet
对象的当前行也是此 SQL 光标的当前行。
-
-
返回:
-
此
ResultSet
对象的光标的 SQL 名称
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
getMetaData
ResultSetMetaData getMetaData()
throws SQLException
-
获取此
ResultSet
对象的列的编号、类型和属性。
-
-
返回:
-
此
ResultSet
对象的列的描述
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
getObject
Object getObject(int columnIndex)
throws SQLException
-
以 Java 编程语言中 Object
的形式获取此 ResultSet
对象的当前行中指定列的值。
此方法将以 Java 对象的形式返回给定列的值。Java 对象的类型将为与该列的 SQL 类型相对应的默认 Java 对象类型,它遵守在 JDBC 规范中指定的内置类型的映射关系。如果值为 SQLNULL
,则驱动程序返回一个 Java null
。
此方法还可用于读取特定于数据库的抽象数据类型。在 JDBC 2.0 API 中,可以扩展 getObject
方法的行为来实现 SQL 自定义类型的数据。
如果 Connection.getTypeMap
不抛出 SQLFeatureNotSupportedException
,则当列包含结构值或独特值时,此方法的行为类似于调用:getObject(columnIndex, this.getStatement().getConnection().getTypeMap())
。如果Connection.getTypeMap
抛出 SQLFeatureNotSupportedException
,则结构值不受支持,独特值映射到 DISTINCT 类型的底层 SQL 类型确定的默认 Java 类。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
保存列值的
java.lang.Object
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
getObject
Object getObject(String columnLabel)
throws SQLException
-
以 Java 编程语言中 Object
的形式获取此 ResultSet
对象的当前行中指定列的值。
此方法将以 Java 对象的形式返回给定列的值。Java 对象的类型将为与该列的 SQL 类型相对应的默认 Java 对象类型,它遵守在 JDBC 规范中指定的内置类型的映射关系。如果值为 SQLNULL
,则驱动程序返回一个 Java null
。
此方法还可用于读取特定于数据库的抽象数据类型。
在 JDBC 2.0 API 中,可以扩展 getObject
方法的行为来实现 SQL 自定义类型的数据。当列包含结构化的或独特的值时,此方法的行为类似于调用:getObject(columnIndex, this.getStatement().getConnection().getTypeMap())
。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
保存列值的
java.lang.Object
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
findColumn
int findColumn(String columnLabel)
throws SQLException
-
将给定的
ResultSet
列标签映射到其
ResultSet
列索引。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
给定列名称的列索引
抛出:
-
SQLException
- 如果
ResultSet
对象不包含标记为
columnLabel
的列,发生数据库访问错误或在已关闭的结果集上调用此方法
getCharacterStream
Reader getCharacterStream(int columnIndex)
throws SQLException
-
以
java.io.Reader
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
包含列值的
java.io.Reader
对象;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
-
1.2
getCharacterStream
Reader getCharacterStream(String columnLabel)
throws SQLException
-
以
java.io.Reader
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
包含列值的
java.io.Reader
对象;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
-
1.2
getBigDecimal
BigDecimal getBigDecimal(int columnIndex)
throws SQLException
-
以具有全精度的
java.math.BigDecimal
的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值(全精度);如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
-
1.2
getBigDecimal
BigDecimal getBigDecimal(String columnLabel)
throws SQLException
-
以具有全精度的
java.math.BigDecimal
的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值(全精度);如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
-
1.2
isBeforeFirst
boolean isBeforeFirst()
throws SQLException
-
获取光标是否位于此
ResultSet
对象的第一行之前。
注:对于带有 TYPE_FORWARD_ONLY
的结果集类型的 ResultSet
,对isBeforeFirst
方法的支持是可选的
-
-
返回:
-
如果光标位于第一行之前,则返回
true
;如果光标位于任何其他位置或者结果集不包含任何行,则返回
false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
isAfterLast
boolean isAfterLast()
throws SQLException
-
获取光标是否位于此
ResultSet
对象的最后一行之后。
注:对于带有 TYPE_FORWARD_ONLY
的结果集类型的 ResultSet
,对isAfterLast
方法的支持是可选的
-
-
返回:
-
如果光标位于最后一行之后,则返回
true
;如果光标位于任何其他位置或者结果集不包含任何行,则返回
false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
isFirst
boolean isFirst()
throws SQLException
-
获取光标是否位于此
ResultSet
对象的第一行。
注:对于带有 TYPE_FORWARD_ONLY
的结果集类型的 ResultSet
,对isFirst
方法的支持是可选的
-
-
返回:
-
如果光标位于第一行,则返回
true
;否则返回
false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
isLast
boolean isLast()
throws SQLException
-
获取光标是否位于此
ResultSet
对象的最后一行。
注:调用
isLast
方法可能开销很大,因为 JDBC 驱动程序可能需要再往后获取一行,以确定当前行是否为结果集中的最后一行。
注:对于带有 TYPE_FORWARD_ONLY
的结果集类型的 ResultSet
,对isLast
方法的支持是可选的
-
-
返回:
-
如果光标位于最后一行上,则返回
true
;否则返回
false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
beforeFirst
void beforeFirst()
throws SQLException
-
将光标移动到此
ResultSet
对象的开头,正好位于第一行之前。如果结果集中不包含任何行,则此方法无效。
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为
TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
afterLast
void afterLast()
throws SQLException
-
将光标移动到此
ResultSet
对象的末尾,正好位于最后一行之后。如果结果集中不包含任何行,则此方法无效。
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为
TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
first
boolean first()
throws SQLException
-
将光标移动到此
ResultSet
对象的第一行。
-
-
返回:
-
如果光标位于有效行,则返回
true
;如果结果集中不存在任何行,则返回
false
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为
TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
last
boolean last()
throws SQLException
-
将光标移动到此
ResultSet
对象的最后一行。
-
-
返回:
-
如果光标位于有效行,则返回
true
;如果结果集中不存在任何行,则返回
false
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为
TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
getRow
int getRow()
throws SQLException
-
获取当前行编号。第一行为 1 号,第二行为 2 号,依此类推。
注:对于带有 TYPE_FORWARD_ONLY
的结果集类型的 ResultSet
,对getRow
方法的支持是可选的
-
-
返回:
-
当前行的编号;如果不存在当前行,则返回
0
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
absolute
boolean absolute(int row)
throws SQLException
-
将光标移动到此
ResultSet
对象的给定行编号。
如果行编号为正,则将光标移动到相对于结果集开头的给定行编号。第一行为行 1,第二行为行 2,依此类推。
如果给定行编号为负,则将光标移动到相对于结果集末尾的绝对行位置。例如,调用方法 absolute(-1)
将光标置于最后一行;调用方法absolute(-2)
将光标移动到倒数第二行,依此类推。
试图将光标置于结果集的第一行/最后一行之外将导致光标位于第一行之前或最后一行之后。
注:调用 absolute(1)
等效于调用 first()
。调用 absolute(-1)
等效于调用 last()
。
-
-
参数:
-
row
- 光标应该移动到的行的编号。正的编号指示从结果集开头开始计数的行编号;负的编号指示从结果集末尾开始计数的行编号
返回:
-
如果光标移动到此
ResultSet
对象的位置处,则返回
true
;如果光标在第一行的前面或最后一行的后面,则返回
false
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为
TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
relative
boolean relative(int rows)
throws SQLException
-
按相对行数(或正或负)移动光标。试图移动到结果集的第一行/最后一行之外,会将光标置于第一行之前或最后一行之后。调用
relative(0)
有效,但是不更改光标位置。
注:调用方法 relative(1)
等效于调用方法 next()
,而调用方法 relative(-1)
等效于调用方法previous()
。
-
-
参数:
-
rows
- 指定从当前行开始移动的行数的
int
;正数表示光标向前移动;负数表示光标向后移动
返回:
-
如果光标位于行上,则返回
true
;否则返回
false
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为
TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
previous
boolean previous()
throws SQLException
-
将光标移动到此
ResultSet
对象的上一行。
当调用 previous
方法返回 false
时,光标位于第一行之前。要求当前行的任何 ResultSet
方法的调用将导致抛出SQLException
。
如果开启了对当前行的输入流,则调用 previous
方法将隐式关闭它。读取新的一行时清除 ResultSet
对象的警告更改。
-
-
返回:
-
如果光标现在位于有效行上,则返回
true
;如果光标位于第一行的前面,则返回
false
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为
TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
setFetchDirection
void setFetchDirection(int direction)
throws SQLException
-
设置此
ResultSet
对象中行的处理方向。初始值由生成此
ResultSet
对象的
Statement
对象确定。获取方向可以在任何时间更改。
-
-
参数:
-
direction
- 指定建议获取方向的
int
;
ResultSet.FETCH_FORWARD
、
ResultSet.FETCH_REVERSE
或
ResultSet.FETCH_UNKNOWN
之一
抛出:
-
SQLException
- 如果发生数据库访问错误,在已关闭的结果集上调用此方法或结果集类型为
TYPE_FORWARD_ONLY
但获取方向不是
FETCH_FORWARD
从以下版本开始:
-
1.2
另请参见:
-
Statement.setFetchDirection(int), getFetchDirection()
getFetchDirection
int getFetchDirection()
throws SQLException
-
获取此
ResultSet
对象的获取方向。
-
-
返回:
-
此
ResultSet
对象的当前获取方向
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
-
1.2
另请参见:
-
setFetchDirection(int)
setFetchSize
void setFetchSize(int rows)
throws SQLException
-
为 JDBC 驱动程序设置此
ResultSet
对象需要更多行时应该从数据库获取的行数。如果指定的获取大小为零,则 JDBC 驱动程序忽略该值,随意对获取大小作出它自己的最佳猜测。默认值由创建结果集的
Statement
对象设置。获取大小可以在任何时间更改。
-
-
参数:
-
rows
- 要获取的行数
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或不满足条件
rows >= 0
从以下版本开始:
-
1.2
另请参见:
-
getFetchSize()
getFetchSize
int getFetchSize()
throws SQLException
-
获取此
ResultSet
对象的获取大小。
-
-
返回:
-
此
ResultSet
对象的当前获取大小
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
-
1.2
另请参见:
-
setFetchSize(int)
getType
int getType()
throws SQLException
-
获取此
ResultSet
对象的类型。类型由创建结果集的
Statement
对象确定。
-
-
返回:
-
ResultSet.TYPE_FORWARD_ONLY
、
ResultSet.TYPE_SCROLL_INSENSITIVE
或
ResultSet.TYPE_SCROLL_SENSITIVE
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
-
1.2
getConcurrency
int getConcurrency()
throws SQLException
-
获取此
ResultSet
对象的并发模式。使用的并发由创建结果集的
Statement
对象确定。
-
-
返回:
-
并发类型,
ResultSet.CONCUR_READ_ONLY
或
ResultSet.CONCUR_UPDATABLE
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
-
1.2
rowUpdated
boolean rowUpdated()
throws SQLException
-
获取是否已更新当前行。返回值取决于结果集是否可以检测到更新。
注:对于 CONCUR_READ_ONLY
的结果集并发性,对 rowUpdated
方法的支持是可选的
-
-
返回:
-
如果所有者和其他人检测到当前行已进行可见更新,则返回
true
;否则返回
false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
另请参见:
-
DatabaseMetaData.updatesAreDetected(int)
rowInserted
boolean rowInserted()
throws SQLException
-
获取当前行是否已有插入。返回值取决于此
ResultSet
对象是否可以检测到可见插入。
注:对于 CONCUR_READ_ONLY
的结果集并发性,对 rowUpdated
方法的支持是可选的
-
-
返回:
-
如果当前检测到已插入,则返回
true
;否则返回
false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
另请参见:
-
DatabaseMetaData.insertsAreDetected(int)
rowDeleted
boolean rowDeleted()
throws SQLException
-
获取是否已删除某行。删除的行可能在结果集中留下一个可见的“洞”。此方法可用于检测结果集中的洞。返回值取决于此
ResultSet
对象是否可以检测到删除。
注:对于 CONCUR_READ_ONLY
的结果集并发性,对 rowDeleted
方法的支持是可选的
-
-
返回:
-
如果所有者或其他人检测到当前行已删除,则返回
true
;否则返回
false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
另请参见:
-
DatabaseMetaData.deletesAreDetected(int)
updateNull
void updateNull(int columnIndex)
throws SQLException
-
用
null
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateBoolean
void updateBoolean(int columnIndex,
boolean x)
throws SQLException
-
用
boolean
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateByte
void updateByte(int columnIndex,
byte x)
throws SQLException
-
用
byte
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateShort
void updateShort(int columnIndex,
short x)
throws SQLException
-
用
short
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateInt
void updateInt(int columnIndex,
int x)
throws SQLException
-
用
int
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateLong
void updateLong(int columnIndex,
long x)
throws SQLException
-
用
long
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会不更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateFloat
void updateFloat(int columnIndex,
float x)
throws SQLException
-
用
float
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateDouble
void updateDouble(int columnIndex,
double x)
throws SQLException
-
用
double
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateBigDecimal
void updateBigDecimal(int columnIndex,
BigDecimal x)
throws SQLException
-
用
java.math.BigDecimal
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateString
void updateString(int columnIndex,
String x)
throws SQLException
-
用
String
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateBytes
void updateBytes(int columnIndex,
byte[] x)
throws SQLException
-
用
byte
数组值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateDate
void updateDate(int columnIndex,
Date x)
throws SQLException
-
用
java.sql.Date
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateTime
void updateTime(int columnIndex,
Time x)
throws SQLException
-
用
java.sql.Time
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateTimestamp
void updateTimestamp(int columnIndex,
Timestamp x)
throws SQLException
-
用
java.sql.Timestamp
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateAsciiStream
void updateAsciiStream(int columnIndex,
InputStream x,
int length)
throws SQLException
-
用 ascii 流值更新指定列,该列将具有指定字节数。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
-
length
- 流的长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateBinaryStream
void updateBinaryStream(int columnIndex,
InputStream x,
int length)
throws SQLException
-
用二进制流值更新指定列,该列将具有指定字节数。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
-
length
- 流的长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateCharacterStream
void updateCharacterStream(int columnIndex,
Reader x,
int length)
throws SQLException
-
用字符流值更新指定列,该列将具有指定字节数。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
-
length
- 流的长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateObject
void updateObject(int columnIndex,
Object x,
int scaleOrLength)
throws SQLException
-
用
Object
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
如果第二个参数是 InputStream
,则该流必须包含 scaleOrLength 指定的字节数。如果第二个参数是 Reader
,则它必须包含 scaleOrLength 指定的字符数。如果这些条件不为真,则执行该语句时驱动程序将生成一个 SQLException
。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
-
scaleOrLength
- 对于
java.math.BigDecimal
对象,此参数是小数点后的位数。对于 Java 对象类型
InputStream
和
Reader
,此参数是该流或 reader 中数据的长度。对于其他所有类型,将忽略此值。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateObject
void updateObject(int columnIndex,
Object x)
throws SQLException
-
用
Object
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateNull
void updateNull(String columnLabel)
throws SQLException
-
用
null
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateBoolean
void updateBoolean(String columnLabel,
boolean x)
throws SQLException
-
用
boolean
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateByte
void updateByte(String columnLabel,
byte x)
throws SQLException
-
用
byte
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateShort
void updateShort(String columnLabel,
short x)
throws SQLException
-
用
short
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateInt
void updateInt(String columnLabel,
int x)
throws SQLException
-
用
int
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateLong
void updateLong(String columnLabel,
long x)
throws SQLException
-
用
long
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateFloat
void updateFloat(String columnLabel,
float x)
throws SQLException
-
用
float
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateDouble
void updateDouble(String columnLabel,
double x)
throws SQLException
-
用
double
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateBigDecimal
void updateBigDecimal(String columnLabel,
BigDecimal x)
throws SQLException
-
用
java.sql.BigDecimal
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateString
void updateString(String columnLabel,
String x)
throws SQLException
-
用
String
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateBytes
void updateBytes(String columnLabel,
byte[] x)
throws SQLException
-
用字节数组值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateDate
void updateDate(String columnLabel,
Date x)
throws SQLException
-
用
java.sql.Date
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateTime
void updateTime(String columnLabel,
Time x)
throws SQLException
-
用
java.sql.Time
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateTimestamp
void updateTimestamp(String columnLabel,
Timestamp x)
throws SQLException
-
用
java.sql.Timestamp
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateAsciiStream
void updateAsciiStream(String columnLabel,
InputStream x,
int length)
throws SQLException
-
用 ascii 流值更新指定列,该列具有指定的字节数。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
-
length
- 流的长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateBinaryStream
void updateBinaryStream(String columnLabel,
InputStream x,
int length)
throws SQLException
-
用二进制流值更新指定列,该列具有指定的字节数。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
-
length
- 流的长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateCharacterStream
void updateCharacterStream(String columnLabel,
Reader reader,
int length)
throws SQLException
-
用字符流值更新指定列,该列具有指定的字节数。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
reader
- 包含新列值的
java.io.Reader
对象
-
length
- 流的长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateObject
void updateObject(String columnLabel,
Object x,
int scaleOrLength)
throws SQLException
-
用
Object
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
如果第二个参数是 InputStream
,则该流必须包含 scaleOrLength 指定的字节数。如果第二个参数是 Reader
,则它必须包含 scaleOrLength 指定的字符数。如果这些条件不为真,则执行该语句时驱动程序将生成一个 SQLException
。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
-
scaleOrLength
- 对于
java.math.BigDecimal
对象,此参数是小数点后的位数。对于 Java 对象类型
InputStream
和
Reader
,此参数是该流或 reader 中数据的长度。 对于其他所有类型,将忽略此值。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateObject
void updateObject(String columnLabel,
Object x)
throws SQLException
-
用
Object
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
insertRow
void insertRow()
throws SQLException
-
将插入行的内容插入到此
ResultSet
对象和数据库中。调用此方法时,光标必须位于插入行上。
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法;如果在光标不位于插入行上时调用此方法,或者插入行中所有不可为 null 的列中还存在未分配非 null 值的列
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
updateRow
void updateRow()
throws SQLException
-
用此
ResultSet
对象的当前行的新内容更新底层数据库。光标不位于插入行上时不能调用此方法。
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
;在已关闭的结果集上调用此方法,或者在光标不位于插入行上时调用了此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
deleteRow
void deleteRow()
throws SQLException
-
从此
ResultSet
对象和底层数据库中删除当前行。光标不位于插入行上时不能调用此方法。
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
;在已关闭的结果集上调用此方法,或者在光标不位于插入行上时调用了此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
refreshRow
void refreshRow()
throws SQLException
-
用数据库中的最近值刷新当前行。光标不位于插入行上时不能调用此方法。
refreshRow
方法提供一种让应用程序显式告知 JDBC 驱动程序从数据库重新获取行的方式。应用程序可能需要在 JDBC 驱动程序完成缓存或预获取操作后调用refreshRow
,以便从数据库获取行的最新值。如果获取大小大于 1,则 JDBC 驱动程序可以一次实际刷新多行。
应根据事务隔离级别和光标敏感度确定是否重新获取所有值。如果在调用更新方法之后,但在调用 updateRow
方法之前调用 refreshRow
,则会丢失对行所作的更新。频繁调用方法 refreshRow
可能导致性能下降。
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法;结果集类型为
TYPE_FORWARD_ONLY
,或者在光标不位于插入行上时调用了此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法,或者对于指定的结果集类型和结果集并发性此方法不受支持。
从以下版本开始:
-
1.2
cancelRowUpdates
void cancelRowUpdates()
throws SQLException
-
取消对
ResultSet
对象中的当前行所作的更新。此方法在调用更新方法之后,但在调用
updateRow
方法之前调用才可以回滚对行所作的更新。如果没有进行任何更新或者已经调用
updateRow
方法,则此方法无效。
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法;结果集并发性为
CONCUR_READ_ONLY
,或者在光标不位于插入行上时调用了此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
moveToInsertRow
void moveToInsertRow()
throws SQLException
-
将光标移动到插入行。将光标置于插入行上时,当前的光标位置会被记住。插入行是一个与可更新结果集相关联的特殊行。它实际上是一个缓冲区,在将行插入到结果集前可以通过调用更新方法在其中构造新行。当光标位于插入行上时,仅能调用更新方法、获取方法以及
insertRow
方法。每次在调用
insertRow
之前调用此方法时,必须为结果集中的所有列分配值。在对列值调用获取方法之前,必须调用更新方法。
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集并发性为
CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
moveToCurrentRow
void moveToCurrentRow()
throws SQLException
-
将光标移动到记住的光标位置,通常为当前行。如果光标不位于插入行上,则此方法无效。
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集并发性为
CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
getStatement
Statement getStatement()
throws SQLException
-
获取生成此
ResultSet
对象的
Statement
对象。如果结果集是以其他方式生成的(如通过
DatabaseMetaData
方法),则此方法可能返回
null
。
-
-
返回:
-
生成此
ResultSet
对象的
Statment
对象;如果结果集是以其他方法生成的,则返回
null
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
-
1.2
getObject
Object getObject(int columnIndex,
Map<String,Class<?>> map)
throws SQLException
-
以 Java 编程语言中
Object
的形式获取此
ResultSet
对象的当前行中指定列的值。如果值为 SQL
NULL
,则驱动程序返回一个 Java
null
。此方法使用给定的
Map
对象作为正在获取的 SQL 结构化或独特类型的自定义映射关系。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
map
- 一个
java.util.Map
对象,包含从 SQL 类型名称到 Java 编程语言中类的映射关系
返回:
-
表示 SQL 值的 Java 编程语言中的
Object
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
getRef
Ref getRef(int columnIndex)
throws SQLException
-
以 Java 编程语言中
Ref
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
表示 SQL
REF
值的
Ref
对象
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
getBlob
Blob getBlob(int columnIndex)
throws SQLException
-
以 Java 编程语言中
Blob
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
表示指定列中的 SQL
BLOB
值的
BLOB
对象
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
getClob
Clob getClob(int columnIndex)
throws SQLException
-
以 Java 编程语言中
Clob
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
表示指定列中的 SQL
Clob
值的
Clob
对象
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
getArray
Array getArray(int columnIndex)
throws SQLException
-
以 Java 编程语言中
Array
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
表示指定列中的 SQL
Array
值的
Array
对象
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
getObject
Object getObject(String columnLabel,
Map<String,Class<?>> map)
throws SQLException
-
以 Java 编程语言中
Object
的形式获取此
ResultSet
对象的当前行中指定列的值。如果值为 SQL
NULL
,则驱动程序返回一个 Java
null
。此方法使用指定的
Map
对象自定义映射关系(如果合适)。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
map
- 包含从 SQL 类型名称到 Java 编程语言中类的映射关系的
java.util.Map
对象
返回:
-
表示指定列中的 SQL 值的
Object
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
getRef
Ref getRef(String columnLabel)
throws SQLException
-
以 Java 编程语言中
Ref
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
表示指定列中 SQL
Ref
值的
Ref
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
getBlob
Blob getBlob(String columnLabel)
throws SQLException
-
以 Java 编程语言中
Blob
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
表示指定列中 SQL
Blob
值的
Blob
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
getClob
Clob getClob(String columnLabel)
throws SQLException
-
以 Java 编程语言中
Clob
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
表示指定列中 SQL
CLOB
值的
Clob
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
getArray
Array getArray(String columnLabel)
throws SQLException
-
以 Java 编程语言中
Array
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
表示指定列中 SQL
ARRAY
值的
ARRAY
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.2
getDate
Date getDate(int columnIndex,
Calendar cal)
throws SQLException
-
以 Java 编程语言中
java.sql.Date
对象的形式获取此
ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造日期的适当毫秒值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
cal
- 在构造日期时使用的
java.util.Calendar
对象
返回:
-
java.sql.Date
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
-
1.2
getDate
Date getDate(String columnLabel,
Calendar cal)
throws SQLException
-
以 Java 编程语言中
java.sql.Date
对象的形式获取此
ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造日期的适当毫秒值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
cal
- 在构造日期时使用的
java.util.Calendar
对象
返回:
-
java.sql.Date
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
-
1.2
getTime
Time getTime(int columnIndex,
Calendar cal)
throws SQLException
-
以 Java 编程语言中
java.sql.Time
对象的形式获取此
ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造时间的适当毫秒值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
cal
- 在构造时间时使用的
java.util.Calendar
对象
返回:
-
java.sql.Time
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
-
1.2
getTime
Time getTime(String columnLabel,
Calendar cal)
throws SQLException
-
以 Java 编程语言中
java.sql.Time
对象的形式获取此
ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造时间的适当毫秒值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
cal
- 在构造时间时使用的
java.util.Calendar
对象
返回:
-
java.sql.Time
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
-
1.2
getTimestamp
Timestamp getTimestamp(int columnIndex,
Calendar cal)
throws SQLException
-
以 Java 编程语言中
java.sql.Timestamp
对象的形式获取此
ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造时间戳的适当毫秒值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
cal
- 在构造时间戳时使用的
java.util.Calendar
对象
返回:
-
java.sql.Timestamp
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
-
1.2
getTimestamp
Timestamp getTimestamp(String columnLabel,
Calendar cal)
throws SQLException
-
以 Java 编程语言中
java.sql.Timestamp
对象的形式获取此
ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造时间戳的适当毫秒值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
cal
- 在构造日期时使用的
java.util.Calendar
对象
返回:
-
java.sql.Timestamp
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
-
1.2
getURL
URL getURL(int columnIndex)
throws SQLException
-
以 Java 编程语言中
java.net.URL
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 索引,其中第一个列是 1、第二个列是 2,……
返回:
-
java.net.URL
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法或 URL 是错误的
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.4
getURL
URL getURL(String columnLabel)
throws SQLException
-
以 Java 编程语言中
java.net.URL
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
java.net.URL
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法,或者 URL 是错误的
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.4
updateRef
void updateRef(int columnIndex,
Ref x)
throws SQLException
-
用
java.sql.Ref
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.4
updateRef
void updateRef(String columnLabel,
Ref x)
throws SQLException
-
用
java.sql.Ref
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.4
updateBlob
void updateBlob(int columnIndex,
Blob x)
throws SQLException
-
用
java.sql.Blob
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.4
updateBlob
void updateBlob(String columnLabel,
Blob x)
throws SQLException
-
用
java.sql.Blob
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.4
updateClob
void updateClob(int columnIndex,
Clob x)
throws SQLException
-
用
java.sql.Clob
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.4
updateClob
void updateClob(String columnLabel,
Clob x)
throws SQLException
-
用
java.sql.Clob
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.4
updateArray
void updateArray(int columnIndex,
Array x)
throws SQLException
-
用
java.sql.Array
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.4
updateArray
void updateArray(String columnLabel,
Array x)
throws SQLException
-
用
java.sql.Array
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.4
getRowId
RowId getRowId(int columnIndex)
throws SQLException
-
以 Java 编程语言中
java.sql.RowId
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果该值为 SQL
NULL
,则返回值为
null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
getRowId
RowId getRowId(String columnLabel)
throws SQLException
-
以 Java 编程语言中
java.sql.RowId
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果该值为 SQL
NULL
,则返回值为
null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateRowId
void updateRowId(int columnIndex,
RowId x)
throws SQLException
-
用
RowId
值更新指定列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateRowId
void updateRowId(String columnLabel,
RowId x)
throws SQLException
-
用
RowId
值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
getHoldability
int getHoldability()
throws SQLException
-
获取此
ResultSet
对象的可保存性
-
-
返回:
-
ResultSet.HOLD_CURSORS_OVER_COMMIT
或
ResultSet.CLOSE_CURSORS_AT_COMMIT
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
-
1.6
isClosed
boolean isClosed()
throws SQLException
-
获取此
ResultSet
对象是否已关闭。如果已经在
ResultSet
上调用了 close 方法,或者
ResultSet
自动关闭,则
ResultSet
已关闭。
-
-
返回:
-
如果此
ResultSet
对象已关闭,则返回 true;如果它仍然是打开的,则返回 false
抛出:
-
SQLException
- 如果发生数据库访问错误
从以下版本开始:
-
1.6
updateNString
void updateNString(int columnIndex,
String nString)
throws SQLException
-
用
String
值更新指定的列。更新
NCHAR
、
NVARCHAR
和
LONGNVARCHAR
列时使用该方法。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
nString
- 要更新的列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果驱动程序不支持国家字符集 (national character set);如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;结果集并发性为
CONCUR_READ_ONLY
或发生数据库访问错误
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateNString
void updateNString(String columnLabel,
String nString)
throws SQLException
-
用
String
值更新指定的列。更新
NCHAR
、
NVARCHAR
和
LONGNVARCHAR
列时使用该方法。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
nString
- 要更新的列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;结果集并发性为
CONCUR_READ_ONLY
或发生数据库访问错误
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateNClob
void updateNClob(int columnIndex,
NClob nClob)
throws SQLException
-
用
java.sql.NClob
值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
nClob
- 要更新的列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;发生数据库访问错误或结果集并发性为
CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateNClob
void updateNClob(String columnLabel,
NClob nClob)
throws SQLException
-
用
java.sql.NClob
值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
nClob
- 要更新的列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;发生数据库访问错误或结果集并发性为
CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
getNClob
NClob getNClob(int columnIndex)
throws SQLException
-
以 Java 编程语言中
NClob
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
表示指定列中 SQL
NCLOB
值的
NClob
对象
抛出:
-
SQLException
- 如果 columnIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法或发生数据库访问错误
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
getNClob
NClob getNClob(String columnLabel)
throws SQLException
-
以 Java 编程语言中
NClob
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
表示指定列中 SQL
NCLOB
值的
NClob
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法或发生数据库访问错误
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
getSQLXML
SQLXML getSQLXML(int columnIndex)
throws SQLException
-
以 Java 编程语言中
java.sql.SQLXML
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
一个映射
SQL XML
值的
SQLXML
对象
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
getSQLXML
SQLXML getSQLXML(String columnLabel)
throws SQLException
-
以 Java 编程语言中
java.sql.SQLXML
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
一个映射
SQL XML
值的
SQLXML
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateSQLXML
void updateSQLXML(int columnIndex,
SQLXML xmlObject)
throws SQLException
-
用
java.sql.SQLXML
值更新指定列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
xmlObject
- 要更新的列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;在已关闭的结果集上调用此方法;没有为
SQLXML
对象关闭
java.xml.transform.Result
、
Writer
或
OutputStream
;如果在处理 XML 值的过程中发生错误或结果集并发性为
CONCUR_READ_ONLY
。该异常的
getCause
方法可以提供更详细的异常信息,例如,如果该流不包含有效的 XML。
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateSQLXML
void updateSQLXML(String columnLabel,
SQLXML xmlObject)
throws SQLException
-
用
java.sql.SQLXML
值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
xmlObject
- 列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;在已关闭的结果集上调用此方法;没有为
SQLXML
对象关闭
java.xml.transform.Result
、
Writer
或
OutputStream
;如果在处理 XML 值的过程中发生错误或结果集并发性为
CONCUR_READ_ONLY
。该异常的
getCause
方法可能提供更详细的异常信息,例如,如果该流不包含有效的 XML。
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
getNString
String getNString(int columnIndex)
throws SQLException
-
以 Java 编程语言中
String
的形式获取此
ResultSet
对象的当前行中指定列的值。访问
NCHAR
、
NVARCHAR
和
LONGNVARCHAR
列时可使用此方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果该值为 SQL
NULL
,则返回值为
null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
getNString
String getNString(String columnLabel)
throws SQLException
-
以 Java 编程语言中
String
的形式获取此
ResultSet
对象的当前行中指定列的值。访问
NCHAR
、
NVARCHAR
和
LONGNVARCHAR
列时可使用此方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果该值为 SQL
NULL
,则返回值为
null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
getNCharacterStream
Reader getNCharacterStream(int columnIndex)
throws SQLException
-
以
java.io.Reader
对象的形式获取此
ResultSet
对象的当前行中指定列的值。访问
NCHAR
、
NVARCHAR
和
LONGNVARCHAR
列时可使用此方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
包含该列值的
java.io.Reader
对象;如果该值为 SQL
NULL
,则返回 Java 编程语言中的值
null
。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
getNCharacterStream
Reader getNCharacterStream(String columnLabel)
throws SQLException
-
以
java.io.Reader
对象的形式获取此
ResultSet
对象的当前行中指定列的值。访问
NCHAR
、
NVARCHAR
和
LONGNVARCHAR
列时可使用此方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
包含该列值的
java.io.Reader
对象;如果该值为 SQL
NULL
,则返回 Java 编程语言中的值
null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateNCharacterStream
void updateNCharacterStream(int columnIndex,
Reader x,
long length)
throws SQLException
-
用字符流值更新指定的列,该值将具有指定的字节数。驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。更新
NCHAR
、
NVARCHAR
和
LONGNVARCHAR
列时可使用此方法。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
-
length
- 流长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateNCharacterStream
void updateNCharacterStream(String columnLabel,
Reader reader,
long length)
throws SQLException
-
用字符流值更新指定的列,该值将具有指定的字节数。驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。更新
NCHAR
、
NVARCHAR
和
LONGNVARCHAR
列时可使用此方法。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
reader
- 包含新列值的
java.io.Reader
对象
-
length
- 流长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateAsciiStream
void updateAsciiStream(int columnIndex,
InputStream x,
long length)
throws SQLException
-
用 ascii 流值更新指定的列,该值将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
-
length
- 流长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateBinaryStream
void updateBinaryStream(int columnIndex,
InputStream x,
long length)
throws SQLException
-
用二进制流值更新指定的列,该值将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
-
length
- 流长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateCharacterStream
void updateCharacterStream(int columnIndex,
Reader x,
long length)
throws SQLException
-
用字符流值更新指定的列,该值将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
-
length
- 流长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateAsciiStream
void updateAsciiStream(String columnLabel,
InputStream x,
long length)
throws SQLException
-
用 ascii 流值更新指定的列,该值将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
-
length
- 流长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateBinaryStream
void updateBinaryStream(String columnLabel,
InputStream x,
long length)
throws SQLException
-
用二进制流值更新指定的列,该值将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
-
length
- 流长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateCharacterStream
void updateCharacterStream(String columnLabel,
Reader reader,
long length)
throws SQLException
-
用字符流值更新指定的列,该值将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
reader
- 包含新列值的
java.io.Reader
对象
-
length
- 流长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateBlob
void updateBlob(int columnIndex,
InputStream inputStream,
long length)
throws SQLException
-
使用给定输入流更新指定的列,该流将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
inputStream
- 包含用来设置参数值的数据的对象。
-
length
- 参数数据中的字节数。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateBlob
void updateBlob(String columnLabel,
InputStream inputStream,
long length)
throws SQLException
-
使用给定输入流更新指定列,该流将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
inputStream
- 包含用来设置参数值的数据的对象。
-
length
- 参数数据中的字节数。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateClob
void updateClob(int columnIndex,
Reader reader,
long length)
throws SQLException
-
使用给定的
Reader
对象更新指定列,该对象是给定的字符长度数目。在将一个非常大的 UNICODE 值输入到
LONGVARCHAR
参数时,通过
java.io.Reader
对象发送它可能更为实际。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
reader
- 包含用来设置参数值的数据的对象。
-
length
- 参数数据中的字符数。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateClob
void updateClob(String columnLabel,
Reader reader,
long length)
throws SQLException
-
使用给定的
Reader
对象更新指定列,该对象是给定的字符长度数目。在将一个非常大的 UNICODE 值输入到
LONGVARCHAR
参数时,通过
java.io.Reader
对象发送它可能更为实际。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
reader
- 包含用来设置参数值的数据的对象。
-
length
- 参数数据中的字符数。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateNClob
void updateNClob(int columnIndex,
Reader reader,
long length)
throws SQLException
-
使用给定的
Reader
对象更新指定的列,该对象是给定的字符长度数目。在将一个非常大的 UNICODE 值输入到
LONGVARCHAR
参数时,通过
java.io.Reader
对象发送它可能更为实际。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
reader
- 包含用来设置参数值的数据的对象。
-
length
- 参数数据中的字符数。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为
CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateNClob
void updateNClob(String columnLabel,
Reader reader,
long length)
throws SQLException
-
使用给定的
Reader
对象更新指定的列,该对象是给定的字符长度数目。在将一个非常大的 UNICODE 值输入到
LONGVARCHAR
参数时,通过
java.io.Reader
对象发送它可能更为实际。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
reader
- 包含用来设置参数值的数据的对象。
-
length
- 参数数据中的字符数。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为
CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateNCharacterStream
void updateNCharacterStream(int columnIndex,
Reader x)
throws SQLException
-
用字符流值更新指定的列。将根据需要从流中读取数据,一直读取到流末尾。驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。更新
NCHAR
、
NVARCHAR
和
LONGNVARCHAR
列时可使用此方法。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateNCharacterStream
是否更有效。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateNCharacterStream
void updateNCharacterStream(String columnLabel,
Reader reader)
throws SQLException
-
用字符流值更新指定的列。将根据需要从流中读取数据,一直读取到流末尾。驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。更新
NCHAR
、
NVARCHAR
和
LONGNVARCHAR
列时可使用此方法。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateNCharacterStream
是否更有效。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
reader
- 包含新列值的
java.io.Reader
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateAsciiStream
void updateAsciiStream(int columnIndex,
InputStream x)
throws SQLException
-
用 ascii 流值更新指定的列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateAsciiStream
是否更有效。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateBinaryStream
void updateBinaryStream(int columnIndex,
InputStream x)
throws SQLException
-
用二进制流值更新指定的列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateBinaryStream
是否更有效。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateCharacterStream
void updateCharacterStream(int columnIndex,
Reader x)
throws SQLException
-
用字符流值更新指定的列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateCharacterStream
是否更有效。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateAsciiStream
void updateAsciiStream(String columnLabel,
InputStream x)
throws SQLException
-
用 ascii 流值更新指定列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateAsciiStream
是否更有效。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateBinaryStream
void updateBinaryStream(String columnLabel,
InputStream x)
throws SQLException
-
用二进制流值更新指定列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateBinaryStream
是否更有效。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateCharacterStream
void updateCharacterStream(String columnLabel,
Reader reader)
throws SQLException
-
用字符流值更新指定列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateCharacterStream
是否更有效。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
reader
- 包含新列值的
java.io.Reader
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateBlob
void updateBlob(int columnIndex,
InputStream inputStream)
throws SQLException
-
使用给定输入流值更新指定列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateBlob
是否更有效。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
inputStream
- 包含用来设置参数值的数据的对象。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateBlob
void updateBlob(String columnLabel,
InputStream inputStream)
throws SQLException
-
使用给定输入流值更新指定列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateBlob
是否更有效。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
inputStream
- 包含用来设置参数值的数据的对象。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateClob
void updateClob(int columnIndex,
Reader reader)
throws SQLException
-
使用给定的
Reader
对象更新指定列。将根据需要从流中读取数据,一直读取到流末尾。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateClob
是否更有效。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
reader
- 包含用来设置参数值的数据的对象。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateClob
void updateClob(String columnLabel,
Reader reader)
throws SQLException
-
使用给定的
Reader
对象更新指定列。将根据需要从流中读取数据,一直读取到流末尾。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateClob
是否更有效。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
reader
- 包含用来设置参数值的数据的对象。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateNClob
void updateNClob(int columnIndex,
Reader reader)
throws SQLException
-
使用给定的
Reader
对象更新指定列。将根据需要从流中读取数据,一直读取到流末尾。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateNClob
是否更有效。
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
-
reader
- 包含用来设置参数值的数据的对象。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为
CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
updateNClob
void updateNClob(String columnLabel,
Reader reader)
throws SQLException
-
使用给定的
Reader
对象更新指定列。将根据需要从流中读取数据,一直读取到流末尾。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateNClob
是否更有效。
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
-
reader
- 包含用来设置参数值的数据的对象。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为
CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
-
1.6
java.sql
接口 ResultSet
-
所有超级接口:
- Wrapper
-
所有已知子接口:
- CachedRowSet, FilteredRowSet, JdbcRowSet, JoinRowSet, RowSet, SyncResolver, WebRowSet
public interface ResultSet extends Wrapper
表示数据库结果集的数据表,通常通过执行查询数据库的语句生成。
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 开始编号。为了获得最大的可移植性,应该按从左到右的顺序读取每行中的结果集列,每列只能读取一次。
对于获取方法,JDBC 驱动程序尝试将底层数据转换为在获取方法中指定的 Java 类型,并返回适当的 Java 值。JDBC 规范有一个表,显示允许的从 SQL 类型到ResultSet
获取方法所使用的 Java 类型的映射关系。
用作获取方法的输入的列名称不区分大小写。用列名称调用获取方法时,如果多个列具有这一名称,则返回第一个匹配列的值。在生成结果集的 SQL 查询中使用列名称时,将使用列名称选项。对于没有在查询中显式指定的列,最好使用列编号。如果使用列名称,则程序员应该注意保证名称唯一引用预期的列,这可以使用 SQLAS 子句确定。
在 JDBC 2.0 API(JavaTM 2 SDK 标准版 1.2 版)中,此接口添加了一组更新方法。关于获取方法参数的注释同样适用于更新方法的参数。
可以用以下两种方式使用更新方法:
- 更新当前行中的列值。在可滚动的
ResultSet
对象中,可以向前和向后移动光标,将其置于绝对位置或相对于当前行的位置。以下代码片段更新ResultSet
对象rs
第五行中的NAME
列,然后使用方法updateRow
更新导出rs
的数据源表。rs.absolute(5); // moves the cursor to the fifth row of rs rs.updateString("NAME", "AINSWORTH"); // updates the //
NAME
column of row 5 to beAINSWORTH
rs.updateRow(); // updates the row in the data source - 将列值插入到插入行中。可更新的
ResultSet
对象具有一个与其关联的特殊行,该行用作构建要插入的行的暂存区域 (staging area)。以下代码片段将光标移动到插入行,构建一个三列的行,并使用方法insertRow
将其插入到rs
和数据源表中。rs.moveToInsertRow(); // moves cursor to the insert row rs.updateString(1, "AINSWORTH"); // updates the // first column of the insert row to be
AINSWORTH
rs.updateInt(2,35); // updates the second column to be35
rs.updateBoolean(3, true); // updates the third column totrue
rs.insertRow(); rs.moveToCurrentRow();
当生成 ResultSet
对象的 Statement
对象关闭、重新执行或用来从多个结果的序列获取下一个结果时,ResultSet
对象将自动关闭。
ResultSet
对象的列的编号、类型和属性由 ResultSet.getMetaData
方法返回的ResulSetMetaData
对象提供。
-
另请参见:
- Statement.executeQuery(java.lang.String), Statement.getResultSet(), ResultSetMetaData
字段摘要 | |
---|---|
static int | CLOSE_CURSORS_AT_COMMIT 该常量指示提交当前事务时,具有此可保存性的打开的 ResultSet 对象将被关闭。 |
static int | CONCUR_READ_ONLY 该常量指示不可以更新的 ResultSet 对象的并发模式。 |
static int | CONCUR_UPDATABLE 该常量指示可以更新的 ResultSet 对象的并发模式。 |
static int | FETCH_FORWARD 该常量指示将按正向(即从第一个到最后一个)处理结果集中的行。 |
static int | FETCH_REVERSE 该常量指示将按逆向(即从最后一个到第一个)处理结果集中的行处理。 |
static int | FETCH_UNKNOWN 该常量指示结果集中的行的处理顺序未知。 |
static int | HOLD_CURSORS_OVER_COMMIT 该常量指示提交当前事务时,具有此可保存性的打开的 ResultSet 对象将保持开放。 |
static int | TYPE_FORWARD_ONLY 该常量指示光标只能向前移动的 ResultSet 对象的类型。 |
static int | TYPE_SCROLL_INSENSITIVE 该常量指示可滚动但通常不受 ResultSet 底层数据更改影响的 ResultSet 对象的类型。 |
static int | TYPE_SCROLL_SENSITIVE 该常量指示可滚动并且通常受 ResultSet 底层数据更改影响的 ResultSet 对象的类型。 |
方法摘要 | |
---|---|
boolean | absolute(int row) 将光标移动到此 ResultSet 对象的给定行编号。 |
void | afterLast() 将光标移动到此 ResultSet 对象的末尾,正好位于最后一行之后。 |
void | beforeFirst() 将光标移动到此 ResultSet 对象的开头,正好位于第一行之前。 |
void | cancelRowUpdates() 取消对 ResultSet 对象中的当前行所作的更新。 |
void | clearWarnings() 清除在此 ResultSet 对象上报告的所有警告。 |
void | close() 立即释放此 ResultSet 对象的数据库和 JDBC 资源,而不是等待该对象自动关闭时发生此操作。 |
void | deleteRow() 从此 ResultSet 对象和底层数据库中删除当前行。 |
int | findColumn(String columnLabel) 将给定的 ResultSet 列标签映射到其 ResultSet 列索引。 |
boolean | first() 将光标移动到此 ResultSet 对象的第一行。 |
Array | getArray(int columnIndex) 以 Java 编程语言中 Array 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Array | getArray(String columnLabel) 以 Java 编程语言中 Array 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
InputStream | getAsciiStream(int columnIndex) 以 ASCII 字符流的形式获取此 ResultSet 对象的当前行中指定列的值。 |
InputStream | getAsciiStream(String columnLabel) 以 ASCII 字符流的形式获取此 ResultSet 对象的当前行中指定列的值。 |
BigDecimal | getBigDecimal(int columnIndex) 以具有全精度的 java.math.BigDecimal 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
BigDecimal | getBigDecimal(int columnIndex, int scale) 已过时。 |
BigDecimal | getBigDecimal(String columnLabel) 以具有全精度的 java.math.BigDecimal 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
BigDecimal | getBigDecimal(String columnLabel, int scale) 已过时。 |
InputStream | getBinaryStream(int columnIndex) 以未解释字节的流的形式获取此 ResultSet 对象的当前行中指定列的值。 |
InputStream | getBinaryStream(String columnLabel) 以未解释的 byte 流的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Blob | getBlob(int columnIndex) 以 Java 编程语言中 Blob 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Blob | getBlob(String columnLabel) 以 Java 编程语言中 Blob 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
boolean | getBoolean(int columnIndex) 以 Java 编程语言中 boolean 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
boolean | getBoolean(String columnLabel) 以 Java 编程语言中 boolean 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
byte | getByte(int columnIndex) 以 Java 编程语言中 byte 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
byte | getByte(String columnLabel) 以 Java 编程语言中 byte 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
byte[] | getBytes(int columnIndex) 以 Java 编程语言中 byte 数组的形式获取此 ResultSet 对象的当前行中指定列的值。 |
byte[] | getBytes(String columnLabel) 以 Java 编程语言中 byte 数组的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Reader | getCharacterStream(int columnIndex) 以 java.io.Reader 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Reader | getCharacterStream(String columnLabel) 以 java.io.Reader 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Clob | getClob(int columnIndex) 以 Java 编程语言中 Clob 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Clob | getClob(String columnLabel) 以 Java 编程语言中 Clob 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
int | getConcurrency() 获取此 ResultSet 对象的并发模式。 |
String | getCursorName() 获取此 ResultSet 对象使用的 SQL 光标的名称。 |
Date | getDate(int columnIndex) 以 Java 编程语言中 java.sql.Date 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Date | getDate(int columnIndex, Calendar cal) 以 Java 编程语言中 java.sql.Date 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Date | getDate(String columnLabel) 以 Java 编程语言中的 java.sql.Date 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Date | getDate(String columnLabel, Calendar cal) 以 Java 编程语言中 java.sql.Date 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
double | getDouble(int columnIndex) 以 Java 编程语言中 double 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
double | getDouble(String columnLabel) 以 Java 编程语言中 double 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
int | getFetchDirection() 获取此 ResultSet 对象的获取方向。 |
int | getFetchSize() 获取此 ResultSet 对象的获取大小。 |
float | getFloat(int columnIndex) 以 Java 编程语言中 float 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
float | getFloat(String columnLabel) 以 Java 编程语言中 float 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
int | getHoldability() 获取此 ResultSet 对象的可保存性 |
int | getInt(int columnIndex) 以 Java 编程语言中 int 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
int | getInt(String columnLabel) 以 Java 编程语言中 int 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
long | getLong(int columnIndex) 以 Java 编程语言中 long 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
long | getLong(String columnLabel) 以 Java 编程语言中 long 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
ResultSetMetaData | getMetaData() 获取此 ResultSet 对象的列的编号、类型和属性。 |
Reader | getNCharacterStream(int columnIndex) 以 java.io.Reader 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Reader | getNCharacterStream(String columnLabel) 以 java.io.Reader 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
NClob | getNClob(int columnIndex) 以 Java 编程语言中 NClob 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
NClob | getNClob(String columnLabel) 以 Java 编程语言中 NClob 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
String | getNString(int columnIndex) 以 Java 编程语言中 String 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
String | getNString(String columnLabel) 以 Java 编程语言中 String 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Object | getObject(int columnIndex) 以 Java 编程语言中 Object 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Object | getObject(int columnIndex, Map<String,Class<?>> map) 以 Java 编程语言中 Object 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Object | getObject(String columnLabel) 以 Java 编程语言中 Object 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Object | getObject(String columnLabel, Map<String,Class<?>> map) 以 Java 编程语言中 Object 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Ref | getRef(int columnIndex) 以 Java 编程语言中 Ref 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Ref | getRef(String columnLabel) 以 Java 编程语言中 Ref 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
int | getRow() 获取当前行编号。 |
RowId | getRowId(int columnIndex) 以 Java 编程语言中 java.sql.RowId 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
RowId | getRowId(String columnLabel) 以 Java 编程语言中 java.sql.RowId 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
short | getShort(int columnIndex) 以 Java 编程语言中 short 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
short | getShort(String columnLabel) 以 Java 编程语言中 short 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
SQLXML | getSQLXML(int columnIndex) 以 Java 编程语言中 java.sql.SQLXML 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
SQLXML | getSQLXML(String columnLabel) 以 Java 编程语言中 java.sql.SQLXML 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Statement | getStatement() 获取生成此 ResultSet 对象的 Statement 对象。 |
String | getString(int columnIndex) 以 Java 编程语言中 String 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
String | getString(String columnLabel) 以 Java 编程语言中 String 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Time | getTime(int columnIndex) 以 Java 编程语言中 java.sql.Time 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Time | getTime(int columnIndex, Calendar cal) 以 Java 编程语言中 java.sql.Time 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Time | getTime(String columnLabel) 以 Java 编程语言中 java.sql.Time 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Time | getTime(String columnLabel, Calendar cal) 以 Java 编程语言中 java.sql.Time 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Timestamp | getTimestamp(int columnIndex) 以 Java 编程语言中 java.sql.Timestamp 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Timestamp | getTimestamp(int columnIndex, Calendar cal) 以 Java 编程语言中 java.sql.Timestamp 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Timestamp | getTimestamp(String columnLabel) 以 Java 编程语言中 java.sql.Timestamp 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Timestamp | getTimestamp(String columnLabel, Calendar cal) 以 Java 编程语言中 java.sql.Timestamp 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
int | getType() 获取此 ResultSet 对象的类型。 |
InputStream | getUnicodeStream(int columnIndex) 已过时。 使用 getCharacterStream 取代 getUnicodeStream |
InputStream | getUnicodeStream(String columnLabel) 已过时。 使用 getCharacterStream 代替 |
URL | getURL(int columnIndex) 以 Java 编程语言中 java.net.URL 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
URL | getURL(String columnLabel) 以 Java 编程语言中 java.net.URL 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
SQLWarning | getWarnings() 获取此 ResultSet 对象上的调用报告的第一个警告。 |
void | insertRow() 将插入行的内容插入到此 ResultSet 对象和数据库中。 |
boolean | isAfterLast() 获取光标是否位于此 ResultSet 对象的最后一行之后。 |
boolean | isBeforeFirst() 获取光标是否位于此 ResultSet 对象的第一行之前。 |
boolean | isClosed() 获取此 ResultSet 对象是否已关闭。 |
boolean | isFirst() 获取光标是否位于此 ResultSet 对象的第一行。 |
boolean | isLast() 获取光标是否位于此 ResultSet 对象的最后一行。 |
boolean | last() 将光标移动到此 ResultSet 对象的最后一行。 |
void | moveToCurrentRow() 将光标移动到记住的光标位置,通常为当前行。 |
void | moveToInsertRow() 将光标移动到插入行。 |
boolean | next() 将光标从当前位置向前移一行。 |
boolean | previous() 将光标移动到此 ResultSet 对象的上一行。 |
void | refreshRow() 用数据库中的最近值刷新当前行。 |
boolean | relative(int rows) 按相对行数(或正或负)移动光标。 |
boolean | rowDeleted() 获取是否已删除某行。 |
boolean | rowInserted() 获取当前行是否已有插入。 |
boolean | rowUpdated() 获取是否已更新当前行。 |
void | setFetchDirection(int direction) 设置此 ResultSet 对象中行的处理方向。 |
void | setFetchSize(int rows) 为 JDBC 驱动程序设置此 ResultSet 对象需要更多行时应该从数据库获取的行数。 |
void | updateArray(int columnIndex, Array x) 用 java.sql.Array 值更新指定列。 |
void | updateArray(String columnLabel, Array x) 用 java.sql.Array 值更新指定列。 |
void | updateAsciiStream(int columnIndex, InputStream x) 用 ascii 流值更新指定的列。 |
void | updateAsciiStream(int columnIndex, InputStream x, int length) 用 ascii 流值更新指定列,该列将具有指定字节数。 |
void | updateAsciiStream(int columnIndex, InputStream x, long length) 用 ascii 流值更新指定的列,该值将具有指定的字节数。 |
void | updateAsciiStream(String columnLabel, InputStream x) 用 ascii 流值更新指定列。 |
void | updateAsciiStream(String columnLabel, InputStream x, int length) 用 ascii 流值更新指定列,该列具有指定的字节数。 |
void | updateAsciiStream(String columnLabel, InputStream x, long length) 用 ascii 流值更新指定的列,该值将具有指定的字节数。 |
void | updateBigDecimal(int columnIndex, BigDecimal x) 用 java.math.BigDecimal 值更新指定列。 |
void | updateBigDecimal(String columnLabel, BigDecimal x) 用 java.sql.BigDecimal 值更新指定列。 |
void | updateBinaryStream(int columnIndex, InputStream x) 用二进制流值更新指定的列。 |
void | updateBinaryStream(int columnIndex, InputStream x, int length) 用二进制流值更新指定列,该列将具有指定字节数。 |
void | updateBinaryStream(int columnIndex, InputStream x, long length) 用二进制流值更新指定的列,该值将具有指定的字节数。 |
void | updateBinaryStream(String columnLabel, InputStream x) 用二进制流值更新指定列。 |
void | updateBinaryStream(String columnLabel, InputStream x, int length) 用二进制流值更新指定列,该列具有指定的字节数。 |
void | updateBinaryStream(String columnLabel, InputStream x, long length) 用二进制流值更新指定的列,该值将具有指定的字节数。 |
void | updateBlob(int columnIndex, Blob x) 用 java.sql.Blob 值更新指定列。 |
void | updateBlob(int columnIndex, InputStream inputStream) 使用给定输入流值更新指定列。 |
void | updateBlob(int columnIndex, InputStream inputStream, long length) 使用给定输入流更新指定的列,该流将具有指定的字节数。 |
void | updateBlob(String columnLabel, Blob x) 用 java.sql.Blob 值更新指定列。 |
void | updateBlob(String columnLabel, InputStream inputStream) 使用给定输入流值更新指定列。 |
void | updateBlob(String columnLabel, InputStream inputStream, long length) 使用给定输入流更新指定列,该流将具有指定的字节数。 |
void | updateBoolean(int columnIndex, boolean x) 用 boolean 值更新指定列。 |
void | updateBoolean(String columnLabel, boolean x) 用 boolean 值更新指定列。 |
void | updateByte(int columnIndex, byte x) 用 byte 值更新指定列。 |
void | updateByte(String columnLabel, byte x) 用 byte 值更新指定列。 |
void | updateBytes(int columnIndex, byte[] x) 用 byte 数组值更新指定列。 |
void | updateBytes(String columnLabel, byte[] x) 用字节数组值更新指定列。 |
void | updateCharacterStream(int columnIndex, Reader x) 用字符流值更新指定的列。 |
void | updateCharacterStream(int columnIndex, Reader x, int length) 用字符流值更新指定列,该列将具有指定字节数。 |
void | updateCharacterStream(int columnIndex, Reader x, long length) 用字符流值更新指定的列,该值将具有指定的字节数。 |
void | updateCharacterStream(String columnLabel, Reader reader) 用字符流值更新指定列。 |
void | updateCharacterStream(String columnLabel, Reader reader, int length) 用字符流值更新指定列,该列具有指定的字节数。 |
void | updateCharacterStream(String columnLabel, Reader reader, long length) 用字符流值更新指定的列,该值将具有指定的字节数。 |
void | updateClob(int columnIndex, Clob x) 用 java.sql.Clob 值更新指定列。 |
void | updateClob(int columnIndex, Reader reader) 使用给定的 Reader 对象更新指定列。 |
void | updateClob(int columnIndex, Reader reader, long length) 使用给定的 Reader 对象更新指定列,该对象是给定的字符长度数目。 |
void | updateClob(String columnLabel, Clob x) 用 java.sql.Clob 值更新指定列。 |
void | updateClob(String columnLabel, Reader reader) 使用给定的 Reader 对象更新指定列。 |
void | updateClob(String columnLabel, Reader reader, long length) 使用给定的 Reader 对象更新指定列,该对象是给定的字符长度数目。 |
void | updateDate(int columnIndex, Date x) 用 java.sql.Date 值更新指定列。 |
void | updateDate(String columnLabel, Date x) 用 java.sql.Date 值更新指定列。 |
void | updateDouble(int columnIndex, double x) 用 double 值更新指定列。 |
void | updateDouble(String columnLabel, double x) 用 double 值更新指定列。 |
void | updateFloat(int columnIndex, float x) 用 float 值更新指定列。 |
void | updateFloat(String columnLabel, float x) 用 float 值更新指定列。 |
void | updateInt(int columnIndex, int x) 用 int 值更新指定列。 |
void | updateInt(String columnLabel, int x) 用 int 值更新指定列。 |
void | updateLong(int columnIndex, long x) 用 long 值更新指定列。 |
void | updateLong(String columnLabel, long x) 用 long 值更新指定列。 |
void | updateNCharacterStream(int columnIndex, Reader x) 用字符流值更新指定的列。 |
void | updateNCharacterStream(int columnIndex, Reader x, long length) 用字符流值更新指定的列,该值将具有指定的字节数。 |
void | updateNCharacterStream(String columnLabel, Reader reader) 用字符流值更新指定的列。 |
void | updateNCharacterStream(String columnLabel, Reader reader, long length) 用字符流值更新指定的列,该值将具有指定的字节数。 |
void | updateNClob(int columnIndex, NClob nClob) 用 java.sql.NClob 值更新指定的列。 |
void | updateNClob(int columnIndex, Reader reader) 使用给定的 Reader 对象更新指定列。 |
void | updateNClob(int columnIndex, Reader reader, long length) 使用给定的 Reader 对象更新指定的列,该对象是给定的字符长度数目。 |
void | updateNClob(String columnLabel, NClob nClob) 用 java.sql.NClob 值更新指定的列。 |
void | updateNClob(String columnLabel, Reader reader) 使用给定的 Reader 对象更新指定列。 |
void | updateNClob(String columnLabel, Reader reader, long length) 使用给定的 Reader 对象更新指定的列,该对象是给定的字符长度数目。 |
void | updateNString(int columnIndex, String nString) 用 String 值更新指定的列。 |
void | updateNString(String columnLabel, String nString) 用 String 值更新指定的列。 |
void | updateNull(int columnIndex) 用 null 值更新指定列。 |
void | updateNull(String columnLabel) 用 null 值更新指定列。 |
void | updateObject(int columnIndex, Object x) 用 Object 值更新指定列。 |
void | updateObject(int columnIndex, Object x, int scaleOrLength) 用 Object 值更新指定列。 |
void | updateObject(String columnLabel, Object x) 用 Object 值更新指定列。 |
void | updateObject(String columnLabel, Object x, int scaleOrLength) 用 Object 值更新指定列。 |
void | updateRef(int columnIndex, Ref x) 用 java.sql.Ref 值更新指定列。 |
void | updateRef(String columnLabel, Ref x) 用 java.sql.Ref 值更新指定列。 |
void | updateRow() 用此 ResultSet 对象的当前行的新内容更新底层数据库。 |
void | updateRowId(int columnIndex, RowId x) 用 RowId 值更新指定列。 |
void | updateRowId(String columnLabel, RowId x) 用 RowId 值更新指定的列。 |
void | updateShort(int columnIndex, short x) 用 short 值更新指定列。 |
void | updateShort(String columnLabel, short x) 用 short 值更新指定列。 |
void | updateSQLXML(int columnIndex, SQLXML xmlObject) 用 java.sql.SQLXML 值更新指定列。 |
void | updateSQLXML(String columnLabel, SQLXML xmlObject) 用 java.sql.SQLXML 值更新指定的列。 |
void | updateString(int columnIndex, String x) 用 String 值更新指定列。 |
void | updateString(String columnLabel, String x) 用 String 值更新指定列。 |
void | updateTime(int columnIndex, Time x) 用 java.sql.Time 值更新指定列。 |
void | updateTime(String columnLabel, Time x) 用 java.sql.Time 值更新指定列。 |
void | updateTimestamp(int columnIndex, Timestamp x) 用 java.sql.Timestamp 值更新指定列。 |
void | updateTimestamp(String columnLabel, Timestamp x) 用 java.sql.Timestamp 值更新指定列。 |
boolean | wasNull() 报告最后一个读取的列是否具有值 SQL NULL 。 |
从接口 java.sql.Wrapper 继承的方法 |
---|
isWrapperFor, unwrap |
字段详细信息 |
---|
FETCH_FORWARD
static final int FETCH_FORWARD
-
该常量指示将按正向(即从第一个到最后一个)处理结果集中的行。
setFetchDirection
方法将此常量用作驱动程序的提示,驱动程序可能忽略它。-
从以下版本开始:
- 1.2 另请参见:
- 常量字段值
FETCH_REVERSE
static final int FETCH_REVERSE
-
该常量指示将按逆向(即从最后一个到第一个)处理结果集中的行处理。
setFetchDirection
方法将此常量用作驱动程序的提示,驱动程序可能忽略它。-
从以下版本开始:
- 1.2 另请参见:
- 常量字段值
FETCH_UNKNOWN
static final int FETCH_UNKNOWN
-
该常量指示结果集中的行的处理顺序未知。
setFetchDirection
方法将此常量用作驱动程序的提示,驱动程序可能忽略它。-
另请参见:
- 常量字段值
TYPE_FORWARD_ONLY
static final int TYPE_FORWARD_ONLY
-
该常量指示光标只能向前移动的
ResultSet
对象的类型。-
从以下版本开始:
- 1.2 另请参见:
- 常量字段值
TYPE_SCROLL_INSENSITIVE
static final int TYPE_SCROLL_INSENSITIVE
-
该常量指示可滚动但通常不受
ResultSet
底层数据更改影响的ResultSet
对象的类型。-
从以下版本开始:
- 1.2 另请参见:
- 常量字段值
TYPE_SCROLL_SENSITIVE
static final int TYPE_SCROLL_SENSITIVE
-
该常量指示可滚动并且通常受
ResultSet
底层数据更改影响的ResultSet
对象的类型。-
从以下版本开始:
- 1.2 另请参见:
- 常量字段值
CONCUR_READ_ONLY
static final int CONCUR_READ_ONLY
-
该常量指示不可以更新的
ResultSet
对象的并发模式。-
从以下版本开始:
- 1.2 另请参见:
- 常量字段值
CONCUR_UPDATABLE
static final int CONCUR_UPDATABLE
-
该常量指示可以更新的
ResultSet
对象的并发模式。-
从以下版本开始:
- 1.2 另请参见:
- 常量字段值
HOLD_CURSORS_OVER_COMMIT
static final int HOLD_CURSORS_OVER_COMMIT
-
该常量指示提交当前事务时,具有此可保存性的打开的
ResultSet
对象将保持开放。-
从以下版本开始:
- 1.4 另请参见:
- 常量字段值
CLOSE_CURSORS_AT_COMMIT
static final int CLOSE_CURSORS_AT_COMMIT
-
该常量指示提交当前事务时,具有此可保存性的打开的
ResultSet
对象将被关闭。-
从以下版本开始:
- 1.4 另请参见:
- 常量字段值
方法详细信息 |
---|
next
boolean next() throws SQLException
-
将光标从当前位置向前移一行。
ResultSet
光标最初位于第一行之前;第一次调用next
方法使第一行成为当前行;第二次调用使第二行成为当前行,依此类推。当调用
next
方法返回false
时,光标位于最后一行的后面。任何要求当前行的ResultSet
方法调用将导致抛出SQLException
。如果结果集的类型是TYPE_FORWARD_ONLY
,则其 JDBC 驱动程序实现对后续next
调用是返回false
还是抛出SQLException
将由供应商指定。如果对当前行开启了输入流,则调用
next
方法将隐式关闭它。读取新行时,将清除ResultSet
对象的警告链。 -
-
-
返回:
-
如果新的当前行有效,则返回
true
;如果不存在下一行,则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
如果新的当前行有效,则返回
close
void close() throws SQLException
-
立即释放此
ResultSet
对象的数据库和 JDBC 资源,而不是等待该对象自动关闭时发生此操作。关闭
ResultSet
对象不会关闭ResultSet
创建的Blob
、Clob
或NClob
对象。Blob
、Clob
或NClob
对象至少在创建它们的事务期间持续有效,除非调用了其free
方法。当关闭
ResultSet
时,所有通过调用getMetaData
方法创建的ResultSetMetaData
实例都可以访问。注:当生成
ResultSet
对象的Statement
对象关闭、重新执行或用来从多个结果的序列获取下一个结果时,该Statement
对象将自动关闭ResultSet
对象。在已关闭的
ResultSet
对象上调用close
方法是无操作 (no-op)。 -
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误
-
wasNull
boolean wasNull() throws SQLException
-
报告最后一个读取的列是否具有值 SQL
NULL
。注意,必须首先对列调用一个获取方法尝试读取其值,然后调用wasNull
方法查看读取的值是否为 SQLNULL
。 -
-
-
返回:
-
如果最后一个读取的列值为 SQL
NULL
,则返回true
;否则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
如果最后一个读取的列值为 SQL
getString
String getString(int columnIndex) throws SQLException
-
以 Java 编程语言中
String
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getBoolean
boolean getBoolean(int columnIndex) throws SQLException
-
以 Java 编程语言中
boolean
的形式获取此ResultSet
对象的当前行中指定列的值。如果指定列的数据类型为 CHAR 或 VARCHAR 且包含 "0",或者数据类型为 BIT、TINYINT、SMALLINT、INTEGER 或 BIGINT 且包含 0,则返回
false
值。如果指定列的数据类型为 CHAR 或 VARCHAR 且包含 "1",或者数据类型为 BIT、TINYINT、SMALLINT、INTEGER 或 BIGINT 且包含 1,则返回true
值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为false
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getByte
byte getByte(int columnIndex) throws SQLException
-
以 Java 编程语言中
byte
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getShort
short getShort(int columnIndex) throws SQLException
-
以 Java 编程语言中
short
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getInt
int getInt(int columnIndex) throws SQLException
-
以 Java 编程语言中
int
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getLong
long getLong(int columnIndex) throws SQLException
-
以 Java 编程语言中
long
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getFloat
float getFloat(int columnIndex) throws SQLException
-
以 Java 编程语言中
float
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getDouble
double getDouble(int columnIndex) throws SQLException
-
以 Java 编程语言中
double
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getBigDecimal
BigDecimal getBigDecimal(int columnIndex, int scale) throws SQLException
- 已过时。
-
以 Java 编程语言中
java.sql.BigDecimal
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
scale
- 小数点右边的位数
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
-
getBytes
byte[] getBytes(int columnIndex) throws SQLException
-
以 Java 编程语言中
byte
数组的形式获取此ResultSet
对象的当前行中指定列的值。这些字节表示驱动程序返回的原始值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getDate
Date getDate(int columnIndex) throws SQLException
-
以 Java 编程语言中
java.sql.Date
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getTime
Time getTime(int columnIndex) throws SQLException
-
以 Java 编程语言中
java.sql.Time
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getTimestamp
Timestamp getTimestamp(int columnIndex) throws SQLException
-
以 Java 编程语言中
java.sql.Timestamp
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getAsciiStream
InputStream getAsciiStream(int columnIndex) throws SQLException
-
以 ASCII 字符流的形式获取此
ResultSet
对象的当前行中指定列的值。然后,可以按块从流中读取值。此方法尤其适合于获取很大的 LONGVARCHAR 值。JDBC 驱动程序将执行从数据库格式到 ASCII 的任何必要转换。注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用
InputStream.available
方法时,不管是否存在可用数据,流都可能返回0
。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
以一字节 ASCII 字符流的形式返回传递数据库列值的 Java 输入流;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getUnicodeStream
InputStream getUnicodeStream(int columnIndex) throws SQLException
-
已过时。
使用
getCharacterStream
取代getUnicodeStream
-
以两字节 3 字符流的形式获取此
ResultSet
对象的当前行中指定列的值。第一个字节是高字节;第二个字节是低字节。然后,可以按块从流中读取值。此方法尤其适合于获取很大的LONGVARCHAR
值。JDBC 驱动程序将执行从数据库格式到 Unicode 的任何必要转换。注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用
InputStream.available
方法时,不管是否存在可用数据,流都可能返回0
。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
以两字节 Unicode 字符流的形式返回传递数据库列值的 Java 输入流;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
-
getBinaryStream
InputStream getBinaryStream(int columnIndex) throws SQLException
-
以未解释字节的流的形式获取此
ResultSet
对象的当前行中指定列的值。然后,可以按块从流中读取值。此方法尤其适合于获取很大的LONGVARBINARY
值。注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用
InputStream.available
方法时,不管是否存在可用数据,流都可能返回0
。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
以未解释字节的流的形式返回传递数据库列值的 Java 输入流;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getString
String getString(String columnLabel) throws SQLException
-
以 Java 编程语言中
String
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getBoolean
boolean getBoolean(String columnLabel) throws SQLException
-
以 Java 编程语言中
boolean
的形式获取此ResultSet
对象的当前行中指定列的值。如果指定列的数据类型为 CHAR 或 VARCHAR 且包含 "0",或者数据类型为 BIT、TINYINT、SMALLINT、INTEGER 或 BIGINT 且包含 0,则返回
false
值。如果指定列的数据类型为 CHAR 或 VARCHAR 且包含 "1",或者数据类型为 BIT、TINYINT、SMALLINT、INTEGER 或 BIGINT 且包含 1,则返回true
值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为false
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getByte
byte getByte(String columnLabel) throws SQLException
-
以 Java 编程语言中
byte
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getShort
short getShort(String columnLabel) throws SQLException
-
以 Java 编程语言中
short
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getInt
int getInt(String columnLabel) throws SQLException
-
以 Java 编程语言中
int
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getLong
long getLong(String columnLabel) throws SQLException
-
以 Java 编程语言中
long
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getFloat
float getFloat(String columnLabel) throws SQLException
-
以 Java 编程语言中
float
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getDouble
double getDouble(String columnLabel) throws SQLException
-
以 Java 编程语言中
double
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getBigDecimal
BigDecimal getBigDecimal(String columnLabel, int scale) throws SQLException
- 已过时。
-
以 Java 编程语言中
java.math.BigDecimal
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
scale
- 小数点右边的位数
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
-
getBytes
byte[] getBytes(String columnLabel) throws SQLException
-
以 Java 编程语言中
byte
数组的形式获取此ResultSet
对象的当前行中指定列的值。这些字节表示驱动程序返回的原始值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getDate
Date getDate(String columnLabel) throws SQLException
-
以 Java 编程语言中的
java.sql.Date
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getTime
Time getTime(String columnLabel) throws SQLException
-
以 Java 编程语言中
java.sql.Time
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getTimestamp
Timestamp getTimestamp(String columnLabel) throws SQLException
-
以 Java 编程语言中
java.sql.Timestamp
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getAsciiStream
InputStream getAsciiStream(String columnLabel) throws SQLException
-
以 ASCII 字符流的形式获取此
ResultSet
对象的当前行中指定列的值。然后,可以按块从流中读取值。此方法尤其适合于获取很大的LONGVARCHAR
值。JDBC 驱动程序将执行从数据库格式到 ASCII 的任何必要转换。注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用
available
方法时,不管是否存在可用数据,流都可能返回0
。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
以一字节 ASCII 字符流的形式返回传递数据库列值的 Java 输入流。如果值为 SQL
NULL
,则返回值为null
。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getUnicodeStream
InputStream getUnicodeStream(String columnLabel) throws SQLException
-
已过时。
使用
getCharacterStream
代替 -
以两字节 Unicode 字符流的形式获取此
ResultSet
对象的当前行中指定列的值。第一个字节是高字节;第二个字节是低字节。然后,可以按块从流中读取值。此方法尤其适合于获取很大的LONGVARCHAR
值。采用 JDBC 技术的驱动程序将执行从数据库格式到 Unicode 的任何必要转换。注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用
InputStream.available
方法时,不管是否存在可用数据,流都可能返回0
。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
以两字节 Unicode 字符流的形式返回传递数据库列值的 Java 输入流。如果值为 SQL
NULL
,则返回值为null
。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
-
getBinaryStream
InputStream getBinaryStream(String columnLabel) throws SQLException
-
以未解释的
byte
流的形式获取此ResultSet
对象的当前行中指定列的值。然后,可以按块从流中读取该值。此方法尤其适合于获取很大的LONGVARBINARY
值。注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用
available
方法时,不管是否存在可用数据,流都可能返回0
。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
以未解释字节流的形式返回传递数据库列值的 Java 输入流;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getWarnings
SQLWarning getWarnings() throws SQLException
-
获取此
ResultSet
对象上的调用报告的第一个警告。此ResultSet
对象上的后续警告会被链接到此方法返回的SQLWarning
对象。每次读取新行时,都会自动清除警告链。不可以在已经关闭的
ResultSet
对象上调用此方法;这样做将导致抛出SQLException
。注:此警告链仅包含
ResultSet
方法产生的警告。Statement
方法(如读取 OUT 参数)产生的任何警告都将链接在Statement
对象上。 -
-
-
返回:
-
报告的第一个
SQLWarning
对象;如果不存在,则返回null
抛出:
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
报告的第一个
clearWarnings
void clearWarnings() throws SQLException
-
清除在此
ResultSet
对象上报告的所有警告。调用此方法后,在为此ResultSet
对象报告新的警告之前,getWarnings
方法将返回null
。 -
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getCursorName
String getCursorName() throws SQLException
-
获取此
ResultSet
对象使用的 SQL 光标的名称。在 SQL 中,通过指定的光标获取结果表。通过一个引用光标名称来定位的更新/删除语句,可以更新或删除结果集的当前行。为了确保光标具有支持更新的适当隔离级别,光标的
SELECT
语句的形式应该为SELECT FOR UPDATE
。如果省略FOR UPDATE
,则定位更新可能失败。JDBC API 通过提供
ResultSet
对象使用的 SQL 光标的名称支持此 SQL 功能。ResultSet
对象的当前行也是此 SQL 光标的当前行。 -
-
-
返回:
-
此
ResultSet
对象的光标的 SQL 名称
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
-
此
getMetaData
ResultSetMetaData getMetaData() throws SQLException
-
获取此
ResultSet
对象的列的编号、类型和属性。 -
-
-
返回:
-
此
ResultSet
对象的列的描述
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
此
getObject
Object getObject(int columnIndex) throws SQLException
-
以 Java 编程语言中
Object
的形式获取此ResultSet
对象的当前行中指定列的值。此方法将以 Java 对象的形式返回给定列的值。Java 对象的类型将为与该列的 SQL 类型相对应的默认 Java 对象类型,它遵守在 JDBC 规范中指定的内置类型的映射关系。如果值为 SQL
NULL
,则驱动程序返回一个 Javanull
。此方法还可用于读取特定于数据库的抽象数据类型。在 JDBC 2.0 API 中,可以扩展
getObject
方法的行为来实现 SQL 自定义类型的数据。如果
Connection.getTypeMap
不抛出SQLFeatureNotSupportedException
,则当列包含结构值或独特值时,此方法的行为类似于调用:getObject(columnIndex, this.getStatement().getConnection().getTypeMap())
。如果Connection.getTypeMap
抛出SQLFeatureNotSupportedException
,则结构值不受支持,独特值映射到 DISTINCT 类型的底层 SQL 类型确定的默认 Java 类。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
保存列值的
java.lang.Object
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getObject
Object getObject(String columnLabel) throws SQLException
-
以 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
int findColumn(String columnLabel) throws SQLException
-
将给定的
ResultSet
列标签映射到其ResultSet
列索引。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
- 给定列名称的列索引 抛出:
-
SQLException
- 如果ResultSet
对象不包含标记为columnLabel
的列,发生数据库访问错误或在已关闭的结果集上调用此方法
-
getCharacterStream
Reader getCharacterStream(int columnIndex) throws SQLException
-
以
java.io.Reader
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
包含列值的
java.io.Reader
对象;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
getCharacterStream
Reader getCharacterStream(String columnLabel) throws SQLException
-
以
java.io.Reader
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
包含列值的
java.io.Reader
对象;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
getBigDecimal
BigDecimal getBigDecimal(int columnIndex) throws SQLException
-
以具有全精度的
java.math.BigDecimal
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值(全精度);如果值为 SQL
NULL
,则返回值为 Java 编程语言中的null
。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
getBigDecimal
BigDecimal getBigDecimal(String columnLabel) throws SQLException
-
以具有全精度的
java.math.BigDecimal
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值(全精度);如果值为 SQL
NULL
,则返回值为 Java 编程语言中的null
。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
isBeforeFirst
boolean isBeforeFirst() throws SQLException
-
获取光标是否位于此
ResultSet
对象的第一行之前。注:对于带有
TYPE_FORWARD_ONLY
的结果集类型的ResultSet
,对isBeforeFirst
方法的支持是可选的 -
-
-
返回:
-
如果光标位于第一行之前,则返回
true
;如果光标位于任何其他位置或者结果集不包含任何行,则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
如果光标位于第一行之前,则返回
isAfterLast
boolean isAfterLast() throws SQLException
-
获取光标是否位于此
ResultSet
对象的最后一行之后。注:对于带有
TYPE_FORWARD_ONLY
的结果集类型的ResultSet
,对isAfterLast
方法的支持是可选的 -
-
-
返回:
-
如果光标位于最后一行之后,则返回
true
;如果光标位于任何其他位置或者结果集不包含任何行,则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
如果光标位于最后一行之后,则返回
isFirst
boolean isFirst() throws SQLException
-
获取光标是否位于此
ResultSet
对象的第一行。注:对于带有
TYPE_FORWARD_ONLY
的结果集类型的ResultSet
,对isFirst
方法的支持是可选的 -
-
-
返回:
-
如果光标位于第一行,则返回
true
;否则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
如果光标位于第一行,则返回
isLast
boolean isLast() throws SQLException
-
获取光标是否位于此
ResultSet
对象的最后一行。 注:调用isLast
方法可能开销很大,因为 JDBC 驱动程序可能需要再往后获取一行,以确定当前行是否为结果集中的最后一行。注:对于带有
TYPE_FORWARD_ONLY
的结果集类型的ResultSet
,对isLast
方法的支持是可选的 -
-
-
返回:
-
如果光标位于最后一行上,则返回
true
;否则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
如果光标位于最后一行上,则返回
beforeFirst
void beforeFirst() throws SQLException
-
将光标移动到此
ResultSet
对象的开头,正好位于第一行之前。如果结果集中不包含任何行,则此方法无效。 -
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
afterLast
void afterLast() throws SQLException
-
将光标移动到此
ResultSet
对象的末尾,正好位于最后一行之后。如果结果集中不包含任何行,则此方法无效。 -
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
first
boolean first() throws SQLException
-
将光标移动到此
ResultSet
对象的第一行。 -
-
-
返回:
-
如果光标位于有效行,则返回
true
;如果结果集中不存在任何行,则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
如果光标位于有效行,则返回
last
boolean last() throws SQLException
-
将光标移动到此
ResultSet
对象的最后一行。 -
-
-
返回:
-
如果光标位于有效行,则返回
true
;如果结果集中不存在任何行,则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
如果光标位于有效行,则返回
getRow
int getRow() throws SQLException
-
获取当前行编号。第一行为 1 号,第二行为 2 号,依此类推。
注:对于带有
TYPE_FORWARD_ONLY
的结果集类型的ResultSet
,对getRow
方法的支持是可选的 -
-
-
返回:
-
当前行的编号;如果不存在当前行,则返回
0
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
当前行的编号;如果不存在当前行,则返回
absolute
boolean absolute(int row) throws SQLException
-
将光标移动到此
ResultSet
对象的给定行编号。如果行编号为正,则将光标移动到相对于结果集开头的给定行编号。第一行为行 1,第二行为行 2,依此类推。
如果给定行编号为负,则将光标移动到相对于结果集末尾的绝对行位置。例如,调用方法
absolute(-1)
将光标置于最后一行;调用方法absolute(-2)
将光标移动到倒数第二行,依此类推。试图将光标置于结果集的第一行/最后一行之外将导致光标位于第一行之前或最后一行之后。
注:调用
absolute(1)
等效于调用first()
。调用absolute(-1)
等效于调用last()
。 -
-
-
参数:
-
row
- 光标应该移动到的行的编号。正的编号指示从结果集开头开始计数的行编号;负的编号指示从结果集末尾开始计数的行编号
返回:
-
如果光标移动到此
ResultSet
对象的位置处,则返回true
;如果光标在第一行的前面或最后一行的后面,则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
relative
boolean relative(int rows) throws SQLException
-
按相对行数(或正或负)移动光标。试图移动到结果集的第一行/最后一行之外,会将光标置于第一行之前或最后一行之后。调用
relative(0)
有效,但是不更改光标位置。注:调用方法
relative(1)
等效于调用方法next()
,而调用方法relative(-1)
等效于调用方法previous()
。 -
-
-
参数:
-
rows
- 指定从当前行开始移动的行数的int
;正数表示光标向前移动;负数表示光标向后移动
返回:
-
如果光标位于行上,则返回
true
;否则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
previous
boolean previous() throws SQLException
-
将光标移动到此
ResultSet
对象的上一行。当调用
previous
方法返回false
时,光标位于第一行之前。要求当前行的任何ResultSet
方法的调用将导致抛出SQLException
。如果开启了对当前行的输入流,则调用
previous
方法将隐式关闭它。读取新的一行时清除ResultSet
对象的警告更改。 -
-
-
返回:
-
如果光标现在位于有效行上,则返回
true
;如果光标位于第一行的前面,则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
如果光标现在位于有效行上,则返回
setFetchDirection
void setFetchDirection(int direction) throws SQLException
-
设置此
ResultSet
对象中行的处理方向。初始值由生成此ResultSet
对象的Statement
对象确定。获取方向可以在任何时间更改。 -
-
-
参数:
-
direction
- 指定建议获取方向的int
;ResultSet.FETCH_FORWARD
、ResultSet.FETCH_REVERSE
或ResultSet.FETCH_UNKNOWN
之一
抛出:
-
SQLException
- 如果发生数据库访问错误,在已关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY
但获取方向不是FETCH_FORWARD
从以下版本开始:
- 1.2 另请参见:
- Statement.setFetchDirection(int), getFetchDirection()
-
getFetchDirection
int getFetchDirection() throws SQLException
-
获取此
ResultSet
对象的获取方向。 -
-
-
返回:
-
此
ResultSet
对象的当前获取方向
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2 另请参见:
- setFetchDirection(int)
-
此
setFetchSize
void setFetchSize(int rows) throws SQLException
-
为 JDBC 驱动程序设置此
ResultSet
对象需要更多行时应该从数据库获取的行数。如果指定的获取大小为零,则 JDBC 驱动程序忽略该值,随意对获取大小作出它自己的最佳猜测。默认值由创建结果集的Statement
对象设置。获取大小可以在任何时间更改。 -
-
-
参数:
-
rows
- 要获取的行数
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或不满足条件rows >= 0
从以下版本开始:
- 1.2 另请参见:
- getFetchSize()
-
getFetchSize
int getFetchSize() throws SQLException
-
获取此
ResultSet
对象的获取大小。 -
-
-
返回:
-
此
ResultSet
对象的当前获取大小
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2 另请参见:
- setFetchSize(int)
-
此
getType
int getType() throws SQLException
-
获取此
ResultSet
对象的类型。类型由创建结果集的Statement
对象确定。 -
-
-
返回:
-
ResultSet.TYPE_FORWARD_ONLY
、ResultSet.TYPE_SCROLL_INSENSITIVE
或ResultSet.TYPE_SCROLL_SENSITIVE
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
getConcurrency
int getConcurrency() throws SQLException
-
获取此
ResultSet
对象的并发模式。使用的并发由创建结果集的Statement
对象确定。 -
-
-
返回:
-
并发类型,
ResultSet.CONCUR_READ_ONLY
或ResultSet.CONCUR_UPDATABLE
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
并发类型,
rowUpdated
boolean rowUpdated() throws SQLException
-
获取是否已更新当前行。返回值取决于结果集是否可以检测到更新。
注:对于
CONCUR_READ_ONLY
的结果集并发性,对rowUpdated
方法的支持是可选的 -
-
-
返回:
-
如果所有者和其他人检测到当前行已进行可见更新,则返回
true
;否则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2 另请参见:
- DatabaseMetaData.updatesAreDetected(int)
-
如果所有者和其他人检测到当前行已进行可见更新,则返回
rowInserted
boolean rowInserted() throws SQLException
-
获取当前行是否已有插入。返回值取决于此
ResultSet
对象是否可以检测到可见插入。注:对于
CONCUR_READ_ONLY
的结果集并发性,对rowUpdated
方法的支持是可选的 -
-
-
返回:
-
如果当前检测到已插入,则返回
true
;否则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2 另请参见:
- DatabaseMetaData.insertsAreDetected(int)
-
如果当前检测到已插入,则返回
rowDeleted
boolean rowDeleted() throws SQLException
-
获取是否已删除某行。删除的行可能在结果集中留下一个可见的“洞”。此方法可用于检测结果集中的洞。返回值取决于此
ResultSet
对象是否可以检测到删除。注:对于
CONCUR_READ_ONLY
的结果集并发性,对rowDeleted
方法的支持是可选的 -
-
-
返回:
-
如果所有者或其他人检测到当前行已删除,则返回
true
;否则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2 另请参见:
- DatabaseMetaData.deletesAreDetected(int)
-
如果所有者或其他人检测到当前行已删除,则返回
updateNull
void updateNull(int columnIndex) throws SQLException
-
用
null
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateBoolean
void updateBoolean(int columnIndex, boolean x) throws SQLException
-
用
boolean
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateByte
void updateByte(int columnIndex, byte x) throws SQLException
-
用
byte
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateShort
void updateShort(int columnIndex, short x) throws SQLException
-
用
short
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateInt
void updateInt(int columnIndex, int x) throws SQLException
-
用
int
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateLong
void updateLong(int columnIndex, long x) throws SQLException
-
用
long
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会不更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateFloat
void updateFloat(int columnIndex, float x) throws SQLException
-
用
float
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateDouble
void updateDouble(int columnIndex, double x) throws SQLException
-
用
double
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateBigDecimal
void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException
-
用
java.math.BigDecimal
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateString
void updateString(int columnIndex, String x) throws SQLException
-
用
String
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateBytes
void updateBytes(int columnIndex, byte[] x) throws SQLException
-
用
byte
数组值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateDate
void updateDate(int columnIndex, Date x) throws SQLException
-
用
java.sql.Date
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateTime
void updateTime(int columnIndex, Time x) throws SQLException
-
用
java.sql.Time
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateTimestamp
void updateTimestamp(int columnIndex, Timestamp x) throws SQLException
-
用
java.sql.Timestamp
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateAsciiStream
void updateAsciiStream(int columnIndex, InputStream x, int length) throws SQLException
-
用 ascii 流值更新指定列,该列将具有指定字节数。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值 -
length
- 流的长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateBinaryStream
void updateBinaryStream(int columnIndex, InputStream x, int length) throws SQLException
-
用二进制流值更新指定列,该列将具有指定字节数。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值 -
length
- 流的长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateCharacterStream
void updateCharacterStream(int columnIndex, Reader x, int length) throws SQLException
-
用字符流值更新指定列,该列将具有指定字节数。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值 -
length
- 流的长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateObject
void updateObject(int columnIndex, Object x, int scaleOrLength) throws SQLException
-
用
Object
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。如果第二个参数是
InputStream
,则该流必须包含 scaleOrLength 指定的字节数。如果第二个参数是Reader
,则它必须包含 scaleOrLength 指定的字符数。如果这些条件不为真,则执行该语句时驱动程序将生成一个SQLException
。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值 -
scaleOrLength
- 对于java.math.BigDecimal
对象,此参数是小数点后的位数。对于 Java 对象类型InputStream
和Reader
,此参数是该流或 reader 中数据的长度。对于其他所有类型,将忽略此值。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateObject
void updateObject(int columnIndex, Object x) throws SQLException
-
用
Object
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateNull
void updateNull(String columnLabel) throws SQLException
-
用
null
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateBoolean
void updateBoolean(String columnLabel, boolean x) throws SQLException
-
用
boolean
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateByte
void updateByte(String columnLabel, byte x) throws SQLException
-
用
byte
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateShort
void updateShort(String columnLabel, short x) throws SQLException
-
用
short
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateInt
void updateInt(String columnLabel, int x) throws SQLException
-
用
int
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateLong
void updateLong(String columnLabel, long x) throws SQLException
-
用
long
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateFloat
void updateFloat(String columnLabel, float x) throws SQLException
-
用
float
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateDouble
void updateDouble(String columnLabel, double x) throws SQLException
-
用
double
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateBigDecimal
void updateBigDecimal(String columnLabel, BigDecimal x) throws SQLException
-
用
java.sql.BigDecimal
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateString
void updateString(String columnLabel, String x) throws SQLException
-
用
String
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateBytes
void updateBytes(String columnLabel, byte[] x) throws SQLException
-
用字节数组值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateDate
void updateDate(String columnLabel, Date x) throws SQLException
-
用
java.sql.Date
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateTime
void updateTime(String columnLabel, Time x) throws SQLException
-
用
java.sql.Time
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateTimestamp
void updateTimestamp(String columnLabel, Timestamp x) throws SQLException
-
用
java.sql.Timestamp
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateAsciiStream
void updateAsciiStream(String columnLabel, InputStream x, int length) throws SQLException
-
用 ascii 流值更新指定列,该列具有指定的字节数。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值 -
length
- 流的长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateBinaryStream
void updateBinaryStream(String columnLabel, InputStream x, int length) throws SQLException
-
用二进制流值更新指定列,该列具有指定的字节数。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值 -
length
- 流的长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateCharacterStream
void updateCharacterStream(String columnLabel, Reader reader, int length) throws SQLException
-
用字符流值更新指定列,该列具有指定的字节数。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
reader
- 包含新列值的java.io.Reader
对象 -
length
- 流的长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateObject
void updateObject(String columnLabel, Object x, int scaleOrLength) throws SQLException
-
用
Object
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。如果第二个参数是
InputStream
,则该流必须包含 scaleOrLength 指定的字节数。如果第二个参数是Reader
,则它必须包含 scaleOrLength 指定的字符数。如果这些条件不为真,则执行该语句时驱动程序将生成一个SQLException
。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值 -
scaleOrLength
- 对于java.math.BigDecimal
对象,此参数是小数点后的位数。对于 Java 对象类型InputStream
和Reader
,此参数是该流或 reader 中数据的长度。 对于其他所有类型,将忽略此值。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateObject
void updateObject(String columnLabel, Object x) throws SQLException
-
用
Object
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
insertRow
void insertRow() throws SQLException
-
将插入行的内容插入到此
ResultSet
对象和数据库中。调用此方法时,光标必须位于插入行上。 -
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法;如果在光标不位于插入行上时调用此方法,或者插入行中所有不可为 null 的列中还存在未分配非 null 值的列 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateRow
void updateRow() throws SQLException
-
用此
ResultSet
对象的当前行的新内容更新底层数据库。光标不位于插入行上时不能调用此方法。 -
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
;在已关闭的结果集上调用此方法,或者在光标不位于插入行上时调用了此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
deleteRow
void deleteRow() throws SQLException
-
从此
ResultSet
对象和底层数据库中删除当前行。光标不位于插入行上时不能调用此方法。 -
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
;在已关闭的结果集上调用此方法,或者在光标不位于插入行上时调用了此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
refreshRow
void refreshRow() throws SQLException
-
用数据库中的最近值刷新当前行。光标不位于插入行上时不能调用此方法。
refreshRow
方法提供一种让应用程序显式告知 JDBC 驱动程序从数据库重新获取行的方式。应用程序可能需要在 JDBC 驱动程序完成缓存或预获取操作后调用refreshRow
,以便从数据库获取行的最新值。如果获取大小大于 1,则 JDBC 驱动程序可以一次实际刷新多行。应根据事务隔离级别和光标敏感度确定是否重新获取所有值。如果在调用更新方法之后,但在调用
updateRow
方法之前调用refreshRow
,则会丢失对行所作的更新。频繁调用方法refreshRow
可能导致性能下降。 -
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法;结果集类型为TYPE_FORWARD_ONLY
,或者在光标不位于插入行上时调用了此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法,或者对于指定的结果集类型和结果集并发性此方法不受支持。
从以下版本开始:
- 1.2
-
cancelRowUpdates
void cancelRowUpdates() throws SQLException
-
取消对
ResultSet
对象中的当前行所作的更新。此方法在调用更新方法之后,但在调用updateRow
方法之前调用才可以回滚对行所作的更新。如果没有进行任何更新或者已经调用updateRow
方法,则此方法无效。 -
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法;结果集并发性为CONCUR_READ_ONLY
,或者在光标不位于插入行上时调用了此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
moveToInsertRow
void moveToInsertRow() throws SQLException
-
将光标移动到插入行。将光标置于插入行上时,当前的光标位置会被记住。插入行是一个与可更新结果集相关联的特殊行。它实际上是一个缓冲区,在将行插入到结果集前可以通过调用更新方法在其中构造新行。当光标位于插入行上时,仅能调用更新方法、获取方法以及
insertRow
方法。每次在调用insertRow
之前调用此方法时,必须为结果集中的所有列分配值。在对列值调用获取方法之前,必须调用更新方法。 -
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集并发性为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
moveToCurrentRow
void moveToCurrentRow() throws SQLException
- 将光标移动到记住的光标位置,通常为当前行。如果光标不位于插入行上,则此方法无效。
-
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集并发性为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getStatement
Statement getStatement() throws SQLException
-
获取生成此
ResultSet
对象的Statement
对象。如果结果集是以其他方式生成的(如通过DatabaseMetaData
方法),则此方法可能返回null
。 -
-
-
返回:
-
生成此
ResultSet
对象的Statment
对象;如果结果集是以其他方法生成的,则返回null
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
生成此
getObject
Object getObject(int columnIndex, Map<String,Class<?>> map) throws SQLException
-
以 Java 编程语言中
Object
的形式获取此ResultSet
对象的当前行中指定列的值。如果值为 SQLNULL
,则驱动程序返回一个 Javanull
。此方法使用给定的Map
对象作为正在获取的 SQL 结构化或独特类型的自定义映射关系。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
map
- 一个java.util.Map
对象,包含从 SQL 类型名称到 Java 编程语言中类的映射关系
返回:
-
表示 SQL 值的 Java 编程语言中的
Object
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getRef
Ref getRef(int columnIndex) throws SQLException
-
以 Java 编程语言中
Ref
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
表示 SQL
REF
值的Ref
对象
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getBlob
Blob getBlob(int columnIndex) throws SQLException
-
以 Java 编程语言中
Blob
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
表示指定列中的 SQL
BLOB
值的BLOB
对象
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getClob
Clob getClob(int columnIndex) throws SQLException
-
以 Java 编程语言中
Clob
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
表示指定列中的 SQL
Clob
值的Clob
对象
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getArray
Array getArray(int columnIndex) throws SQLException
-
以 Java 编程语言中
Array
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
表示指定列中的 SQL
Array
值的Array
对象
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getObject
Object getObject(String columnLabel, Map<String,Class<?>> map) throws SQLException
-
以 Java 编程语言中
Object
的形式获取此ResultSet
对象的当前行中指定列的值。如果值为 SQLNULL
,则驱动程序返回一个 Javanull
。此方法使用指定的Map
对象自定义映射关系(如果合适)。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
map
- 包含从 SQL 类型名称到 Java 编程语言中类的映射关系的java.util.Map
对象
返回:
-
表示指定列中的 SQL 值的
Object
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getRef
Ref getRef(String columnLabel) throws SQLException
-
以 Java 编程语言中
Ref
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
表示指定列中 SQL
Ref
值的Ref
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getBlob
Blob getBlob(String columnLabel) throws SQLException
-
以 Java 编程语言中
Blob
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
表示指定列中 SQL
Blob
值的Blob
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getClob
Clob getClob(String columnLabel) throws SQLException
-
以 Java 编程语言中
Clob
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
表示指定列中 SQL
CLOB
值的Clob
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getArray
Array getArray(String columnLabel) throws SQLException
-
以 Java 编程语言中
Array
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
表示指定列中 SQL
ARRAY
值的ARRAY
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getDate
Date getDate(int columnIndex, Calendar cal) throws SQLException
-
以 Java 编程语言中
java.sql.Date
对象的形式获取此ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造日期的适当毫秒值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
cal
- 在构造日期时使用的java.util.Calendar
对象
返回:
-
java.sql.Date
对象形式的列值;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
getDate
Date getDate(String columnLabel, Calendar cal) throws SQLException
-
以 Java 编程语言中
java.sql.Date
对象的形式获取此ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造日期的适当毫秒值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
cal
- 在构造日期时使用的java.util.Calendar
对象
返回:
-
java.sql.Date
对象形式的列值;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
getTime
Time getTime(int columnIndex, Calendar cal) throws SQLException
-
以 Java 编程语言中
java.sql.Time
对象的形式获取此ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造时间的适当毫秒值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
cal
- 在构造时间时使用的java.util.Calendar
对象
返回:
-
java.sql.Time
对象形式的列值;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
getTime
Time getTime(String columnLabel, Calendar cal) throws SQLException
-
以 Java 编程语言中
java.sql.Time
对象的形式获取此ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造时间的适当毫秒值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
cal
- 在构造时间时使用的java.util.Calendar
对象
返回:
-
java.sql.Time
对象形式的列值;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
getTimestamp
Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException
-
以 Java 编程语言中
java.sql.Timestamp
对象的形式获取此ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造时间戳的适当毫秒值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
cal
- 在构造时间戳时使用的java.util.Calendar
对象
返回:
-
java.sql.Timestamp
对象形式的列值;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
getTimestamp
Timestamp getTimestamp(String columnLabel, Calendar cal) throws SQLException
-
以 Java 编程语言中
java.sql.Timestamp
对象的形式获取此ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造时间戳的适当毫秒值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
cal
- 在构造日期时使用的java.util.Calendar
对象
返回:
-
java.sql.Timestamp
对象形式的列值;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
getURL
URL getURL(int columnIndex) throws SQLException
-
以 Java 编程语言中
java.net.URL
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 索引,其中第一个列是 1、第二个列是 2,……
返回:
-
java.net.URL
对象形式的列值;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法或 URL 是错误的 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.4
-
getURL
URL getURL(String columnLabel) throws SQLException
-
以 Java 编程语言中
java.net.URL
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
java.net.URL
对象形式的列值;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法,或者 URL 是错误的 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.4
-
updateRef
void updateRef(int columnIndex, Ref x) throws SQLException
-
用
java.sql.Ref
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.4
-
updateRef
void updateRef(String columnLabel, Ref x) throws SQLException
-
用
java.sql.Ref
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.4
-
updateBlob
void updateBlob(int columnIndex, Blob x) throws SQLException
-
用
java.sql.Blob
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.4
-
updateBlob
void updateBlob(String columnLabel, Blob x) throws SQLException
-
用
java.sql.Blob
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.4
-
updateClob
void updateClob(int columnIndex, Clob x) throws SQLException
-
用
java.sql.Clob
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.4
-
updateClob
void updateClob(String columnLabel, Clob x) throws SQLException
-
用
java.sql.Clob
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.4
-
updateArray
void updateArray(int columnIndex, Array x) throws SQLException
-
用
java.sql.Array
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.4
-
updateArray
void updateArray(String columnLabel, Array x) throws SQLException
-
用
java.sql.Array
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.4
-
getRowId
RowId getRowId(int columnIndex) throws SQLException
-
以 Java 编程语言中
java.sql.RowId
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果该值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
getRowId
RowId getRowId(String columnLabel) throws SQLException
-
以 Java 编程语言中
java.sql.RowId
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果该值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateRowId
void updateRowId(int columnIndex, RowId x) throws SQLException
-
用
RowId
值更新指定列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateRowId
void updateRowId(String columnLabel, RowId x) throws SQLException
-
用
RowId
值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
getHoldability
int getHoldability() throws SQLException
-
获取此
ResultSet
对象的可保存性 -
-
-
返回:
-
ResultSet.HOLD_CURSORS_OVER_COMMIT
或ResultSet.CLOSE_CURSORS_AT_COMMIT
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.6
-
isClosed
boolean isClosed() throws SQLException
-
获取此
ResultSet
对象是否已关闭。如果已经在ResultSet
上调用了 close 方法,或者ResultSet
自动关闭,则ResultSet
已关闭。 -
-
-
返回:
-
如果此
ResultSet
对象已关闭,则返回 true;如果它仍然是打开的,则返回 false
抛出:
-
SQLException
- 如果发生数据库访问错误
从以下版本开始:
- 1.6
-
如果此
updateNString
void updateNString(int columnIndex, String nString) throws SQLException
-
用
String
值更新指定的列。更新NCHAR
、NVARCHAR
和LONGNVARCHAR
列时使用该方法。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
nString
- 要更新的列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果驱动程序不支持国家字符集 (national character set);如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;结果集并发性为CONCUR_READ_ONLY
或发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNString
void updateNString(String columnLabel, String nString) throws SQLException
-
用
String
值更新指定的列。更新NCHAR
、NVARCHAR
和LONGNVARCHAR
列时使用该方法。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
nString
- 要更新的列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;结果集并发性为CONCUR_READ_ONLY
或发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNClob
void updateNClob(int columnIndex, NClob nClob) throws SQLException
-
用
java.sql.NClob
值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
nClob
- 要更新的列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNClob
void updateNClob(String columnLabel, NClob nClob) throws SQLException
-
用
java.sql.NClob
值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
nClob
- 要更新的列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
getNClob
NClob getNClob(int columnIndex) throws SQLException
-
以 Java 编程语言中
NClob
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
表示指定列中 SQL
NCLOB
值的NClob
对象
抛出:
-
SQLException
- 如果 columnIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法或发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
getNClob
NClob getNClob(String columnLabel) throws SQLException
-
以 Java 编程语言中
NClob
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
表示指定列中 SQL
NCLOB
值的NClob
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法或发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
getSQLXML
SQLXML getSQLXML(int columnIndex) throws SQLException
-
以 Java 编程语言中
java.sql.SQLXML
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
一个映射
SQL XML
值的SQLXML
对象
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
getSQLXML
SQLXML getSQLXML(String columnLabel) throws SQLException
-
以 Java 编程语言中
java.sql.SQLXML
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
一个映射
SQL XML
值的SQLXML
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateSQLXML
void updateSQLXML(int columnIndex, SQLXML xmlObject) throws SQLException
-
用
java.sql.SQLXML
值更新指定列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
xmlObject
- 要更新的列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;在已关闭的结果集上调用此方法;没有为SQLXML
对象关闭java.xml.transform.Result
、Writer
或OutputStream
;如果在处理 XML 值的过程中发生错误或结果集并发性为CONCUR_READ_ONLY
。该异常的getCause
方法可以提供更详细的异常信息,例如,如果该流不包含有效的 XML。 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateSQLXML
void updateSQLXML(String columnLabel, SQLXML xmlObject) throws SQLException
-
用
java.sql.SQLXML
值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
xmlObject
- 列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;在已关闭的结果集上调用此方法;没有为SQLXML
对象关闭java.xml.transform.Result
、Writer
或OutputStream
;如果在处理 XML 值的过程中发生错误或结果集并发性为CONCUR_READ_ONLY
。该异常的getCause
方法可能提供更详细的异常信息,例如,如果该流不包含有效的 XML。 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
getNString
String getNString(int columnIndex) throws SQLException
-
以 Java 编程语言中
String
的形式获取此ResultSet
对象的当前行中指定列的值。访问NCHAR
、NVARCHAR
和LONGNVARCHAR
列时可使用此方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果该值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
getNString
String getNString(String columnLabel) throws SQLException
-
以 Java 编程语言中
String
的形式获取此ResultSet
对象的当前行中指定列的值。访问NCHAR
、NVARCHAR
和LONGNVARCHAR
列时可使用此方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果该值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
getNCharacterStream
Reader getNCharacterStream(int columnIndex) throws SQLException
-
以
java.io.Reader
对象的形式获取此ResultSet
对象的当前行中指定列的值。访问NCHAR
、NVARCHAR
和LONGNVARCHAR
列时可使用此方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
包含该列值的
java.io.Reader
对象;如果该值为 SQLNULL
,则返回 Java 编程语言中的值null
。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
getNCharacterStream
Reader getNCharacterStream(String columnLabel) throws SQLException
-
以
java.io.Reader
对象的形式获取此ResultSet
对象的当前行中指定列的值。访问NCHAR
、NVARCHAR
和LONGNVARCHAR
列时可使用此方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
包含该列值的
java.io.Reader
对象;如果该值为 SQLNULL
,则返回 Java 编程语言中的值null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNCharacterStream
void updateNCharacterStream(int columnIndex, Reader x, long length) throws SQLException
-
用字符流值更新指定的列,该值将具有指定的字节数。驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。更新
NCHAR
、NVARCHAR
和LONGNVARCHAR
列时可使用此方法。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值 -
length
- 流长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNCharacterStream
void updateNCharacterStream(String columnLabel, Reader reader, long length) throws SQLException
-
用字符流值更新指定的列,该值将具有指定的字节数。驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。更新
NCHAR
、NVARCHAR
和LONGNVARCHAR
列时可使用此方法。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
reader
- 包含新列值的java.io.Reader
对象 -
length
- 流长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateAsciiStream
void updateAsciiStream(int columnIndex, InputStream x, long length) throws SQLException
-
用 ascii 流值更新指定的列,该值将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值 -
length
- 流长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateBinaryStream
void updateBinaryStream(int columnIndex, InputStream x, long length) throws SQLException
-
用二进制流值更新指定的列,该值将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值 -
length
- 流长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateCharacterStream
void updateCharacterStream(int columnIndex, Reader x, long length) throws SQLException
-
用字符流值更新指定的列,该值将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值 -
length
- 流长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateAsciiStream
void updateAsciiStream(String columnLabel, InputStream x, long length) throws SQLException
-
用 ascii 流值更新指定的列,该值将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值 -
length
- 流长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateBinaryStream
void updateBinaryStream(String columnLabel, InputStream x, long length) throws SQLException
-
用二进制流值更新指定的列,该值将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值 -
length
- 流长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateCharacterStream
void updateCharacterStream(String columnLabel, Reader reader, long length) throws SQLException
-
用字符流值更新指定的列,该值将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
reader
- 包含新列值的java.io.Reader
对象 -
length
- 流长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateBlob
void updateBlob(int columnIndex, InputStream inputStream, long length) throws SQLException
-
使用给定输入流更新指定的列,该流将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
inputStream
- 包含用来设置参数值的数据的对象。 -
length
- 参数数据中的字节数。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateBlob
void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException
-
使用给定输入流更新指定列,该流将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
inputStream
- 包含用来设置参数值的数据的对象。 -
length
- 参数数据中的字节数。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateClob
void updateClob(int columnIndex, Reader reader, long length) throws SQLException
-
使用给定的
Reader
对象更新指定列,该对象是给定的字符长度数目。在将一个非常大的 UNICODE 值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更为实际。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
reader
- 包含用来设置参数值的数据的对象。 -
length
- 参数数据中的字符数。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateClob
void updateClob(String columnLabel, Reader reader, long length) throws SQLException
-
使用给定的
Reader
对象更新指定列,该对象是给定的字符长度数目。在将一个非常大的 UNICODE 值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更为实际。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
reader
- 包含用来设置参数值的数据的对象。 -
length
- 参数数据中的字符数。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNClob
void updateNClob(int columnIndex, Reader reader, long length) throws SQLException
-
使用给定的
Reader
对象更新指定的列,该对象是给定的字符长度数目。在将一个非常大的 UNICODE 值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更为实际。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
reader
- 包含用来设置参数值的数据的对象。 -
length
- 参数数据中的字符数。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNClob
void updateNClob(String columnLabel, Reader reader, long length) throws SQLException
-
使用给定的
Reader
对象更新指定的列,该对象是给定的字符长度数目。在将一个非常大的 UNICODE 值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更为实际。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
reader
- 包含用来设置参数值的数据的对象。 -
length
- 参数数据中的字符数。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNCharacterStream
void updateNCharacterStream(int columnIndex, Reader x) throws SQLException
-
用字符流值更新指定的列。将根据需要从流中读取数据,一直读取到流末尾。驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。更新
NCHAR
、NVARCHAR
和LONGNVARCHAR
列时可使用此方法。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateNCharacterStream
是否更有效。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNCharacterStream
void updateNCharacterStream(String columnLabel, Reader reader) throws SQLException
-
用字符流值更新指定的列。将根据需要从流中读取数据,一直读取到流末尾。驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。更新
NCHAR
、NVARCHAR
和LONGNVARCHAR
列时可使用此方法。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateNCharacterStream
是否更有效。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
reader
- 包含新列值的java.io.Reader
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateAsciiStream
void updateAsciiStream(int columnIndex, InputStream x) throws SQLException
-
用 ascii 流值更新指定的列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateAsciiStream
是否更有效。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateBinaryStream
void updateBinaryStream(int columnIndex, InputStream x) throws SQLException
-
用二进制流值更新指定的列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateBinaryStream
是否更有效。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateCharacterStream
void updateCharacterStream(int columnIndex, Reader x) throws SQLException
-
用字符流值更新指定的列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateCharacterStream
是否更有效。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateAsciiStream
void updateAsciiStream(String columnLabel, InputStream x) throws SQLException
-
用 ascii 流值更新指定列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateAsciiStream
是否更有效。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateBinaryStream
void updateBinaryStream(String columnLabel, InputStream x) throws SQLException
-
用二进制流值更新指定列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateBinaryStream
是否更有效。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateCharacterStream
void updateCharacterStream(String columnLabel, Reader reader) throws SQLException
-
用字符流值更新指定列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateCharacterStream
是否更有效。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
reader
- 包含新列值的java.io.Reader
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateBlob
void updateBlob(int columnIndex, InputStream inputStream) throws SQLException
-
使用给定输入流值更新指定列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateBlob
是否更有效。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
inputStream
- 包含用来设置参数值的数据的对象。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateBlob
void updateBlob(String columnLabel, InputStream inputStream) throws SQLException
-
使用给定输入流值更新指定列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateBlob
是否更有效。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
inputStream
- 包含用来设置参数值的数据的对象。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateClob
void updateClob(int columnIndex, Reader reader) throws SQLException
-
使用给定的
Reader
对象更新指定列。将根据需要从流中读取数据,一直读取到流末尾。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateClob
是否更有效。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
reader
- 包含用来设置参数值的数据的对象。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateClob
void updateClob(String columnLabel, Reader reader) throws SQLException
-
使用给定的
Reader
对象更新指定列。将根据需要从流中读取数据,一直读取到流末尾。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateClob
是否更有效。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
reader
- 包含用来设置参数值的数据的对象。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNClob
void updateNClob(int columnIndex, Reader reader) throws SQLException
-
使用给定的
Reader
对象更新指定列。将根据需要从流中读取数据,一直读取到流末尾。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateNClob
是否更有效。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
reader
- 包含用来设置参数值的数据的对象。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNClob
void updateNClob(String columnLabel, Reader reader) throws SQLException
-
使用给定的
Reader
对象更新指定列。将根据需要从流中读取数据,一直读取到流末尾。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateNClob
是否更有效。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
reader
- 包含用来设置参数值的数据的对象。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
-
所有超级接口:
- Wrapper
-
所有已知子接口:
- CachedRowSet, FilteredRowSet, JdbcRowSet, JoinRowSet, RowSet, SyncResolver, WebRowSet
public interface ResultSet extends Wrapper
表示数据库结果集的数据表,通常通过执行查询数据库的语句生成。
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 开始编号。为了获得最大的可移植性,应该按从左到右的顺序读取每行中的结果集列,每列只能读取一次。
对于获取方法,JDBC 驱动程序尝试将底层数据转换为在获取方法中指定的 Java 类型,并返回适当的 Java 值。JDBC 规范有一个表,显示允许的从 SQL 类型到ResultSet
获取方法所使用的 Java 类型的映射关系。
用作获取方法的输入的列名称不区分大小写。用列名称调用获取方法时,如果多个列具有这一名称,则返回第一个匹配列的值。在生成结果集的 SQL 查询中使用列名称时,将使用列名称选项。对于没有在查询中显式指定的列,最好使用列编号。如果使用列名称,则程序员应该注意保证名称唯一引用预期的列,这可以使用 SQLAS 子句确定。
在 JDBC 2.0 API(JavaTM 2 SDK 标准版 1.2 版)中,此接口添加了一组更新方法。关于获取方法参数的注释同样适用于更新方法的参数。
可以用以下两种方式使用更新方法:
- 更新当前行中的列值。在可滚动的
ResultSet
对象中,可以向前和向后移动光标,将其置于绝对位置或相对于当前行的位置。以下代码片段更新ResultSet
对象rs
第五行中的NAME
列,然后使用方法updateRow
更新导出rs
的数据源表。rs.absolute(5); // moves the cursor to the fifth row of rs rs.updateString("NAME", "AINSWORTH"); // updates the //
NAME
column of row 5 to beAINSWORTH
rs.updateRow(); // updates the row in the data source - 将列值插入到插入行中。可更新的
ResultSet
对象具有一个与其关联的特殊行,该行用作构建要插入的行的暂存区域 (staging area)。以下代码片段将光标移动到插入行,构建一个三列的行,并使用方法insertRow
将其插入到rs
和数据源表中。rs.moveToInsertRow(); // moves cursor to the insert row rs.updateString(1, "AINSWORTH"); // updates the // first column of the insert row to be
AINSWORTH
rs.updateInt(2,35); // updates the second column to be35
rs.updateBoolean(3, true); // updates the third column totrue
rs.insertRow(); rs.moveToCurrentRow();
当生成 ResultSet
对象的 Statement
对象关闭、重新执行或用来从多个结果的序列获取下一个结果时,ResultSet
对象将自动关闭。
ResultSet
对象的列的编号、类型和属性由 ResultSet.getMetaData
方法返回的ResulSetMetaData
对象提供。
-
另请参见:
- Statement.executeQuery(java.lang.String), Statement.getResultSet(), ResultSetMetaData
字段摘要 | |
---|---|
static int | CLOSE_CURSORS_AT_COMMIT 该常量指示提交当前事务时,具有此可保存性的打开的 ResultSet 对象将被关闭。 |
static int | CONCUR_READ_ONLY 该常量指示不可以更新的 ResultSet 对象的并发模式。 |
static int | CONCUR_UPDATABLE 该常量指示可以更新的 ResultSet 对象的并发模式。 |
static int | FETCH_FORWARD 该常量指示将按正向(即从第一个到最后一个)处理结果集中的行。 |
static int | FETCH_REVERSE 该常量指示将按逆向(即从最后一个到第一个)处理结果集中的行处理。 |
static int | FETCH_UNKNOWN 该常量指示结果集中的行的处理顺序未知。 |
static int | HOLD_CURSORS_OVER_COMMIT 该常量指示提交当前事务时,具有此可保存性的打开的 ResultSet 对象将保持开放。 |
static int | TYPE_FORWARD_ONLY 该常量指示光标只能向前移动的 ResultSet 对象的类型。 |
static int | TYPE_SCROLL_INSENSITIVE 该常量指示可滚动但通常不受 ResultSet 底层数据更改影响的 ResultSet 对象的类型。 |
static int | TYPE_SCROLL_SENSITIVE 该常量指示可滚动并且通常受 ResultSet 底层数据更改影响的 ResultSet 对象的类型。 |
方法摘要 | |
---|---|
boolean | absolute(int row) 将光标移动到此 ResultSet 对象的给定行编号。 |
void | afterLast() 将光标移动到此 ResultSet 对象的末尾,正好位于最后一行之后。 |
void | beforeFirst() 将光标移动到此 ResultSet 对象的开头,正好位于第一行之前。 |
void | cancelRowUpdates() 取消对 ResultSet 对象中的当前行所作的更新。 |
void | clearWarnings() 清除在此 ResultSet 对象上报告的所有警告。 |
void | close() 立即释放此 ResultSet 对象的数据库和 JDBC 资源,而不是等待该对象自动关闭时发生此操作。 |
void | deleteRow() 从此 ResultSet 对象和底层数据库中删除当前行。 |
int | findColumn(String columnLabel) 将给定的 ResultSet 列标签映射到其 ResultSet 列索引。 |
boolean | first() 将光标移动到此 ResultSet 对象的第一行。 |
Array | getArray(int columnIndex) 以 Java 编程语言中 Array 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Array | getArray(String columnLabel) 以 Java 编程语言中 Array 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
InputStream | getAsciiStream(int columnIndex) 以 ASCII 字符流的形式获取此 ResultSet 对象的当前行中指定列的值。 |
InputStream | getAsciiStream(String columnLabel) 以 ASCII 字符流的形式获取此 ResultSet 对象的当前行中指定列的值。 |
BigDecimal | getBigDecimal(int columnIndex) 以具有全精度的 java.math.BigDecimal 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
BigDecimal | getBigDecimal(int columnIndex, int scale) 已过时。 |
BigDecimal | getBigDecimal(String columnLabel) 以具有全精度的 java.math.BigDecimal 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
BigDecimal | getBigDecimal(String columnLabel, int scale) 已过时。 |
InputStream | getBinaryStream(int columnIndex) 以未解释字节的流的形式获取此 ResultSet 对象的当前行中指定列的值。 |
InputStream | getBinaryStream(String columnLabel) 以未解释的 byte 流的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Blob | getBlob(int columnIndex) 以 Java 编程语言中 Blob 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Blob | getBlob(String columnLabel) 以 Java 编程语言中 Blob 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
boolean | getBoolean(int columnIndex) 以 Java 编程语言中 boolean 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
boolean | getBoolean(String columnLabel) 以 Java 编程语言中 boolean 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
byte | getByte(int columnIndex) 以 Java 编程语言中 byte 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
byte | getByte(String columnLabel) 以 Java 编程语言中 byte 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
byte[] | getBytes(int columnIndex) 以 Java 编程语言中 byte 数组的形式获取此 ResultSet 对象的当前行中指定列的值。 |
byte[] | getBytes(String columnLabel) 以 Java 编程语言中 byte 数组的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Reader | getCharacterStream(int columnIndex) 以 java.io.Reader 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Reader | getCharacterStream(String columnLabel) 以 java.io.Reader 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Clob | getClob(int columnIndex) 以 Java 编程语言中 Clob 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Clob | getClob(String columnLabel) 以 Java 编程语言中 Clob 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
int | getConcurrency() 获取此 ResultSet 对象的并发模式。 |
String | getCursorName() 获取此 ResultSet 对象使用的 SQL 光标的名称。 |
Date | getDate(int columnIndex) 以 Java 编程语言中 java.sql.Date 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Date | getDate(int columnIndex, Calendar cal) 以 Java 编程语言中 java.sql.Date 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Date | getDate(String columnLabel) 以 Java 编程语言中的 java.sql.Date 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Date | getDate(String columnLabel, Calendar cal) 以 Java 编程语言中 java.sql.Date 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
double | getDouble(int columnIndex) 以 Java 编程语言中 double 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
double | getDouble(String columnLabel) 以 Java 编程语言中 double 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
int | getFetchDirection() 获取此 ResultSet 对象的获取方向。 |
int | getFetchSize() 获取此 ResultSet 对象的获取大小。 |
float | getFloat(int columnIndex) 以 Java 编程语言中 float 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
float | getFloat(String columnLabel) 以 Java 编程语言中 float 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
int | getHoldability() 获取此 ResultSet 对象的可保存性 |
int | getInt(int columnIndex) 以 Java 编程语言中 int 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
int | getInt(String columnLabel) 以 Java 编程语言中 int 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
long | getLong(int columnIndex) 以 Java 编程语言中 long 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
long | getLong(String columnLabel) 以 Java 编程语言中 long 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
ResultSetMetaData | getMetaData() 获取此 ResultSet 对象的列的编号、类型和属性。 |
Reader | getNCharacterStream(int columnIndex) 以 java.io.Reader 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Reader | getNCharacterStream(String columnLabel) 以 java.io.Reader 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
NClob | getNClob(int columnIndex) 以 Java 编程语言中 NClob 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
NClob | getNClob(String columnLabel) 以 Java 编程语言中 NClob 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
String | getNString(int columnIndex) 以 Java 编程语言中 String 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
String | getNString(String columnLabel) 以 Java 编程语言中 String 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Object | getObject(int columnIndex) 以 Java 编程语言中 Object 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Object | getObject(int columnIndex, Map<String,Class<?>> map) 以 Java 编程语言中 Object 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Object | getObject(String columnLabel) 以 Java 编程语言中 Object 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Object | getObject(String columnLabel, Map<String,Class<?>> map) 以 Java 编程语言中 Object 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Ref | getRef(int columnIndex) 以 Java 编程语言中 Ref 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Ref | getRef(String columnLabel) 以 Java 编程语言中 Ref 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
int | getRow() 获取当前行编号。 |
RowId | getRowId(int columnIndex) 以 Java 编程语言中 java.sql.RowId 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
RowId | getRowId(String columnLabel) 以 Java 编程语言中 java.sql.RowId 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
short | getShort(int columnIndex) 以 Java 编程语言中 short 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
short | getShort(String columnLabel) 以 Java 编程语言中 short 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
SQLXML | getSQLXML(int columnIndex) 以 Java 编程语言中 java.sql.SQLXML 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
SQLXML | getSQLXML(String columnLabel) 以 Java 编程语言中 java.sql.SQLXML 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Statement | getStatement() 获取生成此 ResultSet 对象的 Statement 对象。 |
String | getString(int columnIndex) 以 Java 编程语言中 String 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
String | getString(String columnLabel) 以 Java 编程语言中 String 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Time | getTime(int columnIndex) 以 Java 编程语言中 java.sql.Time 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Time | getTime(int columnIndex, Calendar cal) 以 Java 编程语言中 java.sql.Time 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Time | getTime(String columnLabel) 以 Java 编程语言中 java.sql.Time 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Time | getTime(String columnLabel, Calendar cal) 以 Java 编程语言中 java.sql.Time 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Timestamp | getTimestamp(int columnIndex) 以 Java 编程语言中 java.sql.Timestamp 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Timestamp | getTimestamp(int columnIndex, Calendar cal) 以 Java 编程语言中 java.sql.Timestamp 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Timestamp | getTimestamp(String columnLabel) 以 Java 编程语言中 java.sql.Timestamp 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Timestamp | getTimestamp(String columnLabel, Calendar cal) 以 Java 编程语言中 java.sql.Timestamp 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
int | getType() 获取此 ResultSet 对象的类型。 |
InputStream | getUnicodeStream(int columnIndex) 已过时。 使用 getCharacterStream 取代 getUnicodeStream |
InputStream | getUnicodeStream(String columnLabel) 已过时。 使用 getCharacterStream 代替 |
URL | getURL(int columnIndex) 以 Java 编程语言中 java.net.URL 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
URL | getURL(String columnLabel) 以 Java 编程语言中 java.net.URL 对象的形式获取此 ResultSet 对象的当前行中指定列的值。 |
SQLWarning | getWarnings() 获取此 ResultSet 对象上的调用报告的第一个警告。 |
void | insertRow() 将插入行的内容插入到此 ResultSet 对象和数据库中。 |
boolean | isAfterLast() 获取光标是否位于此 ResultSet 对象的最后一行之后。 |
boolean | isBeforeFirst() 获取光标是否位于此 ResultSet 对象的第一行之前。 |
boolean | isClosed() 获取此 ResultSet 对象是否已关闭。 |
boolean | isFirst() 获取光标是否位于此 ResultSet 对象的第一行。 |
boolean | isLast() 获取光标是否位于此 ResultSet 对象的最后一行。 |
boolean | last() 将光标移动到此 ResultSet 对象的最后一行。 |
void | moveToCurrentRow() 将光标移动到记住的光标位置,通常为当前行。 |
void | moveToInsertRow() 将光标移动到插入行。 |
boolean | next() 将光标从当前位置向前移一行。 |
boolean | previous() 将光标移动到此 ResultSet 对象的上一行。 |
void | refreshRow() 用数据库中的最近值刷新当前行。 |
boolean | relative(int rows) 按相对行数(或正或负)移动光标。 |
boolean | rowDeleted() 获取是否已删除某行。 |
boolean | rowInserted() 获取当前行是否已有插入。 |
boolean | rowUpdated() 获取是否已更新当前行。 |
void | setFetchDirection(int direction) 设置此 ResultSet 对象中行的处理方向。 |
void | setFetchSize(int rows) 为 JDBC 驱动程序设置此 ResultSet 对象需要更多行时应该从数据库获取的行数。 |
void | updateArray(int columnIndex, Array x) 用 java.sql.Array 值更新指定列。 |
void | updateArray(String columnLabel, Array x) 用 java.sql.Array 值更新指定列。 |
void | updateAsciiStream(int columnIndex, InputStream x) 用 ascii 流值更新指定的列。 |
void | updateAsciiStream(int columnIndex, InputStream x, int length) 用 ascii 流值更新指定列,该列将具有指定字节数。 |
void | updateAsciiStream(int columnIndex, InputStream x, long length) 用 ascii 流值更新指定的列,该值将具有指定的字节数。 |
void | updateAsciiStream(String columnLabel, InputStream x) 用 ascii 流值更新指定列。 |
void | updateAsciiStream(String columnLabel, InputStream x, int length) 用 ascii 流值更新指定列,该列具有指定的字节数。 |
void | updateAsciiStream(String columnLabel, InputStream x, long length) 用 ascii 流值更新指定的列,该值将具有指定的字节数。 |
void | updateBigDecimal(int columnIndex, BigDecimal x) 用 java.math.BigDecimal 值更新指定列。 |
void | updateBigDecimal(String columnLabel, BigDecimal x) 用 java.sql.BigDecimal 值更新指定列。 |
void | updateBinaryStream(int columnIndex, InputStream x) 用二进制流值更新指定的列。 |
void | updateBinaryStream(int columnIndex, InputStream x, int length) 用二进制流值更新指定列,该列将具有指定字节数。 |
void | updateBinaryStream(int columnIndex, InputStream x, long length) 用二进制流值更新指定的列,该值将具有指定的字节数。 |
void | updateBinaryStream(String columnLabel, InputStream x) 用二进制流值更新指定列。 |
void | updateBinaryStream(String columnLabel, InputStream x, int length) 用二进制流值更新指定列,该列具有指定的字节数。 |
void | updateBinaryStream(String columnLabel, InputStream x, long length) 用二进制流值更新指定的列,该值将具有指定的字节数。 |
void | updateBlob(int columnIndex, Blob x) 用 java.sql.Blob 值更新指定列。 |
void | updateBlob(int columnIndex, InputStream inputStream) 使用给定输入流值更新指定列。 |
void | updateBlob(int columnIndex, InputStream inputStream, long length) 使用给定输入流更新指定的列,该流将具有指定的字节数。 |
void | updateBlob(String columnLabel, Blob x) 用 java.sql.Blob 值更新指定列。 |
void | updateBlob(String columnLabel, InputStream inputStream) 使用给定输入流值更新指定列。 |
void | updateBlob(String columnLabel, InputStream inputStream, long length) 使用给定输入流更新指定列,该流将具有指定的字节数。 |
void | updateBoolean(int columnIndex, boolean x) 用 boolean 值更新指定列。 |
void | updateBoolean(String columnLabel, boolean x) 用 boolean 值更新指定列。 |
void | updateByte(int columnIndex, byte x) 用 byte 值更新指定列。 |
void | updateByte(String columnLabel, byte x) 用 byte 值更新指定列。 |
void | updateBytes(int columnIndex, byte[] x) 用 byte 数组值更新指定列。 |
void | updateBytes(String columnLabel, byte[] x) 用字节数组值更新指定列。 |
void | updateCharacterStream(int columnIndex, Reader x) 用字符流值更新指定的列。 |
void | updateCharacterStream(int columnIndex, Reader x, int length) 用字符流值更新指定列,该列将具有指定字节数。 |
void | updateCharacterStream(int columnIndex, Reader x, long length) 用字符流值更新指定的列,该值将具有指定的字节数。 |
void | updateCharacterStream(String columnLabel, Reader reader) 用字符流值更新指定列。 |
void | updateCharacterStream(String columnLabel, Reader reader, int length) 用字符流值更新指定列,该列具有指定的字节数。 |
void | updateCharacterStream(String columnLabel, Reader reader, long length) 用字符流值更新指定的列,该值将具有指定的字节数。 |
void | updateClob(int columnIndex, Clob x) 用 java.sql.Clob 值更新指定列。 |
void | updateClob(int columnIndex, Reader reader) 使用给定的 Reader 对象更新指定列。 |
void | updateClob(int columnIndex, Reader reader, long length) 使用给定的 Reader 对象更新指定列,该对象是给定的字符长度数目。 |
void | updateClob(String columnLabel, Clob x) 用 java.sql.Clob 值更新指定列。 |
void | updateClob(String columnLabel, Reader reader) 使用给定的 Reader 对象更新指定列。 |
void | updateClob(String columnLabel, Reader reader, long length) 使用给定的 Reader 对象更新指定列,该对象是给定的字符长度数目。 |
void | updateDate(int columnIndex, Date x) 用 java.sql.Date 值更新指定列。 |
void | updateDate(String columnLabel, Date x) 用 java.sql.Date 值更新指定列。 |
void | updateDouble(int columnIndex, double x) 用 double 值更新指定列。 |
void | updateDouble(String columnLabel, double x) 用 double 值更新指定列。 |
void | updateFloat(int columnIndex, float x) 用 float 值更新指定列。 |
void | updateFloat(String columnLabel, float x) 用 float 值更新指定列。 |
void | updateInt(int columnIndex, int x) 用 int 值更新指定列。 |
void | updateInt(String columnLabel, int x) 用 int 值更新指定列。 |
void | updateLong(int columnIndex, long x) 用 long 值更新指定列。 |
void | updateLong(String columnLabel, long x) 用 long 值更新指定列。 |
void | updateNCharacterStream(int columnIndex, Reader x) 用字符流值更新指定的列。 |
void | updateNCharacterStream(int columnIndex, Reader x, long length) 用字符流值更新指定的列,该值将具有指定的字节数。 |
void | updateNCharacterStream(String columnLabel, Reader reader) 用字符流值更新指定的列。 |
void | updateNCharacterStream(String columnLabel, Reader reader, long length) 用字符流值更新指定的列,该值将具有指定的字节数。 |
void | updateNClob(int columnIndex, NClob nClob) 用 java.sql.NClob 值更新指定的列。 |
void | updateNClob(int columnIndex, Reader reader) 使用给定的 Reader 对象更新指定列。 |
void | updateNClob(int columnIndex, Reader reader, long length) 使用给定的 Reader 对象更新指定的列,该对象是给定的字符长度数目。 |
void | updateNClob(String columnLabel, NClob nClob) 用 java.sql.NClob 值更新指定的列。 |
void | updateNClob(String columnLabel, Reader reader) 使用给定的 Reader 对象更新指定列。 |
void | updateNClob(String columnLabel, Reader reader, long length) 使用给定的 Reader 对象更新指定的列,该对象是给定的字符长度数目。 |
void | updateNString(int columnIndex, String nString) 用 String 值更新指定的列。 |
void | updateNString(String columnLabel, String nString) 用 String 值更新指定的列。 |
void | updateNull(int columnIndex) 用 null 值更新指定列。 |
void | updateNull(String columnLabel) 用 null 值更新指定列。 |
void | updateObject(int columnIndex, Object x) 用 Object 值更新指定列。 |
void | updateObject(int columnIndex, Object x, int scaleOrLength) 用 Object 值更新指定列。 |
void | updateObject(String columnLabel, Object x) 用 Object 值更新指定列。 |
void | updateObject(String columnLabel, Object x, int scaleOrLength) 用 Object 值更新指定列。 |
void | updateRef(int columnIndex, Ref x) 用 java.sql.Ref 值更新指定列。 |
void | updateRef(String columnLabel, Ref x) 用 java.sql.Ref 值更新指定列。 |
void | updateRow() 用此 ResultSet 对象的当前行的新内容更新底层数据库。 |
void | updateRowId(int columnIndex, RowId x) 用 RowId 值更新指定列。 |
void | updateRowId(String columnLabel, RowId x) 用 RowId 值更新指定的列。 |
void | updateShort(int columnIndex, short x) 用 short 值更新指定列。 |
void | updateShort(String columnLabel, short x) 用 short 值更新指定列。 |
void | updateSQLXML(int columnIndex, SQLXML xmlObject) 用 java.sql.SQLXML 值更新指定列。 |
void | updateSQLXML(String columnLabel, SQLXML xmlObject) 用 java.sql.SQLXML 值更新指定的列。 |
void | updateString(int columnIndex, String x) 用 String 值更新指定列。 |
void | updateString(String columnLabel, String x) 用 String 值更新指定列。 |
void | updateTime(int columnIndex, Time x) 用 java.sql.Time 值更新指定列。 |
void | updateTime(String columnLabel, Time x) 用 java.sql.Time 值更新指定列。 |
void | updateTimestamp(int columnIndex, Timestamp x) 用 java.sql.Timestamp 值更新指定列。 |
void | updateTimestamp(String columnLabel, Timestamp x) 用 java.sql.Timestamp 值更新指定列。 |
boolean | wasNull() 报告最后一个读取的列是否具有值 SQL NULL 。 |
从接口 java.sql.Wrapper 继承的方法 |
---|
isWrapperFor, unwrap |
字段详细信息 |
---|
FETCH_FORWARD
static final int FETCH_FORWARD
-
该常量指示将按正向(即从第一个到最后一个)处理结果集中的行。
setFetchDirection
方法将此常量用作驱动程序的提示,驱动程序可能忽略它。-
从以下版本开始:
- 1.2 另请参见:
- 常量字段值
FETCH_REVERSE
static final int FETCH_REVERSE
-
该常量指示将按逆向(即从最后一个到第一个)处理结果集中的行处理。
setFetchDirection
方法将此常量用作驱动程序的提示,驱动程序可能忽略它。-
从以下版本开始:
- 1.2 另请参见:
- 常量字段值
FETCH_UNKNOWN
static final int FETCH_UNKNOWN
-
该常量指示结果集中的行的处理顺序未知。
setFetchDirection
方法将此常量用作驱动程序的提示,驱动程序可能忽略它。-
另请参见:
- 常量字段值
TYPE_FORWARD_ONLY
static final int TYPE_FORWARD_ONLY
-
该常量指示光标只能向前移动的
ResultSet
对象的类型。-
从以下版本开始:
- 1.2 另请参见:
- 常量字段值
TYPE_SCROLL_INSENSITIVE
static final int TYPE_SCROLL_INSENSITIVE
-
该常量指示可滚动但通常不受
ResultSet
底层数据更改影响的ResultSet
对象的类型。-
从以下版本开始:
- 1.2 另请参见:
- 常量字段值
TYPE_SCROLL_SENSITIVE
static final int TYPE_SCROLL_SENSITIVE
-
该常量指示可滚动并且通常受
ResultSet
底层数据更改影响的ResultSet
对象的类型。-
从以下版本开始:
- 1.2 另请参见:
- 常量字段值
CONCUR_READ_ONLY
static final int CONCUR_READ_ONLY
-
该常量指示不可以更新的
ResultSet
对象的并发模式。-
从以下版本开始:
- 1.2 另请参见:
- 常量字段值
CONCUR_UPDATABLE
static final int CONCUR_UPDATABLE
-
该常量指示可以更新的
ResultSet
对象的并发模式。-
从以下版本开始:
- 1.2 另请参见:
- 常量字段值
HOLD_CURSORS_OVER_COMMIT
static final int HOLD_CURSORS_OVER_COMMIT
-
该常量指示提交当前事务时,具有此可保存性的打开的
ResultSet
对象将保持开放。-
从以下版本开始:
- 1.4 另请参见:
- 常量字段值
CLOSE_CURSORS_AT_COMMIT
static final int CLOSE_CURSORS_AT_COMMIT
-
该常量指示提交当前事务时,具有此可保存性的打开的
ResultSet
对象将被关闭。-
从以下版本开始:
- 1.4 另请参见:
- 常量字段值
方法详细信息 |
---|
next
boolean next() throws SQLException
-
将光标从当前位置向前移一行。
ResultSet
光标最初位于第一行之前;第一次调用next
方法使第一行成为当前行;第二次调用使第二行成为当前行,依此类推。当调用
next
方法返回false
时,光标位于最后一行的后面。任何要求当前行的ResultSet
方法调用将导致抛出SQLException
。如果结果集的类型是TYPE_FORWARD_ONLY
,则其 JDBC 驱动程序实现对后续next
调用是返回false
还是抛出SQLException
将由供应商指定。如果对当前行开启了输入流,则调用
next
方法将隐式关闭它。读取新行时,将清除ResultSet
对象的警告链。 -
-
-
返回:
-
如果新的当前行有效,则返回
true
;如果不存在下一行,则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
如果新的当前行有效,则返回
close
void close() throws SQLException
-
立即释放此
ResultSet
对象的数据库和 JDBC 资源,而不是等待该对象自动关闭时发生此操作。关闭
ResultSet
对象不会关闭ResultSet
创建的Blob
、Clob
或NClob
对象。Blob
、Clob
或NClob
对象至少在创建它们的事务期间持续有效,除非调用了其free
方法。当关闭
ResultSet
时,所有通过调用getMetaData
方法创建的ResultSetMetaData
实例都可以访问。注:当生成
ResultSet
对象的Statement
对象关闭、重新执行或用来从多个结果的序列获取下一个结果时,该Statement
对象将自动关闭ResultSet
对象。在已关闭的
ResultSet
对象上调用close
方法是无操作 (no-op)。 -
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误
-
wasNull
boolean wasNull() throws SQLException
-
报告最后一个读取的列是否具有值 SQL
NULL
。注意,必须首先对列调用一个获取方法尝试读取其值,然后调用wasNull
方法查看读取的值是否为 SQLNULL
。 -
-
-
返回:
-
如果最后一个读取的列值为 SQL
NULL
,则返回true
;否则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
如果最后一个读取的列值为 SQL
getString
String getString(int columnIndex) throws SQLException
-
以 Java 编程语言中
String
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getBoolean
boolean getBoolean(int columnIndex) throws SQLException
-
以 Java 编程语言中
boolean
的形式获取此ResultSet
对象的当前行中指定列的值。如果指定列的数据类型为 CHAR 或 VARCHAR 且包含 "0",或者数据类型为 BIT、TINYINT、SMALLINT、INTEGER 或 BIGINT 且包含 0,则返回
false
值。如果指定列的数据类型为 CHAR 或 VARCHAR 且包含 "1",或者数据类型为 BIT、TINYINT、SMALLINT、INTEGER 或 BIGINT 且包含 1,则返回true
值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为false
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getByte
byte getByte(int columnIndex) throws SQLException
-
以 Java 编程语言中
byte
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getShort
short getShort(int columnIndex) throws SQLException
-
以 Java 编程语言中
short
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getInt
int getInt(int columnIndex) throws SQLException
-
以 Java 编程语言中
int
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getLong
long getLong(int columnIndex) throws SQLException
-
以 Java 编程语言中
long
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getFloat
float getFloat(int columnIndex) throws SQLException
-
以 Java 编程语言中
float
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getDouble
double getDouble(int columnIndex) throws SQLException
-
以 Java 编程语言中
double
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getBigDecimal
BigDecimal getBigDecimal(int columnIndex, int scale) throws SQLException
- 已过时。
-
以 Java 编程语言中
java.sql.BigDecimal
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
scale
- 小数点右边的位数
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
-
getBytes
byte[] getBytes(int columnIndex) throws SQLException
-
以 Java 编程语言中
byte
数组的形式获取此ResultSet
对象的当前行中指定列的值。这些字节表示驱动程序返回的原始值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getDate
Date getDate(int columnIndex) throws SQLException
-
以 Java 编程语言中
java.sql.Date
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getTime
Time getTime(int columnIndex) throws SQLException
-
以 Java 编程语言中
java.sql.Time
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getTimestamp
Timestamp getTimestamp(int columnIndex) throws SQLException
-
以 Java 编程语言中
java.sql.Timestamp
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getAsciiStream
InputStream getAsciiStream(int columnIndex) throws SQLException
-
以 ASCII 字符流的形式获取此
ResultSet
对象的当前行中指定列的值。然后,可以按块从流中读取值。此方法尤其适合于获取很大的 LONGVARCHAR 值。JDBC 驱动程序将执行从数据库格式到 ASCII 的任何必要转换。注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用
InputStream.available
方法时,不管是否存在可用数据,流都可能返回0
。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
以一字节 ASCII 字符流的形式返回传递数据库列值的 Java 输入流;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getUnicodeStream
InputStream getUnicodeStream(int columnIndex) throws SQLException
-
已过时。
使用
getCharacterStream
取代getUnicodeStream
-
以两字节 3 字符流的形式获取此
ResultSet
对象的当前行中指定列的值。第一个字节是高字节;第二个字节是低字节。然后,可以按块从流中读取值。此方法尤其适合于获取很大的LONGVARCHAR
值。JDBC 驱动程序将执行从数据库格式到 Unicode 的任何必要转换。注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用
InputStream.available
方法时,不管是否存在可用数据,流都可能返回0
。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
以两字节 Unicode 字符流的形式返回传递数据库列值的 Java 输入流;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
-
getBinaryStream
InputStream getBinaryStream(int columnIndex) throws SQLException
-
以未解释字节的流的形式获取此
ResultSet
对象的当前行中指定列的值。然后,可以按块从流中读取值。此方法尤其适合于获取很大的LONGVARBINARY
值。注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用
InputStream.available
方法时,不管是否存在可用数据,流都可能返回0
。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
以未解释字节的流的形式返回传递数据库列值的 Java 输入流;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getString
String getString(String columnLabel) throws SQLException
-
以 Java 编程语言中
String
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getBoolean
boolean getBoolean(String columnLabel) throws SQLException
-
以 Java 编程语言中
boolean
的形式获取此ResultSet
对象的当前行中指定列的值。如果指定列的数据类型为 CHAR 或 VARCHAR 且包含 "0",或者数据类型为 BIT、TINYINT、SMALLINT、INTEGER 或 BIGINT 且包含 0,则返回
false
值。如果指定列的数据类型为 CHAR 或 VARCHAR 且包含 "1",或者数据类型为 BIT、TINYINT、SMALLINT、INTEGER 或 BIGINT 且包含 1,则返回true
值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为false
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getByte
byte getByte(String columnLabel) throws SQLException
-
以 Java 编程语言中
byte
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getShort
short getShort(String columnLabel) throws SQLException
-
以 Java 编程语言中
short
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getInt
int getInt(String columnLabel) throws SQLException
-
以 Java 编程语言中
int
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getLong
long getLong(String columnLabel) throws SQLException
-
以 Java 编程语言中
long
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getFloat
float getFloat(String columnLabel) throws SQLException
-
以 Java 编程语言中
float
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getDouble
double getDouble(String columnLabel) throws SQLException
-
以 Java 编程语言中
double
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为0
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getBigDecimal
BigDecimal getBigDecimal(String columnLabel, int scale) throws SQLException
- 已过时。
-
以 Java 编程语言中
java.math.BigDecimal
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
scale
- 小数点右边的位数
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
-
getBytes
byte[] getBytes(String columnLabel) throws SQLException
-
以 Java 编程语言中
byte
数组的形式获取此ResultSet
对象的当前行中指定列的值。这些字节表示驱动程序返回的原始值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getDate
Date getDate(String columnLabel) throws SQLException
-
以 Java 编程语言中的
java.sql.Date
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getTime
Time getTime(String columnLabel) throws SQLException
-
以 Java 编程语言中
java.sql.Time
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getTimestamp
Timestamp getTimestamp(String columnLabel) throws SQLException
-
以 Java 编程语言中
java.sql.Timestamp
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getAsciiStream
InputStream getAsciiStream(String columnLabel) throws SQLException
-
以 ASCII 字符流的形式获取此
ResultSet
对象的当前行中指定列的值。然后,可以按块从流中读取值。此方法尤其适合于获取很大的LONGVARCHAR
值。JDBC 驱动程序将执行从数据库格式到 ASCII 的任何必要转换。注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用
available
方法时,不管是否存在可用数据,流都可能返回0
。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
以一字节 ASCII 字符流的形式返回传递数据库列值的 Java 输入流。如果值为 SQL
NULL
,则返回值为null
。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getUnicodeStream
InputStream getUnicodeStream(String columnLabel) throws SQLException
-
已过时。
使用
getCharacterStream
代替 -
以两字节 Unicode 字符流的形式获取此
ResultSet
对象的当前行中指定列的值。第一个字节是高字节;第二个字节是低字节。然后,可以按块从流中读取值。此方法尤其适合于获取很大的LONGVARCHAR
值。采用 JDBC 技术的驱动程序将执行从数据库格式到 Unicode 的任何必要转换。注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用
InputStream.available
方法时,不管是否存在可用数据,流都可能返回0
。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
以两字节 Unicode 字符流的形式返回传递数据库列值的 Java 输入流。如果值为 SQL
NULL
,则返回值为null
。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
-
getBinaryStream
InputStream getBinaryStream(String columnLabel) throws SQLException
-
以未解释的
byte
流的形式获取此ResultSet
对象的当前行中指定列的值。然后,可以按块从流中读取该值。此方法尤其适合于获取很大的LONGVARBINARY
值。注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用
available
方法时,不管是否存在可用数据,流都可能返回0
。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
以未解释字节流的形式返回传递数据库列值的 Java 输入流;如果值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getWarnings
SQLWarning getWarnings() throws SQLException
-
获取此
ResultSet
对象上的调用报告的第一个警告。此ResultSet
对象上的后续警告会被链接到此方法返回的SQLWarning
对象。每次读取新行时,都会自动清除警告链。不可以在已经关闭的
ResultSet
对象上调用此方法;这样做将导致抛出SQLException
。注:此警告链仅包含
ResultSet
方法产生的警告。Statement
方法(如读取 OUT 参数)产生的任何警告都将链接在Statement
对象上。 -
-
-
返回:
-
报告的第一个
SQLWarning
对象;如果不存在,则返回null
抛出:
-
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
-
报告的第一个
clearWarnings
void clearWarnings() throws SQLException
-
清除在此
ResultSet
对象上报告的所有警告。调用此方法后,在为此ResultSet
对象报告新的警告之前,getWarnings
方法将返回null
。 -
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getCursorName
String getCursorName() throws SQLException
-
获取此
ResultSet
对象使用的 SQL 光标的名称。在 SQL 中,通过指定的光标获取结果表。通过一个引用光标名称来定位的更新/删除语句,可以更新或删除结果集的当前行。为了确保光标具有支持更新的适当隔离级别,光标的
SELECT
语句的形式应该为SELECT FOR UPDATE
。如果省略FOR UPDATE
,则定位更新可能失败。JDBC API 通过提供
ResultSet
对象使用的 SQL 光标的名称支持此 SQL 功能。ResultSet
对象的当前行也是此 SQL 光标的当前行。 -
-
-
返回:
-
此
ResultSet
对象的光标的 SQL 名称
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
-
此
getMetaData
ResultSetMetaData getMetaData() throws SQLException
-
获取此
ResultSet
对象的列的编号、类型和属性。 -
-
-
返回:
-
此
ResultSet
对象的列的描述
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
此
getObject
Object getObject(int columnIndex) throws SQLException
-
以 Java 编程语言中
Object
的形式获取此ResultSet
对象的当前行中指定列的值。此方法将以 Java 对象的形式返回给定列的值。Java 对象的类型将为与该列的 SQL 类型相对应的默认 Java 对象类型,它遵守在 JDBC 规范中指定的内置类型的映射关系。如果值为 SQL
NULL
,则驱动程序返回一个 Javanull
。此方法还可用于读取特定于数据库的抽象数据类型。在 JDBC 2.0 API 中,可以扩展
getObject
方法的行为来实现 SQL 自定义类型的数据。如果
Connection.getTypeMap
不抛出SQLFeatureNotSupportedException
,则当列包含结构值或独特值时,此方法的行为类似于调用:getObject(columnIndex, this.getStatement().getConnection().getTypeMap())
。如果Connection.getTypeMap
抛出SQLFeatureNotSupportedException
,则结构值不受支持,独特值映射到 DISTINCT 类型的底层 SQL 类型确定的默认 Java 类。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
保存列值的
java.lang.Object
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
-
getObject
Object getObject(String columnLabel) throws SQLException
-
以 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
int findColumn(String columnLabel) throws SQLException
-
将给定的
ResultSet
列标签映射到其ResultSet
列索引。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
- 给定列名称的列索引 抛出:
-
SQLException
- 如果ResultSet
对象不包含标记为columnLabel
的列,发生数据库访问错误或在已关闭的结果集上调用此方法
-
getCharacterStream
Reader getCharacterStream(int columnIndex) throws SQLException
-
以
java.io.Reader
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
包含列值的
java.io.Reader
对象;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
getCharacterStream
Reader getCharacterStream(String columnLabel) throws SQLException
-
以
java.io.Reader
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
包含列值的
java.io.Reader
对象;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
getBigDecimal
BigDecimal getBigDecimal(int columnIndex) throws SQLException
-
以具有全精度的
java.math.BigDecimal
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值(全精度);如果值为 SQL
NULL
,则返回值为 Java 编程语言中的null
。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
getBigDecimal
BigDecimal getBigDecimal(String columnLabel) throws SQLException
-
以具有全精度的
java.math.BigDecimal
的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值(全精度);如果值为 SQL
NULL
,则返回值为 Java 编程语言中的null
。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
isBeforeFirst
boolean isBeforeFirst() throws SQLException
-
获取光标是否位于此
ResultSet
对象的第一行之前。注:对于带有
TYPE_FORWARD_ONLY
的结果集类型的ResultSet
,对isBeforeFirst
方法的支持是可选的 -
-
-
返回:
-
如果光标位于第一行之前,则返回
true
;如果光标位于任何其他位置或者结果集不包含任何行,则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
如果光标位于第一行之前,则返回
isAfterLast
boolean isAfterLast() throws SQLException
-
获取光标是否位于此
ResultSet
对象的最后一行之后。注:对于带有
TYPE_FORWARD_ONLY
的结果集类型的ResultSet
,对isAfterLast
方法的支持是可选的 -
-
-
返回:
-
如果光标位于最后一行之后,则返回
true
;如果光标位于任何其他位置或者结果集不包含任何行,则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
如果光标位于最后一行之后,则返回
isFirst
boolean isFirst() throws SQLException
-
获取光标是否位于此
ResultSet
对象的第一行。注:对于带有
TYPE_FORWARD_ONLY
的结果集类型的ResultSet
,对isFirst
方法的支持是可选的 -
-
-
返回:
-
如果光标位于第一行,则返回
true
;否则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
如果光标位于第一行,则返回
isLast
boolean isLast() throws SQLException
-
获取光标是否位于此
ResultSet
对象的最后一行。 注:调用isLast
方法可能开销很大,因为 JDBC 驱动程序可能需要再往后获取一行,以确定当前行是否为结果集中的最后一行。注:对于带有
TYPE_FORWARD_ONLY
的结果集类型的ResultSet
,对isLast
方法的支持是可选的 -
-
-
返回:
-
如果光标位于最后一行上,则返回
true
;否则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
如果光标位于最后一行上,则返回
beforeFirst
void beforeFirst() throws SQLException
-
将光标移动到此
ResultSet
对象的开头,正好位于第一行之前。如果结果集中不包含任何行,则此方法无效。 -
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
afterLast
void afterLast() throws SQLException
-
将光标移动到此
ResultSet
对象的末尾,正好位于最后一行之后。如果结果集中不包含任何行,则此方法无效。 -
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
first
boolean first() throws SQLException
-
将光标移动到此
ResultSet
对象的第一行。 -
-
-
返回:
-
如果光标位于有效行,则返回
true
;如果结果集中不存在任何行,则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
如果光标位于有效行,则返回
last
boolean last() throws SQLException
-
将光标移动到此
ResultSet
对象的最后一行。 -
-
-
返回:
-
如果光标位于有效行,则返回
true
;如果结果集中不存在任何行,则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
如果光标位于有效行,则返回
getRow
int getRow() throws SQLException
-
获取当前行编号。第一行为 1 号,第二行为 2 号,依此类推。
注:对于带有
TYPE_FORWARD_ONLY
的结果集类型的ResultSet
,对getRow
方法的支持是可选的 -
-
-
返回:
-
当前行的编号;如果不存在当前行,则返回
0
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
当前行的编号;如果不存在当前行,则返回
absolute
boolean absolute(int row) throws SQLException
-
将光标移动到此
ResultSet
对象的给定行编号。如果行编号为正,则将光标移动到相对于结果集开头的给定行编号。第一行为行 1,第二行为行 2,依此类推。
如果给定行编号为负,则将光标移动到相对于结果集末尾的绝对行位置。例如,调用方法
absolute(-1)
将光标置于最后一行;调用方法absolute(-2)
将光标移动到倒数第二行,依此类推。试图将光标置于结果集的第一行/最后一行之外将导致光标位于第一行之前或最后一行之后。
注:调用
absolute(1)
等效于调用first()
。调用absolute(-1)
等效于调用last()
。 -
-
-
参数:
-
row
- 光标应该移动到的行的编号。正的编号指示从结果集开头开始计数的行编号;负的编号指示从结果集末尾开始计数的行编号
返回:
-
如果光标移动到此
ResultSet
对象的位置处,则返回true
;如果光标在第一行的前面或最后一行的后面,则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
relative
boolean relative(int rows) throws SQLException
-
按相对行数(或正或负)移动光标。试图移动到结果集的第一行/最后一行之外,会将光标置于第一行之前或最后一行之后。调用
relative(0)
有效,但是不更改光标位置。注:调用方法
relative(1)
等效于调用方法next()
,而调用方法relative(-1)
等效于调用方法previous()
。 -
-
-
参数:
-
rows
- 指定从当前行开始移动的行数的int
;正数表示光标向前移动;负数表示光标向后移动
返回:
-
如果光标位于行上,则返回
true
;否则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
previous
boolean previous() throws SQLException
-
将光标移动到此
ResultSet
对象的上一行。当调用
previous
方法返回false
时,光标位于第一行之前。要求当前行的任何ResultSet
方法的调用将导致抛出SQLException
。如果开启了对当前行的输入流,则调用
previous
方法将隐式关闭它。读取新的一行时清除ResultSet
对象的警告更改。 -
-
-
返回:
-
如果光标现在位于有效行上,则返回
true
;如果光标位于第一行的前面,则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
如果光标现在位于有效行上,则返回
setFetchDirection
void setFetchDirection(int direction) throws SQLException
-
设置此
ResultSet
对象中行的处理方向。初始值由生成此ResultSet
对象的Statement
对象确定。获取方向可以在任何时间更改。 -
-
-
参数:
-
direction
- 指定建议获取方向的int
;ResultSet.FETCH_FORWARD
、ResultSet.FETCH_REVERSE
或ResultSet.FETCH_UNKNOWN
之一
抛出:
-
SQLException
- 如果发生数据库访问错误,在已关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY
但获取方向不是FETCH_FORWARD
从以下版本开始:
- 1.2 另请参见:
- Statement.setFetchDirection(int), getFetchDirection()
-
getFetchDirection
int getFetchDirection() throws SQLException
-
获取此
ResultSet
对象的获取方向。 -
-
-
返回:
-
此
ResultSet
对象的当前获取方向
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2 另请参见:
- setFetchDirection(int)
-
此
setFetchSize
void setFetchSize(int rows) throws SQLException
-
为 JDBC 驱动程序设置此
ResultSet
对象需要更多行时应该从数据库获取的行数。如果指定的获取大小为零,则 JDBC 驱动程序忽略该值,随意对获取大小作出它自己的最佳猜测。默认值由创建结果集的Statement
对象设置。获取大小可以在任何时间更改。 -
-
-
参数:
-
rows
- 要获取的行数
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或不满足条件rows >= 0
从以下版本开始:
- 1.2 另请参见:
- getFetchSize()
-
getFetchSize
int getFetchSize() throws SQLException
-
获取此
ResultSet
对象的获取大小。 -
-
-
返回:
-
此
ResultSet
对象的当前获取大小
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2 另请参见:
- setFetchSize(int)
-
此
getType
int getType() throws SQLException
-
获取此
ResultSet
对象的类型。类型由创建结果集的Statement
对象确定。 -
-
-
返回:
-
ResultSet.TYPE_FORWARD_ONLY
、ResultSet.TYPE_SCROLL_INSENSITIVE
或ResultSet.TYPE_SCROLL_SENSITIVE
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
getConcurrency
int getConcurrency() throws SQLException
-
获取此
ResultSet
对象的并发模式。使用的并发由创建结果集的Statement
对象确定。 -
-
-
返回:
-
并发类型,
ResultSet.CONCUR_READ_ONLY
或ResultSet.CONCUR_UPDATABLE
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
并发类型,
rowUpdated
boolean rowUpdated() throws SQLException
-
获取是否已更新当前行。返回值取决于结果集是否可以检测到更新。
注:对于
CONCUR_READ_ONLY
的结果集并发性,对rowUpdated
方法的支持是可选的 -
-
-
返回:
-
如果所有者和其他人检测到当前行已进行可见更新,则返回
true
;否则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2 另请参见:
- DatabaseMetaData.updatesAreDetected(int)
-
如果所有者和其他人检测到当前行已进行可见更新,则返回
rowInserted
boolean rowInserted() throws SQLException
-
获取当前行是否已有插入。返回值取决于此
ResultSet
对象是否可以检测到可见插入。注:对于
CONCUR_READ_ONLY
的结果集并发性,对rowUpdated
方法的支持是可选的 -
-
-
返回:
-
如果当前检测到已插入,则返回
true
;否则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2 另请参见:
- DatabaseMetaData.insertsAreDetected(int)
-
如果当前检测到已插入,则返回
rowDeleted
boolean rowDeleted() throws SQLException
-
获取是否已删除某行。删除的行可能在结果集中留下一个可见的“洞”。此方法可用于检测结果集中的洞。返回值取决于此
ResultSet
对象是否可以检测到删除。注:对于
CONCUR_READ_ONLY
的结果集并发性,对rowDeleted
方法的支持是可选的 -
-
-
返回:
-
如果所有者或其他人检测到当前行已删除,则返回
true
;否则返回false
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2 另请参见:
- DatabaseMetaData.deletesAreDetected(int)
-
如果所有者或其他人检测到当前行已删除,则返回
updateNull
void updateNull(int columnIndex) throws SQLException
-
用
null
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateBoolean
void updateBoolean(int columnIndex, boolean x) throws SQLException
-
用
boolean
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateByte
void updateByte(int columnIndex, byte x) throws SQLException
-
用
byte
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateShort
void updateShort(int columnIndex, short x) throws SQLException
-
用
short
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateInt
void updateInt(int columnIndex, int x) throws SQLException
-
用
int
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateLong
void updateLong(int columnIndex, long x) throws SQLException
-
用
long
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会不更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateFloat
void updateFloat(int columnIndex, float x) throws SQLException
-
用
float
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateDouble
void updateDouble(int columnIndex, double x) throws SQLException
-
用
double
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateBigDecimal
void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException
-
用
java.math.BigDecimal
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateString
void updateString(int columnIndex, String x) throws SQLException
-
用
String
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateBytes
void updateBytes(int columnIndex, byte[] x) throws SQLException
-
用
byte
数组值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateDate
void updateDate(int columnIndex, Date x) throws SQLException
-
用
java.sql.Date
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateTime
void updateTime(int columnIndex, Time x) throws SQLException
-
用
java.sql.Time
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateTimestamp
void updateTimestamp(int columnIndex, Timestamp x) throws SQLException
-
用
java.sql.Timestamp
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateAsciiStream
void updateAsciiStream(int columnIndex, InputStream x, int length) throws SQLException
-
用 ascii 流值更新指定列,该列将具有指定字节数。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值 -
length
- 流的长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateBinaryStream
void updateBinaryStream(int columnIndex, InputStream x, int length) throws SQLException
-
用二进制流值更新指定列,该列将具有指定字节数。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值 -
length
- 流的长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateCharacterStream
void updateCharacterStream(int columnIndex, Reader x, int length) throws SQLException
-
用字符流值更新指定列,该列将具有指定字节数。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值 -
length
- 流的长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateObject
void updateObject(int columnIndex, Object x, int scaleOrLength) throws SQLException
-
用
Object
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。如果第二个参数是
InputStream
,则该流必须包含 scaleOrLength 指定的字节数。如果第二个参数是Reader
,则它必须包含 scaleOrLength 指定的字符数。如果这些条件不为真,则执行该语句时驱动程序将生成一个SQLException
。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值 -
scaleOrLength
- 对于java.math.BigDecimal
对象,此参数是小数点后的位数。对于 Java 对象类型InputStream
和Reader
,此参数是该流或 reader 中数据的长度。对于其他所有类型,将忽略此值。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateObject
void updateObject(int columnIndex, Object x) throws SQLException
-
用
Object
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateNull
void updateNull(String columnLabel) throws SQLException
-
用
null
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateBoolean
void updateBoolean(String columnLabel, boolean x) throws SQLException
-
用
boolean
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateByte
void updateByte(String columnLabel, byte x) throws SQLException
-
用
byte
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateShort
void updateShort(String columnLabel, short x) throws SQLException
-
用
short
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateInt
void updateInt(String columnLabel, int x) throws SQLException
-
用
int
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateLong
void updateLong(String columnLabel, long x) throws SQLException
-
用
long
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateFloat
void updateFloat(String columnLabel, float x) throws SQLException
-
用
float
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateDouble
void updateDouble(String columnLabel, double x) throws SQLException
-
用
double
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateBigDecimal
void updateBigDecimal(String columnLabel, BigDecimal x) throws SQLException
-
用
java.sql.BigDecimal
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateString
void updateString(String columnLabel, String x) throws SQLException
-
用
String
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateBytes
void updateBytes(String columnLabel, byte[] x) throws SQLException
-
用字节数组值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateDate
void updateDate(String columnLabel, Date x) throws SQLException
-
用
java.sql.Date
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateTime
void updateTime(String columnLabel, Time x) throws SQLException
-
用
java.sql.Time
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateTimestamp
void updateTimestamp(String columnLabel, Timestamp x) throws SQLException
-
用
java.sql.Timestamp
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateAsciiStream
void updateAsciiStream(String columnLabel, InputStream x, int length) throws SQLException
-
用 ascii 流值更新指定列,该列具有指定的字节数。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值 -
length
- 流的长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateBinaryStream
void updateBinaryStream(String columnLabel, InputStream x, int length) throws SQLException
-
用二进制流值更新指定列,该列具有指定的字节数。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值 -
length
- 流的长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateCharacterStream
void updateCharacterStream(String columnLabel, Reader reader, int length) throws SQLException
-
用字符流值更新指定列,该列具有指定的字节数。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
reader
- 包含新列值的java.io.Reader
对象 -
length
- 流的长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateObject
void updateObject(String columnLabel, Object x, int scaleOrLength) throws SQLException
-
用
Object
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。如果第二个参数是
InputStream
,则该流必须包含 scaleOrLength 指定的字节数。如果第二个参数是Reader
,则它必须包含 scaleOrLength 指定的字符数。如果这些条件不为真,则执行该语句时驱动程序将生成一个SQLException
。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值 -
scaleOrLength
- 对于java.math.BigDecimal
对象,此参数是小数点后的位数。对于 Java 对象类型InputStream
和Reader
,此参数是该流或 reader 中数据的长度。 对于其他所有类型,将忽略此值。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateObject
void updateObject(String columnLabel, Object x) throws SQLException
-
用
Object
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
insertRow
void insertRow() throws SQLException
-
将插入行的内容插入到此
ResultSet
对象和数据库中。调用此方法时,光标必须位于插入行上。 -
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法;如果在光标不位于插入行上时调用此方法,或者插入行中所有不可为 null 的列中还存在未分配非 null 值的列 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
updateRow
void updateRow() throws SQLException
-
用此
ResultSet
对象的当前行的新内容更新底层数据库。光标不位于插入行上时不能调用此方法。 -
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
;在已关闭的结果集上调用此方法,或者在光标不位于插入行上时调用了此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
deleteRow
void deleteRow() throws SQLException
-
从此
ResultSet
对象和底层数据库中删除当前行。光标不位于插入行上时不能调用此方法。 -
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
;在已关闭的结果集上调用此方法,或者在光标不位于插入行上时调用了此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
refreshRow
void refreshRow() throws SQLException
-
用数据库中的最近值刷新当前行。光标不位于插入行上时不能调用此方法。
refreshRow
方法提供一种让应用程序显式告知 JDBC 驱动程序从数据库重新获取行的方式。应用程序可能需要在 JDBC 驱动程序完成缓存或预获取操作后调用refreshRow
,以便从数据库获取行的最新值。如果获取大小大于 1,则 JDBC 驱动程序可以一次实际刷新多行。应根据事务隔离级别和光标敏感度确定是否重新获取所有值。如果在调用更新方法之后,但在调用
updateRow
方法之前调用refreshRow
,则会丢失对行所作的更新。频繁调用方法refreshRow
可能导致性能下降。 -
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法;结果集类型为TYPE_FORWARD_ONLY
,或者在光标不位于插入行上时调用了此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法,或者对于指定的结果集类型和结果集并发性此方法不受支持。
从以下版本开始:
- 1.2
-
cancelRowUpdates
void cancelRowUpdates() throws SQLException
-
取消对
ResultSet
对象中的当前行所作的更新。此方法在调用更新方法之后,但在调用updateRow
方法之前调用才可以回滚对行所作的更新。如果没有进行任何更新或者已经调用updateRow
方法,则此方法无效。 -
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法;结果集并发性为CONCUR_READ_ONLY
,或者在光标不位于插入行上时调用了此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
moveToInsertRow
void moveToInsertRow() throws SQLException
-
将光标移动到插入行。将光标置于插入行上时,当前的光标位置会被记住。插入行是一个与可更新结果集相关联的特殊行。它实际上是一个缓冲区,在将行插入到结果集前可以通过调用更新方法在其中构造新行。当光标位于插入行上时,仅能调用更新方法、获取方法以及
insertRow
方法。每次在调用insertRow
之前调用此方法时,必须为结果集中的所有列分配值。在对列值调用获取方法之前,必须调用更新方法。 -
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集并发性为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
moveToCurrentRow
void moveToCurrentRow() throws SQLException
- 将光标移动到记住的光标位置,通常为当前行。如果光标不位于插入行上,则此方法无效。
-
-
-
抛出:
-
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集并发性为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getStatement
Statement getStatement() throws SQLException
-
获取生成此
ResultSet
对象的Statement
对象。如果结果集是以其他方式生成的(如通过DatabaseMetaData
方法),则此方法可能返回null
。 -
-
-
返回:
-
生成此
ResultSet
对象的Statment
对象;如果结果集是以其他方法生成的,则返回null
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
生成此
getObject
Object getObject(int columnIndex, Map<String,Class<?>> map) throws SQLException
-
以 Java 编程语言中
Object
的形式获取此ResultSet
对象的当前行中指定列的值。如果值为 SQLNULL
,则驱动程序返回一个 Javanull
。此方法使用给定的Map
对象作为正在获取的 SQL 结构化或独特类型的自定义映射关系。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
map
- 一个java.util.Map
对象,包含从 SQL 类型名称到 Java 编程语言中类的映射关系
返回:
-
表示 SQL 值的 Java 编程语言中的
Object
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getRef
Ref getRef(int columnIndex) throws SQLException
-
以 Java 编程语言中
Ref
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
表示 SQL
REF
值的Ref
对象
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getBlob
Blob getBlob(int columnIndex) throws SQLException
-
以 Java 编程语言中
Blob
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
表示指定列中的 SQL
BLOB
值的BLOB
对象
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getClob
Clob getClob(int columnIndex) throws SQLException
-
以 Java 编程语言中
Clob
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
表示指定列中的 SQL
Clob
值的Clob
对象
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getArray
Array getArray(int columnIndex) throws SQLException
-
以 Java 编程语言中
Array
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
表示指定列中的 SQL
Array
值的Array
对象
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getObject
Object getObject(String columnLabel, Map<String,Class<?>> map) throws SQLException
-
以 Java 编程语言中
Object
的形式获取此ResultSet
对象的当前行中指定列的值。如果值为 SQLNULL
,则驱动程序返回一个 Javanull
。此方法使用指定的Map
对象自定义映射关系(如果合适)。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
map
- 包含从 SQL 类型名称到 Java 编程语言中类的映射关系的java.util.Map
对象
返回:
-
表示指定列中的 SQL 值的
Object
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getRef
Ref getRef(String columnLabel) throws SQLException
-
以 Java 编程语言中
Ref
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
表示指定列中 SQL
Ref
值的Ref
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getBlob
Blob getBlob(String columnLabel) throws SQLException
-
以 Java 编程语言中
Blob
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
表示指定列中 SQL
Blob
值的Blob
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getClob
Clob getClob(String columnLabel) throws SQLException
-
以 Java 编程语言中
Clob
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
表示指定列中 SQL
CLOB
值的Clob
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getArray
Array getArray(String columnLabel) throws SQLException
-
以 Java 编程语言中
Array
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
表示指定列中 SQL
ARRAY
值的ARRAY
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.2
-
getDate
Date getDate(int columnIndex, Calendar cal) throws SQLException
-
以 Java 编程语言中
java.sql.Date
对象的形式获取此ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造日期的适当毫秒值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
cal
- 在构造日期时使用的java.util.Calendar
对象
返回:
-
java.sql.Date
对象形式的列值;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
getDate
Date getDate(String columnLabel, Calendar cal) throws SQLException
-
以 Java 编程语言中
java.sql.Date
对象的形式获取此ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造日期的适当毫秒值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
cal
- 在构造日期时使用的java.util.Calendar
对象
返回:
-
java.sql.Date
对象形式的列值;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
getTime
Time getTime(int columnIndex, Calendar cal) throws SQLException
-
以 Java 编程语言中
java.sql.Time
对象的形式获取此ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造时间的适当毫秒值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
cal
- 在构造时间时使用的java.util.Calendar
对象
返回:
-
java.sql.Time
对象形式的列值;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
getTime
Time getTime(String columnLabel, Calendar cal) throws SQLException
-
以 Java 编程语言中
java.sql.Time
对象的形式获取此ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造时间的适当毫秒值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
cal
- 在构造时间时使用的java.util.Calendar
对象
返回:
-
java.sql.Time
对象形式的列值;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
getTimestamp
Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException
-
以 Java 编程语言中
java.sql.Timestamp
对象的形式获取此ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造时间戳的适当毫秒值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
cal
- 在构造时间戳时使用的java.util.Calendar
对象
返回:
-
java.sql.Timestamp
对象形式的列值;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
getTimestamp
Timestamp getTimestamp(String columnLabel, Calendar cal) throws SQLException
-
以 Java 编程语言中
java.sql.Timestamp
对象的形式获取此ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造时间戳的适当毫秒值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
cal
- 在构造日期时使用的java.util.Calendar
对象
返回:
-
java.sql.Timestamp
对象形式的列值;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.2
-
getURL
URL getURL(int columnIndex) throws SQLException
-
以 Java 编程语言中
java.net.URL
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 索引,其中第一个列是 1、第二个列是 2,……
返回:
-
java.net.URL
对象形式的列值;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法或 URL 是错误的 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.4
-
getURL
URL getURL(String columnLabel) throws SQLException
-
以 Java 编程语言中
java.net.URL
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
java.net.URL
对象形式的列值;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法,或者 URL 是错误的 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.4
-
updateRef
void updateRef(int columnIndex, Ref x) throws SQLException
-
用
java.sql.Ref
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.4
-
updateRef
void updateRef(String columnLabel, Ref x) throws SQLException
-
用
java.sql.Ref
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.4
-
updateBlob
void updateBlob(int columnIndex, Blob x) throws SQLException
-
用
java.sql.Blob
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.4
-
updateBlob
void updateBlob(String columnLabel, Blob x) throws SQLException
-
用
java.sql.Blob
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.4
-
updateClob
void updateClob(int columnIndex, Clob x) throws SQLException
-
用
java.sql.Clob
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.4
-
updateClob
void updateClob(String columnLabel, Clob x) throws SQLException
-
用
java.sql.Clob
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.4
-
updateArray
void updateArray(int columnIndex, Array x) throws SQLException
-
用
java.sql.Array
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.4
-
updateArray
void updateArray(String columnLabel, Array x) throws SQLException
-
用
java.sql.Array
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.4
-
getRowId
RowId getRowId(int columnIndex) throws SQLException
-
以 Java 编程语言中
java.sql.RowId
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果该值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
getRowId
RowId getRowId(String columnLabel) throws SQLException
-
以 Java 编程语言中
java.sql.RowId
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果该值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateRowId
void updateRowId(int columnIndex, RowId x) throws SQLException
-
用
RowId
值更新指定列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateRowId
void updateRowId(String columnLabel, RowId x) throws SQLException
-
用
RowId
值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
getHoldability
int getHoldability() throws SQLException
-
获取此
ResultSet
对象的可保存性 -
-
-
返回:
-
ResultSet.HOLD_CURSORS_OVER_COMMIT
或ResultSet.CLOSE_CURSORS_AT_COMMIT
抛出:
-
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
从以下版本开始:
- 1.6
-
isClosed
boolean isClosed() throws SQLException
-
获取此
ResultSet
对象是否已关闭。如果已经在ResultSet
上调用了 close 方法,或者ResultSet
自动关闭,则ResultSet
已关闭。 -
-
-
返回:
-
如果此
ResultSet
对象已关闭,则返回 true;如果它仍然是打开的,则返回 false
抛出:
-
SQLException
- 如果发生数据库访问错误
从以下版本开始:
- 1.6
-
如果此
updateNString
void updateNString(int columnIndex, String nString) throws SQLException
-
用
String
值更新指定的列。更新NCHAR
、NVARCHAR
和LONGNVARCHAR
列时使用该方法。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
nString
- 要更新的列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果驱动程序不支持国家字符集 (national character set);如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;结果集并发性为CONCUR_READ_ONLY
或发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNString
void updateNString(String columnLabel, String nString) throws SQLException
-
用
String
值更新指定的列。更新NCHAR
、NVARCHAR
和LONGNVARCHAR
列时使用该方法。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
nString
- 要更新的列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;结果集并发性为CONCUR_READ_ONLY
或发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNClob
void updateNClob(int columnIndex, NClob nClob) throws SQLException
-
用
java.sql.NClob
值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
nClob
- 要更新的列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNClob
void updateNClob(String columnLabel, NClob nClob) throws SQLException
-
用
java.sql.NClob
值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
nClob
- 要更新的列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
getNClob
NClob getNClob(int columnIndex) throws SQLException
-
以 Java 编程语言中
NClob
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
表示指定列中 SQL
NCLOB
值的NClob
对象
抛出:
-
SQLException
- 如果 columnIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法或发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
getNClob
NClob getNClob(String columnLabel) throws SQLException
-
以 Java 编程语言中
NClob
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
表示指定列中 SQL
NCLOB
值的NClob
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法或发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
getSQLXML
SQLXML getSQLXML(int columnIndex) throws SQLException
-
以 Java 编程语言中
java.sql.SQLXML
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
一个映射
SQL XML
值的SQLXML
对象
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
getSQLXML
SQLXML getSQLXML(String columnLabel) throws SQLException
-
以 Java 编程语言中
java.sql.SQLXML
对象的形式获取此ResultSet
对象的当前行中指定列的值。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
一个映射
SQL XML
值的SQLXML
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateSQLXML
void updateSQLXML(int columnIndex, SQLXML xmlObject) throws SQLException
-
用
java.sql.SQLXML
值更新指定列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
xmlObject
- 要更新的列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;在已关闭的结果集上调用此方法;没有为SQLXML
对象关闭java.xml.transform.Result
、Writer
或OutputStream
;如果在处理 XML 值的过程中发生错误或结果集并发性为CONCUR_READ_ONLY
。该异常的getCause
方法可以提供更详细的异常信息,例如,如果该流不包含有效的 XML。 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateSQLXML
void updateSQLXML(String columnLabel, SQLXML xmlObject) throws SQLException
-
用
java.sql.SQLXML
值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
xmlObject
- 列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;在已关闭的结果集上调用此方法;没有为SQLXML
对象关闭java.xml.transform.Result
、Writer
或OutputStream
;如果在处理 XML 值的过程中发生错误或结果集并发性为CONCUR_READ_ONLY
。该异常的getCause
方法可能提供更详细的异常信息,例如,如果该流不包含有效的 XML。 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
getNString
String getNString(int columnIndex) throws SQLException
-
以 Java 编程语言中
String
的形式获取此ResultSet
对象的当前行中指定列的值。访问NCHAR
、NVARCHAR
和LONGNVARCHAR
列时可使用此方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
列值;如果该值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
getNString
String getNString(String columnLabel) throws SQLException
-
以 Java 编程语言中
String
的形式获取此ResultSet
对象的当前行中指定列的值。访问NCHAR
、NVARCHAR
和LONGNVARCHAR
列时可使用此方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
列值;如果该值为 SQL
NULL
,则返回值为null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
getNCharacterStream
Reader getNCharacterStream(int columnIndex) throws SQLException
-
以
java.io.Reader
对象的形式获取此ResultSet
对象的当前行中指定列的值。访问NCHAR
、NVARCHAR
和LONGNVARCHAR
列时可使用此方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,……
返回:
-
包含该列值的
java.io.Reader
对象;如果该值为 SQLNULL
,则返回 Java 编程语言中的值null
。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
getNCharacterStream
Reader getNCharacterStream(String columnLabel) throws SQLException
-
以
java.io.Reader
对象的形式获取此ResultSet
对象的当前行中指定列的值。访问NCHAR
、NVARCHAR
和LONGNVARCHAR
列时可使用此方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
返回:
-
包含该列值的
java.io.Reader
对象;如果该值为 SQLNULL
,则返回 Java 编程语言中的值null
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNCharacterStream
void updateNCharacterStream(int columnIndex, Reader x, long length) throws SQLException
-
用字符流值更新指定的列,该值将具有指定的字节数。驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。更新
NCHAR
、NVARCHAR
和LONGNVARCHAR
列时可使用此方法。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值 -
length
- 流长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNCharacterStream
void updateNCharacterStream(String columnLabel, Reader reader, long length) throws SQLException
-
用字符流值更新指定的列,该值将具有指定的字节数。驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。更新
NCHAR
、NVARCHAR
和LONGNVARCHAR
列时可使用此方法。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
reader
- 包含新列值的java.io.Reader
对象 -
length
- 流长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateAsciiStream
void updateAsciiStream(int columnIndex, InputStream x, long length) throws SQLException
-
用 ascii 流值更新指定的列,该值将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值 -
length
- 流长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateBinaryStream
void updateBinaryStream(int columnIndex, InputStream x, long length) throws SQLException
-
用二进制流值更新指定的列,该值将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值 -
length
- 流长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateCharacterStream
void updateCharacterStream(int columnIndex, Reader x, long length) throws SQLException
-
用字符流值更新指定的列,该值将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值 -
length
- 流长度
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateAsciiStream
void updateAsciiStream(String columnLabel, InputStream x, long length) throws SQLException
-
用 ascii 流值更新指定的列,该值将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值 -
length
- 流长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateBinaryStream
void updateBinaryStream(String columnLabel, InputStream x, long length) throws SQLException
-
用二进制流值更新指定的列,该值将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值 -
length
- 流长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateCharacterStream
void updateCharacterStream(String columnLabel, Reader reader, long length) throws SQLException
-
用字符流值更新指定的列,该值将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
reader
- 包含新列值的java.io.Reader
对象 -
length
- 流长度
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateBlob
void updateBlob(int columnIndex, InputStream inputStream, long length) throws SQLException
-
使用给定输入流更新指定的列,该流将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
inputStream
- 包含用来设置参数值的数据的对象。 -
length
- 参数数据中的字节数。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateBlob
void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException
-
使用给定输入流更新指定列,该流将具有指定的字节数。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
inputStream
- 包含用来设置参数值的数据的对象。 -
length
- 参数数据中的字节数。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateClob
void updateClob(int columnIndex, Reader reader, long length) throws SQLException
-
使用给定的
Reader
对象更新指定列,该对象是给定的字符长度数目。在将一个非常大的 UNICODE 值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更为实际。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
reader
- 包含用来设置参数值的数据的对象。 -
length
- 参数数据中的字符数。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateClob
void updateClob(String columnLabel, Reader reader, long length) throws SQLException
-
使用给定的
Reader
对象更新指定列,该对象是给定的字符长度数目。在将一个非常大的 UNICODE 值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更为实际。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
reader
- 包含用来设置参数值的数据的对象。 -
length
- 参数数据中的字符数。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNClob
void updateNClob(int columnIndex, Reader reader, long length) throws SQLException
-
使用给定的
Reader
对象更新指定的列,该对象是给定的字符长度数目。在将一个非常大的 UNICODE 值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更为实际。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
reader
- 包含用来设置参数值的数据的对象。 -
length
- 参数数据中的字符数。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNClob
void updateNClob(String columnLabel, Reader reader, long length) throws SQLException
-
使用给定的
Reader
对象更新指定的列,该对象是给定的字符长度数目。在将一个非常大的 UNICODE 值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更为实际。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
reader
- 包含用来设置参数值的数据的对象。 -
length
- 参数数据中的字符数。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNCharacterStream
void updateNCharacterStream(int columnIndex, Reader x) throws SQLException
-
用字符流值更新指定的列。将根据需要从流中读取数据,一直读取到流末尾。驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。更新
NCHAR
、NVARCHAR
和LONGNVARCHAR
列时可使用此方法。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateNCharacterStream
是否更有效。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNCharacterStream
void updateNCharacterStream(String columnLabel, Reader reader) throws SQLException
-
用字符流值更新指定的列。将根据需要从流中读取数据,一直读取到流末尾。驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。更新
NCHAR
、NVARCHAR
和LONGNVARCHAR
列时可使用此方法。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateNCharacterStream
是否更有效。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
reader
- 包含新列值的java.io.Reader
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateAsciiStream
void updateAsciiStream(int columnIndex, InputStream x) throws SQLException
-
用 ascii 流值更新指定的列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateAsciiStream
是否更有效。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateBinaryStream
void updateBinaryStream(int columnIndex, InputStream x) throws SQLException
-
用二进制流值更新指定的列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateBinaryStream
是否更有效。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateCharacterStream
void updateCharacterStream(int columnIndex, Reader x) throws SQLException
-
用字符流值更新指定的列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateCharacterStream
是否更有效。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
x
- 新列值
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateAsciiStream
void updateAsciiStream(String columnLabel, InputStream x) throws SQLException
-
用 ascii 流值更新指定列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateAsciiStream
是否更有效。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateBinaryStream
void updateBinaryStream(String columnLabel, InputStream x) throws SQLException
-
用二进制流值更新指定列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateBinaryStream
是否更有效。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
x
- 新列值
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateCharacterStream
void updateCharacterStream(String columnLabel, Reader reader) throws SQLException
-
用字符流值更新指定列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateCharacterStream
是否更有效。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
reader
- 包含新列值的java.io.Reader
对象
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateBlob
void updateBlob(int columnIndex, InputStream inputStream) throws SQLException
-
使用给定输入流值更新指定列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateBlob
是否更有效。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
inputStream
- 包含用来设置参数值的数据的对象。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateBlob
void updateBlob(String columnLabel, InputStream inputStream) throws SQLException
-
使用给定输入流值更新指定列。将根据需要从流中读取数据,一直读取到流末尾。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateBlob
是否更有效。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
inputStream
- 包含用来设置参数值的数据的对象。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateClob
void updateClob(int columnIndex, Reader reader) throws SQLException
-
使用给定的
Reader
对象更新指定列。将根据需要从流中读取数据,一直读取到流末尾。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateClob
是否更有效。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
reader
- 包含用来设置参数值的数据的对象。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateClob
void updateClob(String columnLabel, Reader reader) throws SQLException
-
使用给定的
Reader
对象更新指定列。将根据需要从流中读取数据,一直读取到流末尾。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateClob
是否更有效。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
reader
- 包含用来设置参数值的数据的对象。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法 -
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNClob
void updateNClob(int columnIndex, Reader reader) throws SQLException
-
使用给定的
Reader
对象更新指定列。将根据需要从流中读取数据,一直读取到流末尾。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateNClob
是否更有效。 -
-
-
参数:
-
columnIndex
- 第一个列是 1,第二个列是 2,…… -
reader
- 包含用来设置参数值的数据的对象。
抛出:
-
SQLException
- 如果 columnIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-
updateNClob
void updateNClob(String columnLabel, Reader reader) throws SQLException
-
使用给定的
Reader
对象更新指定列。将根据需要从流中读取数据,一直读取到流末尾。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或insertRow
方法。注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的
updateNClob
是否更有效。 -
-
-
参数:
-
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称 -
reader
- 包含用来设置参数值的数据的对象。
抛出:
-
SQLException
- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
-
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
- 1.6
-