Module java.sql
Package java.sql

Interface ResultSet

所有超接口:
AutoCloseable, Wrapper
所有已知子接口:
CachedRowSet, FilteredRowSet, JdbcRowSet, JoinRowSet, RowSet, SyncResolver, WebRowSet

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将是可滚动的,不会显示其他人所做的更改,
       // 并且是可更新的

 
ResultSet接口提供了用于从当前行检索列值的getter方法(getBooleangetLong等)。可以使用列的索引号或列的名称检索值。一般来说,使用列索引会更有效率。列从1开始编号。为了最大的可移植性,应按照每行中结果集列的从左到右顺序读取,并且每列只能读取一次。

对于getter方法,JDBC驱动程序尝试将底层数据转换为getter方法中指定的Java类型,并返回适当的Java值。 JDBC规范中有一张表显示了可以被ResultSet getter方法使用的SQL类型到Java类型的允许映射。

作为getter方法的输入使用的列名是不区分大小写的。当使用列名调用getter方法且有多个列具有相同名称时,将返回第一个匹配列的值。列名选项设计用于在生成结果集的SQL查询中使用列名。对于未在查询中明确命名的列,最好使用列号。如果使用列名,程序员应注意确保它们唯一地指代所需的列,可以通过SQL AS子句来保证。

在JDBC 2.0 API(Java 2 SDK,标准版,版本1.2)中向此接口添加了一组更新器方法。关于getter方法的参数的注释也适用于更新器方法的参数。

更新器方法可以以两种方式使用:

  1. 更新当前行中的列值。在可滚动的ResultSet对象中,游标可以向前和向后移动,到绝对位置或相对于当前行的位置。以下代码片段更新rs对象的第五行中的NAME列,然后使用updateRow方法更新从中派生rs的数据源表。
           rs.absolute(5); // 将游标移动到rs的第五行
           rs.updateString("NAME", "AINSWORTH"); // 更新第5行的NAME列为AINSWORTH
           rs.updateRow(); // 更新数据源中的行
    
     
  2. 将列值插入插入行。可更新的ResultSet对象有一个特殊的与之关联的行,用作构建要插入的行的临时区域。以下代码片段将游标移动到插入行,构建一个三列行,并使用insertRow方法将其插入rs和数据源表。
           rs.moveToInsertRow(); // 将游标移动到插入行
           rs.updateString(1, "AINSWORTH"); // 更新插入行的第一列为AINSWORTH
           rs.updateInt(2,35); // 更新第二列为35
           rs.updateBoolean(3, true); // 更新第三列为true
           rs.insertRow();
           rs.moveToCurrentRow();
    
     

当生成它的Statement对象关闭、重新执行或用于从多个结果序列中检索下一个结果时,ResultSet对象会自动关闭。

ResultSet对象的列数、类型和属性由ResultSet.getMetaData方法返回的ResultSetMetaData对象提供。

