|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
public interface ResultSet
表示数据库结果集的数据表,通常通过执行查询数据库的语句生成。
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 查询中使用列名称时,将使用列名称选项。对于没有在查询中显式指定的列,最好使用列编号。如果使用列名称,则程序员应该注意保证名称唯一引用预期的列,这可以使用 SQL AS 子句确定。
在 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 beAINSWORTH
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 |
字段详细信息 |
---|
static final int FETCH_FORWARD
setFetchDirection
方法将此常量用作驱动程序的提示,驱动程序可能忽略它。
static final int FETCH_REVERSE
setFetchDirection
方法将此常量用作驱动程序的提示,驱动程序可能忽略它。
static final int FETCH_UNKNOWN
setFetchDirection
方法将此常量用作驱动程序的提示,驱动程序可能忽略它。
static final int TYPE_FORWARD_ONLY
ResultSet
对象的类型。
static final int TYPE_SCROLL_INSENSITIVE
ResultSet
底层数据更改影响的
ResultSet
对象的类型。
static final int TYPE_SCROLL_SENSITIVE
ResultSet
底层数据更改影响的
ResultSet
对象的类型。
static final int CONCUR_READ_ONLY
ResultSet
对象的并发模式。
static final int CONCUR_UPDATABLE
ResultSet
对象的并发模式。
static final int HOLD_CURSORS_OVER_COMMIT
ResultSet
对象将保持开放。
static final int CLOSE_CURSORS_AT_COMMIT
ResultSet
对象将被关闭。
方法详细信息 |
---|
boolean next() throws SQLException
ResultSet
光标最初位于第一行之前;第一次调用
next
方法使第一行成为当前行;第二次调用使第二行成为当前行,依此类推。
当调用 next
方法返回 false
时,光标位于最后一行的后面。任何要求当前行的 ResultSet
方法调用将导致抛出 SQLException
。如果结果集的类型是 TYPE_FORWARD_ONLY
,则其 JDBC 驱动程序实现对后续 next
调用是返回 false
还是抛出 SQLException
将由供应商指定。
如果对当前行开启了输入流,则调用 next
方法将隐式关闭它。读取新行时,将清除 ResultSet
对象的警告链。
true
;如果不存在下一行,则返回
false
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
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
- 如果发生数据库访问错误
boolean wasNull() throws SQLException
NULL
。注意,必须首先对列调用一个获取方法尝试读取其值,然后调用
wasNull
方法查看读取的值是否为 SQL
NULL
。
NULL
,则返回
true
;否则返回
false
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
String getString(int columnIndex) throws SQLException
String
的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
null
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
boolean getBoolean(int columnIndex) throws SQLException
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,……
NULL
,则返回值为
false
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
byte getByte(int columnIndex) throws SQLException
byte
的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
0
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
short getShort(int columnIndex) throws SQLException
short
的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
0
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
int getInt(int columnIndex) throws SQLException
int
的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
0
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
long getLong(int columnIndex) throws SQLException
long
的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
0
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
float getFloat(int columnIndex) throws SQLException
float
的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
0
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
double getDouble(int columnIndex) throws SQLException
double
的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
0
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
BigDecimal getBigDecimal(int columnIndex, int scale) throws SQLException
java.sql.BigDecimal
的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
scale
- 小数点右边的位数
NULL
,则返回值为
null
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
byte[] getBytes(int columnIndex) throws SQLException
byte
数组的形式获取此
ResultSet
对象的当前行中指定列的值。这些字节表示驱动程序返回的原始值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
null
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
Date getDate(int columnIndex) throws SQLException
java.sql.Date
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
null
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
Time getTime(int columnIndex) throws SQLException
java.sql.Time
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
null
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
Timestamp getTimestamp(int columnIndex) throws SQLException
java.sql.Timestamp
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
null
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
InputStream getAsciiStream(int columnIndex) throws SQLException
ResultSet
对象的当前行中指定列的值。然后,可以按块从流中读取值。此方法尤其适合于获取很大的
注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用 InputStream.available
方法时,不管是否存在可用数据,流都可能返回 0
。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
null
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
InputStream getUnicodeStream(int columnIndex) throws SQLException
getCharacterStream
取代 getUnicodeStream
ResultSet
对象的当前行中指定列的值。第一个字节是高字节;第二个字节是低字节。然后,可以按块从流中读取值。此方法尤其适合于获取很大的
LONGVARCHAR
值。JDBC 驱动程序将执行从数据库格式到 Unicode 的任何必要转换。
注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用 InputStream.available
方法时,不管是否存在可用数据,流都可能返回 0
。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
null
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
InputStream getBinaryStream(int columnIndex) throws SQLException
ResultSet
对象的当前行中指定列的值。然后,可以按块从流中读取值。此方法尤其适合于获取很大的
LONGVARBINARY
值。
注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用 InputStream.available
方法时,不管是否存在可用数据,流都可能返回 0
。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
null
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
String getString(String columnLabel) throws SQLException
String
的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
NULL
,则返回值为
null
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
boolean getBoolean(String columnLabel) throws SQLException
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 子句,则标签是列名称
NULL
,则返回值为
false
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
byte getByte(String columnLabel) throws SQLException
byte
的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
NULL
,则返回值为
0
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
short getShort(String columnLabel) throws SQLException
short
的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
NULL
,则返回值为
0
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
int getInt(String columnLabel) throws SQLException
int
的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
NULL
,则返回值为
0
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
long getLong(String columnLabel) throws SQLException
long
的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
NULL
,则返回值为
0
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
float getFloat(String columnLabel) throws SQLException
float
的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
NULL
,则返回值为
0
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
double getDouble(String columnLabel) throws SQLException
double
的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
NULL
,则返回值为
0
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
BigDecimal getBigDecimal(String columnLabel, int scale) throws SQLException
java.math.BigDecimal
的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
scale
- 小数点右边的位数
NULL
,则返回值为
null
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
byte[] getBytes(String columnLabel) throws SQLException
byte
数组的形式获取此
ResultSet
对象的当前行中指定列的值。这些字节表示驱动程序返回的原始值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
NULL
,则返回值为
null
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
Date getDate(String columnLabel) throws SQLException
java.sql.Date
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
NULL
,则返回值为
null
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
Time getTime(String columnLabel) throws SQLException
java.sql.Time
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
NULL
,则返回值为
null
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
Timestamp getTimestamp(String columnLabel) throws SQLException
java.sql.Timestamp
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
NULL
,则返回值为
null
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
InputStream getAsciiStream(String columnLabel) throws SQLException
ResultSet
对象的当前行中指定列的值。然后,可以按块从流中读取值。此方法尤其适合于获取很大的
LONGVARCHAR
值。JDBC 驱动程序将执行从数据库格式到 ASCII 的任何必要转换。
注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用 available
方法时,不管是否存在可用数据,流都可能返回 0
。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
NULL
,则返回值为
null
。
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
InputStream getUnicodeStream(String columnLabel) throws SQLException
getCharacterStream
代替
ResultSet
对象的当前行中指定列的值。第一个字节是高字节;第二个字节是低字节。然后,可以按块从流中读取值。此方法尤其适合于获取很大的
LONGVARCHAR
值。采用 JDBC 技术的驱动程序将执行从数据库格式到 Unicode 的任何必要转换。
注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用 InputStream.available
方法时,不管是否存在可用数据,流都可能返回 0
。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
NULL
,则返回值为
null
。
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
InputStream getBinaryStream(String columnLabel) throws SQLException
byte
流的形式获取此
ResultSet
对象的当前行中指定列的值。然后,可以按块从流中读取该值。此方法尤其适合于获取很大的
LONGVARBINARY
值。
注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用 available
方法时,不管是否存在可用数据,流都可能返回 0
。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
NULL
,则返回值为
null
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLWarning getWarnings() throws SQLException
ResultSet
对象上的调用报告的第一个警告。此
ResultSet
对象上的后续警告会被链接到此方法返回的
SQLWarning
对象。
每次读取新行时,都会自动清除警告链。不可以在已经关闭的 ResultSet
对象上调用此方法;这样做将导致抛出 SQLException
。
注:此警告链仅包含 ResultSet
方法产生的警告。Statement
方法(如读取 OUT 参数)产生的任何警告都将链接在 Statement
对象上。
SQLWarning
对象;如果不存在,则返回
null
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
void clearWarnings() throws SQLException
ResultSet
对象上报告的所有警告。调用此方法后,在为此
ResultSet
对象报告新的警告之前,
getWarnings
方法将返回
null
。
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
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 驱动程序不支持此方法
ResultSetMetaData getMetaData() throws SQLException
ResultSet
对象的列的编号、类型和属性。
ResultSet
对象的列的描述
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
Object getObject(int columnIndex) throws SQLException
以 Java 编程语言中 Object
的形式获取此 ResultSet
对象的当前行中指定列的值。
此方法将以 Java 对象的形式返回给定列的值。Java 对象的类型将为与该列的 SQL 类型相对应的默认 Java 对象类型,它遵守在 JDBC 规范中指定的内置类型的映射关系。如果值为 SQL NULL
,则驱动程序返回一个 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 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
Object getObject(String columnLabel) throws SQLException
以 Java 编程语言中 Object
的形式获取此 ResultSet
对象的当前行中指定列的值。
此方法将以 Java 对象的形式返回给定列的值。Java 对象的类型将为与该列的 SQL 类型相对应的默认 Java 对象类型,它遵守在 JDBC 规范中指定的内置类型的映射关系。如果值为 SQL NULL
,则驱动程序返回一个 Java null
。
此方法还可用于读取特定于数据库的抽象数据类型。
在 JDBC 2.0 API 中,可以扩展 getObject
方法的行为来实现 SQL 自定义类型的数据。当列包含结构化的或独特的值时,此方法的行为类似于调用:getObject(columnIndex, this.getStatement().getConnection().getTypeMap())
。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
java.lang.Object
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
int findColumn(String columnLabel) throws SQLException
ResultSet
列标签映射到其
ResultSet
列索引。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
SQLException
- 如果
ResultSet
对象不包含标记为
columnLabel
的列,发生数据库访问错误或在已关闭的结果集上调用此方法
Reader getCharacterStream(int columnIndex) throws SQLException
java.io.Reader
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
java.io.Reader
对象;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
。
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
Reader getCharacterStream(String columnLabel) throws SQLException
java.io.Reader
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
java.io.Reader
对象;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
BigDecimal getBigDecimal(int columnIndex) throws SQLException
java.math.BigDecimal
的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为 Java 编程语言中的
null
。
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
BigDecimal getBigDecimal(String columnLabel) throws SQLException
java.math.BigDecimal
的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
NULL
,则返回值为 Java 编程语言中的
null
。
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
boolean isBeforeFirst() throws SQLException
ResultSet
对象的第一行之前。
注:对于带有 TYPE_FORWARD_ONLY
的结果集类型的 ResultSet
,对 isBeforeFirst
方法的支持是可选的
true
;如果光标位于任何其他位置或者结果集不包含任何行,则返回
false
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
boolean isAfterLast() throws SQLException
ResultSet
对象的最后一行之后。
注:对于带有 TYPE_FORWARD_ONLY
的结果集类型的 ResultSet
,对 isAfterLast
方法的支持是可选的
true
;如果光标位于任何其他位置或者结果集不包含任何行,则返回
false
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
boolean isFirst() throws SQLException
ResultSet
对象的第一行。
注:对于带有 TYPE_FORWARD_ONLY
的结果集类型的 ResultSet
,对 isFirst
方法的支持是可选的
true
;否则返回
false
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
boolean isLast() throws SQLException
ResultSet
对象的最后一行。
注:调用
isLast
方法可能开销很大,因为 JDBC 驱动程序可能需要再往后获取一行,以确定当前行是否为结果集中的最后一行。
注:对于带有 TYPE_FORWARD_ONLY
的结果集类型的 ResultSet
,对 isLast
方法的支持是可选的
true
;否则返回
false
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void beforeFirst() throws SQLException
ResultSet
对象的开头,正好位于第一行之前。如果结果集中不包含任何行,则此方法无效。
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为
TYPE_FORWARD_ONLY
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void afterLast() throws SQLException
ResultSet
对象的末尾,正好位于最后一行之后。如果结果集中不包含任何行,则此方法无效。
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为
TYPE_FORWARD_ONLY
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
boolean first() throws SQLException
ResultSet
对象的第一行。
true
;如果结果集中不存在任何行,则返回
false
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为
TYPE_FORWARD_ONLY
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
boolean last() throws SQLException
ResultSet
对象的最后一行。
true
;如果结果集中不存在任何行,则返回
false
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为
TYPE_FORWARD_ONLY
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
int getRow() throws SQLException
注:对于带有 TYPE_FORWARD_ONLY
的结果集类型的 ResultSet
,对 getRow
方法的支持是可选的
0
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
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 驱动程序不支持此方法
boolean relative(int rows) throws SQLException
relative(0)
有效,但是不更改光标位置。
注:调用方法 relative(1)
等效于调用方法 next()
,而调用方法 relative(-1)
等效于调用方法 previous()
。
rows
- 指定从当前行开始移动的行数的
int
;正数表示光标向前移动;负数表示光标向后移动
true
;否则返回
false
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为
TYPE_FORWARD_ONLY
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
boolean previous() throws SQLException
ResultSet
对象的上一行。
当调用 previous
方法返回 false
时,光标位于第一行之前。要求当前行的任何 ResultSet
方法的调用将导致抛出 SQLException
。
如果开启了对当前行的输入流,则调用 previous
方法将隐式关闭它。读取新的一行时清除 ResultSet
对象的警告更改。
true
;如果光标位于第一行的前面,则返回
false
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集类型为
TYPE_FORWARD_ONLY
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
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
Statement.setFetchDirection(int)
,
getFetchDirection()
int getFetchDirection() throws SQLException
ResultSet
对象的获取方向。
ResultSet
对象的当前获取方向
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
setFetchDirection(int)
void setFetchSize(int rows) throws SQLException
ResultSet
对象需要更多行时应该从数据库获取的行数。如果指定的获取大小为零,则 JDBC 驱动程序忽略该值,随意对获取大小作出它自己的最佳猜测。默认值由创建结果集的
Statement
对象设置。获取大小可以在任何时间更改。
rows
- 要获取的行数
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或不满足条件
rows >= 0
getFetchSize()
int getFetchSize() throws SQLException
ResultSet
对象的获取大小。
ResultSet
对象的当前获取大小
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
setFetchSize(int)
int getType() throws SQLException
ResultSet
对象的类型。类型由创建结果集的
Statement
对象确定。
ResultSet.TYPE_FORWARD_ONLY
、
ResultSet.TYPE_SCROLL_INSENSITIVE
或
ResultSet.TYPE_SCROLL_SENSITIVE
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
int getConcurrency() throws SQLException
ResultSet
对象的并发模式。使用的并发由创建结果集的
Statement
对象确定。
ResultSet.CONCUR_READ_ONLY
或
ResultSet.CONCUR_UPDATABLE
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
boolean rowUpdated() throws SQLException
注:对于 CONCUR_READ_ONLY
的结果集并发性,对 rowUpdated
方法的支持是可选的
true
;否则返回
false
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
DatabaseMetaData.updatesAreDetected(int)
boolean rowInserted() throws SQLException
ResultSet
对象是否可以检测到可见插入。
注:对于 CONCUR_READ_ONLY
的结果集并发性,对 rowUpdated
方法的支持是可选的
true
;否则返回
false
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
DatabaseMetaData.insertsAreDetected(int)
boolean rowDeleted() throws SQLException
ResultSet
对象是否可以检测到删除。
注:对于 CONCUR_READ_ONLY
的结果集并发性,对 rowDeleted
方法的支持是可选的
true
;否则返回
false
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
DatabaseMetaData.deletesAreDetected(int)
void updateNull(int columnIndex) throws SQLException
null
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateBoolean(int columnIndex, boolean x) throws SQLException
boolean
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateByte(int columnIndex, byte x) throws SQLException
byte
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateShort(int columnIndex, short x) throws SQLException
short
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateInt(int columnIndex, int x) throws SQLException
int
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateLong(int columnIndex, long x) throws SQLException
long
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会不更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateFloat(int columnIndex, float x) throws SQLException
float
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateDouble(int columnIndex, double x) throws SQLException
double
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException
java.math.BigDecimal
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateString(int columnIndex, String x) throws SQLException
String
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateBytes(int columnIndex, byte[] x) throws SQLException
byte
数组值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateDate(int columnIndex, Date x) throws SQLException
java.sql.Date
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateTime(int columnIndex, Time x) throws SQLException
java.sql.Time
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateTimestamp(int columnIndex, Timestamp x) throws SQLException
java.sql.Timestamp
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateAsciiStream(int columnIndex, InputStream x, int length) throws SQLException
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
length
- 流的长度
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateBinaryStream(int columnIndex, InputStream x, int length) throws SQLException
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
length
- 流的长度
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateCharacterStream(int columnIndex, Reader x, int length) throws SQLException
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
length
- 流的长度
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
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 驱动程序不支持此方法
void updateObject(int columnIndex, Object x) throws SQLException
Object
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateNull(String columnLabel) throws SQLException
null
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateBoolean(String columnLabel, boolean x) throws SQLException
boolean
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
x
- 新列值
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateByte(String columnLabel, byte x) throws SQLException
byte
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
x
- 新列值
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateShort(String columnLabel, short x) throws SQLException
short
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
x
- 新列值
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateInt(String columnLabel, int x) throws SQLException
int
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
x
- 新列值
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateLong(String columnLabel, long x) throws SQLException
long
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
x
- 新列值
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateFloat(String columnLabel, float x) throws SQLException
float
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
x
- 新列值
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateDouble(String columnLabel, double x) throws SQLException
double
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
x
- 新列值
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
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 驱动程序不支持此方法
void updateString(String columnLabel, String x) throws SQLException
String
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
x
- 新列值
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateBytes(String columnLabel, byte[] x) throws SQLException
updateRow
或
insertRow
方法。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
x
- 新列值
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
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 驱动程序不支持此方法
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 驱动程序不支持此方法
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 驱动程序不支持此方法
void updateAsciiStream(String columnLabel, InputStream x, int length) throws SQLException
updateRow
或
insertRow
方法。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
x
- 新列值
length
- 流的长度
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
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 驱动程序不支持此方法
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 驱动程序不支持此方法
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 驱动程序不支持此方法
void updateObject(String columnLabel, Object x) throws SQLException
Object
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
x
- 新列值
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void insertRow() throws SQLException
ResultSet
对象和数据库中。调用此方法时,光标必须位于插入行上。
SQLException
- 如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法;如果在光标不位于插入行上时调用此方法,或者插入行中所有不可为 null 的列中还存在未分配非 null 值的列
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateRow() throws SQLException
ResultSet
对象的当前行的新内容更新底层数据库。光标不位于插入行上时不能调用此方法。
SQLException
- 如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
;在已关闭的结果集上调用此方法,或者在光标不位于插入行上时调用了此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void deleteRow() throws SQLException
ResultSet
对象和底层数据库中删除当前行。光标不位于插入行上时不能调用此方法。
SQLException
- 如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
;在已关闭的结果集上调用此方法,或者在光标不位于插入行上时调用了此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void refreshRow() throws SQLException
refreshRow
方法提供一种让应用程序显式告知 JDBC 驱动程序从数据库重新获取行的方式。应用程序可能需要在 JDBC 驱动程序完成缓存或预获取操作后调用 refreshRow
,以便从数据库获取行的最新值。如果获取大小大于 1,则 JDBC 驱动程序可以一次实际刷新多行。
应根据事务隔离级别和光标敏感度确定是否重新获取所有值。如果在调用更新方法之后,但在调用 updateRow
方法之前调用 refreshRow
,则会丢失对行所作的更新。频繁调用方法 refreshRow
可能导致性能下降。
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法;结果集类型为
TYPE_FORWARD_ONLY
,或者在光标不位于插入行上时调用了此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法,或者对于指定的结果集类型和结果集并发性此方法不受支持。
void cancelRowUpdates() throws SQLException
ResultSet
对象中的当前行所作的更新。此方法在调用更新方法之后,但在调用
updateRow
方法之前调用才可以回滚对行所作的更新。如果没有进行任何更新或者已经调用
updateRow
方法,则此方法无效。
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法;结果集并发性为
CONCUR_READ_ONLY
,或者在光标不位于插入行上时调用了此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void moveToInsertRow() throws SQLException
insertRow
方法。每次在调用
insertRow
之前调用此方法时,必须为结果集中的所有列分配值。在对列值调用获取方法之前,必须调用更新方法。
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集并发性为
CONCUR_READ_ONLY
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void moveToCurrentRow() throws SQLException
SQLException
- 如果发生数据库访问错误;在已关闭的结果集上调用此方法或结果集并发性为
CONCUR_READ_ONLY
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
Statement getStatement() throws SQLException
ResultSet
对象的
Statement
对象。如果结果集是以其他方式生成的(如通过
DatabaseMetaData
方法),则此方法可能返回
null
。
ResultSet
对象的
Statment
对象;如果结果集是以其他方法生成的,则返回
null
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
Object getObject(int columnIndex, Map<String,Class<?>> map) throws SQLException
Object
的形式获取此
ResultSet
对象的当前行中指定列的值。如果值为 SQL
NULL
,则驱动程序返回一个 Java
null
。此方法使用给定的
Map
对象作为正在获取的 SQL 结构化或独特类型的自定义映射关系。
columnIndex
- 第一个列是 1,第二个列是 2,……
map
- 一个
java.util.Map
对象,包含从 SQL 类型名称到 Java 编程语言中类的映射关系
Object
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
Ref getRef(int columnIndex) throws SQLException
Ref
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
REF
值的
Ref
对象
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
Blob getBlob(int columnIndex) throws SQLException
Blob
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
BLOB
值的
BLOB
对象
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
Clob getClob(int columnIndex) throws SQLException
Clob
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
Clob
值的
Clob
对象
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
Array getArray(int columnIndex) throws SQLException
Array
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
Array
值的
Array
对象
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
Object getObject(String columnLabel, Map<String,Class<?>> map) throws SQLException
Object
的形式获取此
ResultSet
对象的当前行中指定列的值。如果值为 SQL
NULL
,则驱动程序返回一个 Java
null
。此方法使用指定的
Map
对象自定义映射关系(如果合适)。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
map
- 包含从 SQL 类型名称到 Java 编程语言中类的映射关系的
java.util.Map
对象
Object
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
Ref getRef(String columnLabel) throws SQLException
Ref
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
Ref
值的
Ref
对象
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
Blob getBlob(String columnLabel) throws SQLException
Blob
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
Blob
值的
Blob
对象
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
Clob getClob(String columnLabel) throws SQLException
Clob
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
CLOB
值的
Clob
对象
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
Array getArray(String columnLabel) throws SQLException
Array
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
ARRAY
值的
ARRAY
对象
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
Date getDate(int columnIndex, Calendar cal) throws SQLException
java.sql.Date
对象的形式获取此
ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造日期的适当毫秒值。
columnIndex
- 第一个列是 1,第二个列是 2,……
cal
- 在构造日期时使用的
java.util.Calendar
对象
java.sql.Date
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
Date getDate(String columnLabel, Calendar cal) throws SQLException
java.sql.Date
对象的形式获取此
ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造日期的适当毫秒值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
cal
- 在构造日期时使用的
java.util.Calendar
对象
java.sql.Date
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
Time getTime(int columnIndex, Calendar cal) throws SQLException
java.sql.Time
对象的形式获取此
ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造时间的适当毫秒值。
columnIndex
- 第一个列是 1,第二个列是 2,……
cal
- 在构造时间时使用的
java.util.Calendar
对象
java.sql.Time
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
Time getTime(String columnLabel, Calendar cal) throws SQLException
java.sql.Time
对象的形式获取此
ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造时间的适当毫秒值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
cal
- 在构造时间时使用的
java.util.Calendar
对象
java.sql.Time
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException
java.sql.Timestamp
对象的形式获取此
ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造时间戳的适当毫秒值。
columnIndex
- 第一个列是 1,第二个列是 2,……
cal
- 在构造时间戳时使用的
java.util.Calendar
对象
java.sql.Timestamp
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
Timestamp getTimestamp(String columnLabel, Calendar cal) throws SQLException
java.sql.Timestamp
对象的形式获取此
ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造时间戳的适当毫秒值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
cal
- 在构造日期时使用的
java.util.Calendar
对象
java.sql.Timestamp
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
URL getURL(int columnIndex) throws SQLException
java.net.URL
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 索引,其中第一个列是 1、第二个列是 2,……
java.net.URL
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法或 URL 是错误的
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
URL getURL(String columnLabel) throws SQLException
java.net.URL
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
java.net.URL
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法,或者 URL 是错误的
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateRef(int columnIndex, Ref x) throws SQLException
java.sql.Ref
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
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 驱动程序不支持此方法
void updateBlob(int columnIndex, Blob x) throws SQLException
java.sql.Blob
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
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 驱动程序不支持此方法
void updateClob(int columnIndex, Clob x) throws SQLException
java.sql.Clob
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
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 驱动程序不支持此方法
void updateArray(int columnIndex, Array x) throws SQLException
java.sql.Array
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
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 驱动程序不支持此方法
RowId getRowId(int columnIndex) throws SQLException
java.sql.RowId
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
null
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
RowId getRowId(String columnLabel) throws SQLException
java.sql.RowId
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
NULL
,则返回值为
null
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateRowId(int columnIndex, RowId x) throws SQLException
RowId
值更新指定列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateRowId(String columnLabel, RowId x) throws SQLException
RowId
值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
x
- 列值
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
int getHoldability() throws SQLException
ResultSet
对象的可保存性
ResultSet.HOLD_CURSORS_OVER_COMMIT
或
ResultSet.CLOSE_CURSORS_AT_COMMIT
SQLException
- 如果发生数据库访问错误或在已关闭的结果集上调用此方法
boolean isClosed() throws SQLException
ResultSet
对象是否已关闭。如果已经在
ResultSet
上调用了 close 方法,或者
ResultSet
自动关闭,则
ResultSet
已关闭。
ResultSet
对象已关闭,则返回 true;如果它仍然是打开的,则返回 false
SQLException
- 如果发生数据库访问错误
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 驱动程序不支持此方法
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 驱动程序不支持此方法
void updateNClob(int columnIndex, NClob nClob) throws SQLException
java.sql.NClob
值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
nClob
- 要更新的列值
SQLException
- 如果 columnIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法;发生数据库访问错误或结果集并发性为
CONCUR_READ_ONLY
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
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 驱动程序不支持此方法
NClob getNClob(int columnIndex) throws SQLException
NClob
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NCLOB
值的
NClob
对象
SQLException
- 如果 columnIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法或发生数据库访问错误
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
NClob getNClob(String columnLabel) throws SQLException
NClob
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
NCLOB
值的
NClob
对象
SQLException
- 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;在已关闭的结果集上调用此方法或发生数据库访问错误
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
SQLXML getSQLXML(int columnIndex) throws SQLException
java.sql.SQLXML
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
SQL XML
值的
SQLXML
对象
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
SQLXML getSQLXML(String columnLabel) throws SQLException
java.sql.SQLXML
对象的形式获取此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
SQL XML
值的
SQLXML
对象
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
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 驱动程序不支持此方法
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 驱动程序不支持此方法
String getNString(int columnIndex) throws SQLException
String
的形式获取此
ResultSet
对象的当前行中指定列的值。访问
NCHAR
、
NVARCHAR
和
LONGNVARCHAR
列时可使用此方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
null
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
String getNString(String columnLabel) throws SQLException
String
的形式获取此
ResultSet
对象的当前行中指定列的值。访问
NCHAR
、
NVARCHAR
和
LONGNVARCHAR
列时可使用此方法。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
NULL
,则返回值为
null
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
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 驱动程序不支持此方法
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 驱动程序不支持此方法
void updateNCharacterStream(int columnIndex, Reader x, long length) throws SQLException
NCHAR
、
NVARCHAR
和
LONGNVARCHAR
列时可使用此方法。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
length
- 流长度
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateNCharacterStream(String columnLabel, Reader reader, long length) throws SQLException
NCHAR
、
NVARCHAR
和
LONGNVARCHAR
列时可使用此方法。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
reader
- 包含新列值的
java.io.Reader
对象
length
- 流长度
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateAsciiStream(int columnIndex, InputStream x, long length) throws SQLException
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
length
- 流长度
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateBinaryStream(int columnIndex, InputStream x, long length) throws SQLException
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
length
- 流长度
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateCharacterStream(int columnIndex, Reader x, long length) throws SQLException
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
length
- 流长度
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateAsciiStream(String columnLabel, InputStream x, long length) throws SQLException
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
x
- 新列值
length
- 流长度
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
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 驱动程序不支持此方法
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 驱动程序不支持此方法
void updateBlob(int columnIndex, InputStream inputStream, long length) throws SQLException
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
inputStream
- 包含用来设置参数值的数据的对象。
length
- 参数数据中的字节数。
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
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 驱动程序不支持此方法
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 驱动程序不支持此方法
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 驱动程序不支持此方法
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 驱动程序不支持此方法
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 驱动程序不支持此方法
void updateNCharacterStream(int columnIndex, Reader x) throws SQLException
NCHAR
、
NVARCHAR
和
LONGNVARCHAR
列时可使用此方法。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateNCharacterStream
是否更有效。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateNCharacterStream(String columnLabel, Reader reader) throws SQLException
NCHAR
、
NVARCHAR
和
LONGNVARCHAR
列时可使用此方法。
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateNCharacterStream
是否更有效。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
reader
- 包含新列值的
java.io.Reader
对象
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateAsciiStream(int columnIndex, InputStream x) throws SQLException
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateAsciiStream
是否更有效。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateBinaryStream(int columnIndex, InputStream x) throws SQLException
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateBinaryStream
是否更有效。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateCharacterStream(int columnIndex, Reader x) throws SQLException
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateCharacterStream
是否更有效。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
void updateAsciiStream(String columnLabel, InputStream x) throws SQLException
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateAsciiStream
是否更有效。
columnLabel
- 使用 SQL AS 子句指定的列标签。如果未指定 SQL AS 子句,则标签是列名称
x
- 新列值
SQLException
- 如果 columnLabel 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
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 驱动程序不支持此方法
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 驱动程序不支持此方法
void updateBlob(int columnIndex, InputStream inputStream) throws SQLException
更新方法用于更新当前行或插入行中的列值。更新方法不更新底层数据库;更新数据库要调用 updateRow
或 insertRow
方法。
注:请参考 JDBC 驱动程序文档,以确定使用带长度参数的 updateBlob
是否更有效。
columnIndex
- 第一个列是 1,第二个列是 2,……
inputStream
- 包含用来设置参数值的数据的对象。
SQLException
- 如果 columnIndex 无效;如果发生数据库访问错误;结果集并发性为
CONCUR_READ_ONLY
或在已关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法
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 驱动程序不支持此方法
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 驱动程序不支持此方法
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 驱动程序不支持此方法
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 驱动程序不支持此方法
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 驱动程序不支持此方法
|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。