public interface ResultSet extends Wrapper, AutoCloseable
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
接口提供getter方法( getBoolean
, getLong
,用于从当前行检索列值,等等)。
可以使用列的索引号或列的名称来检索值。
一般来说,使用列索引将更有效率。
列从1编号。为了最大可移植性,每行中的结果集列应以从左到右的顺序读取,每列应只读一次。
对于getter方法,JDBC驱动程序尝试将底层数据转换为getter方法中指定的Java类型,并返回合适的Java值。 JDBC规范具有一个表格,该表格显示了可由ResultSet
getter方法使用的SQL类型到Java类型的允许映射。
用作getter方法输入的列名不区分大小写。 当使用列名称调用getter方法时,多个列具有相同的名称,将返回第一个匹配列的值。 列名称选项用于在生成结果集的SQL查询中使用列名时使用。 对于在查询中未明确命名的列,最好使用列号。 如果使用列名称,程序员应该小心保证它们唯一地引用预期的列,这可以通过SQL AS子句来确保。
JDBC 2.0 API(Java¢2 SDK,Standard Edition,1.2版)中的此接口添加了一组更新方法。 关于getter方法参数的注释也适用于updater方法的参数。
更新方法可以以两种方式使用:
ResultSet
对象中,光标可以向前和向后移动到绝对位置或相对于当前行的位置。 下面的代码段更新NAME
所述的第五行中列ResultSet
对象rs
,然后使用方法updateRow
来更新该数据的源表rs
推导。 rs.absolute(5); // moves the cursor to the fifth row of rs
rs.updateString("NAME", "AINSWORTH"); // updates the
// NAME
column of row 5 to be AINSWORTH
rs.updateRow(); // updates the row in the data source
ResultSet
对象具有与其相关ResultSet
的特殊行,用作构建要插入的行的暂存区域。 以下代码片段将光标移动到插入行,构建一个三列行,并将其插入到rs
,并使用方法insertRow
进入数据源表。 rs.moveToInsertRow(); // moves cursor to the insert row
rs.updateString(1, "AINSWORTH"); // updates the
// first column of the insert row to be AINSWORTH
rs.updateInt(2,35); // updates the second column to be 35
rs.updateBoolean(3, true); // updates the third column to true
rs.insertRow();
rs.moveToCurrentRow();
甲ResultSet
当对象将自动关闭Statement
生成它对象被关闭时,重新执行,或用于检索从多个结果的序列中的下一结果。
ResultSet
对象的列的数量,类型和属性由ResultSet.getMetaData
方法返回的ResultSetMetaData
对象提供。
Modifier and Type | Field and Description |
---|---|
static int |
CLOSE_CURSORS_AT_COMMIT
当提交当前事务时,指示打开
ResultSet 具有此
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 对基于
ResultSet 的数据的更改
ResultSet 。
|
Modifier and Type | Method and Description |
---|---|
boolean |
absolute(int row)
将光标移动到此
ResultSet 对象中的给定行号。
|
void |
afterLast()
将光标移动到这个
ResultSet 对象的末尾,就在最后一行之后。
|
void |
beforeFirst()
将光标移动到这个
ResultSet 对象的正面,就在第一行之前。
|
void |
cancelRowUpdates()
取消对此
ResultSet 对象中当前行的更新。
|
void |
clearWarnings()
清除此
ResultSet 对象上报告的所有警告。
|
void |
close()
ResultSet 释放此
ResultSet 对象的数据库和JDBC资源,而不是等待其自动关闭时发生。
|
void |
deleteRow()
从此
ResultSet 对象和底层数据库中删除当前行。
|
int |
findColumn(String columnLabel)
将给定的
ResultSet 列标签映射到其
ResultSet 列索引。
|
boolean |
first()
将光标移动到此
ResultSet 对象中的第一行。
|
Array |
getArray(int columnIndex)
将该
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
Array 对象检索。
|
Array |
getArray(String columnLabel)
将此
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
Array 对象检索。
|
InputStream |
getAsciiStream(int columnIndex)
将此
ResultSet 对象的当前行中指定列的值作为ASCII字符流检索。
|
InputStream |
getAsciiStream(String columnLabel)
将此
ResultSet 对象的当前行中指定列的值作为ASCII字符流检索。
|
BigDecimal |
getBigDecimal(int columnIndex)
将此
ResultSet 对象的当前行中指定列的值作为
java.math.BigDecimal 以完全精确的方式获取。
|
BigDecimal |
getBigDecimal(int columnIndex, int scale)
已弃用
使用
getBigDecimal(int columnIndex) 或getBigDecimal(String columnLabel)
|
BigDecimal |
getBigDecimal(String columnLabel)
将此
ResultSet 对象的当前行中的指定列的值作为
java.math.BigDecimal 完全精确检索。
|
BigDecimal |
getBigDecimal(String columnLabel, int scale)
已弃用
使用
getBigDecimal(int columnIndex) 或getBigDecimal(String columnLabel)
|
InputStream |
getBinaryStream(int columnIndex)
将此
ResultSet 对象的当前行中的指定列的值作为未解释的字节流检索。
|
InputStream |
getBinaryStream(String columnLabel)
将此
ResultSet 对象的当前行中的指定列的值
ResultSet 为未解释的流
byte s。
|
Blob |
getBlob(int columnIndex)
将该
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
Blob 对象检索。
|
Blob |
getBlob(String columnLabel)
将此
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
Blob 对象检索。
|
boolean |
getBoolean(int columnIndex)
这个检索的当前行中指定列的值
ResultSet 对象为
boolean 的Java编程语言。
|
boolean |
getBoolean(String columnLabel)
这个检索的当前行中指定列的值
ResultSet 对象为
boolean 的Java编程语言。
|
byte |
getByte(int columnIndex)
这个检索的当前行中指定列的值
ResultSet 对象为
byte 的Java编程语言。
|
byte |
getByte(String columnLabel)
这个检索的当前行中指定列的值
ResultSet 对象为
byte 的Java编程语言。
|
byte[] |
getBytes(int columnIndex)
将该
ResultSet 对象的当前行中的指定列的值作为Java编程语言中的
byte 数组检索。
|
byte[] |
getBytes(String columnLabel)
将该
ResultSet 对象的当前行中的指定列的值作为Java编程语言中的
byte 数组检索。
|
Reader |
getCharacterStream(int columnIndex)
将此
ResultSet 对象的当前行中的指定列的值
ResultSet 为
java.io.Reader 对象。
|
Reader |
getCharacterStream(String columnLabel)
将此
ResultSet 对象的当前行中的指定列的值
ResultSet 为
java.io.Reader 对象。
|
Clob |
getClob(int columnIndex)
将该
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
Clob 对象检索。
|
Clob |
getClob(String columnLabel)
将该
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
Clob 对象检索。
|
int |
getConcurrency()
检索此
ResultSet 对象的并发模式。
|
String |
getCursorName()
检索此
ResultSet 对象使用的SQL游标的名称。
|
Date |
getDate(int columnIndex)
将该
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
java.sql.Date 对象检索。
|
Date |
getDate(int columnIndex, Calendar cal)
将此
ResultSet 对象的当前行中指定列的值
ResultSet 为Java编程语言中的
java.sql.Date 对象。
|
Date |
getDate(String columnLabel)
将此
ResultSet 对象的当前行中的指定列的值作为Java编程语言中的
java.sql.Date 对象检索。
|
Date |
getDate(String columnLabel, Calendar cal)
将该
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
java.sql.Date 对象检索。
|
double |
getDouble(int columnIndex)
这个检索的当前行中指定列的值
ResultSet 对象为
double 的Java编程语言。
|
double |
getDouble(String columnLabel)
这个检索的当前行中指定列的值
ResultSet 对象为
double 的Java编程语言。
|
int |
getFetchDirection()
检索此
ResultSet 对象的抓取方向。
|
int |
getFetchSize()
检索此
ResultSet 对象的提取大小。
|
float |
getFloat(int columnIndex)
这个检索的当前行中指定列的值
ResultSet 对象为
float 的Java编程语言。
|
float |
getFloat(String columnLabel)
这个检索的当前行中指定列的值
ResultSet 对象为
float 的Java编程语言。
|
int |
getHoldability()
检索此
ResultSet 对象的
ResultSet
|
int |
getInt(int columnIndex)
这个检索的当前行中指定列的值
ResultSet 作为对象
int 在Java编程语言。
|
int |
getInt(String columnLabel)
以Java编程语言中的
int 此
ResultSet 对象的当前行中指定列的值。
|
long |
getLong(int columnIndex)
这个检索的当前行中指定列的值
ResultSet 对象为
long 的Java编程语言。
|
long |
getLong(String columnLabel)
这个检索的当前行中指定列的值
ResultSet 对象为
long 的Java编程语言。
|
ResultSetMetaData |
getMetaData()
检索此
ResultSet 对象的列的数量,类型和属性。
|
Reader |
getNCharacterStream(int columnIndex)
将此
ResultSet 对象的当前行中的指定列的值
ResultSet 为
java.io.Reader 对象。
|
Reader |
getNCharacterStream(String columnLabel)
将此
ResultSet 对象的当前行中的指定列的值
ResultSet 为
java.io.Reader 对象。
|
NClob |
getNClob(int columnIndex)
将该
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
NClob 对象检索。
|
NClob |
getNClob(String columnLabel)
将此
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
NClob 对象检索。
|
String |
getNString(int columnIndex)
这个检索的当前行中指定列的值
ResultSet 对象为
String 的Java编程语言。
|
String |
getNString(String columnLabel)
这个检索的当前行中指定列的值
ResultSet 对象为
String 的Java编程语言。
|
Object |
getObject(int columnIndex)
获取此的当前行中指定列的值
ResultSet 作为对象
Object 在Java编程语言。
|
<T> T |
getObject(int columnIndex, 类<T> type)
检索此
ResultSet 对象的当前行中指定列的值,并将转换为SQL类型的列到所请求的Java数据类型,如果转换支持。
|
Object |
getObject(int columnIndex, Map<String,类<?>> map)
这个检索的当前行中指定列的值
ResultSet 作为对象
Object 在Java编程语言。
|
Object |
getObject(String columnLabel)
获取此的当前行中指定列的值
ResultSet 作为对象
Object 在Java编程语言。
|
<T> T |
getObject(String columnLabel, 类<T> type)
检索此
ResultSet 对象的当前行中指定列的值,并将转换为SQL类型的列到所请求的Java数据类型,如果转换支持。
|
Object |
getObject(String columnLabel, Map<String,类<?>> map)
这个检索的当前行中指定列的值
ResultSet 作为对象
Object 在Java编程语言。
|
Ref |
getRef(int columnIndex)
将此
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
Ref 对象检索。
|
Ref |
getRef(String columnLabel)
将该
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
Ref 对象检索。
|
int |
getRow()
检索当前行号。
|
RowId |
getRowId(int columnIndex)
将此
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
java.sql.RowId 对象检索。
|
RowId |
getRowId(String columnLabel)
将该
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
java.sql.RowId 对象检索。
|
short |
getShort(int columnIndex)
这个检索的当前行中指定列的值
ResultSet 对象为
short 的Java编程语言。
|
short |
getShort(String columnLabel)
这个检索的当前行中指定列的值
ResultSet 对象为
short 的Java编程语言。
|
SQLXML |
getSQLXML(int columnIndex)
这个检索的当前行中指定列的值
ResultSet 为
java.sql.SQLXML 的Java编程语言对象。
|
SQLXML |
getSQLXML(String columnLabel)
这个检索的当前行中指定列的值
ResultSet 为
java.sql.SQLXML 的Java编程语言对象。
|
Statement |
getStatement()
检索
Statement 生成此对象
ResultSet 对象。
|
String |
getString(int columnIndex)
这个检索的当前行中指定列的值
ResultSet 对象为
String 的Java编程语言。
|
String |
getString(String columnLabel)
这个检索的当前行中指定列的值
ResultSet 对象为
String 的Java编程语言。
|
Time |
getTime(int columnIndex)
将此
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
java.sql.Time 对象检索。
|
Time |
getTime(int columnIndex, Calendar cal)
将此
ResultSet 对象的当前行中的指定列的值作为Java编程语言中的
java.sql.Time 对象检索。
|
Time |
getTime(String columnLabel)
将此
ResultSet 对象的当前行中的指定列的值作为Java编程语言中的
java.sql.Time 对象检索。
|
Time |
getTime(String columnLabel, Calendar cal)
将此
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
java.sql.Time 对象检索。
|
Timestamp |
getTimestamp(int columnIndex)
将该
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
java.sql.Timestamp 对象检索。
|
Timestamp |
getTimestamp(int columnIndex, Calendar cal)
将此
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
java.sql.Timestamp 对象检索。
|
Timestamp |
getTimestamp(String columnLabel)
将此
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
java.sql.Timestamp 对象检索。
|
Timestamp |
getTimestamp(String columnLabel, Calendar cal)
将此
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
java.sql.Timestamp 对象检索。
|
int |
getType()
检索此
ResultSet 对象的类型。
|
InputStream |
getUnicodeStream(int columnIndex)
已弃用
使用
getCharacterStream 代替getUnicodeStream
|
InputStream |
getUnicodeStream(String columnLabel)
已弃用
使用
getCharacterStream 代替
|
URL |
getURL(int columnIndex)
将该
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
java.net.URL 对象检索。
|
URL |
getURL(String columnLabel)
将此
ResultSet 对象的当前行中指定列的值作为Java编程语言中的
java.net.URL 对象检索。
|
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 值更新指定的列。
|
default void |
updateObject(int columnIndex, Object x, SQLType targetSqlType)
使用
Object 值更新指定的列。
|
default void |
updateObject(int columnIndex, Object x, SQLType targetSqlType, int scaleOrLength)
使用
Object 值更新指定的列。
|
void |
updateObject(String columnLabel, Object x)
使用
Object 值更新指定的列。
|
void |
updateObject(String columnLabel, Object x, int scaleOrLength)
使用
Object 值更新指定的列。
|
default void |
updateObject(String columnLabel, Object x, SQLType targetSqlType)
使用
Object 值更新指定的列。
|
default void |
updateObject(String columnLabel, Object x, SQLType targetSqlType, 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 。
|
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
对基于
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
具有此
ResultSet
对象的常量将被关闭。
boolean next() throws SQLException
ResultSet
光标最初位于第一行之前;
第一次调用方法next
使第一行成为当前行;
第二个调用使第二行成为当前行,依此类推。
当调用next
方法返回false
时,光标位于最后一行之后。 任何调用需要当前行的ResultSet
方法将导致抛出SQLException
。 如果结果集类型为TYPE_FORWARD_ONLY
,这是他们指定的JDBC驱动程序实现是否会返回供应商false
或抛出一个SQLException
上的后续调用next
。
如果当前行的输入流已打开,则对方法next
的调用将隐式关闭它。 当读取新行时, ResultSet
对象的警告链将被清除。
true
如果新的当前行有效;
false
如果没有更多的行
SQLException
- 如果发生数据库访问错误,或者在关闭的结果集上调用此方法
void close() throws SQLException
ResultSet
发布此ResultSet
对象的数据库和JDBC资源,而不是等待此事件在自动关闭时发生。
一个的闭合ResultSet
对象不关闭Blob
, Clob
或NClob
由创建的对象ResultSet
。 Blob
, Clob
或NClob
对象在它们被创建的,除非他们的交易的至少持续时间保持有效free
被调用方法。
当ResultSet
关闭时,通过调用getMetaData
方法创建的任何ResultSetMetaData
实例仍然可访问。
注意: ResultSet
目的是通过自动关闭Statement
生成它时该对象Statement
对象被关闭时,重新执行,或用于检索从多个结果的序列中的下一结果。
调用已关闭的ResultSet
对象上的方法close
是无操作的。
close
中的
AutoCloseable
SQLException
- 如果发生数据库访问错误
boolean wasNull() throws SQLException
NULL
。
请注意,您必须先在列上调用其中一个getter方法以尝试读取其值,然后调用方法wasNull
来查看读取的值是否为SQL NULL
。
true
如果读取的最后一列值为SQL
NULL
和
false
false
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
String getString(int columnIndex) throws SQLException
ResultSet
对象为
String
的Java编程语言。
columnIndex
- 第一列是1,第二列是2,...
NULL
,返回值为null
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
boolean getBoolean(int columnIndex) throws SQLException
ResultSet
对象为boolean
的Java编程语言。
如果指定列的数据类型为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
ResultSet
对象为
byte
的Java编程语言。
columnIndex
- 第一列是1,第二列是2,...
NULL
,返回值为0
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
short getShort(int columnIndex) throws SQLException
ResultSet
对象为
short
的Java编程语言。
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
ResultSet
对象为
long
的Java编程语言。
columnIndex
- 第一列是1,第二列是2,...
NULL
,返回值为0
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
float getFloat(int columnIndex) throws SQLException
ResultSet
对象为
float
的Java编程语言。
columnIndex
- 第一列是1,第二列是2,...
NULL
,返回值为0
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
double getDouble(int columnIndex) throws SQLException
ResultSet
对象为
double
的Java编程语言。
columnIndex
- 第一列是1,第二列是2,...
NULL
,返回值为0
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
@Deprecated BigDecimal getBigDecimal(int columnIndex, int scale) throws SQLException
getBigDecimal(int columnIndex)
或getBigDecimal(String columnLabel)
ResultSet
对象为
java.sql.BigDecimal
的Java编程语言。
columnIndex
- 第一列是1,第二列是2,...
scale
- 小数点右侧的位数
NULL
,返回值为null
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
byte[] getBytes(int columnIndex) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的byte
数组检索。
字节表示驱动程序返回的原始值。
columnIndex
- 第一列是1,第二列是2,...
NULL
,返回值为null
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
Date getDate(int columnIndex) throws SQLException
ResultSet
对象的当前行中的指定列的值作为Java编程语言中的
java.sql.Date
对象检索。
columnIndex
- 第一列是1,第二列是2,...
NULL
,返回值为null
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
Time getTime(int columnIndex) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的
java.sql.Time
对象检索。
columnIndex
- 第一列是1,第二列是2,...
NULL
,则返回值为null
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
Timestamp getTimestamp(int columnIndex) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的
java.sql.Timestamp
对象检索。
columnIndex
- 第一列是1,第二列是2,...
NULL
,返回值为null
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
InputStream getAsciiStream(int columnIndex) throws SQLException
ResultSet
对象的当前行中指定列的值作为ASCII字符流检索。
然后可以从流中读取大小写的值。
这种方法特别适用于检索大量的LONGVARCHAR
值。
JDBC驱动程序将从数据库格式进行任何必要的转换为ASCII。
注意:返回流中的所有数据必须在获取任何其他列的值之前读取。 下一次调用getter方法会隐式关闭流。 此外,当调用方法InputStream.available
是否有数据可用时,流可能返回0
。
columnIndex
- 第一列是1,第二列是2,...
NULL
,返回值为null
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
@Deprecated InputStream getUnicodeStream(int columnIndex) throws SQLException
getCharacterStream
代替getUnicodeStream
ResultSet
对象的当前行中指定列的值,以及两字节3个字符的流。
第一个字节是高字节;
第二个字节是低字节。
然后可以从流中读取大小写的值。
这种方法特别适用于检索大量的LONGVARCHAR
值。
JDBC驱动程序将从数据库格式进行任何必要的转换为Unicode。
注意:返回流中的所有数据必须在获取任何其他列的值之前读取。 下一次调用getter方法会隐式关闭流。 此外,当调用方法InputStream.available
时,是否有数据可用,流可能返回0
。
columnIndex
- 第一列是1,第二列是2,...
NULL
,返回值为null
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
InputStream getBinaryStream(int columnIndex) throws SQLException
ResultSet
对象的当前行中的指定列的值作为未解释的字节流检索。
然后可以从流中读取大小写的值。
该方法特别适用于检索大量的LONGVARBINARY
值。
注意:返回流中的所有数据必须在获取任何其他列的值之前读取。 下一次调用getter方法会隐式关闭流。 此外,当调用方法InputStream.available
是否有数据可用时,流可能返回0
。
columnIndex
- 第一列是1,第二列是2,...
NULL
,则返回值为null
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
String getString(String columnLabel) throws SQLException
ResultSet
对象为
String
的Java编程语言。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
NULL
,返回值为null
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
boolean getBoolean(String columnLabel) throws SQLException
ResultSet
对象为boolean
的Java编程语言。
如果指定列的数据类型为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
ResultSet
对象为
byte
的Java编程语言。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
NULL
,返回值为0
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
short getShort(String columnLabel) throws SQLException
ResultSet
对象为
short
的Java编程语言。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
NULL
,返回值为0
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
int getInt(String columnLabel) throws SQLException
ResultSet
作为对象
int
在Java编程语言。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
NULL
,返回值为0
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
long getLong(String columnLabel) throws SQLException
ResultSet
对象为
long
的Java编程语言。
columnLabel
- 用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
NULL
,则返回值为0
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
float getFloat(String columnLabel) throws SQLException
ResultSet
对象为
float
的Java编程语言。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
NULL
,返回值为0
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
double getDouble(String columnLabel) throws SQLException
ResultSet
对象为
double
的Java编程语言。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
NULL
,返回值为0
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
@Deprecated BigDecimal getBigDecimal(String columnLabel, int scale) throws SQLException
getBigDecimal(int columnIndex)
或getBigDecimal(String columnLabel)
ResultSet
对象为
java.math.BigDecimal
的Java编程语言。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
scale
- 小数点右侧的位数
NULL
,返回值为null
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
byte[] getBytes(String columnLabel) throws SQLException
ResultSet
对象的当前行中的指定列的值作为Java编程语言中的byte
数组检索。
字节表示驱动程序返回的原始值。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
NULL
,则返回的值为null
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
Date getDate(String columnLabel) throws SQLException
ResultSet
对象的形式
java.sql.Date
此
ResultSet
对象的当前行中指定列的值。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
NULL
,则返回的值为null
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
Time getTime(String columnLabel) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的
java.sql.Time
对象检索。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
NULL
,返回值为null
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
Timestamp getTimestamp(String columnLabel) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的
java.sql.Timestamp
对象检索。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
NULL
,则返回值为null
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
InputStream getAsciiStream(String columnLabel) throws SQLException
ResultSet
对象的当前行中指定列的值作为ASCII字符流检索。
然后可以从流中读取大小写的值。
这种方法特别适用于检索大量的LONGVARCHAR
值。
JDBC驱动程序将从数据库格式进行任何必要的转换为ASCII。
注意:返回流中的所有数据必须在获取任何其他列的值之前读取。 下一次调用getter方法会隐式关闭流。 此外,当调用方法available
是否有可用数据可用时,流可能返回0
。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
NULL
,返回值为null
。
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
@Deprecated InputStream getUnicodeStream(String columnLabel) throws SQLException
getCharacterStream
ResultSet
对象的当前行中指定列的值作为两字节Unicode字符流检索。
第一个字节是高字节;
第二个字节是低字节。
然后可以从流中读取大小写的值。
该方法特别适用于检索大型LONGVARCHAR
值。
启用JDBC技术的驱动程序将从数据库格式进行任何必要的转换为Unicode。
注意:返回流中的所有数据必须在获取任何其他列的值之前读取。 下一次调用getter方法会隐式关闭流。 此外,当调用方法InputStream.available
时,是否有数据可用,流可能返回0
。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
NULL
,返回值为null
。
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
InputStream getBinaryStream(String columnLabel) throws SQLException
ResultSet
对象的当前行中的指定列的值ResultSet
为未解释的流byte
s。
然后可以从流中读取大小写的值。
这种方法特别适用于检索大量的LONGVARBINARY
值。
注意:返回流中的所有数据必须在获取任何其他列的值之前读取。 下一次调用getter方法会隐式关闭流。 此外,当调用方法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
对象上报告的所有警告。
调用此方法后,方法getWarnings
返回null
,直到此ResultSet
对象报告新的警告。
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
获取此的当前行中指定列的值ResultSet
作为对象Object
在Java编程语言。
此方法将以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
获取此的当前行中指定列的值ResultSet
作为对象Object
在Java编程语言。
此方法将以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
ResultSet
对象的当前行中的指定列的值
ResultSet
为
java.io.Reader
对象。
columnIndex
- 第一列是1,第二列是2,...
java.io.Reader
对象;
如果值为SQL NULL
,则返回的值为null
在Java编程语言中)。
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
Reader getCharacterStream(String columnLabel) throws SQLException
ResultSet
对象的当前行中的指定列的值
ResultSet
为
java.io.Reader
对象。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
java.io.Reader
对象;
如果值为SQL NULL
,返回的值为null
,在Java编程语言
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
BigDecimal getBigDecimal(int columnIndex) throws SQLException
ResultSet
对象的当前行中指定列的值作为
java.math.BigDecimal
完全精确检索。
columnIndex
- 第一列是1,第二列是2,...
NULL
,返回的值为null
,在Java编程语言中。
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
BigDecimal getBigDecimal(String columnLabel) throws SQLException
ResultSet
对象的当前行中指定列的值作为
java.math.BigDecimal
以完全精确的方式获取。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
NULL
,则返回的值为null
在Java编程语言中)。
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
boolean isBeforeFirst() throws SQLException
ResultSet
对象中的第一行之前。
注意:对于ResultSet
s,支持isBeforeFirst
方法是可选的,结果集类型为TYPE_FORWARD_ONLY
true
如果光标在第一行之前;
false
如果光标在任何其他位置或结果集不包含任何行
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
boolean isAfterLast() throws SQLException
ResultSet
对象中的最后一行之后。
注意:对于ResultSet
s,支持isAfterLast
方法是可选的,结果集类型为TYPE_FORWARD_ONLY
true
如果光标在最后一行之后;
false
如果光标处于任何其他位置,或者结果集不包含任何行
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
boolean isFirst() throws SQLException
ResultSet
对象的第一行。
注意:支持isFirst
方法对于ResultSet
s是可选的,结果集类型为TYPE_FORWARD_ONLY
true
如果光标在第一行上;
false
否则
SQLException
- 如果发生数据库访问错误或在关闭结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
boolean isLast() throws SQLException
ResultSet
对象的最后一行。
注意:调用方法isLast
可能是昂贵的,因为JDBC驱动程序可能需要提前一行才能确定当前行是否是结果集中的最后一行。
注意:对于ResultSet
s,支持isLast
方法是可选的,结果集类型为TYPE_FORWARD_ONLY
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
注意:对于ResultSet
s,支持getRow
方法是可选的,结果集类型为TYPE_FORWARD_ONLY
0
如果没有当前行
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
boolean absolute(int row) throws SQLException
ResultSet
对象中给定的行号。
如果行号为正,则光标相对于结果集的开头移动到给定的行号。 第一行是第1行,第二行是第2行,依此类推。
如果给定行号为负,光标将移动到相对于结果集结尾的绝对行位置。 例如,调用方法absolute(-1)
将光标置于最后一行; 调用方法absolute(-2)
将光标移动到下一行到最后一行,依此类推。
如果指定的行号为零,则光标移动到第一行之前。
将光标定位在结果集中的第一行/最后一行之外的尝试将光标留在第一行之前或最后一行之后。
注意:调用absolute(1)
与调用first()
相同。 调用absolute(-1)
与调用last()
相同。
row
- 光标应该移动的行的编号。
值为零表示光标将位于第一行之前;
正数表示从结果集开始计数的行号;
负号表示从结果集的结尾开始计数的行号
true
如果光标移动到这个ResultSet
对象的位置;
false
如果光标在第一行之前或最后一行之后
SQLException
- 如果发生数据库访问错误;
该方法在闭合结果集上调用或结果集类型为TYPE_FORWARD_ONLY
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
boolean relative(int rows) throws SQLException
relative(0)
是有效的,但不会更改光标位置。
注:调用方法relative(1)
是相同的调用方法next()
并调用方法relative(-1)
是相同的调用方法previous()
。
rows
- 一个int
从当前行移动的行数的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
对象中的行将被处理的方向的提示。
初始值由确定Statement
生成此对象ResultSet
对象。
抓取方向可随时更改。
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
注意:支持rowUpdated
方法是可选的,结果集并发性为CONCUR_READ_ONLY
true
如果检测到当前行已被所有者或另一个明显更新;
false
否则
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
DatabaseMetaData.updatesAreDetected(int)
boolean rowInserted() throws SQLException
ResultSet
对象是否可以检测到可见的插入。
注意:支持rowInserted
方法是可选的,结果集并发性为CONCUR_READ_ONLY
true
如果检测到当前行被插入;
false
否则
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
DatabaseMetaData.insertsAreDetected(int)
boolean rowDeleted() throws SQLException
ResultSet
对象是否可以检测到删除。
注意:支持rowDeleted
方法是可选的,结果集并发性为CONCUR_READ_ONLY
true
如果检测到当前行被所有者或另一个删除;
false
否则
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
DatabaseMetaData.deletesAreDetected(int)
void updateNull(int columnIndex) throws SQLException
null
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列是2,...
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateBoolean(int columnIndex, boolean x) throws SQLException
boolean
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列为1,第二列为2,...
x
- 新的列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者在一个封闭的结果集上调用这个方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateByte(int columnIndex, byte x) throws SQLException
byte
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateShort(int columnIndex, short x) throws SQLException
short
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateInt(int columnIndex, int x) throws SQLException
int
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者在一个封闭的结果集上调用这个方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateLong(int columnIndex, long x) throws SQLException
long
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateFloat(int columnIndex, float x) throws SQLException
float
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateDouble(int columnIndex, double x) throws SQLException
double
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者在一个封闭的结果集上调用这个方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException
java.math.BigDecimal
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateString(int columnIndex, String x) throws SQLException
String
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者在一个封闭的结果集上调用这个方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateBytes(int columnIndex, byte[] x) throws SQLException
byte
数组值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这种方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateDate(int columnIndex, Date x) throws SQLException
java.sql.Date
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法更新数据库。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者在一个封闭的结果集上调用这个方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateTime(int columnIndex, Time x) throws SQLException
java.sql.Time
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateTimestamp(int columnIndex, Timestamp x) throws SQLException
java.sql.Timestamp
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是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
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
如果第二个参数是InputStream
则流必须包含scaleOrLength指定的字节数。 如果第二个参数是Reader
那么读者必须包含由scaleOrLength指定的字符数。 如果这些条件不正确,则执行该SQLException
时,驱动程序将生成一个SQLException
。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
scaleOrLength
-为的目的java.math.BigDecimal
,这是数字的小数点后的位数。
对于Java对象类型InputStream
和Reader
,这是流或读取器中数据的长度。
对于所有其他类型,此值将被忽略。
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性为CONCUR_READ_ONLY
或者在一个封闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateObject(int columnIndex, Object x) throws SQLException
Object
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateNull(String columnLabel) throws SQLException
null
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateBoolean(String columnLabel, boolean x) throws SQLException
boolean
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
x
- 新的列值
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateByte(String columnLabel, byte x) throws SQLException
byte
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
x
- 新的列值
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateShort(String columnLabel, short x) throws SQLException
short
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
x
- 新的列值
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误;
结果集并发性为CONCUR_READ_ONLY
或者在一个封闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateInt(String columnLabel, int x) throws SQLException
int
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
x
- 新的列值
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者在一个封闭的结果集上调用这个方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateLong(String columnLabel, long x) throws SQLException
long
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
x
- 新的列值
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者在一个封闭的结果集上调用这个方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateFloat(String columnLabel, float x) throws SQLException
float
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
x
- 新的列值
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateDouble(String columnLabel, double x) throws SQLException
double
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是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
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
x
- 新的列值
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateString(String columnLabel, String x) throws SQLException
String
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是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
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是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
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是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
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是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
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
如果第二个参数是InputStream
则流必须包含scaleOrLength指定的字节数。 如果第二个参数是Reader
那么读者必须包含由scaleOrLength指定的字符数。 如果这些条件不正确,则执行该SQLException
时,驱动程序将生成一个SQLException
。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
x
- 新的列值
scaleOrLength
-为的目的java.math.BigDecimal
,这是数字的小数点后的位数。
对于Java对象类型InputStream
和Reader
,这是流或读取器中数据的长度。
对于所有其他类型,此值将被忽略。
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateObject(String columnLabel, Object x) throws SQLException
Object
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
x
- 新的列值
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误;
结果集并发性为CONCUR_READ_ONLY
或者在一个封闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void insertRow() throws SQLException
ResultSet
对象中并进入数据库。
当调用此方法时,游标必须位于插入行上。
SQLException
- 如果发生数据库访问错误;
结果集并发性为CONCUR_READ_ONLY
,该方法在闭合结果集上调用,如果当游标不在插入行上时调用此方法,或者插入行中不是全部不可为空的列都被赋予非 - 空值
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
方法为refreshRow
程序提供了一种明确告知JDBC驱动程序从数据库中提取行的方法。 当JDBC驱动程序执行缓存或预refreshRow
时,应用程序可能希望调用refreshRow
,以从数据库中获取行的最新值。 如果抓取大小大于1,JDBC驱动程序可能会一次刷新多个行。
根据事务隔离级别和光标灵敏度,所有值都被刷新。 如果在调用updater方法后调用了refreshRow
,但在调用方法updateRow
之前调用,那么对行的更新就会丢失。 refreshRow
调用方法refreshRow
可能会降低性能。
SQLException
- 如果发生数据库访问错误;
这个方法在一个封闭的结果集上被调用;
结果集类型为TYPE_FORWARD_ONLY
或者当光标在插入行上时调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法,或者该方法不支持指定的结果集类型和结果集并发。
void cancelRowUpdates() throws SQLException
ResultSet
对象中当前行的更新。
调用updateRow
方法之后,调用方法updateRow
之前可以调用此方法来回滚对行进行的更新。
如果没有更新或已经调用了updateRow
,则此方法无效。
SQLException
- 如果发生数据库访问错误;
这个方法在一个封闭的结果集上被调用;
结果集并发性为CONCUR_READ_ONLY
或者当光标在插入行上时调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void moveToInsertRow() throws SQLException
insertRow
方法。
在调用insertRow
之前,每次调用此方法时,都必须为结果集中的所有列赋予一个值。
必须先调用updater方法,然后才能对列值调用getter方法。
SQLException
- 如果发生数据库访问错误;
这个方法在一个封闭的结果集上被调用,或者结果集并发是CONCUR_READ_ONLY
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void moveToCurrentRow() throws SQLException
SQLException
- 如果发生数据库访问错误;
这个方法在一个封闭的结果集上被调用,或者结果集并发是CONCUR_READ_ONLY
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
Statement getStatement() throws SQLException
Statement
生成此对象ResultSet
对象。
如果结果集是以某种其他方式生成的,例如通过DatabaseMetaData
方法,则此方法可能会返回null
。
Statement
生成此对象
ResultSet
对象或
null
如果结果集制作一些其他的方式
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
Object getObject(int columnIndex, Map<String,类<?>> map) throws SQLException
Object
此ResultSet
对象当前行中指定列的值。
如果该值为SQL NULL
,驱动程序将返回Java null
。
此方法使用给定的Map
对象进行正在检索的SQL结构化或不同类型的自定义映射。
columnIndex
- 第一列是1,第二列是2,...
map
- 包含从SQL类型名称到Java编程语言中的类的映射的
java.util.Map
对象
Object
SQL值的Java编程语言中的一个Object
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
Ref getRef(int columnIndex) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的
Ref
对象检索。
columnIndex
- 第一列是1,第二列是2,...
REF
值的
Ref
对象
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
Blob getBlob(int columnIndex) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的
Blob
对象检索。
columnIndex
- 第一列是1,第二列是2,...
Blob
对象,表示指定列中的SQL
BLOB
值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
Clob getClob(int columnIndex) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的
Clob
对象检索。
columnIndex
- 第一列是1,第二列是2,...
Clob
对象,表示指定列中的SQL
CLOB
值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
Array getArray(int columnIndex) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的
Array
对象检索。
columnIndex
- 第一列是1,第二列是2,...
Array
对象,表示指定列中的SQL
ARRAY
值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
Object getObject(String columnLabel, Map<String,类<?>> map) throws SQLException
ResultSet
作为对象Object
在Java编程语言。
如果值为SQL NULL
,则驱动程序返回Java null
。
如果适用,此方法使用指定的Map
对象进行自定义映射。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
map
- 包含从SQL类型名称到Java编程语言中的类的映射的
java.util.Map
对象
Object
表示指定列中的SQL值
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
Ref getRef(String columnLabel) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的
Ref
对象检索。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
Ref
对象,表示指定列中的SQL
REF
值
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
Blob getBlob(String columnLabel) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的
Blob
对象检索。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
Blob
对象,表示指定列中的SQL
BLOB
值
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
Clob getClob(String columnLabel) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的
Clob
对象检索。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
Clob
对象,表示指定列中的SQL
CLOB
值
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
Array getArray(String columnLabel) throws SQLException
ResultSet
对象的当前行中的指定列的值作为Java编程语言中的
Array
对象检索。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
Array
指定列中的SQL
ARRAY
值的
Array
对象
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
Date getDate(int columnIndex, Calendar cal) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的java.sql.Date
对象检索。
如果基础数据库不存储时区信息,则此方法使用给定的日历为日期构造适当的毫秒值。
columnIndex
- 第一列是1,第二列是2,...
cal
- 用于
java.util.Calendar
日期的
java.util.Calendar
对象
java.sql.Date
对象;
如果值为SQL NULL
,返回的值为null
,在Java编程语言
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
Date getDate(String columnLabel, Calendar cal) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的java.sql.Date
对象检索。
如果基础数据库不存储时区信息,则此方法使用给定的日历为日期构造适当的毫秒值。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
cal
- 用于
java.util.Calendar
日期的
java.util.Calendar
对象
java.sql.Date
对象;
如果值为SQL NULL
,则返回的值为null
,在Java编程语言
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
Time getTime(int columnIndex, Calendar cal) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的java.sql.Time
对象检索。
如果基础数据库不存储时区信息,则此方法使用给定的日历来构建适当的毫秒值。
columnIndex
- 第一列是1,第二列是2,...
cal
- 用于
java.util.Calendar
时间的
java.util.Calendar
对象
java.sql.Time
对象;
如果值为SQL NULL
,返回的值为null
,在Java编程语言
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
Time getTime(String columnLabel, Calendar cal) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的java.sql.Time
对象检索。
如果基础数据库不存储时区信息,则此方法使用给定的日历来构建适当的毫秒值。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
cal
- 用于
java.util.Calendar
时间的
java.util.Calendar
对象
java.sql.Time
对象;
如果值为SQL NULL
,返回的值为null
,在Java编程语言
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的java.sql.Timestamp
对象检索。
如果基础数据库不存储时区信息,则此方法使用给定的日历为时间戳创建适当的毫秒值。
columnIndex
- 第一列是1,第二列是2,...
cal
- 用于
java.util.Calendar
对象
java.sql.Timestamp
对象;
如果值为SQL NULL
,则返回的值为null
,在Java编程语言
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
Timestamp getTimestamp(String columnLabel, Calendar cal) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的java.sql.Timestamp
对象检索。
如果基础数据库不存储时区信息,则此方法使用给定的日历为时间戳创建适当的毫秒值。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
cal
- 用于
java.util.Calendar
日期的
java.util.Calendar
对象
java.sql.Timestamp
对象;
如果值为SQL NULL
,返回的值为null
,在Java编程语言
SQLException
- 如果columnLabel无效或者发生数据库访问错误或者在关闭结果集上调用此方法
URL getURL(int columnIndex) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的
java.net.URL
对象检索。
columnIndex
- 列1的索引是第一个,第二个是第二个,...
java.net.URL
对象;
如果值为SQL NULL
,返回的值为null
,在Java编程语言
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
这个方法在一个封闭的结果集上被调用,或者一个URL是格式错误的
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
URL getURL(String columnLabel) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的
java.net.URL
对象检索。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
java.net.URL
对象;
如果值是SQL NULL
,返回的值是null
Java编程语言
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误;
这个方法在一个封闭的结果集上被调用,或者一个URL是格式错误的
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateRef(int columnIndex, Ref x) throws SQLException
java.sql.Ref
值更新指定列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性为CONCUR_READ_ONLY
或者在封闭结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateRef(String columnLabel, Ref x) throws SQLException
java.sql.Ref
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是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
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列是2,...
x
- 新列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateBlob(String columnLabel, Blob x) throws SQLException
java.sql.Blob
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是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
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性为CONCUR_READ_ONLY
或者在一个封闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateClob(String columnLabel, Clob x) throws SQLException
java.sql.Clob
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是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
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者在一个封闭的结果集上调用这个方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateArray(String columnLabel, Array x) throws SQLException
java.sql.Array
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
x
- 新的列值
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
RowId getRowId(int columnIndex) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的
java.sql.RowId
对象检索。
columnIndex
- 第一列是1,第二列2,...
NULL
,返回的值为null
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
RowId getRowId(String columnLabel) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的
java.sql.RowId
对象检索。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
NULL
,返回值为null
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateRowId(int columnIndex, RowId x) throws SQLException
RowId
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列2,...
x
- 列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateRowId(String columnLabel, RowId x) throws SQLException
RowId
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
x
- 列值
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
int getHoldability() throws SQLException
ResultSet
对象的
ResultSet
ResultSet.HOLD_CURSORS_OVER_COMMIT
或
ResultSet.CLOSE_CURSORS_AT_COMMIT
SQLException
- 如果发生数据库访问错误或在关闭的结果集上调用此方法
boolean isClosed() throws SQLException
ResultSet
对象是否已关闭。
一个ResultSet
如果close方法被调用它是封闭的,或者如果它会自动关闭。
ResultSet
对象关闭,则为true;
如果它仍然开放,则为false
SQLException
- 如果发生数据库访问错误
void updateNString(int columnIndex, String nString) throws SQLException
String
值更新指定的列。
更新时,它适用于使用NCHAR
, NVARCHAR
和LONGNVARCHAR
列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列2,...
nString
- 要更新的列的值
SQLException
- 如果columnIndex无效;
如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
这个方法在一个封闭的结果集上被调用;
结果集并发性为CONCUR_READ_ONLY
或发生数据库访问错误
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateNString(String columnLabel, String nString) throws SQLException
String
值更新指定的列。
更新时,它适用于使用NCHAR
, NVARCHAR
和LONGNVARCHAR
列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是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
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列2,...
nClob
- 要更新的列的值
SQLException
- 如果columnIndex无效;
如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
这个方法在一个封闭的结果集上被调用;
如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateNClob(String columnLabel, NClob nClob) throws SQLException
java.sql.NClob
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
nClob
- 要更新的列的值
SQLException
- 如果columnLabel无效;
如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
这个方法在一个封闭的结果集上被调用;
如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
NClob getNClob(int columnIndex) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的
NClob
对象检索。
columnIndex
- 第一列是1,第二列是2,...
NClob
对象,表示指定列中的SQL
NCLOB
值
SQLException
- 如果columnIndex无效;
如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
这个方法在一个封闭的结果集上被调用,或者发生数据库访问错误
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
NClob getNClob(String columnLabel) throws SQLException
ResultSet
对象的当前行中指定列的值作为Java编程语言中的
NClob
对象检索。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
NClob
对象,表示指定列中的SQL
NCLOB
值
SQLException
- 如果columnLabel无效;
如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
这个方法在一个封闭的结果集上被调用,或者发生数据库访问错误
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
SQLXML getSQLXML(int columnIndex) throws SQLException
ResultSet
为
java.sql.SQLXML
的Java编程语言对象。
columnIndex
- 第一列是1,第二列是2,...
SQLXML
对象映射一个
SQL XML
值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
SQLXML getSQLXML(String columnLabel) throws SQLException
ResultSet
为
java.sql.SQLXML
的Java编程语言对象。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
SQLXML
对象映射一个
SQL XML
值
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateSQLXML(int columnIndex, SQLXML xmlObject) throws SQLException
java.sql.SQLXML
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列2,...
xmlObject
- 要更新的列的值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
这个方法在一个封闭的结果集上被调用;
的java.xml.transform.Result
, Writer
或OutputStream
尚未收为SQLXML
对象;
如果处理XML值或结果集中存在错误并发性是CONCUR_READ_ONLY
。
getCause
方法可能会提供更详细的异常,例如,如果流不包含有效的XML。
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateSQLXML(String columnLabel, SQLXML xmlObject) throws SQLException
java.sql.SQLXML
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
xmlObject
- 列值
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误;
这个方法在一个封闭的结果集上被调用;
的java.xml.transform.Result
, Writer
或OutputStream
尚未收为SQLXML
对象;
如果处理XML值或结果集中存在错误并发性是CONCUR_READ_ONLY
。
getCause
方法可能会提供更详细的异常,例如,如果流不包含有效的XML。
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
String getNString(int columnIndex) throws SQLException
ResultSet
对象为String
的Java编程语言。
访问时,它适用于使用NCHAR
, NVARCHAR
和LONGNVARCHAR
列。
columnIndex
- 第一列是1,第二列是2,...
NULL
,则返回的值为null
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
String getNString(String columnLabel) throws SQLException
ResultSet
对象为String
的Java编程语言。
访问时,它适用于使用NCHAR
, NVARCHAR
和LONGNVARCHAR
列。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
NULL
,返回值为null
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
Reader getNCharacterStream(int columnIndex) throws SQLException
ResultSet
对象的当前行中的指定列的值ResultSet
为java.io.Reader
对象。
访问时,它适用于使用NCHAR
, NVARCHAR
和LONGNVARCHAR
列。
columnIndex
- 第一列是1,第二列是2,...
java.io.Reader
对象;
如果值是SQL NULL
,返回的值是null
Java编程语言。
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
Reader getNCharacterStream(String columnLabel) throws SQLException
ResultSet
对象的当前行中的指定列的值ResultSet
为java.io.Reader
对象。
访问时,它适用于使用NCHAR
, NVARCHAR
和LONGNVARCHAR
列。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
java.io.Reader
对象;
如果值为SQL NULL
,返回的值为null
,在Java编程语言
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误或在关闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateNCharacterStream(int columnIndex, Reader x, long length) throws SQLException
NCHAR
, NVARCHAR
和LONGNVARCHAR
列。
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是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
列。
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是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
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
length
- 流的长度
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateBinaryStream(int columnIndex, InputStream x, long length) throws SQLException
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
length
- 流的长度
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateCharacterStream(int columnIndex, Reader x, long length) throws SQLException
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
length
- 流的长度
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者在一个封闭的结果集上调用这个方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateAsciiStream(String columnLabel, InputStream x, long length) throws SQLException
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是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
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是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
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是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
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列是2,...
inputStream
- 包含将参数值设置为的数据的对象。
length
- 参数数据中的字节数。
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是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到数据库字符格式进行任何必要的转换。
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是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到数据库字符格式进行任何必要的转换。
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是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到数据库字符格式进行任何必要的转换。
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。
columnIndex
- 第一列是1,第二列2,...
reader
- 包含将参数值设置为的数据的对象。
length
- 参数数据中的字符数。
SQLException
- 如果columnIndex无效,
如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
,则此方法将在闭包结果集上CONCUR_READ_ONLY
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateNClob(String columnLabel, Reader reader, long length) throws SQLException
Reader
对象更新指定的列,这是给定的长度的字符数。
当将非常大的UNICODE值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更实用。
JDBC驱动程序将从UNICODE到数据库字符格式进行任何必要的转换。
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
reader
- 包含用于设置参数值的数据的对象。
length
- 参数数据中的字符数。
SQLException
- 如果columnLabel无效;
如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
这个方法在一个封闭的结果集上被调用;
如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateNCharacterStream(int columnIndex, Reader x) throws SQLException
NCHAR
, NVARCHAR
和LONGNVARCHAR
列。
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是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
列。
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是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
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。
注:请参考JDBC驱动程序文档,以确定它可能是更有效地使用一个版本的updateAsciiStream
其带长度参数。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateBinaryStream(int columnIndex, InputStream x) throws SQLException
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。
注:请参考JDBC驱动程序文档,以确定它可能是更有效地使用一个版本的updateBinaryStream
其带长度参数。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateCharacterStream(int columnIndex, Reader x) throws SQLException
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。
注意:请参阅您的JDBC驱动程序文档,以确定使用需要长度参数的版本updateCharacterStream
可能会更有效。
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者在一个封闭的结果集上调用这个方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateAsciiStream(String columnLabel, InputStream x) throws SQLException
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是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
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是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
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是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
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。
注:请参考JDBC驱动程序文档,以确定它可能是更有效地使用一个版本的updateBlob
其带长度参数。
columnIndex
- 第一列是1,第二列是2,...
inputStream
- 包含将参数值设置为的数据的对象。
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void updateBlob(String columnLabel, InputStream inputStream) throws SQLException
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是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到数据库字符格式进行任何必要的转换。
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是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到数据库字符格式进行任何必要的转换。
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是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到数据库字符格式进行任何必要的转换。
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。
注:请参考JDBC驱动程序文档,以确定它可能是更有效地使用一个版本的updateNClob
其带长度参数。
columnIndex
- 第一列是1,第二列2,...
reader
- 包含用于设置参数值的数据的对象。
SQLException
- 如果columnIndex无效;
如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
,则此方法将在闭包结果集上CONCUR_READ_ONLY
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持这种方法
void updateNClob(String columnLabel, Reader reader) throws SQLException
Reader
对象更新指定的列。
数据将根据需要从流中读取,直到达到流出端。
JDBC驱动程序将从UNICODE到数据库字符格式进行任何必要的转换。
更新器方法用于更新当前行或插入行中的列值。 updater方法不更新底层数据库; 而是updateRow
或insertRow
方法来更新数据库。
注:请参考JDBC驱动程序文档,以确定它可能是更有效地使用一个版本的updateNClob
其带长度参数。
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
reader
- 包含用于设置参数值的数据的对象。
SQLException
- 如果columnLabel无效;
如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
这个方法在一个封闭的结果集上被调用;
如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
<T> T getObject(int columnIndex, 类<T> type) throws SQLException
检索此ResultSet
对象的当前行中指定列的值,并将转换为SQL类型的列到所请求的Java数据类型,如果转换支持。 如果转换不受支持,或者为该类型指定为null,则抛出SQLException
。
至少,实现必须支持附录B表B-3中定义的转换,并将适当的用户定义的SQL类型转换为实现SQLData
或Struct
的Java类型。 可以支持额外的转换,并定义供应商。
T
- 由此Class对象建模的类的类型
columnIndex
- 第一列是1,第二列是2,...
type
- 表示将指定列转换为的Java数据类型的类。
type
的实例
SQLException
- 如果不支持转换,则type为null或发生其他错误。
异常的getCause()方法可能会提供更详细的异常,例如,如果发生转换错误
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
<T> T getObject(String columnLabel, 类<T> type) throws SQLException
检索此ResultSet
对象当前行中指定列的值,并将转换为SQL类型的列到所请求的Java数据类型,如果转换支持。 如果不支持转换或为该类型指定了SQLException
则抛出SQLException
。
至少,实现必须支持附录B表B-3中定义的转换,并将适当的用户定义的SQL类型转换为实现SQLData
或Struct
的Java类型。 可以支持额外的转换,并定义供应商。
T
- 由此Class对象建模的类的类型
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
type
- 表示将指定列转换为的Java数据类型的类。
type
的实例
SQLException
- 如果不支持转换,则type为null或发生其他错误。
异常的getCause()方法可能会提供更详细的异常,例如,如果发生转换错误
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
default void updateObject(int columnIndex, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException
Object
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
如果第二个参数是InputStream
则流必须包含scaleOrLength指定的字节数。 如果第二个参数是Reader
那么读者必须包含由scaleOrLength指定的字符数。 如果这些条件不正确,则执行该SQLException
时,驱动程序将生成一个SQLException
。
默认实现将抛出SQLFeatureNotSupportedException
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
targetSqlType
- 要发送到数据库的SQL类型
scaleOrLength
-为的目的java.math.BigDecimal
,这是数字的小数点后的位数。
对于Java对象类型InputStream
和Reader
,这是流或读取器中数据的长度。
对于所有其他类型,此值将被忽略。
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性为CONCUR_READ_ONLY
或者在一个封闭的结果集上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法;
如果JDBC驱动程序不支持指定的targetSqlType
JDBCType
, SQLType
default void updateObject(String columnLabel, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException
Object
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
如果第二个参数是InputStream
则流必须包含scaleOrLength指定的字节数。 如果第二个参数是Reader
那么读者必须包含scaleOrLength指定的字符数。 如果这些条件不正确,则执行该SQLException
时,驱动程序将生成一个SQLException
。
默认实现将抛出SQLFeatureNotSupportedException
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
x
- 新的列值
targetSqlType
- 要发送到数据库的SQL类型
scaleOrLength
-为的目的java.math.BigDecimal
,这是数字的小数点后的位数。
对于Java对象类型InputStream
和Reader
,这是流或读取器中数据的长度。
对于所有其他类型,此值将被忽略。
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法;
如果JDBC驱动程序不支持指定的targetSqlType
JDBCType
, SQLType
default void updateObject(int columnIndex, Object x, SQLType targetSqlType) throws SQLException
Object
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
默认实现将抛出SQLFeatureNotSupportedException
columnIndex
- 第一列是1,第二列是2,...
x
- 新的列值
targetSqlType
- 要发送到数据库的SQL类型
SQLException
- 如果columnIndex无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法;
如果JDBC驱动程序不支持指定的targetSqlType
JDBCType
, SQLType
default void updateObject(String columnLabel, Object x, SQLType targetSqlType) throws SQLException
Object
值更新指定的列。
更新器方法用于更新当前行或插入行中的列值。
updater方法不更新底层数据库;
而是updateRow
或insertRow
方法来更新数据库。
默认实现将抛出SQLFeatureNotSupportedException
columnLabel
- 使用SQL AS子句指定的列的标签。
如果未指定SQL AS子句,则该标签是列的名称
x
- 新的列值
targetSqlType
- 要发送到数据库的SQL类型
SQLException
- 如果columnLabel无效;
如果发生数据库访问错误;
结果集并发性是CONCUR_READ_ONLY
或者这个方法在一个封闭的结果集上被调用
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法;
如果JDBC驱动程序不支持指定的targetSqlType
JDBCType
,
SQLType
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.