自版本:
1.1
参见:
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final int
    表示当当前事务提交时,具有此保持性的打开ResultSet对象将被关闭的常量。
    static final int
    表示不可更新的ResultSet对象的并发模式的常量。
    static final int
    表示可更新的ResultSet对象的并发模式的常量。
    static final int
    表示结果集中的行将以向前方向处理的常量;从第一个到最后一个。
    static final int
    表示结果集中的行将以向后方向处理的常量;从最后一个到第一个。
    static final int
    表示结果集中的行将以未知顺序处理的常量。
    static final int
    表示具有此保持性的打开ResultSet对象将在当前事务提交时保持打开的常量。
    static final int
    表示只能向前移动的ResultSet对象的类型的常量。
    static final int
    表示可滚动但通常不敏感于底层数据更改的ResultSet对象的类型的常量。
    static final int
    表示可滚动且通常敏感于底层数据更改的ResultSet对象的类型的常量。
  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    absolute(int row)
    将游标移动到此ResultSet对象中给定行号。
    void
    将游标移动到此ResultSet对象的末尾,即最后一行之后。
    void
    将游标移动到此ResultSet对象的开头,即第一行之前。
    void
    取消在此ResultSet对象中当前行所做的更新。
    void
    清除在此ResultSet对象上报告的所有警告。
    void
    close()
    立即释放此ResultSet对象的数据库和JDBC资源,而不是等待自动关闭时释放。
    void
    从此ResultSet对象和底层数据库中删除当前行。
    int
    findColumn(String columnLabel)
    将给定的ResultSet列标签映射到其ResultSet列索引。
    boolean
    first()
    将游标移动到此ResultSet对象中的第一行。
    getArray(int columnIndex)
    以Java编程语言中的Array对象形式检索此ResultSet对象当前行中指定列的值。
    getArray(String columnLabel)
    以Java编程语言中的Array对象形式检索此ResultSet对象当前行中指定列的值。
    getAsciiStream(int columnIndex)
    以ASCII字符流形式检索此ResultSet对象当前行中指定列的值。
    getAsciiStream(String columnLabel)
    以ASCII字符流形式检索此ResultSet对象当前行中指定列的值。
    getBigDecimal(int columnIndex)
    以完整精度的java.math.BigDecimal形式检索此ResultSet对象当前行中指定列的值。
    getBigDecimal(int columnIndex, int scale)
    已弃用。
    使用getBigDecimal(int columnIndex)getBigDecimal(String columnLabel)
    getBigDecimal(String columnLabel)
    以完整精度的java.math.BigDecimal形式检索此ResultSet对象当前行中指定列的值。
    getBigDecimal(String columnLabel, int scale)
    已弃用。
    使用getBigDecimal(int columnIndex)getBigDecimal(String columnLabel)
    getBinaryStream(int columnIndex)
    以未解释字节流形式检索此ResultSet对象当前行中指定列的值。
    getBinaryStream(String columnLabel)
    以未解释byte流形式检索此ResultSet对象当前行中指定列的值。
    getBlob(int columnIndex)
    以Java编程语言中的Blob对象形式检索此ResultSet对象当前行中指定列的值。
    getBlob(String columnLabel)
    检索当前行中指定列的值作为Java编程语言中的Blob对象。
    boolean
    getBoolean(int columnIndex)
    检索当前行中指定列的值作为Java编程语言中的布尔值。
    boolean
    getBoolean(String columnLabel)
    检索当前行中指定列的值作为Java编程语言中的布尔值。
    byte
    getByte(int columnIndex)
    检索当前行中指定列的值作为Java编程语言中的字节。
    byte
    getByte(String columnLabel)
    检索当前行中指定列的值作为Java编程语言中的字节。
    byte[]
    getBytes(int columnIndex)
    检索当前行中指定列的值作为Java编程语言中的字节数组。
    byte[]
    getBytes(String columnLabel)
    检索当前行中指定列的值作为Java编程语言中的字节数组。
    getCharacterStream(int columnIndex)
    检索当前行中指定列的值作为java.io.Reader对象。
    getCharacterStream(String columnLabel)
    检索当前行中指定列的值作为java.io.Reader对象。
    getClob(int columnIndex)
    检索当前行中指定列的值作为Java编程语言中的Clob对象。
    getClob(String columnLabel)
    检索当前行中指定列的值作为Java编程语言中的Clob对象。
    int
    检索此ResultSet对象的并发模式。
    检索此ResultSet对象使用的SQL游标的名称。
    getDate(int columnIndex)
    检索当前行中指定列的值作为Java编程语言中的java.sql.Date对象。
    getDate(int columnIndex, Calendar cal)
    检索当前行中指定列的值作为Java编程语言中的java.sql.Date对象。
    getDate(String columnLabel)
    检索当前行中指定列的值作为Java编程语言中的java.sql.Date对象。
    getDate(String columnLabel, Calendar cal)
    检索当前行中指定列的值作为Java编程语言中的java.sql.Date对象。
    double
    getDouble(int columnIndex)
    检索当前行中指定列的值作为Java编程语言中的双精度浮点数。
    double
    getDouble(String columnLabel)
    检索当前行中指定列的值作为Java编程语言中的双精度浮点数。
    int
    检索此ResultSet对象的获取方向。
    int
    检索此ResultSet对象的获取大小。
    float
    getFloat(int columnIndex)
    检索当前行中指定列的值作为Java编程语言中的浮点数。
    float
    getFloat(String columnLabel)
    检索当前行中指定列的值作为Java编程语言中的浮点数。
    int
    检索此ResultSet对象的可保持性。
    int
    getInt(int columnIndex)
    检索当前行中指定列的值作为Java编程语言中的整数。
    int
    getInt(String columnLabel)
    检索当前行中指定列的值作为Java编程语言中的整数。
    long
    getLong(int columnIndex)
    检索当前行中指定列的值作为Java编程语言中的长整型。
    long
    getLong(String columnLabel)
    检索当前行中指定列的值作为Java编程语言中的长整型。
    检索此ResultSet对象的列数、类型和属性。
    getNCharacterStream(int columnIndex)
    检索当前行中指定列的值作为java.io.Reader对象。
    getNCharacterStream(String columnLabel)
    检索当前行中指定列的值作为java.io.Reader对象。
    getNClob(int columnIndex)
    检索当前行中指定列的值作为Java编程语言中的NClob对象。
    getNClob(String columnLabel)
    检索当前行中指定列的值作为Java编程语言中的NClob对象。
    getNString(int columnIndex)
    检索当前行中指定列的值作为Java编程语言中的字符串。
    getNString(String columnLabel)
    检索当前行中指定列的值作为Java编程语言中的字符串。
    getObject(int columnIndex)
    获取当前行中指定列的值作为Java编程语言中的对象。
    <T> T
    getObject(int columnIndex, Class<T> type)
    检索当前行中指定列的值,并将其从列的SQL类型转换为请求的Java数据类型,如果支持转换。
    getObject(int columnIndex, Map<String,Class<?>> map)
    检索当前行中指定列的值作为Java编程语言中的对象。
    getObject(String columnLabel)
    获取当前行中指定列的值作为Java编程语言中的对象。
    <T> T
    getObject(String columnLabel, Class<T> type)
    检索当前行中指定列的值,并将其从列的SQL类型转换为请求的Java数据类型,如果支持转换。
    getObject(String columnLabel, Map<String,Class<?>> map)
    检索当前行中指定列的值作为Java编程语言中的对象。
    Ref
    getRef(int columnIndex)
    检索当前行中指定列的值作为Java编程语言中的Ref对象。
    Ref
    getRef(String columnLabel)
    检索当前行中指定列的值作为Java编程语言中的Ref对象。
    int
    getRow()
    检索当前行的行号。
    getRowId(int columnIndex)
    检索当前行中指定列的值作为Java编程语言中的java.sql.RowId对象。
    getRowId(String columnLabel)
    检索当前行中指定列的值作为Java编程语言中的java.sql.RowId对象。
    short
    getShort(int columnIndex)
    检索当前行中指定列的值作为Java编程语言中的短整型。
    short
    getShort(String columnLabel)
    检索当前行中指定列的值作为Java编程语言中的短整型。
    getSQLXML(int columnIndex)
    检索当前行中指定列的值作为Java编程语言中的java.sql.SQLXML对象。
    getSQLXML(String columnLabel)
    检索当前行中指定列的值作为Java编程语言中的java.sql.SQLXML对象。
    检索生成此ResultSet对象的Statement对象。
    getString(int columnIndex)
    检索当前行中指定列的值作为Java编程语言中的字符串。
    getString(String columnLabel)
    检索当前行中指定列的值作为Java编程语言中的字符串。
    getTime(int columnIndex)
    检索当前行中指定列的值作为Java编程语言中的java.sql.Time对象。
    getTime(int columnIndex, Calendar cal)
    检索当前行中指定列的值作为Java编程语言中的java.sql.Time对象。
    getTime(String columnLabel)
    检索当前行中指定列的值作为Java编程语言中的java.sql.Time对象。
    getTime(String columnLabel, Calendar cal)
    检索当前行中指定列的值作为Java编程语言中的java.sql.Time对象。
    getTimestamp(int columnIndex)
    检索当前行中指定列的值作为Java编程语言中的java.sql.Timestamp对象。
    getTimestamp(int columnIndex, Calendar cal)
    检索当前行中指定列的值作为Java编程语言中的java.sql.Timestamp对象。
    getTimestamp(String columnLabel)
    检索当前行中指定列的值作为Java编程语言中的java.sql.Timestamp对象。
    getTimestamp(String columnLabel, Calendar cal)
    检索当前行中指定列的值作为Java编程语言中的java.sql.Timestamp对象。
    int
    检索此ResultSet对象的类型。
    getUnicodeStream(int columnIndex)
    已弃用。
    使用getCharacterStream代替getUnicodeStream
    getUnicodeStream(String columnLabel)
    已弃用。
    使用getCharacterStream代替
    URL
    getURL(int columnIndex)
    检索当前行中指定列的值作为Java编程语言中的java.net.URL对象。
    URL
    getURL(String columnLabel)
    检索当前行中指定列的值作为Java编程语言中的java.net.URL对象。
    检索此ResultSet对象上调用报告的第一个警告。
    void
    将插入行的内容插入到此ResultSet对象和数据库中。
    boolean
    检索光标是否位于此ResultSet对象中的最后一行之后。
    boolean
    检索光标是否位于此ResultSet对象中的第一行之前。
    boolean
    检索此ResultSet对象是否已关闭。
    boolean
    检索光标是否位于此ResultSet对象的第一行。
    boolean
    isLast()
    检索光标是否位于此ResultSet对象的最后一行。
    boolean
    last()
    将光标移动到此ResultSet对象中的最后一行。
    void
    将光标移动到记住的光标位置,通常是当前行。
    void
    将光标移动到插入行。
    boolean
    next()
    将光标从当前位置向前移动一行。
    boolean
    将光标移动到此ResultSet对象中的上一行。
    void
    使用数据库中最新值刷新当前行。
    boolean
    relative(int rows)
    移动相对数量的行,可以是正数也可以是负数。
    boolean
    检索是否已删除行。
    boolean
    检索当前行是否已插入。
    boolean
    检索当前行是否已更新。
    void
    setFetchDirection(int direction)
    给出在处理此ResultSet对象中的行时的方向提示。
    void
    setFetchSize(int rows)
    给JDBC驱动程序一个提示,指示在需要更多行时应从数据库中获取的行数。
    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
    使用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
    使用二进制流值更新指定列。
    void
    updateBinaryStream(String columnLabel, InputStream x, int length)
    使用指定字节数的二进制流值更新指定列。
    void
    updateBinaryStream(String columnLabel, InputStream x, long length)
    使用指定字节数的二进制流值更新指定列。
    void
    updateBlob(int columnIndex, InputStream inputStream)
    使用给定的输入流更新指定列。
    void
    updateBlob(int columnIndex, InputStream inputStream, long length)
    使用指定字节数的给定输入流更新指定列。
    void
    updateBlob(int columnIndex, Blob x)
    使用java.sql.Blob值更新指定列。
    void
    updateBlob(String columnLabel, InputStream inputStream)
    使用给定的输入流更新指定列。
    void
    updateBlob(String columnLabel, InputStream inputStream, long length)
    使用指定字节数的给定输入流更新指定列。
    void
    updateBlob(String columnLabel, Blob x)
    使用java.sql.Blob值更新指定列。
    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)
    使用字节数组值更新指定列。
    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, Reader reader)
    使用给定的Reader对象更新指定列。
    void
    updateClob(int columnIndex, Reader reader, long length)
    使用给定的Reader对象更新指定列,其长度为给定的字符数。
    void
    updateClob(int columnIndex, Clob x)
    使用java.sql.Clob值更新指定列。
    void
    updateClob(String columnLabel, Reader reader)
    使用给定的Reader对象更新指定列。
    void
    updateClob(String columnLabel, Reader reader, long length)
    使用给定的Reader对象更新指定列,其长度为给定的字符数。
    void
    updateClob(String columnLabel, Clob x)
    使用java.sql.Clob值更新指定列。
    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, Reader reader)
    使用给定的Reader对象更新指定列。数据将根据需要从流中读取,直到达到流的末尾。
    void
    updateNClob(int columnIndex, Reader reader, long length)
    使用给定的Reader对象更新指定列,其长度为给定的字符数。
    void
    updateNClob(int columnIndex, NClob nClob)
    使用java.sql.NClob值更新指定列。
    void
    updateNClob(String columnLabel, Reader reader)
    使用给定的Reader对象更新指定列。
    void
    updateNClob(String columnLabel, Reader reader, long length)
    使用给定的Reader对象更新指定列,其长度为给定的字符数。
    void
    updateNClob(String columnLabel, NClob nClob)
    使用java.sql.NClob值更新指定列。
    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
    使用此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
    报告最后读取的列是否具有SQL NULL值。

    Methods declared in interface java.sql.Wrapper

    isWrapperFor, unwrap
  • Field Details

    • FETCH_FORWARD

      static final int FETCH_FORWARD
      表示结果集中的行将按照正向顺序处理;从第一个到最后一个。此常量由方法setFetchDirection使用,作为对驱动程序的提示,驱动程序可能会忽略该提示。
      自:
      1.2
      另请参见:
    • FETCH_REVERSE

      static final int FETCH_REVERSE
      表示结果集中的行将按照反向顺序处理;从最后一个到第一个。此常量由方法setFetchDirection使用,作为对驱动程序的提示,驱动程序可能会忽略该提示。
      自:
      1.2
      另请参见:
    • FETCH_UNKNOWN

      static final int FETCH_UNKNOWN
      表示结果集中的行将以未知顺序处理。此常量由方法setFetchDirection使用,作为对驱动程序的提示,驱动程序可能会忽略该提示。
      另请参见:
    • TYPE_FORWARD_ONLY

      static final int TYPE_FORWARD_ONLY
      表示ResultSet对象的游标只能向前移动的类型。
      自:
      1.2
      另请参见:
    • TYPE_SCROLL_INSENSITIVE

      static final int TYPE_SCROLL_INSENSITIVE
      表示ResultSet对象的类型为可滚动但通常不敏感于底层ResultSet数据更改的类型。
      自:
      1.2
      另请参见:
    • TYPE_SCROLL_SENSITIVE

      static final int TYPE_SCROLL_SENSITIVE
      表示ResultSet对象的类型为可滚动且通常对底层ResultSet数据更改敏感的类型。
      自:
      1.2
      另请参见:
    • CONCUR_READ_ONLY

      static final int CONCUR_READ_ONLY
      表示ResultSet对象的并发模式为不可更新。
      自:
      1.2
      另请参见:
    • CONCUR_UPDATABLE

      static final int CONCUR_UPDATABLE
      表示ResultSet对象的并发模式为可更新。
      自:
      1.2
      另请参见:
    • HOLD_CURSORS_OVER_COMMIT

      static final int HOLD_CURSORS_OVER_COMMIT
      表示具有此保持性的打开ResultSet对象将在当前事务提交时保持打开状态。
      自:
      1.4
      另请参见:
    • CLOSE_CURSORS_AT_COMMIT

      static final int CLOSE_CURSORS_AT_COMMIT
      表示具有此保持性的打开ResultSet对象将在当前事务提交时关闭。
      自:
      1.4
      另请参见:
  • Method Details

    • next

      boolean next() throws SQLException
      从当前位置将游标向前移动一行。 ResultSet游标最初定位在第一行之前;第一次调用方法next将第一行设为当前行;第二次调用将第二行设为当前行,依此类推。

      当调用next方法返回false时,游标定位在最后一行之后。任何需要当前行的ResultSet方法的调用将导致抛出SQLException。如果结果集类型为TYPE_FORWARD_ONLY,则由供应商指定其JDBC驱动程序实现在随后调用next时返回false或抛出SQLException

      如果当前行有打开的输入流,调用next方法将隐式关闭它。读取新行时,ResultSet对象的警告链将被清除。

      返回:
      如果新的当前行有效,则返回true;如果没有更多行,则返回false
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭结果集上调用此方法
    • close

      void close() throws SQLException
      立即释放此ResultSet对象的数据库和JDBC资源,而不是等待自动关闭。

      关闭ResultSet对象不会关闭由ResultSet创建的BlobClobNClob对象。除非调用它们的free方法,否则BlobClobNClob对象在创建它们的事务持续时间内保持有效。

      关闭ResultSet时,通过调用getMetaData方法创建的任何ResultSetMetaData实例仍然可访问。

      注意:Statement对象关闭、重新执行或用于检索多个结果序列中的下一个结果时,ResultSet对象会自动关闭。

      对已经关闭的ResultSet对象调用close方法不会产生任何效果。

      指定者:
      close 在接口 AutoCloseable
      抛出:
      SQLException - 如果发生数据库访问错误
    • wasNull

      boolean wasNull() throws SQLException
      报告上次读取的列是否具有SQL NULL值。请注意,必须首先调用列的getter方法尝试读取其值,然后调用方法wasNull查看读取的值是否为SQL NULL
      返回:
      如果上次读取的列值为SQL NULL,则返回true;否则返回false
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭结果集上调用此方法
    • getString

      String getString(int columnIndex) throws SQLException
      以Java编程语言中的String形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      列值;如果值为SQL NULL,则返回值为null
      抛出:
      SQLException - 如果列索引无效;如果发生数据库访问错误或在关闭结果集上调用此方法
    • getBoolean

      boolean getBoolean(int columnIndex) throws SQLException
      以Java编程语言中的boolean形式检索此ResultSet对象当前行中指定列的值。

      如果指定列的数据类型为CHAR或VARCHAR并包含"0",或者数据类型为BIT、TINYINT、SMALLINT、INTEGER或BIGINT并包含0,则返回false。如果指定列的数据类型为CHAR或VARCHAR并包含"1",或者数据类型为BIT、TINYINT、SMALLINT、INTEGER或BIGINT并包含1,则返回true

      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      列值;如果值为SQL NULL,则返回false
      抛出:
      SQLException - 如果列索引无效;如果发生数据库访问错误或在关闭结果集上调用此方法
    • getByte

      byte getByte(int columnIndex) throws SQLException
      以Java编程语言中的byte形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      列值;如果值为SQL NULL,则返回值为0
      抛出:
      SQLException - 如果列索引无效;如果发生数据库访问错误或在关闭结果集上调用此方法
    • getShort

      short getShort(int columnIndex) throws SQLException
      以Java编程语言中的short形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      列值;如果值为SQL NULL,则返回值为0
      抛出:
      SQLException - 如果列索引无效;如果发生数据库访问错误或在关闭结果集上调用此方法
    • getInt

      int getInt(int columnIndex) throws SQLException
      以Java编程语言中的int形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      列的值;如果值为SQL NULL,则返回值为0
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
    • getLong

      long getLong(int columnIndex) throws SQLException
      以Java编程语言中的long形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      列的值;如果值为SQL NULL,则返回值为0
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
    • getFloat

      float getFloat(int columnIndex) throws SQLException
      以Java编程语言中的float形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      列的值;如果值为SQL NULL,则返回值为0
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
    • getDouble

      double getDouble(int columnIndex) throws SQLException
      以Java编程语言中的double形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      列的值;如果值为SQL NULL,则返回值为0
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
    • getBigDecimal

      @Deprecated(since="1.2") BigDecimal getBigDecimal(int columnIndex, int scale) throws SQLException
      Deprecated.
      Use getBigDecimal(int columnIndex) or getBigDecimal(String columnLabel)
      以Java编程语言中的java.sql.BigDecimal形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      scale - 小数点右侧的数字个数
      返回:
      列的值;如果值为SQL NULL,则返回值为null
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
    • getBytes

      byte[] getBytes(int columnIndex) throws SQLException
      以Java编程语言中的byte数组形式检索此ResultSet对象当前行中指定列的值。字节表示驱动程序返回的原始值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      列的值;如果值为SQL NULL,则返回值为null
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
    • getDate

      Date getDate(int columnIndex) throws SQLException
      以Java编程语言中的java.sql.Date对象形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      列的值;如果值为SQL NULL,则返回值为null
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
    • getTime

      Time getTime(int columnIndex) throws SQLException
      以Java编程语言中的java.sql.Time对象形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      列的值;如果值为SQL NULL,则返回值为null
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
    • getTimestamp

      Timestamp getTimestamp(int columnIndex) throws SQLException
      以Java编程语言中的java.sql.Timestamp对象形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      列的值;如果值为SQL NULL,则返回值为null
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
    • getAsciiStream

      InputStream getAsciiStream(int columnIndex) throws SQLException
      以ASCII字符流形式检索此ResultSet对象当前行中指定列的值。然后可以从流中以块的形式读取值。此方法特别适用于检索大型LONGVARCHAR值。JDBC驱动程序将从数据库格式转换为ASCII。

      注意: 必须在获取任何其他列的值之前读取返回流中的所有数据。对getter方法的下一次调用将隐式关闭流。此外,当调用InputStream.available方法时,流可能返回0,无论数据是否可用。

      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      作为一个字节ASCII字符流传递数据库列值的Java输入流;如果值为SQL NULL,则返回值为null
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
    • getUnicodeStream

      @Deprecated(since="1.2") InputStream getUnicodeStream(int columnIndex) throws SQLException
      Deprecated.
      use getCharacterStream in place of getUnicodeStream
      以两字节Unicode字符流形式检索此ResultSet对象当前行中指定列的值。第一个字节是高字节;第二个字节是低字节。然后可以从流中以块的形式读取值。此方法特别适用于检索大型LONGVARCHAR值。JDBC驱动程序将从数据库格式转换为Unicode。

      注意: 必须在获取任何其他列的值之前读取返回流中的所有数据。对getter方法的下一次调用将隐式关闭流。此外,当调用InputStream.available方法时,流可能返回0,无论数据是否可用。

      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      作为一个两字节Unicode字符流传递数据库列值的Java输入流;如果值为SQL NULL,则返回值为null
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
    • getBinaryStream

      InputStream getBinaryStream(int columnIndex) throws SQLException
      以未解释字节流形式检索此ResultSet对象当前行中指定列的值。然后可以从流中以块的形式读取值。此方法特别适用于检索大型LONGVARBINARY值。

      注意: 必须在获取任何其他列的值之前读取返回流中的所有数据。对getter方法的下一次调用将隐式关闭流。此外,当调用InputStream.available方法时,流可能返回0,无论数据是否可用。

      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      作为一个未解释字节流传递数据库列值的Java输入流;如果值为SQL NULL,则返回值为null
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
    • getString

      String getString(String columnLabel) throws SQLException
      以Java编程语言中的String形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      列的值;如果值为SQL NULL,则返回值为null
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭结果集上调用此方法
    • getBoolean

      boolean getBoolean(String columnLabel) throws SQLException
      检索当前行中指定列的值作为Java编程语言中的boolean

      如果指定列的数据类型为CHAR或VARCHAR并包含"0",或者数据类型为BIT、TINYINT、SMALLINT、INTEGER或BIGINT并包含0,则返回false。如果指定列的数据类型为CHAR或VARCHAR并包含"1",或者数据类型为BIT、TINYINT、SMALLINT、INTEGER或BIGINT并包含1,则返回true

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      列的值;如果值为SQL NULL,则返回值为false
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
    • getByte

      byte getByte(String columnLabel) throws SQLException
      检索当前行中指定列的值作为Java编程语言中的byte
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      列的值;如果值为SQL NULL,则返回值为0
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
    • getShort

      short getShort(String columnLabel) throws SQLException
      检索当前行中指定列的值作为Java编程语言中的short
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      列的值;如果值为SQL NULL,则返回值为0
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
    • getInt

      int getInt(String columnLabel) throws SQLException
      检索当前行中指定列的值作为Java编程语言中的int
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      列的值;如果值为SQL NULL,则返回值为0
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
    • getLong

      long getLong(String columnLabel) throws SQLException
      检索当前行中指定列的值作为Java编程语言中的long
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      列的值;如果值为SQL NULL,则返回值为0
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
    • getFloat

      float getFloat(String columnLabel) throws SQLException
      检索当前行中指定列的值作为Java编程语言中的float
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      列的值;如果值为SQL NULL,则返回值为0
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
    • getDouble

      double getDouble(String columnLabel) throws SQLException
      检索当前行中指定列的值作为Java编程语言中的double
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      列的值;如果值为SQL NULL,则返回值为0
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
    • getBigDecimal

      @Deprecated(since="1.2") BigDecimal getBigDecimal(String columnLabel, int scale) throws SQLException
      Deprecated.
      Use getBigDecimal(int columnIndex) or getBigDecimal(String columnLabel)
      检索当前行中指定列的值作为Java编程语言中的java.math.BigDecimal
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      scale - 小数点右侧的位数
      返回:
      列的值;如果值为SQL NULL,则返回值为null
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
    • getBytes

      byte[] getBytes(String columnLabel) throws SQLException
      检索当前行中指定列的值作为Java编程语言中的byte数组。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      列的值;如果值为SQL NULL,则返回值为null
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
    • getDate

      Date getDate(String columnLabel) throws SQLException
      检索当前行中指定列的值作为Java编程语言中的java.sql.Date对象。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      列的值;如果值为SQL NULL,则返回值为null
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
    • getTime

      Time getTime(String columnLabel) throws SQLException
      检索当前行中指定列的值作为Java编程语言中的java.sql.Time对象。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      列的值;如果值为SQL NULL,则返回值为null
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
    • getTimestamp

      Timestamp getTimestamp(String columnLabel) throws SQLException
      检索当前行中指定列的值作为Java编程语言中的java.sql.Timestamp对象。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      列的值;如果值为SQL NULL,则返回值为null
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
    • getAsciiStream

      InputStream getAsciiStream(String columnLabel) throws SQLException
      检索当前行中指定列的值作为ASCII字符流。这些字节代表驱动程序返回的原始值。

      注意: 必须在获取任何其他列的值之前读取返回流中的所有数据。对getter方法的下一次调用将隐式关闭流。此外,当调用available方法时,流可能返回0,无论数据是否可用。

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      作为一个字节ASCII字符流传递数据库列值的Java输入流。如果值为SQL NULL,则返回值为null
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
    • getUnicodeStream

      @Deprecated(since="1.2") InputStream getUnicodeStream(String columnLabel) throws SQLException
      Deprecated.
      use getCharacterStream instead
      检索此ResultSet对象当前行中指定列的值,作为两字节Unicode字符流。第一个字节是高字节;第二个字节是低字节。然后可以从流中以块的方式读取值。此方法特别适用于检索大型LONGVARCHAR值。JDBC技术启用的驱动程序将从数据库格式转换为Unicode。

      注意:必须在获取任何其他列的值之前读取返回流中的所有数据。对getter方法的下一次调用将隐式关闭流。此外,当调用方法InputStream.available时,流可能返回0,无论是否有可用数据。

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签是列的名称
      返回:
      作为两字节Unicode字符流传递数据库列值的Java输入流。如果值为SQL NULL,则返回的值为null
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
    • getBinaryStream

      InputStream getBinaryStream(String columnLabel) throws SQLException
      检索此ResultSet对象当前行中指定列的值,作为未解释的byte流。然后可以从流中以块的方式读取值。此方法特别适用于检索大型LONGVARBINARY值。

      注意:必须在获取任何其他列的值之前读取返回流中的所有数据。对getter方法的下一次调用将隐式关闭流。此外,当调用方法available时,流可能返回0,无论是否有可用数据。

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签是列的名称
      返回:
      作为未解释的字节流传递数据库列值的Java输入流;如果值为SQL NULL,则结果为null
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭结果集上调用此方法
    • getWarnings

      SQLWarning getWarnings() throws SQLException
      检索此ResultSet对象调用时报告的第一个警告。此ResultSet对象上的后续警告将链接到此方法返回的SQLWarning对象。

      每次读取新行时,警告链都会自动清除。不得在已关闭的ResultSet对象上调用此方法;这样做将导致抛出SQLException

      注意:此警告链仅涵盖由ResultSet方法引起的警告。由Statement方法引起的任何警告(例如读取OUT参数)将链接到Statement对象。

      返回:
      报告的第一个SQLWarning对象或如果没有则为null
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭结果集上调用此方法
    • clearWarnings

      void clearWarnings() throws SQLException
      清除此ResultSet对象上报告的所有警告。调用此方法后,方法getWarnings将返回null,直到为此ResultSet对象报告新警告为止。
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭结果集上调用此方法
    • getCursorName

      String getCursorName() throws SQLException
      检索此ResultSet对象使用的SQL游标的名称。

      在SQL中,通过命名的游标检索结果表。可以使用引用游标名称的定位更新/删除语句更新或删除结果集的当前行。为确保游标具有适当的隔离级别以支持更新,游标的SELECT语句应为SELECT FOR UPDATE的形式。如果省略了FOR UPDATE,则定位更新可能失败。

      JDBC API通过提供ResultSet对象使用的SQL游标的名称来支持此SQL功能。ResultSet对象的当前行也是此SQL游标的当前行。

      返回:
      ResultSet对象的游标的SQL名称
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
    • getMetaData

      ResultSetMetaData getMetaData() throws SQLException
      检索此ResultSet对象的列的数量、类型和属性。
      返回:
      ResultSet对象的列的描述
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭结果集上调用此方法
    • getObject

      Object getObject(int columnIndex) throws SQLException

      以Java编程语言中的Object形式获取此ResultSet对象当前行中指定列的值。

      此方法将以Java对象的形式返回给定列的值。Java对象的类型将是与列的SQL类型对应的默认Java对象类型,遵循JDBC规范中指定的内置类型的映射。如果值为SQL NULL,驱动程序将返回Java null

      此方法还可用于读取特定于数据库的抽象数据类型。在JDBC 2.0 API中,方法getObject的行为扩展到实例化SQL用户定义类型的数据。

      如果Connection.getTypeMap不抛出SQLFeatureNotSupportedException,则当列包含结构化或不同值时,此方法的行为就像调用:getObject(columnIndex, this.getStatement().getConnection().getTypeMap())。如果Connection.getTypeMap抛出SQLFeatureNotSupportedException,则不支持结构化值,并且不同值将根据DISTINCT类型的基础SQL类型确定的默认Java类映射。

      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      包含列值的java.lang.Object
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
    • getObject

      Object getObject(String columnLabel) throws SQLException

      以Java编程语言中的Object形式获取此ResultSet对象当前行中指定列的值。

      此方法将以Java对象的形式返回给定列的值。Java对象的类型将是与列的SQL类型对应的默认Java对象类型,遵循JDBC规范中指定的内置类型的映射。如果值为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无效;如果发生数据库访问错误或在关闭结果集上调用此方法
    • findColumn

      int findColumn(String columnLabel) throws SQLException
      将给定的ResultSet列标签映射到其ResultSet列索引。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签是列的名称
      返回:
      给定列名的列索引
      抛出:
      SQLException - 如果ResultSet对象不包含标记为columnLabel的列,发生数据库访问错误或在关闭结果集上调用此方法
    • getCharacterStream

      Reader getCharacterStream(int columnIndex) throws SQLException
      检索此ResultSet对象当前行中指定列的值,作为java.io.Reader对象。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      包含列值的java.io.Reader对象;如果值为SQL NULL,则在Java编程语言中返回的值为null
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误或在关闭结果集上调用此方法
      自:
      1.2
    • getCharacterStream

      Reader getCharacterStream(String columnLabel) throws SQLException
      检索此ResultSet对象当前行中指定列的值,作为java.io.Reader对象。
      参数:
      columnLabel - 使用SQL AS子句指定的列标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      包含列值的java.io.Reader对象;如果值为SQL NULL,则在Java编程语言中返回的值为null
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      自版本:
      1.2
    • getBigDecimal

      BigDecimal getBigDecimal(int columnIndex) throws SQLException
      以完整精度将当前行中指定列的值作为java.math.BigDecimal检索。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      列值(完整精度);如果值为SQL NULL,则在Java编程语言中返回的值为null
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      自版本:
      1.2
    • getBigDecimal

      BigDecimal getBigDecimal(String columnLabel) throws SQLException
      以完整精度将当前行中指定列的值作为java.math.BigDecimal检索。
      参数:
      columnLabel - 使用SQL AS子句指定的列标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      列值(完整精度);如果值为SQL NULL,则在Java编程语言中返回的值为null
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      自版本:
      1.2
    • isBeforeFirst

      boolean isBeforeFirst() throws SQLException
      检索此ResultSet对象中当前行中指定列的值,作为具有完整精度的java.math.BigDecimal

      注意:对于结果集类型为TYPE_FORWARD_ONLYResultSetisBeforeFirst方法的支持是可选的

      返回:
      如果光标位于第一行之前,则返回true;如果光标位于任何其他位置或结果集不包含行,则返回false
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • isAfterLast

      boolean isAfterLast() throws SQLException
      检索此ResultSet对象中光标是否位于最后一行之后。

      注意:对于结果集类型为TYPE_FORWARD_ONLYResultSetisAfterLast方法的支持是可选的

      返回:
      如果光标位于最后一行之后,则返回true;如果光标位于任何其他位置或结果集不包含行,则返回false
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • isFirst

      boolean isFirst() throws SQLException
      检索此ResultSet对象中光标是否位于第一行。

      注意:对于结果集类型为TYPE_FORWARD_ONLYResultSetisFirst方法的支持是可选的

      返回:
      如果光标位于第一行,则返回true;否则返回false
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • isLast

      boolean isLast() throws SQLException
      检索此ResultSet对象中光标是否位于最后一行。 注意:调用isLast方法可能很昂贵,因为JDBC驱动程序可能需要提前获取一行,以确定当前行是否为结果集中的最后一行。

      注意:对于结果集类型为TYPE_FORWARD_ONLYResultSetisLast方法的支持是可选的

      返回:
      如果光标位于最后一行,则返回true;否则返回false
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • beforeFirst

      void beforeFirst() throws SQLException
      将光标移动到此ResultSet对象的开头,即第一行之前。如果结果集不包含行,则此方法不起作用。
      抛出:
      SQLException - 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • afterLast

      void afterLast() throws SQLException
      将光标移动到此ResultSet对象的末尾,即最后一行之后。如果结果集不包含行,则此方法不起作用。
      抛出:
      SQLException - 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • first

      boolean first() throws SQLException
      将光标移动到此ResultSet对象中的第一行。
      返回:
      如果光标位于有效行上,则返回true;如果结果集中没有行,则返回false
      抛出:
      SQLException - 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • last

      boolean last() throws SQLException
      将光标移动到此ResultSet对象中的最后一行。
      返回:
      如果光标位于有效行上,则返回true;如果结果集中没有行,则返回false
      抛出:
      SQLException - 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为TYPE_FORWARD_ONLY
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • getRow

      int getRow() throws SQLException
      检索当前行号。第一行为1,第二行为2,依此类推。

      注意:对于结果集类型为TYPE_FORWARD_ONLYResultSetgetRow方法的支持是可选的

      返回:
      当前行号;如果没有当前行,则为0
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • absolute

      boolean absolute(int row) throws SQLException
      将光标移动到此ResultSet对象中的给定行号。

      如果行号为正数,则光标相对于结果集开头移动到给定行号。第一行为第1行,第二行为第2行,依此类推。

      如果给定的行号为负数,则光标相对于结果集末尾移动到绝对行位置。例如,调用absolute(-1)方法将光标定位在最后一行;调用absolute(-2)方法将光标移动到倒数第二行,依此类推。

      如果指定的行号为零,则光标移动到第一行之前。

      尝试将光标定位到结果集中的第一行/最后一行之外会使光标位于第一行之前或最后一行之后。

      注意:调用absolute(1)与调用first()相同。调用absolute(-1)与调用last()相同。

      参数:
      row - 光标应移动到的行号。值为零表示光标将定位在第一行之前;正数表示从结果集开头开始计数的行号;负数表示从结果集末尾开始计数的行号
      返回:
      true 如果光标移动到此 ResultSet 对象中的位置;false 如果光标在第一行之前或最后一行之后
      抛出:
      SQLException - 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为 TYPE_FORWARD_ONLY 时调用此方法
      SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法
      自版本:
      1.2
    • relative

      boolean relative(int rows) throws SQLException
      将光标相对移动一定数量的行,可以是正数或负数。尝试移动到结果集中的第一行/最后一行之外的位置会将光标定位在第一行之前/最后一行之后。调用 relative(0) 是有效的,但不会更改光标位置。

      注意: 调用方法 relative(1) 等同于调用方法 next(),调用方法 relative(-1) 等同于调用方法 previous()

      参数:
      rows - 指定要从当前行移动的行数;正数将光标向前移动;负数将光标向后移动
      返回:
      true 如果光标在一行上;否则为 false
      抛出:
      SQLException - 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为 TYPE_FORWARD_ONLY 时调用此方法
      SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法
      自版本:
      1.2
    • previous

      boolean previous() throws SQLException
      将光标移动到此 ResultSet 对象中的上一行。

      当调用 previous 方法返回 false 时,光标定位在第一行之前。任何需要当前行的 ResultSet 方法的调用将导致抛出 SQLException

      如果为当前行打开了输入流,则调用方法 previous 将隐式关闭它。当读取新行时,ResultSet 对象的警告更改将被清除。

      返回:
      true 如果光标现在位于有效行上;false 如果光标位于第一行之前
      抛出:
      SQLException - 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为 TYPE_FORWARD_ONLY 时调用此方法
      SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法
      自版本:
      1.2
    • setFetchDirection

      void setFetchDirection(int direction) throws SQLException
      给出此 ResultSet 对象中行的处理方向的提示。初始值由生成此 ResultSet 对象的 Statement 对象确定。可以随时更改提取方向。
      参数:
      direction - 指定建议的提取方向的 int;为 ResultSet.FETCH_FORWARDResultSet.FETCH_REVERSEResultSet.FETCH_UNKNOWN 之一
      抛出:
      SQLException - 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集类型为 TYPE_FORWARD_ONLY 且提取方向不是 FETCH_FORWARD 时调用此方法
      自版本:
      1.2
      另请参阅:
    • getFetchDirection

      int getFetchDirection() throws SQLException
      检索此 ResultSet 对象的提取方向。
      返回:
      ResultSet 对象的当前提取方向
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭的结果集上调用此方法
      自版本:
      1.2
      另请参阅:
    • setFetchSize

      void setFetchSize(int rows) throws SQLException
      给 JDBC 驱动程序一个提示,指示在需要更多行时应从数据库中获取的行数。如果指定的提取大小为零,则 JDBC 驱动程序将忽略该值,并可以自行猜测提取大小。默认值由创建结果集的 Statement 对象设置。提取大小可以随时更改。
      参数:
      rows - 要获取的行数
      抛出:
      SQLException - 如果发生数据库访问错误;在关闭的结果集上调用此方法或不满足条件 rows >= 0 时调用此方法
      自版本:
      1.2
      另请参阅:
    • getFetchSize

      int getFetchSize() throws SQLException
      检索此 ResultSet 对象的提取大小。
      返回:
      ResultSet 对象的当前提取大小
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭的结果集上调用此方法
      自版本:
      1.2
      另请参阅:
    • getType

      int getType() throws SQLException
      检索此 ResultSet 对象的类型。类型由创建结果集的 Statement 对象确定。
      返回:
      ResultSet.TYPE_FORWARD_ONLYResultSet.TYPE_SCROLL_INSENSITIVEResultSet.TYPE_SCROLL_SENSITIVE
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭的结果集上调用此方法
      自版本:
      1.2
    • getConcurrency

      int getConcurrency() throws SQLException
      检索此 ResultSet 对象的并发模式。使用的并发性由创建结果集的 Statement 对象确定。
      返回:
      并发类型,为 ResultSet.CONCUR_READ_ONLYResultSet.CONCUR_UPDATABLE
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭的结果集上调用此方法
      自版本:
      1.2
    • rowUpdated

      boolean rowUpdated() throws SQLException
      检索当前行是否已更新。返回的值取决于结果集是否能够检测更新。

      注意: 对于结果集并发性为 CONCUR_READ_ONLY 的情况,对 rowUpdated 方法的支持是可选的

      返回:
      true 如果当前行被所有者或其他人明显更新;否则为 false
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法
      自版本:
      1.2
      另请参阅:
    • rowInserted

      boolean rowInserted() throws SQLException
      检索当前行是否已插入。返回的值取决于此 ResultSet 对象是否能够检测可见插入。

      注意: 对于结果集并发性为 CONCUR_READ_ONLY 的情况,对 rowInserted 方法的支持是可选的

      返回:
      true 如果当前行被检测到已插入;否则为 false
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法
      自版本:
      1.2
      另请参阅:
    • rowDeleted

      boolean rowDeleted() throws SQLException
      检索是否已删除行。删除的行可能在结果集中留下可见的“空洞”。此方法可用于检测结果集中的空洞。返回的值取决于此 ResultSet 对象是否能够检测删除。

      注意: 对于结果集并发性为 CONCUR_READ_ONLY 的情况,对 rowDeleted 方法的支持是可选的

      返回:
      true 如果当前行被所有者或其他人删除,则返回true;否则返回false
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
      参见:
    • updateNull

      void updateNull(int columnIndex) throws SQLException
      使用null值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      抛出:
      SQLException - 如果列索引无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • updateBoolean

      void updateBoolean(int columnIndex, boolean x) throws SQLException
      使用boolean值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果列索引无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • updateByte

      void updateByte(int columnIndex, byte x) throws SQLException
      使用byte值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果列索引无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • updateShort

      void updateShort(int columnIndex, short x) throws SQLException
      使用short值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果列索引无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • updateInt

      void updateInt(int columnIndex, int x) throws SQLException
      使用int值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果列索引无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • updateLong

      void updateLong(int columnIndex, long x) throws SQLException
      使用long值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果列索引无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • updateFloat

      void updateFloat(int columnIndex, float x) throws SQLException
      使用float值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果列索引无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • updateDouble

      void updateDouble(int columnIndex, double x) throws SQLException
      使用double值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果列索引无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • updateBigDecimal

      void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException
      使用java.math.BigDecimal值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果列索引无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • updateString

      void updateString(int columnIndex, String x) throws SQLException
      使用String值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果列索引无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • updateBytes

      void updateBytes(int columnIndex, byte[] x) throws SQLException
      使用byte数组值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateDate

      void updateDate(int columnIndex, Date x) throws SQLException
      使用java.sql.Date值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateTime

      void updateTime(int columnIndex, Time x) throws SQLException
      使用java.sql.Time值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateTimestamp

      void updateTimestamp(int columnIndex, Timestamp x) throws SQLException
      使用java.sql.Timestamp值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateAsciiStream

      void updateAsciiStream(int columnIndex, InputStream x, int length) throws SQLException
      使用ascii流值更新指定的列,该值将具有指定的字节数。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      length - 流的长度
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateBinaryStream

      void updateBinaryStream(int columnIndex, InputStream x, int length) throws SQLException
      使用二进制流值更新指定的列,该值将具有指定的字节数。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      length - 流的长度
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateCharacterStream

      void updateCharacterStream(int columnIndex, Reader x, int length) throws SQLException
      使用字符流值更新指定的列,该值将具有指定的字节数。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      length - 流的长度
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateObject

      void updateObject(int columnIndex, Object x, int scaleOrLength) throws SQLException
      使用Object值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      如果第二个参数是InputStream,则流必须包含由scaleOrLength指定的字节数。如果第二个参数是Reader,则读取器必须包含由scaleOrLength指定的字符数。如果这些条件不成立,当执行语句时驱动程序将生成SQLException

      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      scaleOrLength - 对于java.math.BigDecimal对象,这是小数点后的位数。对于Java对象类型InputStreamReader,这是流或读取器中的数据长度。对于所有其他类型,此值将被忽略。
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateObject

      void updateObject(int columnIndex, Object x) throws SQLException
      使用Object值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateNull

      void updateNull(String columnLabel) throws SQLException
      使用null值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateBoolean

      void updateBoolean(String columnLabel, boolean x) throws SQLException
      使用boolean值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateByte

      void updateByte(String columnLabel, byte x) throws SQLException
      使用byte值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateShort

      void updateShort(String columnLabel, short x) throws SQLException
      使用short值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateInt

      void updateInt(String columnLabel, int x) throws SQLException
      使用int值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateLong

      void updateLong(String columnLabel, long x) throws SQLException
      使用long值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateFloat

      void updateFloat(String columnLabel, float x) throws SQLException
      使用float值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateDouble

      void updateDouble(String columnLabel, double x) throws SQLException
      使用double值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateBigDecimal

      void updateBigDecimal(String columnLabel, BigDecimal x) throws SQLException
      使用java.sql.BigDecimal值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateString

      void updateString(String columnLabel, String x) throws SQLException
      使用String值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateBytes

      void updateBytes(String columnLabel, byte[] x) throws SQLException
      使用字节数组值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateDate

      void updateDate(String columnLabel, Date x) throws SQLException
      使用java.sql.Date值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateTime

      void updateTime(String columnLabel, Time x) throws SQLException
      使用java.sql.Time值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateTimestamp

      void updateTimestamp(String columnLabel, Timestamp x) throws SQLException
      使用java.sql.Timestamp值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateAsciiStream

      void updateAsciiStream(String columnLabel, InputStream x, int length) throws SQLException
      使用ascii流值更新指定的列,该值将具有指定的字节数。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      length - 流的长度
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateBinaryStream

      void updateBinaryStream(String columnLabel, InputStream x, int length) throws SQLException
      使用二进制流值更新指定的列,该值将具有指定的字节数。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      length - 流的长度
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateCharacterStream

      void updateCharacterStream(String columnLabel, Reader reader, int length) throws SQLException
      使用字符流值更新指定的列,该值将具有指定的字节数。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      reader - 包含新列值的java.io.Reader对象
      length - 流的长度
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateObject

      void updateObject(String columnLabel, Object x, int scaleOrLength) throws SQLException
      使用Object值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      如果第二个参数是InputStream,则流必须包含由scaleOrLength指定的字节数。如果第二个参数是Reader,则读取器必须包含由scaleOrLength指定的字符数。如果这些条件不成立,当执行语句时驱动程序将生成SQLException

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      scaleOrLength - 对于java.math.BigDecimal对象,这是小数点后的位数。对于Java对象类型InputStreamReader,这是流或读取器中的数据长度。对于所有其他类型,此值将被忽略。
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateObject

      void updateObject(String columnLabel, Object x) throws SQLException
      使用Object值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • insertRow

      void insertRow() throws SQLException
      将插入行的内容插入此ResultSet对象和数据库中。调用此方法时,光标必须位于插入行上。
      抛出:
      SQLException - 如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY;在关闭的结果集上调用此方法;当光标不在插入行上时调用此方法;或者如果插入行中的所有非空列未给定非空值
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • updateRow

      void updateRow() throws SQLException
      使用此ResultSet对象当前行的新内容更新底层数据库。当光标位于插入行上时,无法调用此方法。
      抛出:
      SQLException - 如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY;在关闭的结果集上调用此方法;或者当光标位于插入行上时调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.2版本起:
      1.2
    • deleteRow

      void deleteRow() throws SQLException
      从此ResultSet对象和底层数据库中删除当前行。当光标位于插入行上时,无法调用此方法。
      抛出:
      SQLException - 如果发生数据库访问错误;结果集并发性为 CONCUR_READ_ONLY;在关闭的结果集上调用此方法或在光标位于插入行时调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • refreshRow

      void refreshRow() throws SQLException
      刷新当前行以获取数据库中最新的值。当光标位于插入行时,无法调用此方法。

      refreshRow 方法提供了一种应用程序明确告诉JDBC驱动程序从数据库重新获取一行或多行的方式。应用程序可能希望在JDBC驱动程序执行缓存或预取时调用 refreshRow 以从数据库获取行的最新值。如果获取大小大于一,则JDBC驱动程序实际上可能一次刷新多行。

      所有值都将根据事务隔离级别和光标敏感性重新获取。如果在调用更新程序方法后但在调用方法 updateRow 之前调用 refreshRow,则对行进行的更新将丢失。频繁调用方法 refreshRow 可能会降低性能。

      抛出:
      SQLException - 如果发生数据库访问错误;在关闭的结果集上调用此方法;结果集类型为 TYPE_FORWARD_ONLY 或在光标位于插入行时调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法或不支持指定的结果集类型和结果集并发性
      自版本:
      1.2
    • cancelRowUpdates

      void cancelRowUpdates() throws SQLException
      取消在此 ResultSet 对象中对当前行所做的更新。可以在调用更新程序方法后但在调用方法 updateRow 之前调用此方法,以撤消对行所做的更新。如果没有进行更新或已经调用 updateRow,则此方法不起作用。
      抛出:
      SQLException - 如果发生数据库访问错误;在关闭的结果集上调用此方法;结果集并发性为 CONCUR_READ_ONLY 或在光标位于插入行时调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • moveToInsertRow

      void moveToInsertRow() throws SQLException
      将光标移动到插入行。在光标位于插入行时,当前光标位置将被记住。插入行是与可更新结果集关联的特殊行。它本质上是一个缓冲区,可以通过在将行插入结果集之前调用更新程序方法来构造新行。只有在光标位于插入行时才能调用更新程序、获取程序和 insertRow 方法。每次调用此方法之前,必须为结果集中的所有列赋值,然后才能调用 insertRow。在调用列值的获取程序方法之前必须调用更新程序方法。
      抛出:
      SQLException - 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集并发性为 CONCUR_READ_ONLY
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • moveToCurrentRow

      void moveToCurrentRow() throws SQLException
      将光标移动到记住的光标位置,通常是当前行。如果光标不在插入行上,则此方法不起作用。
      抛出:
      SQLException - 如果发生数据库访问错误;在关闭的结果集上调用此方法或结果集并发性为 CONCUR_READ_ONLY
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • getStatement

      Statement getStatement() throws SQLException
      检索生成此 ResultSet 对象的 Statement 对象。如果结果集是以其他方式生成的,例如通过 DatabaseMetaData 方法生成的,则此方法可能返回 null
      返回:
      生成此 ResultSet 对象的 Statement 对象或如果结果集是以其他方式生成的则返回 null
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭的结果集上调用此方法
      自版本:
      1.2
    • getObject

      Object getObject(int columnIndex, Map<String,Class<?>> map) throws SQLException
      以Java编程语言中的 Object 形式检索此 ResultSet 对象的当前行中指定列的值。如果值为SQL NULL,则驱动程序返回Java null。如果适用,此方法使用给定的 Map 对象进行SQL结构化或不同类型的自定义映射。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      map - 包含SQL类型名称到Java编程语言中的类的映射的 java.util.Map 对象
      返回:
      以Java编程语言中的 Object 形式表示的SQL值
      抛出:
      SQLException - 如果列索引无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • getRef

      Ref getRef(int columnIndex) throws SQLException
      以Java编程语言中的 Ref 对象形式检索此 ResultSet 对象的当前行中指定列的值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      表示SQL REF 值的 Ref 对象
      抛出:
      SQLException - 如果列索引无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • getBlob

      Blob getBlob(int columnIndex) throws SQLException
      以Java编程语言中的 Blob 对象形式检索此 ResultSet 对象的当前行中指定列的值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      表示指定列中的SQL BLOB 值的 Blob 对象
      抛出:
      SQLException - 如果列索引无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • getClob

      Clob getClob(int columnIndex) throws SQLException
      以Java编程语言中的 Clob 对象形式检索此 ResultSet 对象的当前行中指定列的值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      表示指定列中的SQL CLOB 值的 Clob 对象
      抛出:
      SQLException - 如果列索引无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • getArray

      Array getArray(int columnIndex) throws SQLException
      以Java编程语言中的 Array 对象形式检索此 ResultSet 对象的当前行中指定列的值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      表示指定列中的SQL ARRAY 值的 Array 对象
      抛出:
      SQLException - 如果列索引无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • getObject

      Object getObject(String columnLabel, Map<String,Class<?>> map) throws SQLException
      以Java编程语言中的 Object 形式检索此 ResultSet 对象的当前行中指定列的值。如果值为SQL NULL,则驱动程序返回Java null。如果适用,此方法使用指定的 Map 对象进行自定义映射。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      map - 一个包含从SQL类型名称到Java编程语言中的类的映射的java.util.Map对象
      返回:
      一个表示指定列中SQL值的Object
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • getRef

      Ref getRef(String columnLabel) throws SQLException
      以Java编程语言中的Ref对象的形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      一个表示指定列中SQL REF值的Ref对象
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • getBlob

      Blob getBlob(String columnLabel) throws SQLException
      以Java编程语言中的Blob对象的形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      一个表示指定列中SQL BLOB值的Blob对象
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • getClob

      Clob getClob(String columnLabel) throws SQLException
      以Java编程语言中的Clob对象的形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      一个表示指定列中SQL CLOB值的Clob对象
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • getArray

      Array getArray(String columnLabel) throws SQLException
      以Java编程语言中的Array对象的形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      一个表示指定列中SQL ARRAY值的Array对象
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.2
    • getDate

      Date getDate(int columnIndex, Calendar cal) throws SQLException
      以Java编程语言中的java.sql.Date对象的形式检索此ResultSet对象当前行中指定列的值。如果底层数据库不存储时区信息,则此方法使用给定的日历构造日期的适当毫秒值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      cal - 用于构造日期的java.util.Calendar对象
      返回:
      作为java.sql.Date对象的列值;如果值为SQL NULL,则在Java编程语言中返回的值为null
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      自版本:
      1.2
    • getDate

      Date getDate(String columnLabel, Calendar cal) throws SQLException
      以Java编程语言中的java.sql.Date对象的形式检索此ResultSet对象当前行中指定列的值。如果底层数据库不存储时区信息,则此方法使用给定的日历构造日期的适当毫秒值。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      cal - 用于构造日期的java.util.Calendar对象
      返回:
      作为java.sql.Date对象的列值;如果值为SQL NULL,则在Java编程语言中返回的值为null
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      自版本:
      1.2
    • getTime

      Time getTime(int columnIndex, Calendar cal) throws SQLException
      以Java编程语言中的java.sql.Time对象的形式检索此ResultSet对象当前行中指定列的值。如果底层数据库不存储时区信息,则此方法使用给定的日历构造时间的适当毫秒值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      cal - 用于构造时间的java.util.Calendar对象
      返回:
      作为java.sql.Time对象的列值;如果值为SQL NULL,则在Java编程语言中返回的值为null
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      自版本:
      1.2
    • getTime

      Time getTime(String columnLabel, Calendar cal) throws SQLException
      以Java编程语言中的java.sql.Time对象的形式检索此ResultSet对象当前行中指定列的值。如果底层数据库不存储时区信息,则此方法使用给定的日历构造时间的适当毫秒值。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      cal - 用于构造时间的java.util.Calendar对象
      返回:
      作为java.sql.Time对象的列值;如果值为SQL NULL,则在Java编程语言中返回的值为null
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      自版本:
      1.2
    • getTimestamp

      Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException
      以Java编程语言中的java.sql.Timestamp对象的形式检索此ResultSet对象当前行中指定列的值。如果底层数据库不存储时区信息,则此方法使用给定的日历构造时间戳的适当毫秒值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      cal - 用于构造时间戳的java.util.Calendar对象
      返回:
      作为java.sql.Timestamp对象的列值;如果值为SQL NULL,则在Java编程语言中返回的值为null
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      自版本:
      1.2
    • getTimestamp

      Timestamp getTimestamp(String columnLabel, Calendar cal) throws SQLException
      以Java编程语言中的java.sql.Timestamp对象的形式检索此ResultSet对象当前行中指定列的值。如果底层数据库不存储时区信息,则此方法使用给定的日历构造时间戳的适当毫秒值。
      参数:
      columnLabel - 使用SQL AS子句指定的列标签。如果未指定SQL AS子句,则标签为列的名称
      cal - 用于构造日期的java.util.Calendar对象
      返回:
      作为java.sql.Timestamp对象的列值;如果值为SQL NULL,则在Java编程语言中返回的值为null
      抛出:
      SQLException - 如果columnLabel无效或发生数据库访问错误或在关闭的结果集上调用此方法
      自版本:
      1.2
    • getURL

      URL getURL(int columnIndex) throws SQLException
      以Java编程语言中的java.net.URL对象的形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnIndex - 列的索引,1表示第一列,2表示第二列,...
      返回:
      作为java.net.URL对象的列值;如果值为SQL NULL,则在Java编程语言中返回的值为null
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;在关闭的结果集上调用此方法;或URL格式不正确
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.4
    • getURL

      URL getURL(String columnLabel) throws SQLException
      以Java编程语言中的java.net.URL对象的形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnLabel - 使用SQL AS子句指定的列标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      作为java.net.URL对象的列值;如果值为SQL NULL,则在Java编程语言中返回的值为null
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;在关闭的结果集上调用此方法;或URL格式不正确
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.4
    • updateRef

      void updateRef(int columnIndex, Ref x) throws SQLException
      使用java.sql.Ref值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY;或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.4
    • updateRef

      void updateRef(String columnLabel, Ref x) throws SQLException
      使用java.sql.Ref值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY;或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.4
    • updateBlob

      void updateBlob(int columnIndex, Blob x) throws SQLException
      使用java.sql.Blob值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY;或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.4
    • updateBlob

      void updateBlob(String columnLabel, Blob x) throws SQLException
      使用java.sql.Blob值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY;或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.4
    • updateClob

      void updateClob(int columnIndex, Clob x) throws SQLException
      使用java.sql.Clob值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY;或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.4
    • updateClob

      void updateClob(String columnLabel, Clob x) throws SQLException
      使用java.sql.Clob值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY;或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.4
    • updateArray

      void updateArray(int columnIndex, Array x) throws SQLException
      使用java.sql.Array值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY;或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.4
    • updateArray

      void updateArray(String columnLabel, Array x) throws SQLException
      使用java.sql.Array值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.4版本起:
      1.4
    • getRowId

      RowId getRowId(int columnIndex) throws SQLException
      以Java编程语言中的java.sql.RowId对象的形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      列值;如果值为SQL NULL,则返回值为null
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.6版本起:
      1.6
    • getRowId

      RowId getRowId(String columnLabel) throws SQLException
      以Java编程语言中的java.sql.RowId对象的形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      列值;如果值为SQL NULL,则返回值为null
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.6版本起:
      1.6
    • updateRowId

      void updateRowId(int columnIndex, RowId x) throws SQLException
      使用RowId值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 列值
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.6版本起:
      1.6
    • updateRowId

      void updateRowId(String columnLabel, RowId x) throws SQLException
      使用RowId值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.6版本起:
      1.6
    • getHoldability

      int getHoldability() throws SQLException
      检索此ResultSet对象的保持性
      返回:
      ResultSet.HOLD_CURSORS_OVER_COMMITResultSet.CLOSE_CURSORS_AT_COMMIT
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭的结果集上调用此方法
      自1.6版本起:
      1.6
    • isClosed

      boolean isClosed() throws SQLException
      检索此ResultSet对象是否已关闭。如果在其上调用了close方法,或者它被自动关闭,则ResultSet已关闭。
      返回:
      如果此ResultSet对象已关闭,则为true;如果仍然打开,则为false
      抛出:
      SQLException - 如果发生数据库访问错误
      自1.6版本起:
      1.6
    • updateNString

      void updateNString(int columnIndex, String nString) throws SQLException
      使用String值更新指定的列。用于更新NCHARNVARCHARLONGNVARCHAR列时使用。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      nString - 要更新的列的值
      抛出:
      SQLException - 如果columnIndex无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭的结果集上调用此方法;结果集并发性为CONCUR_READ_ONLY或如果发生数据库访问错误
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.6版本起:
      1.6
    • updateNString

      void updateNString(String columnLabel, String nString) throws SQLException
      使用String值更新指定的列。用于更新NCHARNVARCHARLONGNVARCHAR列时使用。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      nString - 要更新的列的值
      抛出:
      SQLException - 如果columnLabel无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭的结果集上调用此方法;结果集并发性为CONCUR_READ_ONLY或如果发生数据库访问错误
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.6版本起:
      1.6
    • updateNClob

      void updateNClob(int columnIndex, NClob nClob) throws SQLException
      使用java.sql.NClob值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      nClob - 要更新的列的值
      抛出:
      SQLException - 如果columnIndex无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.6版本起:
      1.6
    • updateNClob

      void updateNClob(String columnLabel, NClob nClob) throws SQLException
      使用java.sql.NClob值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      nClob - 要更新的列的值
      抛出:
      SQLException - 如果columnLabel无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自1.6版本起:
      1.6
    • getNClob

      NClob getNClob(int columnIndex) throws SQLException
      以Java编程语言中的NClob对象的形式检索此ResultSet对象当前行中指定列的值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      一个表示指定列中SQL NCLOB 值的 NClob 对象
      抛出:
      SQLException - 如果 columnIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭结果集上调用此方法或发生数据库访问错误时
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自从:
      1.6
    • getNClob

      NClob getNClob(String columnLabel) throws SQLException
      以Java编程语言中的 NClob 对象的形式检索此 ResultSet 对象当前行中指定列的值。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      一个表示指定列中SQL NCLOB 值的 NClob 对象
      抛出:
      SQLException - 如果 columnLabel 无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭结果集上调用此方法或发生数据库访问错误时
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自从:
      1.6
    • getSQLXML

      SQLXML getSQLXML(int columnIndex) throws SQLException
      以Java编程语言中的 java.sql.SQLXML 对象的形式检索此 ResultSet 对象当前行中指定列的值。
      参数:
      columnIndex - 第一列为1,第二列为2,...
      返回:
      一个映射到 SQL XML 值的 SQLXML 对象
      抛出:
      SQLException - 如果 columnIndex 无效;如果发生数据库访问错误或在关闭结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自从:
      1.6
    • getSQLXML

      SQLXML getSQLXML(String columnLabel) throws SQLException
      以Java编程语言中的 java.sql.SQLXML 对象的形式检索此 ResultSet 对象当前行中指定列的值。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      一个映射到 SQL XML 值的 SQLXML 对象
      抛出:
      SQLException - 如果 columnLabel 无效;如果发生数据库访问错误或在关闭结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自从:
      1.6
    • updateSQLXML

      void updateSQLXML(int columnIndex, SQLXML xmlObject) throws SQLException
      使用 java.sql.SQLXML 值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用 updateRowinsertRow 方法来更新数据库。
      参数:
      columnIndex - 第一列为1,第二为2,...
      xmlObject - 要更新的列的值
      抛出:
      SQLException - 如果 columnIndex 无效;如果发生数据库访问错误;在关闭结果集上调用此方法;java.xml.transform.ResultWriterOutputStream 未关闭 SQLXML 对象;如果处理XML值时出现错误或结果集并发性为 CONCUR_READ_ONLY。异常的 getCause 方法可能提供更详细的异常,例如,如果流不包含有效的XML。
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自从:
      1.6
    • updateSQLXML

      void updateSQLXML(String columnLabel, SQLXML xmlObject) throws SQLException
      使用 java.sql.SQLXML 值更新指定的列。更新程序方法用于更新当前行或插入行中的列值。更新程序方法不会更新底层数据库;而是调用 updateRowinsertRow 方法来更新数据库。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      xmlObject - 列值
      抛出:
      SQLException - 如果 columnLabel 无效;如果发生数据库访问错误;在关闭结果集上调用此方法;java.xml.transform.ResultWriterOutputStream 未关闭 SQLXML 对象;如果处理XML值时出现错误或结果集并发性为 CONCUR_READ_ONLY。异常的 getCause 方法可能提供更详细的异常,例如,如果流不包含有效的XML。
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自从:
      1.6
    • getNString

      String getNString(int columnIndex) throws SQLException
      以Java编程语言中的 String 对象的形式检索此 ResultSet 对象当前行中指定列的值。在访问 NCHARNVARCHARLONGNVARCHAR 列时使用。
      参数:
      columnIndex - 第一列为1,第二为2,...
      返回:
      列值;如果值为SQL NULL,则返回值为 null
      抛出:
      SQLException - 如果 columnIndex 无效;如果发生数据库访问错误或在关闭结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自从:
      1.6
    • getNString

      String getNString(String columnLabel) throws SQLException
      以Java编程语言中的 String 对象的形式检索此 ResultSet 对象当前行中指定列的值。在访问 NCHARNVARCHARLONGNVARCHAR 列时使用。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      列值;如果值为SQL NULL,则返回值为 null
      抛出:
      SQLException - 如果 columnLabel 无效;如果发生数据库访问错误或在关闭结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自从:
      1.6
    • getNCharacterStream

      Reader getNCharacterStream(int columnIndex) throws SQLException
      以Java编程语言中的 java.io.Reader 对象的形式检索此 ResultSet 对象当前行中指定列的值。在访问 NCHARNVARCHARLONGNVARCHAR 列时使用。
      参数:
      columnIndex - 第一列为1,第二为2,...
      返回:
      一个包含列值的 java.io.Reader 对象;如果值为SQL NULL,则返回值为 null 在Java编程语言中。
      抛出:
      SQLException - 如果 columnIndex 无效;如果发生数据库访问错误或在关闭结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自从:
      1.6
    • getNCharacterStream

      Reader getNCharacterStream(String columnLabel) throws SQLException
      以Java编程语言中的 java.io.Reader 对象的形式检索此 ResultSet 对象当前行中指定列的值。在访问 NCHARNVARCHARLONGNVARCHAR 列时使用。
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      返回:
      一个包含列值的 java.io.Reader 对象;如果值为SQL NULL,则返回值为 null 在Java编程语言中
      抛出:
      SQLException - 如果 columnLabel 无效;如果发生数据库访问错误或在关闭结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自从:
      1.6
    • updateNCharacterStream

      void updateNCharacterStream(int columnIndex, Reader x, long length) throws SQLException
      更新指定列的字符流值,该值将具有指定的字节数。驱动程序将从Java字符格式转换为数据库中的国家字符集。用于更新NCHARNVARCHARLONGNVARCHAR列时。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      length - 流的长度
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自:
      1.6
    • updateNCharacterStream

      void updateNCharacterStream(String columnLabel, Reader reader, long length) throws SQLException
      更新指定列的字符流值,该值将具有指定的字节数。驱动程序将从Java字符格式转换为数据库中的国家字符集。用于更新NCHARNVARCHARLONGNVARCHAR列时。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      reader - 包含新列值的java.io.Reader对象
      length - 流的长度
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自:
      1.6
    • updateAsciiStream

      void updateAsciiStream(int columnIndex, InputStream x, long length) throws SQLException
      更新指定列的ASCII流值,该值将具有指定的字节数。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      length - 流的长度
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自:
      1.6
    • updateBinaryStream

      void updateBinaryStream(int columnIndex, InputStream x, long length) throws SQLException
      更新指定列的二进制流值,该值将具有指定的字节数。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      length - 流的长度
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自:
      1.6
    • updateCharacterStream

      void updateCharacterStream(int columnIndex, Reader x, long length) throws SQLException
      更新指定列的字符流值,该值将具有指定的字节数。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      length - 流的长度
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自:
      1.6
    • updateAsciiStream

      void updateAsciiStream(String columnLabel, InputStream x, long length) throws SQLException
      更新指定列的ASCII流值,该值将具有指定的字节数。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      length - 流的长度
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自:
      1.6
    • updateBinaryStream

      void updateBinaryStream(String columnLabel, InputStream x, long length) throws SQLException
      更新指定列的二进制流值,该值将具有指定的字节数。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      length - 流的长度
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自:
      1.6
    • updateCharacterStream

      void updateCharacterStream(String columnLabel, Reader reader, long length) throws SQLException
      更新指定列的字符流值,该值将具有指定的字节数。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      reader - 包含新列值的java.io.Reader对象
      length - 流的长度
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自:
      1.6
    • updateBlob

      void updateBlob(int columnIndex, InputStream inputStream, long length) throws SQLException
      使用给定的输入流更新指定列,该值将具有指定的字节数。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      参数:
      columnIndex - 第一列为1,第二列为2,...
      inputStream - 包含要设置参数值的数据的对象。
      length - 参数数据中的字节数。
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自:
      1.6
    • updateBlob

      void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException
      更新指定的列,使用给定的输入流,该输入流将具有指定的字节数。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称。
      inputStream - 包含要设置参数值的数据的对象。
      length - 参数数据中的字节数。
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.6
    • updateClob

      void updateClob(int columnIndex, Reader reader, long length) throws SQLException
      使用给定的Reader对象更新指定的列,该对象的长度为给定的字符数。当将非常大的UNICODE值输入到LONGVARCHAR参数时,通过java.io.Reader对象发送可能更实用。JDBC驱动程序将从UNICODE转换为数据库字符格式。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      参数:
      columnIndex - 第一列为1,第二列为2,...
      reader - 包含要设置参数值的数据的对象。
      length - 参数数据中的字符数。
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.6
    • updateClob

      void updateClob(String columnLabel, Reader reader, long length) throws SQLException
      使用给定的Reader对象更新指定的列,该对象的长度为给定的字符数。当将非常大的UNICODE值输入到LONGVARCHAR参数时,通过java.io.Reader对象发送可能更实用。JDBC驱动程序将从UNICODE转换为数据库字符格式。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称。
      reader - 包含要设置参数值的数据的对象。
      length - 参数数据中的字符数。
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.6
    • updateNClob

      void updateNClob(int columnIndex, Reader reader, long length) throws SQLException
      使用给定的Reader对象更新指定的列,该对象的长度为给定的字符数。当将非常大的UNICODE值输入到LONGVARCHAR参数时,通过java.io.Reader对象发送可能更实用。JDBC驱动程序将从UNICODE转换为数据库字符格式。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      参数:
      columnIndex - 第一列为1,第二为2,...
      reader - 包含要设置参数值的数据的对象。
      length - 参数数据中的字符数。
      抛出:
      SQLException - 如果columnIndex无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭的结果集上调用此方法,如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.6
    • updateNClob

      void updateNClob(String columnLabel, Reader reader, long length) throws SQLException
      使用给定的Reader对象更新指定的列,该对象的长度为给定的字符数。当将非常大的UNICODE值输入到LONGVARCHAR参数时,通过java.io.Reader对象发送可能更实用。JDBC驱动程序将从UNICODE转换为数据库字符格式。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称。
      reader - 包含要设置参数值的数据的对象。
      length - 参数数据中的字符数。
      抛出:
      SQLException - 如果columnLabel无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.6
    • updateNCharacterStream

      void updateNCharacterStream(int columnIndex, Reader x) throws SQLException
      使用字符流值更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。驱动程序将从Java字符格式转换为数据库中的国家字符集。用于更新NCHARNVARCHARLONGNVARCHAR列时。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的updateNCharacterStream版本。

      参数:
      columnIndex - 第一列为1,第二为2,...
      x - 新的列值
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.6
    • updateNCharacterStream

      void updateNCharacterStream(String columnLabel, Reader reader) throws SQLException
      使用字符流值更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。驱动程序将从Java字符格式转换为数据库中的国家字符集。用于更新NCHARNVARCHARLONGNVARCHAR列时。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的updateNCharacterStream版本。

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称。
      reader - 包含新列值的java.io.Reader对象。
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.6
    • updateAsciiStream

      void updateAsciiStream(int columnIndex, InputStream x) throws SQLException
      使用ASCII流值更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的updateAsciiStream版本。

      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.6
    • updateBinaryStream

      void updateBinaryStream(int columnIndex, InputStream x) throws SQLException
      使用二进制流值更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的updateBinaryStream版本。

      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.6
    • updateCharacterStream

      void updateCharacterStream(int columnIndex, Reader x) throws SQLException
      使用字符流值更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的updateCharacterStream版本。

      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.6
    • updateAsciiStream

      void updateAsciiStream(String columnLabel, InputStream x) throws SQLException
      使用ASCII流值更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的updateAsciiStream版本。

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.6
    • updateBinaryStream

      void updateBinaryStream(String columnLabel, InputStream x) throws SQLException
      使用二进制流值更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的updateBinaryStream版本。

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.6
    • updateCharacterStream

      void updateCharacterStream(String columnLabel, Reader reader) throws SQLException
      使用字符流值更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的updateCharacterStream版本。

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      reader - 包含新列值的java.io.Reader对象
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.6
    • updateBlob

      void updateBlob(int columnIndex, InputStream inputStream) throws SQLException
      使用给定的输入流更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的updateBlob版本。

      参数:
      columnIndex - 第一列为1,第二列为2,...
      inputStream - 包含要设置参数值的数据的对象
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.6
    • updateBlob

      void updateBlob(String columnLabel, InputStream inputStream) throws SQLException
      使用给定的输入流更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的updateBlob版本。

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      inputStream - 包含要设置参数值的数据的对象
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.6
    • updateClob

      void updateClob(int columnIndex, Reader reader) throws SQLException
      使用给定的Reader对象更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。JDBC驱动程序将执行从UNICODE到数据库字符格式的任何必要转换。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的updateClob版本。

      参数:
      columnIndex - 第一列为1,第二列为2,...
      reader - 包含要设置参数值的数据的对象
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.6
    • updateClob

      void updateClob(String columnLabel, Reader reader) throws SQLException
      使用给定的Reader对象更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。JDBC驱动程序将执行从UNICODE到数据库字符格式的任何必要转换。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的updateClob版本。

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      reader - 包含要设置参数值的数据的对象
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.6
    • updateNClob

      void updateNClob(int columnIndex, Reader reader) throws SQLException
      使用给定的Reader对象更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。JDBC驱动程序将执行从UNICODE到数据库字符格式的任何必要转换。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的updateNClob版本。

      参数:
      columnIndex - 第一列为1,第二列为2,...
      reader - 包含要设置参数值的数据的对象
      抛出:
      SQLException - 如果columnIndex无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.6
    • updateNClob

      void updateNClob(String columnLabel, Reader reader) throws SQLException
      使用给定的Reader对象更新指定的列。数据将根据需要从流中读取,直到达到流的末尾。JDBC驱动程序将执行从UNICODE到数据库字符格式的任何必要转换。

      更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      注意: 请查阅您的JDBC驱动程序文档,以确定是否更有效地使用带有长度参数的updateNClob版本。

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      reader - 包含要设置参数值的数据的对象
      抛出:
      SQLException - 如果columnLabel无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;在关闭的结果集上调用此方法;如果发生数据库访问错误或结果集并发性为CONCUR_READ_ONLY
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.6
    • getObject

      <T> T getObject(int columnIndex, Class<T> type) throws SQLException

      检索此ResultSet对象当前行中指定列的值,并将其从列的SQL类型转换为请求的Java数据类型,如果支持转换。如果不支持转换或为类型指定了null,则会抛出SQLException

      至少,实现必须支持附录B,表B-3中定义的转换,以及适当用户定义的SQL类型到实现SQLDataStruct的Java类型的转换。其他转换可能会得到支持,并且是供应商定义的。

      类型参数:
      T - 由此Class对象建模的类的类型
      参数:
      columnIndex - 第一列为1,第二列为2,...
      type - 表示要将指定列转换为的Java数据类型的类
      返回:
      一个持有列值的type实例
      抛出:
      SQLException - 如果不支持转换,type为null或发生其他错误。异常的getCause()方法可能提供更详细的异常,例如,如果发生转换错误
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.7
    • getObject

      <T> T getObject(String columnLabel, Class<T> type) throws SQLException

      检索此ResultSet对象当前行中指定列的值,并将其从列的SQL类型转换为请求的Java数据类型,如果支持转换。如果不支持转换或为类型指定了null,则会抛出SQLException

      至少,实现必须支持附录B,表B-3中定义的转换,以及适当用户定义的SQL类型到实现SQLDataStruct的Java类型的转换。其他转换可能会得到支持,并且是供应商定义的。

      类型参数:
      T - 由此Class对象建模的类的类型
      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      type - 表示要将指定列转换为的Java数据类型的类
      返回:
      一个持有列值的type实例
      抛出:
      SQLException - 如果不支持转换,type为null或发生其他错误。异常的getCause()方法可能提供更详细的异常,例如,如果发生转换错误
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.7
    • updateObject

      default void updateObject(int columnIndex, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException
      使用Object值更新指定的列。更新方法用于更新当前行或插入行中的列值。更新方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      如果第二个参数是InputStream,则流必须包含由scaleOrLength指定的字节数。如果第二个参数是Reader,则读取器必须包含由scaleOrLength指定的字符数。如果这些条件不成立,当执行语句时,驱动程序将生成SQLException

      默认实现将抛出SQLFeatureNotSupportedException

      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      targetSqlType - 要发送到数据库的SQL类型
      scaleOrLength - 对于java.math.BigDecimal对象,这是小数点后的位数。对于Java对象类型InputStreamReader,这是流或读取器中的数据长度。对于所有其他类型,此值将被忽略。
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法;如果JDBC驱动程序不支持指定的targetSqlType
      自版本:
      1.8
      参见:
    • updateObject

      default void updateObject(String columnLabel, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException
      更新指定列的Object值。更新器方法用于更新当前行或插入行中的列值。更新器方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      如果第二个参数是一个InputStream,那么流必须包含由scaleOrLength指定的字节数。如果第二个参数是一个Reader,那么读取器必须包含由scaleOrLength指定的字符数。如果这些条件不成立,当执行语句时驱动程序将生成一个SQLException

      默认实现将抛出SQLFeatureNotSupportedException

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      targetSqlType - 要发送到数据库的SQL类型
      scaleOrLength - 对于java.math.BigDecimal对象,这是小数点后的位数。对于Java对象类型InputStreamReader,这是流或读取器中数据的长度。对于所有其他类型,此值将被忽略。
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法;如果JDBC驱动程序不支持指定的targetSqlType
      自从:
      1.8
      参见:
    • updateObject

      default void updateObject(int columnIndex, Object x, SQLType targetSqlType) throws SQLException
      更新指定列的Object值。更新器方法用于更新当前行或插入行中的列值。更新器方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      默认实现将抛出SQLFeatureNotSupportedException

      参数:
      columnIndex - 第一列为1,第二列为2,...
      x - 新的列值
      targetSqlType - 要发送到数据库的SQL类型
      抛出:
      SQLException - 如果columnIndex无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法;如果JDBC驱动程序不支持指定的targetSqlType
      自从:
      1.8
      参见:
    • updateObject

      default void updateObject(String columnLabel, Object x, SQLType targetSqlType) throws SQLException
      更新指定列的Object值。更新器方法用于更新当前行或插入行中的列值。更新器方法不会更新底层数据库;而是调用updateRowinsertRow方法来更新数据库。

      默认实现将抛出SQLFeatureNotSupportedException

      参数:
      columnLabel - 使用SQL AS子句指定的列的标签。如果未指定SQL AS子句,则标签为列的名称
      x - 新的列值
      targetSqlType - 要发送到数据库的SQL类型
      抛出:
      SQLException - 如果columnLabel无效;如果发生数据库访问错误;结果集并发性为CONCUR_READ_ONLY或在关闭的结果集上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法;如果JDBC驱动程序不支持指定的targetSqlType
      自从:
      1.8
      参见: