原网址
接口 ResultSet
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 查询中使用列名称时使用。对于没有在查询中显式命名的列,最好使用列编号。如果使用列名称,程序员无法保证名称实际所指的就是预期的列。
在 JDBC 2.0 API (JDK 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 该常量指示调用 Connection.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 该常量指示调用 Connection.commit 方法时不应关闭 ResultSet 对象。 |
static int |
TYPE_FORWARD_ONLY 该常量指示指针只能向前移动的 ResultSet 对象的类型。 |
static int |
TYPE_SCROLL_INSENSITIVE 该常量指示可滚动但通常不受其他的更改影响的 ResultSet 对象的类型。 |
static int |
TYPE_SCROLL_SENSITIVE 该常量指示可滚动并且通常受其他的更改影响的 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 columnName) 将给定的 ResultSet 列名称映射到其 ResultSet 列索引。 |
boolean |
first() 将指针移动到此 ResultSet 对象的第一行。 |
Array |
getArray(int i) 以 Java 编程语言中 Array 对象的形式检索此 ResultSet 对象的当前行中指定列的值。 |
Array |
getArray(String colName) 以 Java 编程语言中 Array 对象的形式检索此 ResultSet 对象的当前行中指定列的值。 |
InputStream |
getAsciiStream(int columnIndex) 以 ASCII 字符流的形式检索此 ResultSet 对象的当前行中指定列的值。 |
InputStream |
getAsciiStream(String columnName) 以 ASCII 字符流的形式检索此 ResultSet 对象的当前行中指定列的值。 |
BigDecimal |
getBigDecimal(int columnIndex) 以具有全精度的 java.math.BigDecimal 的形式检索此 ResultSet 对象的当前行中指定列的值。 |
BigDecimal |
getBigDecimal(int columnIndex, int scale) 已过时。 |
BigDecimal |
getBigDecimal(String columnName) 以具有全精度的 java.math.BigDecimal 的形式检索此 ResultSet 对象的当前行中指定列的值。 |
BigDecimal |
getBigDecimal(String columnName, int scale) 已过时。 |
InputStream |
getBinaryStream(int columnIndex) 以未解释字节的二进制流的形式检索此 ResultSet 对象的当前行中指定列的值。 |
InputStream |
getBinaryStream(String columnName) 以未解释的 byte 流的形式检索此 ResultSet 对象的当前行中指定列的值。 |
Blob |
getBlob(int i) 以 Java 编程语言中 Blob 对象的形式检索此 ResultSet 对象的当前行中指定列的值。 |
Blob |
getBlob(String colName) 以 Java 编程语言中 Blob 对象的形式检索此 ResultSet 对象的当前行中指定列的值。 |
boolean |
getBoolean(int columnIndex) 以 Java 编程语言中 boolean 的形式检索此 ResultSet 对象的当前行中指定列的值。 |
boolean |
getBoolean(String columnName) 以 Java 编程语言中 boolean 的形式检索此 ResultSet 对象的当前行中指定列的值。 |
byte |
getByte(int columnIndex) 以 Java 编程语言中 byte 的形式检索此 ResultSet 对象的当前行中指定列的值。 |
byte |
getByte(String columnName) 以 Java 编程语言中 byte 的形式检索此 ResultSet 对象的当前行中指定列的值。 |
byte[] |
getBytes(int columnIndex) 以 Java 编程语言中 byte 数组的形式检索此 ResultSet 对象的当前行中指定列的值。 |
byte[] |
getBytes(String columnName) 以 Java 编程语言中 byte 数组的形式检索此 ResultSet 对象的当前行中指定列的值。 |
Reader |
getCharacterStream(int columnIndex) 以 java.io.Reader 对象的形式检索此 ResultSet 对象的当前行中指定列的值。 |
Reader |
getCharacterStream(String columnName) 以 java.io.Reader 对象的形式检索此 ResultSet 对象的当前行中指定列的值。 |
Clob |
getClob(int i) 以 Java 编程语言中 Clob 对象的形式检索此 ResultSet 对象的当前行中指定列的值。 |
Clob |
getClob(String colName) 以 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 columnName) 以 Java 编程语言中的 java.sql.Date 对象的形式检索此 ResultSet 对象的当前行中指定列的值。 |
Date |
getDate(String columnName,Calendar cal) 以 Java 编程语言中 java.sql.Date 对象的形式检索此 ResultSet 对象的当前行中指定列的值。 |
double |
getDouble(int columnIndex) 以 Java 编程语言中 double 的形式检索此 ResultSet 对象的当前行中指定列的值。 |
double |
getDouble(String columnName) 以 Java 编程语言中 double 的形式检索此 ResultSet 对象的当前行中指定列的值。 |
int |
getFetchDirection() 检索此 ResultSet 对象的获取方向。 |
int |
getFetchSize() 检索此 ResultSet 对象的获取大小。 |
float |
getFloat(int columnIndex) 以 Java 编程语言中 float 的形式检索此 ResultSet 对象的当前行中指定列的值。 |
float |
getFloat(String columnName) 以 Java 编程语言中 float 的形式检索此 ResultSet 对象的当前行中指定列的值。 |
int |
getInt(int columnIndex) 以 Java 编程语言中 int 的形式检索此 ResultSet 对象的当前行中指定列的值。 |
int |
getInt(String columnName) 以 Java 编程语言中 int 的形式检索此 ResultSet 对象的当前行中指定列的值。 |
long |
getLong(int columnIndex) 以 Java 编程语言中 long 的形式检索此 ResultSet 对象的当前行中指定列的值。 |
long |
getLong(String columnName) 以 Java 编程语言中 long 的形式检索此 ResultSet 对象的当前行中指定列的值。 |
ResultSetMetaData |
getMetaData() 检索此 ResultSet 对象的列的编号、类型和属性。 |
Object |
getObject(int columnIndex) 以 Java 编程语言中 Object 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Object |
getObject(int i, Map 以 Java 编程语言中 Object 的形式检索此 ResultSet 对象的当前行中指定列的值。 |
Object |
getObject(String columnName) 以 Java 编程语言中 Object 的形式获取此 ResultSet 对象的当前行中指定列的值。 |
Object |
getObject(String colName,Map 以 Java 编程语言中 Object 的形式检索此 ResultSet 对象的当前行中指定列的值。 |
Ref |
getRef(int i) 以 Java 编程语言中 Ref 对象的形式检索此 ResultSet 对象的当前行中指定列的值。 |
Ref |
getRef(String colName) 以 Java 编程语言中 Ref 对象的形式检索此 ResultSet 对象的当前行中指定列的值。 |
int |
getRow() 检索当前行编号。 |
short |
getShort(int columnIndex) 以 Java 编程语言中 short 的形式检索此 ResultSet 对象的当前行中指定列的值。 |
short |
getShort(String columnName) 以 Java 编程语言中 short 的形式检索此 ResultSet 对象的当前行中指定列的值。 |
Statement |
getStatement() 检索生成此 ResultSet 对象的 Statement 对象。 |
String |
getString(int columnIndex) 以 Java 编程语言中 String 的形式检索此 ResultSet 对象的当前行中指定列的值。 |
String |
getString(String columnName) 以 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 columnName) 以 Java 编程语言中 java.sql.Time 对象的形式检索此 ResultSet 对象的当前行中指定列的值。 |
Time |
getTime(String columnName,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 columnName) 以 java.sql.Timestamp 对象的形式检索此 ResultSet 对象的当前行中指定列的值。 |
Timestamp |
getTimestamp(String columnName,Calendar cal) 以 Java 编程语言中 java.sql.Timestamp 对象的形式检索此 ResultSet 对象的当前行中指定列的值。 |
int |
getType() 检索此 ResultSet 对象的类型。 |
InputStream |
getUnicodeStream(int columnIndex) 已过时。 使用 getCharacterStream 取代 getUnicodeStream |
InputStream |
getUnicodeStream(String columnName) 已过时。 使用 getCharacterStream 代替 |
URL |
getURL(int columnIndex) 以 Java 编程语言中 java.net.URL 对象的形式检索此 ResultSet 对象的当前行中指定列的值。 |
URL |
getURL(String columnName) 以 Java 编程语言中 java.net.URL 对象的形式检索此 ResultSet 对象的当前行中指定列的值。 |
SQLWarning |
getWarnings() 检索此 ResultSet 对象上的调用报告的第一个警告。 |
void |
insertRow() 将插入行的内容插入到此 ResultSet 对象和数据库中。 |
boolean |
isAfterLast() 检索指针是否位于此 ResultSet 对象的最后一行之后。 |
boolean |
isBeforeFirst() 检索指针是否位于此 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 columnName,Array x) 用 java.sql.Array 值更新指定列。 |
void |
updateAsciiStream(int columnIndex, InputStream x, int length) 用 ascii 流值更新指定列。 |
void |
updateAsciiStream(String columnName,InputStream x, int length) 用 ascii 流值更新指定列。 |
void |
updateBigDecimal(int columnIndex, BigDecimal x) 用 java.math.BigDecimal 值更新指定列。 |
void |
updateBigDecimal(String columnName,BigDecimal x) 用 java.sql.BigDecimal 值更新指定列。 |
void |
updateBinaryStream(int columnIndex, InputStream x, int length) 用二进制流值更新指定列。 |
void |
updateBinaryStream(String columnName,InputStream x, int length) 用二进制流值更新指定列。 |
void |
updateBlob(int columnIndex, Blob x) 用 java.sql.Blob 值更新指定列。 |
void |
updateBlob(String columnName,Blob x) 用 java.sql.Blob 值更新指定列。 |
void |
updateBoolean(int columnIndex, boolean x) 用 boolean 值更新指定列。 |
void |
updateBoolean(String columnName, boolean x) 用 boolean 值更新指定列。 |
void |
updateByte(int columnIndex, byte x) 用 byte 值更新指定列。 |
void |
updateByte(String columnName, byte x) 用 byte 值更新指定列。 |
void |
updateBytes(int columnIndex, byte[] x) 用 byte 数组值更新指定列。 |
void |
updateBytes(String columnName, byte[] x) 用字节数组值更新指定列。 |
void |
updateCharacterStream(int columnIndex, Reader x, int length) 用字符流值更新指定列。 |
void |
updateCharacterStream(String columnName,Reader reader, int length) 用字符流值更新指定列。 |
void |
updateClob(int columnIndex, Clob x) 用 java.sql.Clob 值更新指定列。 |
void |
updateClob(String columnName,Clob x) 用 java.sql.Clob 值更新指定列。 |
void |
updateDate(int columnIndex, Date x) 用 java.sql.Date 值更新指定列。 |
void |
updateDate(String columnName,Date x) 用 java.sql.Date 值更新指定列。 |
void |
updateDouble(int columnIndex, double x) 用 double 值更新指定列。 |
void |
updateDouble(String columnName, double x) 用 double 值更新指定列。 |
void |
updateFloat(int columnIndex, float x) 用 float 值更新指定列。 |
void |
updateFloat(String columnName, float x) 用 float 值更新指定列。 |
void |
updateInt(int columnIndex, int x) 用 int 值更新指定列。 |
void |
updateInt(String columnName, int x) 用 int 值更新指定列。 |
void |
updateLong(int columnIndex, long x) 用 long 值更新指定列。 |
void |
updateLong(String columnName, long x) 用 long 值更新指定列。 |
void |
updateNull(int columnIndex) 为可以为 null 的列提供 null 值。 |
void |
updateNull(String columnName) 用 null 值更新指定列。 |
void |
updateObject(int columnIndex, Object x) 用 Object 值更新指定列。 |
void |
updateObject(int columnIndex, Object x, int scale) 用 Object 值更新指定列。 |
void |
updateObject(String columnName,Object x) 用 Object 值更新指定列。 |
void |
updateObject(String columnName,Object x, int scale) 用 Object 值更新指定列。 |
void |
updateRef(int columnIndex, Ref x) 用 java.sql.Ref 值更新指定列。 |
void |
updateRef(String columnName,Ref x) 用 java.sql.Ref 值更新指定列。 |
void |
updateRow() 用此 ResultSet 对象的当前行的新内容更新底层数据库。 |
void |
updateShort(int columnIndex, short x) 用 short 值更新指定列。 |
void |
updateShort(String columnName, short x) 用 short 值更新指定列。 |
void |
updateString(int columnIndex, String x) 用 String 值更新指定列。 |
void |
updateString(String columnName,String x) 用 String 值更新指定列。 |
void |
updateTime(int columnIndex, Time x) 用 java.sql.Time 值更新指定列。 |
void |
updateTime(String columnName,Time x) 用 java.sql.Time 值更新指定列。 |
void |
updateTimestamp(int columnIndex, Timestamp x) 用 java.sql.Timestamp 值更新指定列。 |
void |
updateTimestamp(String columnName,Timestamp x) 用 java.sql.Timestamp 值更新指定列。 |
boolean |
wasNull() 报告最后一个读取的列是否具有值 SQL NULL 。 |
字段详细信息 |
---|
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
对象的类型。
static final int TYPE_SCROLL_SENSITIVE
ResultSet
对象的类型。
static final int CONCUR_READ_ONLY
ResultSet
对象的并发模式。
static final int CONCUR_UPDATABLE
ResultSet
对象的并发模式。
static final int HOLD_CURSORS_OVER_COMMIT
Connection.commit
方法时不应关闭
ResultSet
对象。
static final int CLOSE_CURSORS_AT_COMMIT
Connection.commit
方法时应该关闭
ResultSet
对象。
方法详细信息 |
---|
boolean next() throws SQLException
ResultSet
指针最初位于第一行之前;第一次调用
next
方法使第一行成为当前行;第二次调用使第二行成为当前行,依此类推。
如果开启了对当前行的输入流,则调用 next
方法将隐式关闭它。读取新行时,将清除 ResultSet
对象的警告链。
true
;如果不存在下一行,则返回
false
SQLException
- 如果发生数据库访问错误
void close() throws SQLException
ResultSet
对象的数据库和 JDBC 资源,而不是等待该对象自动关闭时发生此操作。
注:当生成 ResultSet
对象的 Statement
对象关闭、重新执行或用来从多个结果的序列检索下一个结果时,该Statement
对象会自动关闭ResultSet
对象。垃圾回收ResultSet
对象时它也会自动关闭。
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
- 如果发生数据库访问错误
boolean getBoolean(int columnIndex) throws SQLException
boolean
的形式检索此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
false
SQLException
- 如果发生数据库访问错误
byte getByte(int columnIndex) throws SQLException
byte
的形式检索此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
0
SQLException
- 如果发生数据库访问错误
short getShort(int columnIndex) throws SQLException
short
的形式检索此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
0
SQLException
- 如果发生数据库访问错误
int getInt(int columnIndex) throws SQLException
int
的形式检索此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
0
SQLException
- 如果发生数据库访问错误
long getLong(int columnIndex) throws SQLException
long
的形式检索此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
0
SQLException
- 如果发生数据库访问错误
float getFloat(int columnIndex) throws SQLException
float
的形式检索此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
0
SQLException
- 如果发生数据库访问错误
double getDouble(int columnIndex) throws SQLException
double
的形式检索此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
0
SQLException
- 如果发生数据库访问错误
@Deprecated
BigDecimal getBigDecimal(int columnIndex,
int scale)
throws SQLException
java.sql.BigDecimal
的形式检索此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
scale
- 小数点右边的位数
NULL
,则返回值为
null
SQLException
- 如果发生数据库访问错误
byte[] getBytes(int columnIndex) throws SQLException
byte
数组的形式检索此
ResultSet
对象的当前行中指定列的值。这些字节表示驱动程序返回的原始值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
null
SQLException
- 如果发生数据库访问错误
Date getDate(int columnIndex) throws SQLException
java.sql.Date
对象的形式检索此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
null
SQLException
- 如果发生数据库访问错误
Time getTime(int columnIndex) throws SQLException
java.sql.Time
对象的形式检索此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
null
SQLException
- 如果发生数据库访问错误
Timestamp getTimestamp(int columnIndex) throws SQLException
java.sql.Timestamp
对象的形式检索此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
null
SQLException
- 如果发生数据库访问错误
InputStream getAsciiStream(int columnIndex) throws SQLException
ResultSet
对象的当前行中指定列的值。然后,可以按块从流中读取值。此方法尤其适合于检索很大的 LONGVARCHAR 值。JDBC 驱动程序将执行从数据库格式到 ASCII 的任何必要转换。
注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用 InputStream.available
方法时,不管是否存在可用数据,流都可能返回0
。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
null
SQLException
- 如果发生数据库访问错误
@Deprecated
InputStream getUnicodeStream(int columnIndex)
throws SQLException
getCharacterStream
取代 getUnicodeStream
ResultSet
对象的当前行中指定列的值。第一个字节是高字节;第二个字节是低字节。然后,可以按块从流中读取值。此方法尤其适合于检索很大的
LONGVARCHAR
值。JDBC 驱动程序将执行从数据库格式到 Unicode 的任何必要转换。
注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用 InputStream.available
方法时,不管是否存在可用数据,流都可能返回0
。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
null
SQLException
- 如果发生数据库访问错误
InputStream getBinaryStream(int columnIndex) throws SQLException
ResultSet
对象的当前行中指定列的值。然后,可以按块从流中读取值。此方法尤其适合于检索很大的
LONGVARBINARY
值。
注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用 InputStream.available
方法时,不管是否存在可用数据,流都可能返回0
。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为
null
SQLException
- 如果发生数据库访问错误
String getString(String columnName) throws SQLException
String
的形式检索此
ResultSet
对象的当前行中指定列的值。
columnName
- 列的 SQL 名称
NULL
,则返回值为
null
SQLException
- 如果发生数据库访问错误
boolean getBoolean(String columnName) throws SQLException
boolean
的形式检索此
ResultSet
对象的当前行中指定列的值。
columnName
- 列的 SQL 名称
NULL
,则返回值为
false
SQLException
- 如果发生数据库访问错误
byte getByte(String columnName) throws SQLException
byte
的形式检索此
ResultSet
对象的当前行中指定列的值。
columnName
- 列的 SQL 名称
NULL
,则返回值为
0
SQLException
- 如果发生数据库访问错误
short getShort(String columnName) throws SQLException
short
的形式检索此
ResultSet
对象的当前行中指定列的值。
columnName
- 列的 SQL 名称
NULL
,则返回值为
0
SQLException
- 如果发生数据库访问错误
int getInt(String columnName) throws SQLException
int
的形式检索此
ResultSet
对象的当前行中指定列的值。
columnName
- 列的 SQL 名称
NULL
,则返回值为
0
SQLException
- 如果发生数据库访问错误
long getLong(String columnName) throws SQLException
long
的形式检索此
ResultSet
对象的当前行中指定列的值。
columnName
- 列的 SQL 名称
NULL
,则返回值为
0
SQLException
- 如果发生数据库访问错误
float getFloat(String columnName) throws SQLException
float
的形式检索此
ResultSet
对象的当前行中指定列的值。
columnName
- 列的 SQL 名称
NULL
,则返回值为
0
SQLException
- 如果发生数据库访问错误
double getDouble(String columnName) throws SQLException
double
的形式检索此
ResultSet
对象的当前行中指定列的值。
columnName
- 列的 SQL 名称
NULL
,则返回值为
0
SQLException
- 如果发生数据库访问错误
@Deprecated
BigDecimal getBigDecimal(String columnName,
int scale)
throws SQLException
java.math.BigDecimal
的形式检索此
ResultSet
对象的当前行中指定列的值。
columnName
- 列的 SQL 名称
scale
- 小数点右边的位数
NULL
,则返回值为
null
SQLException
- 如果发生数据库访问错误
byte[] getBytes(String columnName) throws SQLException
byte
数组的形式检索此
ResultSet
对象的当前行中指定列的值。这些字节表示驱动程序返回的原始值。
columnName
- 列的 SQL 名称
NULL
,则返回值为
null
SQLException
- 如果发生数据库访问错误
Date getDate(String columnName) throws SQLException
java.sql.Date
对象的形式检索此
ResultSet
对象的当前行中指定列的值。
columnName
- 列的 SQL 名称
NULL
,则返回值为
null
SQLException
- 如果发生数据库访问错误
Time getTime(String columnName) throws SQLException
java.sql.Time
对象的形式检索此
ResultSet
对象的当前行中指定列的值。
columnName
- 列的 SQL 名称
NULL
,则返回值为
null
SQLException
- 如果发生数据库访问错误
Timestamp getTimestamp(String columnName) throws SQLException
java.sql.Timestamp
对象的形式检索此
ResultSet
对象的当前行中指定列的值。
columnName
- 列的 SQL 名称
NULL
,则返回值为
null
SQLException
- 如果发生数据库访问错误
InputStream getAsciiStream(String columnName) throws SQLException
ResultSet
对象的当前行中指定列的值。然后,可以按块从流中读取值。此方法尤其适合于检索很大的
LONGVARCHAR
值。JDBC 驱动程序将执行从数据库格式到 ASCII 的任何必要转换。
注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用 available
方法时,不管是否存在可用数据,流都可能返回0
。
columnName
- 列的 SQL 名称
NULL
,则返回值为
null
。
SQLException
- 如果发生数据库访问错误
@Deprecated
InputStream getUnicodeStream(String columnName)
throws SQLException
getCharacterStream
代替
ResultSet
对象的当前行中指定列的值。第一个字节是高字节;第二个字节是低字节。然后,可以按块从流中读取值。此方法尤其适合于检索很大的
LONGVARCHAR
值。采用 JDBC 技术的驱动程序将执行从数据库格式到 Unicode 的任何必要转换。
注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用 InputStream.available
方法时,不管是否存在可用数据,流都可能返回0
。
columnName
- 列的 SQL 名称
NULL
,则返回值为
null
。
SQLException
- 如果发生数据库访问错误
InputStream getBinaryStream(String columnName) throws SQLException
byte
流的形式检索此
ResultSet
对象的当前行中指定列的值。然后可以按块从流中读取该值。此方法尤其适合于检索很大的
LONGVARBINARY
值。
注:在获取任何其他列的值之前必须读取返回流中的所有数据。下一次调用获取方法将隐式关闭该流。此外,当调用 available
方法时,不管是否存在可用数据,流都可能返回0
。
columnName
- 列的 SQL 名称
NULL
,则返回值为
null
SQLException
- 如果发生数据库访问错误
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 指针的当前行。
注:如果不支持定位更新,则抛出 SQLException
。
ResultSet
对象的指针的 SQL 名称
SQLException
- 如果发生数据库访问错误
ResultSetMetaData getMetaData() throws SQLException
ResultSet
对象的列的编号、类型和属性。
ResultSet
对象的列的描述
SQLException
- 如果发生数据库访问错误
Object getObject(int columnIndex) throws SQLException
以 Java 编程语言中 Object
的形式获取此 ResultSet
对象的当前行中指定列的值。
此方法将以 Java 对象的形式返回给定列的值。Java 对象的类型将为与该列的 SQL 类型相对应的默认 Java 对象类型,它遵守在 JDBC 规范中指定的内置类型的映射关系。如果值为 SQLNULL
,则驱动程序返回一个 Javanull
。
此方法还可用于读取特定于数据库的抽象数据类型。在 JDBC 2.0 API 中,可以扩展 getObject
方法的行为来实现 SQL 自定义类型的数据。当列包含结构化的或独特的值时,此方法的行为类似于调用:getObject(columnIndex, this.getStatement().getConnection().getTypeMap())
。
columnIndex
- 第一个列是 1,第二个列是 2,……
java.lang.Object
SQLException
- 如果发生数据库访问错误
Object getObject(String columnName) throws SQLException
以 Java 编程语言中 Object
的形式获取此 ResultSet
对象的当前行中指定列的值。
此方法将以 Java 对象的形式返回给定列的值。Java 对象的类型将为与该列的 SQL 类型相对应的默认 Java 对象类型,它遵守在 JDBC 规范中指定的内置类型的映射关系。如果值为 SQLNULL
,则驱动程序返回一个 Javanull
。
此方法还可用于读取特定于数据库的抽象数据类型。
在 JDBC 2.0 API 中,可以扩展 getObject
方法的行为来实现 SQL 自定义类型的数据。当列包含结构化的或独特的值时,此方法的行为类似于调用:getObject(columnIndex, this.getStatement().getConnection().getTypeMap())
。
columnName
- 列的 SQL 名称
java.lang.Object
SQLException
- 如果发生数据库访问错误
int findColumn(String columnName) throws SQLException
ResultSet
列名称映射到其
ResultSet
列索引。
columnName
- 列的名称
SQLException
- 如果
ResultSet
对象不包含
columnName
或者发生数据库访问错误
Reader getCharacterStream(int columnIndex) throws SQLException
java.io.Reader
对象的形式检索此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
java.io.Reader
对象;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
。
SQLException
- 如果发生数据库访问错误
Reader getCharacterStream(String columnName) throws SQLException
java.io.Reader
对象的形式检索此
ResultSet
对象的当前行中指定列的值。
columnName
- 列的名称
java.io.Reader
对象;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
SQLException
- 如果发生数据库访问错误
BigDecimal getBigDecimal(int columnIndex) throws SQLException
java.math.BigDecimal
的形式检索此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 第一个列是 1,第二个列是 2,……
NULL
,则返回值为 Java 编程语言中的
null
。
SQLException
- 如果发生数据库访问错误
BigDecimal getBigDecimal(String columnName) throws SQLException
java.math.BigDecimal
的形式检索此
ResultSet
对象的当前行中指定列的值。
columnName
- 列名称
NULL
,则返回值为 Java 编程语言中的
null
。
SQLException
- 如果发生数据库访问错误
boolean isBeforeFirst() throws SQLException
ResultSet
对象的第一行之前。
true
;如果指针位于任何其他位置或者结果集不包含任何行,则返回
false
SQLException
- 如果发生数据库访问错误
boolean isAfterLast() throws SQLException
ResultSet
对象的最后一行之后。
true
;如果指针位于任何其他位置或者结果集不包含任何行,则返回
false
SQLException
- 如果发生数据库访问错误
boolean isFirst() throws SQLException
ResultSet
对象的第一行。
true
;否则返回
false
SQLException
- 如果发生数据库访问错误
boolean isLast() throws SQLException
ResultSet
对象的最后一行。注:调用
isLast
方法可能开销很大,因为 JDBC 驱动程序可能需要再往后获取一行,以确定当前行是否为结果集中的最后一行。
true
;否则返回
false
SQLException
- 如果发生数据库访问错误
void beforeFirst() throws SQLException
ResultSet
对象的开头,正好位于第一行之前。如果结果集中不包含任何行,则此方法无效。
SQLException
- 如果发生数据库访问错误或者结果集类型为
TYPE_FORWARD_ONLY
void afterLast() throws SQLException
ResultSet
对象的末尾,正好位于最后一行之后。如果结果集中不包含任何行,则此方法无效。
SQLException
- 如果发生数据库访问错误或者结果集类型为
TYPE_FORWARD_ONLY
boolean first() throws SQLException
ResultSet
对象的第一行。
true
;如果结果集中不存在任何行,则返回
false
SQLException
- 如果发生数据库访问错误或者结果集类型为
TYPE_FORWARD_ONLY
boolean last() throws SQLException
ResultSet
对象的最后一行。
true
;如果结果集中不存在任何行,则返回
false
SQLException
- 如果发生数据库访问错误或者结果集类型为
TYPE_FORWARD_ONLY
int getRow() throws SQLException
0
SQLException
- 如果发生数据库访问错误
boolean absolute(int row) throws SQLException
ResultSet
对象的给定行编号。
如果行编号为正,则将指针移动到相对于结果集开头的给定行编号。第一行为行 1,第二行为行 2,依此类推。
如果给定行编号为负,则将指针移动到相对于结果集末尾的绝对行位置。例如,调用方法 absolute(-1)
将指针置于最后一行;调用方法absolute(-2)
将指针移动到倒数第二行,依此类推。
试图将指针置于结果集的第一行/最后一行之外将导致指针位于第一行之前或最后一行之后。
注:调用 absolute(1)
等效于调用 first()
。调用 absolute(-1)
等效于调用 last()
。
row
- 指针应该移动到的行的编号。正的编号指示从结果集开头开始计数的行编号;负的编号指示从结果集末尾开始计数的行编号
true
;否则返回
false
SQLException
- 如果发生数据库访问错误或者结果集类型为
TYPE_FORWARD_ONLY
boolean relative(int rows) throws SQLException
relative(0)
有效,但是不更改指针位置。
注:调用方法 relative(1)
等效于调用方法 next()
,而调用方法 relative(-1)
等效于调用方法previous()
。
rows
- 指定从当前行开始移动的行数的
int
;正数表示指针向前移动;负数表示指针向后移动
true
;否则返回
false
SQLException
- 如果发生数据库访问错误、不存在当前行或者结果集类型为
TYPE_FORWARD_ONLY
boolean previous() throws SQLException
ResultSet
对象的上一行。
true
;如果它不在结果集中,则返回
false
SQLException
- 如果发生数据库访问错误或者结果集类型为
TYPE_FORWARD_ONLY
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
- 如果发生数据库访问错误或者不满足条件
0 <= rows <= Statement.getMaxRows()
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
true
SQLException
- 如果发生数据库访问错误
DatabaseMetaData.updatesAreDetected(int)
boolean rowInserted() throws SQLException
ResultSet
对象是否可以检测到可见插入。
true
;否则返回
false
SQLException
- 如果发生数据库访问错误
DatabaseMetaData.insertsAreDetected(int)
boolean rowDeleted() throws SQLException
ResultSet
对象是否可以检测到删除。
true
;否则返回
false
SQLException
- 如果发生数据库访问错误
DatabaseMetaData.deletesAreDetected(int)
void updateNull(int columnIndex) throws SQLException
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
SQLException
- 如果发生数据库访问错误
void updateBoolean(int columnIndex, boolean x) throws SQLException
boolean
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateByte(int columnIndex, byte x) throws SQLException
byte
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateShort(int columnIndex, short x) throws SQLException
short
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateInt(int columnIndex, int x) throws SQLException
int
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateLong(int columnIndex, long x) throws SQLException
long
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会不更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateFloat(int columnIndex, float x) throws SQLException
float
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateDouble(int columnIndex, double x) throws SQLException
double
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException
java.math.BigDecimal
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateString(int columnIndex, String x) throws SQLException
String
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateBytes(int columnIndex, byte[] x) throws SQLException
byte
数组值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateDate(int columnIndex, Date x) throws SQLException
java.sql.Date
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateTime(int columnIndex, Time x) throws SQLException
java.sql.Time
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateTimestamp(int columnIndex, Timestamp x) throws SQLException
java.sql.Timestamp
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateAsciiStream(int columnIndex, InputStream x, int length) throws SQLException
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
length
- 流的长度
SQLException
- 如果发生数据库访问错误
void updateBinaryStream(int columnIndex, InputStream x, int length) throws SQLException
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
length
- 流的长度
SQLException
- 如果发生数据库访问错误
void updateCharacterStream(int columnIndex, Reader x, int length) throws SQLException
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
length
- 流的长度
SQLException
- 如果发生数据库访问错误
void updateObject(int columnIndex, Object x, int scale) throws SQLException
Object
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
scale
- 对于
java.sql.Types.DECIMA
或
java.sql.Types.NUMERIC
类型,此参数是小数点后面的位数。对于其他所有类型,将忽略此值。
SQLException
- 如果发生数据库访问错误
void updateObject(int columnIndex, Object x) throws SQLException
Object
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateNull(String columnName) throws SQLException
null
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnName
- 列的名称
SQLException
- 如果发生数据库访问错误
void updateBoolean(String columnName, boolean x) throws SQLException
boolean
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateByte(String columnName, byte x) throws SQLException
byte
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateShort(String columnName, short x) throws SQLException
short
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateInt(String columnName, int x) throws SQLException
int
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateLong(String columnName, long x) throws SQLException
long
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateFloat(String columnName, float x) throws SQLException
float
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateDouble(String columnName, double x) throws SQLException
double
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateBigDecimal(String columnName, BigDecimal x) throws SQLException
java.sql.BigDecimal
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateString(String columnName, String x) throws SQLException
String
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateBytes(String columnName, byte[] x) throws SQLException
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateDate(String columnName, Date x) throws SQLException
java.sql.Date
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateTime(String columnName, Time x) throws SQLException
java.sql.Time
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateTimestamp(String columnName, Timestamp x) throws SQLException
java.sql.Timestamp
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateAsciiStream(String columnName, InputStream x, int length) throws SQLException
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
length
- 流的长度
SQLException
- 如果发生数据库访问错误
void updateBinaryStream(String columnName, InputStream x, int length) throws SQLException
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
length
- 流的长度
SQLException
- 如果发生数据库访问错误
void updateCharacterStream(String columnName, Reader reader, int length) throws SQLException
updateRow
或
insertRow
方法。
columnName
- 列的名称
reader
- 包含新列值的
java.io.Reader
对象
length
- 流的长度
SQLException
- 如果发生数据库访问错误
void updateObject(String columnName, Object x, int scale) throws SQLException
Object
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
scale
- 对于
java.sql.Types.DECIMAL
或
java.sql.Types.NUMERIC
类型,此参数是小数点后面的位数。对于其他所有类型,将忽略此值。
SQLException
- 如果发生数据库访问错误
void updateObject(String columnName, Object x) throws SQLException
Object
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
SQLException
- 如果发生数据库访问错误
void insertRow() throws SQLException
ResultSet
对象和数据库中。调用此方法时,指针必须位于插入行上。
SQLException
- 如果发生数据库访问错误,如果在指针不位于插入行上时调用此方法,或者插入行中所有不可为 null 的列中还存在未分配值的列
void updateRow() throws SQLException
ResultSet
对象的当前行的新内容更新底层数据库。指针不位于插入行上时不能调用此方法。
SQLException
- 如果发生数据库访问错误或者在指针不位于插入行上时调用了此方法
void deleteRow() throws SQLException
ResultSet
对象和底层数据库中删除当前行。指针不位于插入行上时不能调用此方法。
SQLException
- 如果发生数据库访问错误或者在指针不位于插入行上时调用了此方法
void refreshRow() throws SQLException
refreshRow
方法提供一种让应用程序显式告知 JDBC 驱动程序从数据库重新获取行的方式。应用程序可能需要在 JDBC 驱动程序完成缓存或预获取操作后调用refreshRow
,以便从数据库获取行的最新值。如果获取大小大于 1,则 JDBC 驱动程序可以一次实际刷新多行。
应根据事务隔离级别和指针敏感度确定是否重新获取所有值。如果在调用更新方法之后,但在调用 updateRow
方法之前调用 refreshRow
,则会丢失对行所作的更新。频繁调用方法 refreshRow
可能导致性能下降。
SQLException
- 如果发生数据库访问错误或者在指针不位于插入行上时调用了此方法
void cancelRowUpdates() throws SQLException
ResultSet
对象中的当前行所作的更新。此方法在调用更新方法之后,但在调用
updateRow
方法之前调用才可以回滚对行所作的更新。如果没有进行任何更新或者已经调用
updateRow
方法,则此方法无效。
SQLException
- 如果发生数据库访问错误或者在指针不位于插入行上时调用了此方法
void moveToInsertRow() throws SQLException
insertRow
方法。每次在调用
insertRow
之前调用此方法时,必须为结果集中的所有列分配值。在对列值调用获取方法之前,必须调用更新方法。
SQLException
- 如果发生数据库访问错误或者结果集不可更新
void moveToCurrentRow() throws SQLException
SQLException
- 如果发生数据库访问错误或者结果集不可更新
Statement getStatement() throws SQLException
ResultSet
对象的
Statement
对象。如果结果集是以其他方式生成的(如通过
DatabaseMetaData
方法),则此方法返回
null
。
ResultSet
对象的
Statment
对象;如果结果集是以其他方法生成的,则返回
null
SQLException
- 如果发生数据库访问错误
Object getObject(int i, Map> map) throws SQLException
Object
的形式检索此
ResultSet
对象的当前行中指定列的值。如果值为 SQL
NULL
,则驱动程序返回一个 Java
null
。此方法使用给定的
Map
对象作为正在检索的 SQL 结构化或独特类型的自定义映射关系。
i
- 第一个列是 1,第二个列是 2,……
map
- 一个
java.util.Map
对象,包含从 SQL 类型名称到 Java 编程语言中类的映射关系
Object
SQLException
- 如果发生数据库访问错误
Ref getRef(int i) throws SQLException
Ref
对象的形式检索此
ResultSet
对象的当前行中指定列的值。
i
- 第一个列是 1,第二个列是 2,……
REF
值的
Ref
对象
SQLException
- 如果发生数据库访问错误
Blob getBlob(int i) throws SQLException
Blob
对象的形式检索此
ResultSet
对象的当前行中指定列的值。
i
- 第一个列是 1,第二个列是 2,……
BLOB
值的
BLOB
对象
SQLException
- 如果发生数据库访问错误
Clob getClob(int i) throws SQLException
Clob
对象的形式检索此
ResultSet
对象的当前行中指定列的值。
i
- 第一个列是 1,第二个列是 2,……
Clob
值的
Clob
对象
SQLException
- 如果发生数据库访问错误
Array getArray(int i) throws SQLException
Array
对象的形式检索此
ResultSet
对象的当前行中指定列的值。
i
- 第一个列是 1,第二个列是 2,……
Array
值的
Array
对象
SQLException
- 如果发生数据库访问错误
Object getObject(String colName, Map> map) throws SQLException
Object
的形式检索此
ResultSet
对象的当前行中指定列的值。如果值为 SQL
NULL
,则驱动程序返回一个 Java
null
。此方法使用指定的
Map
对象自定义映射关系(如果合适)。
colName
- 列的名称,根据它来检索值
map
- 包含从 SQL 类型名称到 Java 编程语言中类的映射关系的
java.util.Map
对象
Object
SQLException
- 如果发生数据库访问错误
Ref getRef(String colName) throws SQLException
Ref
对象的形式检索此
ResultSet
对象的当前行中指定列的值。
colName
- 列名称
Ref
值的
Ref
对象
SQLException
- 如果发生数据库访问错误
Blob getBlob(String colName) throws SQLException
Blob
对象的形式检索此
ResultSet
对象的当前行中指定列的值。
colName
- 列的名称,根据它检索值
Blob
值的
Blob
对象
SQLException
- 如果发生数据库访问错误
Clob getClob(String colName) throws SQLException
Clob
对象的形式检索此
ResultSet
对象的当前行中指定列的值。
colName
- 列的名称,根据它检索值
CLOB
值的
Clob
对象
SQLException
- 如果发生数据库访问错误
Array getArray(String colName) throws SQLException
Array
对象的形式检索此
ResultSet
对象的当前行中指定列的值。
colName
- 列的名称,根据它检索值
ARRAY
值的
ARRAY
对象
SQLException
- 如果发生数据库访问错误
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
- 如果发生数据库访问错误
Date getDate(String columnName, Calendar cal) throws SQLException
java.sql.Date
对象的形式检索此
ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造日期的适当毫秒值。
columnName
- 列的 SQL 名称,根据它检索值
cal
- 在构造日期时使用的
java.util.Calendar
对象
java.sql.Date
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
SQLException
- 如果发生数据库访问错误
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
- 如果发生数据库访问错误
Time getTime(String columnName, Calendar cal) throws SQLException
java.sql.Time
对象的形式检索此
ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造时间的适当毫秒值。
columnName
- 列的 SQL 名称
cal
- 在构造时间时使用的
java.util.Calendar
对象
java.sql.Time
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
SQLException
- 如果发生数据库访问错误
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
- 如果发生数据库访问错误
Timestamp getTimestamp(String columnName, Calendar cal) throws SQLException
java.sql.Timestamp
对象的形式检索此
ResultSet
对象的当前行中指定列的值。如果底层数据库未存储时区信息,则此方法使用给定日历构造时间戳的适当毫秒值。
columnName
- 列的 SQL 名称
cal
- 在构造日期时使用的
java.util.Calendar
对象
java.sql.Timestamp
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
SQLException
- 如果发生数据库访问错误
URL getURL(int columnIndex) throws SQLException
java.net.URL
对象的形式检索此
ResultSet
对象的当前行中指定列的值。
columnIndex
- 索引,其中第一个列是 1、第二个列是 2,……
java.net.URL
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
SQLException
- 如果发生数据库访问错误或者 URL 是错误的
URL getURL(String columnName) throws SQLException
java.net.URL
对象的形式检索此
ResultSet
对象的当前行中指定列的值。
columnName
- 列的 SQL 名称
java.net.URL
对象形式的列值;如果值为 SQL
NULL
,则返回值为 Java 编程语言中的
null
SQLException
- 如果发生数据库访问错误或者 URL 是错误的
void updateRef(int columnIndex, Ref x) throws SQLException
java.sql.Ref
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateRef(String columnName, Ref x) throws SQLException
java.sql.Ref
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateBlob(int columnIndex, Blob x) throws SQLException
java.sql.Blob
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateBlob(String columnName, Blob x) throws SQLException
java.sql.Blob
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateClob(int columnIndex, Clob x) throws SQLException
java.sql.Clob
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateClob(String columnName, Clob x) throws SQLException
java.sql.Clob
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateArray(int columnIndex, Array x) throws SQLException
java.sql.Array
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnIndex
- 第一个列是 1,第二个列是 2,……
x
- 新列值
SQLException
- 如果发生数据库访问错误
void updateArray(String columnName, Array x) throws SQLException用
java.sql.Array
值更新指定列。更新方法用于更新当前行或插入行中的列值,并不会更新底层数据库;更新数据库要调用
updateRow
或
insertRow
方法。
columnName
- 列的名称
x
- 新列值
SQLException
- 如果发生数据库访问错误