模块  java.sql
软件包  javax.sql

Interface RowSet

  • All Superinterfaces:
    AutoCloseableResultSetWrapper
    All Known Subinterfaces:
    CachedRowSetFilteredRowSetJdbcRowSetJoinRowSetSyncResolverWebRowSet

    public interface RowSet
    extends ResultSet
    为JavaBeans™组件模型添加JDBC API支持的接口。 可以在可视Bean开发环境中用作JavaBeans组件的行集可以在设计时创建和配置,并在运行时执行。

    RowSet接口提供了一组JavaBeans属性,这些属性允许将RowSet实例配置为连接到JDBC数据源并从数据源读取一些数据。 A组的设置方法( setIntsetBytessetString ,等)提供了一种方式来传递输入参数行集的命令属性。 此命令是行集从关系数据库获取数据时使用的SQL查询,通常就是这种情况。

    RowSet接口支持JavaBeans事件,允许RowSet集上发生事件时通知应用程序中的其他组件,例如其值的更改。

    RowSet接口的独特之处在于它旨在使用其余的JDBC API实现。 换句话说, RowSet实现是一个在JDBC驱动程序“顶部”执行的软件层。 任何人都可以提供RowSet接口的实现,包括希望提供RowSet实现作为其JDBC产品的一部分的JDBC驱动程序供应商。

    RowSet对象可以与数据源建立连接,并在整个生命周期内维护该连接,在这种情况下,它被称为连接的行集。 行集还可以与数据源建立连接,从中获取数据,然后关闭连接。 这样的行集称为断开连接的行集。 断开连接的行集可能会在断开连接时对其数据进行更改,然后将更改发送回原始数据源,但必须重新建立连接才能执行此操作。

    断开连接的行集可以具有ReaderRowSetReader对象)和与其关联的写入器( RowSetWriter对象)。 Reader可以以许多不同的方式实现,以用数据填充行集,包括从非关系数据源获取数据。 编写器还可以以许多不同的方式实现,以将对行集数据所做的更改传播回底层数据源。

    行集易于使用。 RowSet接口扩展了标准java.sql.ResultSet接口。 RowSetMetaData接口扩展了java.sql.ResultSetMetaData接口。 因此,熟悉JDBC API的开发人员必须学习使用行集的最少数量的新API。 此外,还可以轻松地使用与JDBC ResultSet对象一起使用的第三方软件工具来处理行集。

    从以下版本开始:
    1.4
    • 方法详细信息

      • getUrl

        String getUrl()
               throws SQLException
        如果它使用DriverManager而不是DataSource对象来建立连接,则检索此RowSet对象将用于创建连接的url属性。 默认值为null
        结果
        一个字符串网址
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        setUrl(java.lang.String)
      • setUrl

        void setUrl​(String url)
             throws SQLException
        设置RowSet对象在使用DriverManager创建连接时将使用的URL。 设置此属性是可选的。 如果使用URL,则必须先加载接受URL的JDBC驱动程序,然后才能使用行集连接到数据库。 在读取或写入数据时,行集将在内部使用URL来创建数据库连接。 URL或数据源名称用于创建连接,最近设置为非null值。
        参数
        url - 字符串值; 可能是null
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        getUrl()
      • setDataSourceName

        void setDataSourceName​(String name)
                        throws SQLException
        将此RowSet对象的数据源名称属性设置为给定的String

        数据源名称属性的值可用于查找已使用命名服务注册的DataSource对象。 检索后, DataSource对象可用于创建与其表示的数据源的连接。

        参数
        name - 此RowSet对象的数据源的逻辑名称; 可能是null
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        getDataSourceName()
      • getUsername

        String getUsername()
        检索用于为此RowSet对象创建数据库连接的用户名。 在调用方法execute之前,在运行时设置username属性。 它通常不是RowSet对象的序列化状态的一部分。
        结果
        用户名属性
        另请参见:
        setUsername(java.lang.String)
      • setUsername

        void setUsername​(String name)
                  throws SQLException
        将此 RowSet对象的username属性设置为给定的 String
        参数
        name - 用户名
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        getUsername()
      • getPassword

        String getPassword()
        检索用于创建数据库连接的密码。 在调用方法execute之前,在运行时设置password属性。 它通常不是RowSet对象的序列化状态的一部分。
        结果
        用于建立数据库连接的密码
        另请参见:
        setPassword(java.lang.String)
      • setPassword

        void setPassword​(String password)
                  throws SQLException
        将此 RowSet对象的数据库密码设置为给定的 String
        参数
        password - 密码字符串
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        getPassword()
      • getTransactionIsolation

        int getTransactionIsolation()
        检索为此 RowSet对象设置的事务隔离级别。
        结果
        事务隔离级别; 之一Connection.TRANSACTION_READ_UNCOMMITTEDConnection.TRANSACTION_READ_COMMITTEDConnection.TRANSACTION_REPEATABLE_READ ,或Connection.TRANSACTION_SERIALIZABLE
        另请参见:
        setTransactionIsolation(int)
      • setTransactionIsolation

        void setTransactionIsolation​(int level)
                              throws SQLException
        设置此 RowSet对象的事务隔离级别。
        参数
        level - 事务隔离级别; 之一Connection.TRANSACTION_READ_UNCOMMITTEDConnection.TRANSACTION_READ_COMMITTEDConnection.TRANSACTION_REPEATABLE_READ ,或Connection.TRANSACTION_SERIALIZABLE
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        getTransactionIsolation()
      • setTypeMap

        void setTypeMap​(Map<String,​<?>> map)
                 throws SQLException
        安装给定的java.util.Map对象的默认类型映射此RowSet对象。 除非提供另一个类型映射作为方法参数,否则将使用此类型映射。
        参数
        map - 一个 java.util.Map对象,包含SQL用户定义类型的名称以及要将其映射到的Java类
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        getTypeMap()
      • getCommand

        String getCommand()
        检索此RowSet对象的命令属性。 command属性包含一个命令字符串,该字符串必须是SQL查询,可以执行该命令字符串以使用数据填充行集。 默认值为null
        结果
        命令字符串; 可能是null
        另请参见:
        setCommand(java.lang.String)
      • setCommand

        void setCommand​(String cmd)
                 throws SQLException
        将此RowSet对象的命令属性设置为给定的SQL查询。 当行集从不支持命令的数据源(如电子表格)获取其数据时,此属性是可选的。
        参数
        cmd - 将用于获取此RowSet对象的数据的SQL查询; 可能是null
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        getCommand()
      • isReadOnly

        boolean isReadOnly()
        检索此RowSet对象是否为只读。 如果可以进行更新,则默认情况下,行集可以更新。

        尝试更新只读行集将导致抛出SQLException

        结果
        true如果此RowSet对象是只读的; false如果可以更新
        另请参见:
        setReadOnly(boolean)
      • setReadOnly

        void setReadOnly​(boolean value)
                  throws SQLException
        设置此 RowSet对象是否对给定的 boolean是只读的。
        参数
        value - true如果只读; false如果可以更新
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        isReadOnly()
      • getMaxFieldSize

        int getMaxFieldSize()
                     throws SQLException
        检索可能为某些列值返回的最大字节数。 此限制仅适用于BINARYVARBINARYLONGVARBINARYBINARYCHARVARCHARLONGVARCHARNCHARNVARCHAR列。 如果超出限制,则会以静默方式丢弃多余的数据。
        结果
        当前最大列大小限制; 零意味着没有限制
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        setMaxFieldSize(int)
      • setMaxFieldSize

        void setMaxFieldSize​(int max)
                      throws SQLException
        将可以为列值返回的最大字节数设置为给定的字节数。 此限制仅适用于BINARYVARBINARYLONGVARBINARYBINARYCHARVARCHARLONGVARCHARNCHARNVARCHAR列。 如果超出限制,则会以静默方式丢弃多余的数据。 为获得最大的可移植性,请使用大于256的值。
        参数
        max - 新的最大列大小限制(以字节为单位); 零意味着无限
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        getMaxFieldSize()
      • getMaxRows

        int getMaxRows()
                throws SQLException
        检索此RowSet对象可包含的最大行数。 如果超出限制,则会以静默方式删除多余的行。
        结果
        RowSet对象可包含的当前最大行数; 零意味着无限
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        setMaxRows(int)
      • setMaxRows

        void setMaxRows​(int max)
                 throws SQLException
        将此RowSet对象可包含的最大行数设置为指定的数字。 如果超出限制,则会以静默方式删除多余的行。
        参数
        max - 新的最大行数; 零意味着无限
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        getMaxRows()
      • getEscapeProcessing

        boolean getEscapeProcessing()
                             throws SQLException
        检索是否为此RowSet对象启用了转义处理。 如果启用了转义扫描(默认情况下),则在将SQL语句发送到数据库之前,驱动程序将执行转义替换。
        结果
        true如果启用了转义处理; false如果被禁用
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        setEscapeProcessing(boolean)
      • setEscapeProcessing

        void setEscapeProcessing​(boolean enable)
                          throws SQLException
        打开或关闭此RowSet对象的转义处理。 如果启用了转义扫描(默认设置),则在将SQL语句发送到数据库之前,驱动程序将执行转义替换。
        参数
        enable - true启用转义处理; false禁用它
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        getEscapeProcessing()
      • getQueryTimeout

        int getQueryTimeout()
                     throws SQLException
        检索驱动程序等待语句执行的最大秒数。 如果超出此限制,则抛出SQLException
        结果
        当前查询超时限制,以秒为单位; 零意味着无限
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        setQueryTimeout(int)
      • setQueryTimeout

        void setQueryTimeout​(int seconds)
                      throws SQLException
        将驱动程序等待语句执行的最长时间设置为给定的秒数。 如果超出此限制,则抛出SQLException
        参数
        seconds - 新的查询超时限制,以秒为单位; 零意味着没有限制
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        getQueryTimeout()
      • setType

        void setType​(int type)
              throws SQLException
        将此RowSet对象的类型设置为给定类型。 此方法用于更改行集的类型,默认情况下为只读且不可滚动。
        参数
        type -之一的 ResultSet常数指定类型: ResultSet.TYPE_FORWARD_ONLYResultSet.TYPE_SCROLL_INSENSITIVE ,或 ResultSet.TYPE_SCROLL_SENSITIVE
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        ResultSet.getType()
      • setConcurrency

        void setConcurrency​(int concurrency)
                     throws SQLException
        将此RowSet对象的并发设置为给定的并发级别。 此方法用于更改行集的并发级别,默认情况下为ResultSet.CONCUR_READ_ONLY
        参数
        concurrency - 指定并发级别的 ResultSet常量之一: ResultSet.CONCUR_READ_ONLYResultSet.CONCUR_UPDATABLE
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        ResultSet.getConcurrency()
      • setNull

        void setNull​(int parameterIndex,
                     int sqlType)
              throws SQLException
        将此RowSet对象的SQL命令中的指定参数设置为SQL NULL

        注意:您必须指定参数的SQL类型。

        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        sqlType - 由 java.sql.Types定义的SQL类型代码
        异常
        SQLException - 如果发生数据库访问错误
      • setNull

        void setNull​(String parameterName,
                     int sqlType)
              throws SQLException
        将指定参数设置为SQL NULL

        注意:您必须指定参数的SQL类型。

        参数
        parameterName - 参数的名称
        sqlType - java.sql.Types定义的SQL类型代码
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
      • setNull

        void setNull​(int paramIndex,
                     int sqlType,
                     String typeName)
              throws SQLException
        将此RowSet对象的SQL命令中的指定参数设置为SQL NULL 此版本的方法setNull应该用于SQL用户定义类型(UDT)和REF类型参数。 的UDT的实例包括: STRUCTDISTINCTJAVA_OBJECT ,和指定数组类型。

        注意:为了便于移植,应用程序必须在指定NULL UDT或REF参数时提供SQL类型代码和完全限定的SQL类型名称。 对于UDT,名称是参数本身的类型名称。 对于REF参数,名称是引用类型的类型名称。 如果JDBC驱动程序不需要类型代码或类型名称信息,则可能会忽略它。 虽然它适用于UDT和REF参数,但此方法可用于设置任何JDBC类型的null参数。 如果参数没有用户定义的类型或REF类型,则忽略typeName参数。

        参数
        paramIndex - 第一个参数是1,第二个参数是2,...
        sqlType - 来自 java.sql.Types的数值
        typeName - SQL UDT的完全限定名称或REF类型引用的SQL结构类型的类型名称; 如果参数不是UDT或REF类型,则忽略
        异常
        SQLException - 如果发生数据库访问错误
      • setNull

        void setNull​(String parameterName,
                     int sqlType,
                     String typeName)
              throws SQLException
        将指定参数设置为SQL NULL 此版本的方法setNull应该用于用户定义的类型和REF类型参数。 用户定义类型的示例包括:STRUCT,DISTINCT,JAVA_OBJECT和命名数组类型。

        注意:为了便于移植,应用程序必须在指定NULL用户定义或REF参数时提供SQL类型代码和完全限定的SQL类型名称。 在用户定义类型的情况下,名称是参数本身的类型名称。 对于REF参数,名称是引用类型的类型名称。 如果JDBC驱动程序不需要类型代码或类型名称信息,则可能会忽略它。 虽然它适用于用户定义和Ref参数,但此方法可用于设置任何JDBC类型的null参数。 如果参数没有用户定义或REF类型,则忽略给定的typeName。

        参数
        parameterName - 参数的名称
        sqlType - 数值范围为 java.sql.Types
        typeName - SQL用户定义类型的完全限定名称; 如果参数不是用户定义的类型或SQL REF值,则忽略该值
        异常
        SQLException - 如果发生数据库访问错误或在关闭时调用此方法 CallableStatement
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
      • setBoolean

        void setBoolean​(int parameterIndex,
                        boolean x)
                 throws SQLException
        将此RowSet对象命令中的指定参数设置为给定的Java boolean值。 在将数据发送到数据库之前,驱动程序将其转换为SQL BIT值。
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误
      • setBoolean

        void setBoolean​(String parameterName,
                        boolean x)
                 throws SQLException
        将指定参数设置为给定的Java boolean值。 驱动程序在将其发送到数据库时将其转换为SQL BITBOOLEAN值。
        参数
        parameterName - 参数的名称
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误或在关闭时调用此方法 CallableStatement
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
        另请参见:
        ResultSet.getBoolean(int)
      • setByte

        void setByte​(int parameterIndex,
                     byte x)
              throws SQLException
        将此RowSet对象命令中的指定参数设置为给定的Java byte值。 在将其发送到数据库之前,驱动程序将其转换为SQL TINYINT值。
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误
      • setByte

        void setByte​(String parameterName,
                     byte x)
              throws SQLException
        将指定参数设置为给定的Java byte值。 驱动程序在将其发送到数据库时将其转换为SQL TINYINT值。
        参数
        parameterName - 参数的名称
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
        另请参见:
        ResultSet.getByte(int)
      • setShort

        void setShort​(int parameterIndex,
                      short x)
               throws SQLException
        将此RowSet对象命令中的指定参数设置为给定的Java short值。 在将其发送到数据库之前,驱动程序将其转换为SQL SMALLINT值。
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误
      • setShort

        void setShort​(String parameterName,
                      short x)
               throws SQLException
        将指定参数设置为给定的Java short值。 驱动程序在将其发送到数据库时将其转换为SQL SMALLINT值。
        参数
        parameterName - 参数的名称
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
        另请参见:
        ResultSet.getShort(int)
      • setInt

        void setInt​(int parameterIndex,
                    int x)
             throws SQLException
        将此RowSet对象命令中的指定参数设置为给定的Java int值。 在将其发送到数据库之前,驱动程序将其转换为SQL INTEGER值。
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误
      • setInt

        void setInt​(String parameterName,
                    int x)
             throws SQLException
        将指定参数设置为给定的Java int值。 驱动程序在将其发送到数据库时将其转换为SQL INTEGER值。
        参数
        parameterName - 参数的名称
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误或在关闭时调用此方法 CallableStatement
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
        另请参见:
        ResultSet.getInt(int)
      • setLong

        void setLong​(int parameterIndex,
                     long x)
              throws SQLException
        将此RowSet对象命令中的指定参数设置为给定的Java long值。 在将其发送到数据库之前,驱动程序将其转换为SQL BIGINT值。
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误
      • setLong

        void setLong​(String parameterName,
                     long x)
              throws SQLException
        将指定参数设置为给定的Java long值。 驱动程序在将其发送到数据库时将其转换为SQL BIGINT值。
        参数
        parameterName - 参数的名称
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
        另请参见:
        ResultSet.getLong(int)
      • setFloat

        void setFloat​(int parameterIndex,
                      float x)
               throws SQLException
        将此RowSet对象命令中的指定参数设置为给定的Java float值。 在将其发送到数据库之前,驱动程序将其转换为SQL REAL值。
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误
      • setFloat

        void setFloat​(String parameterName,
                      float x)
               throws SQLException
        将指定参数设置为给定的Java float值。 驱动程序将其发送到数据库时将其转换为SQL FLOAT值。
        参数
        parameterName - 参数的名称
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误或在关闭时调用此方法 CallableStatement
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
        另请参见:
        ResultSet.getFloat(int)
      • setDouble

        void setDouble​(int parameterIndex,
                       double x)
                throws SQLException
        将此RowSet对象命令中的指定参数设置为给定的Java double值。 在将其发送到数据库之前,驱动程序将其转换为SQL DOUBLE值。
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误
      • setDouble

        void setDouble​(String parameterName,
                       double x)
                throws SQLException
        将指定参数设置为给定的Java double值。 驱动程序在将其发送到数据库时将其转换为SQL DOUBLE值。
        参数
        parameterName - 参数的名称
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
        另请参见:
        ResultSet.getDouble(int)
      • setBigDecimal

        void setBigDecimal​(int parameterIndex,
                           BigDecimal x)
                    throws SQLException
        将此RowSet对象命令中的指定参数设置为给定的java.math.BigDecimal值。 在将其发送到数据库之前,驱动程序将其转换为SQL NUMERIC值。
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误
      • setBigDecimal

        void setBigDecimal​(String parameterName,
                           BigDecimal x)
                    throws SQLException
        将指定参数设置为给定的java.math.BigDecimal值。 驱动程序在将其发送到数据库时将其转换为SQL NUMERIC值。
        参数
        parameterName - 参数的名称
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误或在关闭时调用此方法 CallableStatement
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
        另请参见:
        ResultSet.getBigDecimal(int, int)
      • setString

        void setString​(int parameterIndex,
                       String x)
                throws SQLException
        将此RowSet对象命令中的指定参数设置为给定的Java String值。 在将其发送到数据库之前,驱动程序将其转换为SQL VARCHARLONGVARCHAR值,具体取决于参数的大小相对于VARCHAR值的驱动程序限制。
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误
      • setString

        void setString​(String parameterName,
                       String x)
                throws SQLException
        将指定参数设置为给定的Java String值。 将驱动程序发送到数据库时,驱动程序将其转换为SQL VARCHARLONGVARCHAR值(取决于参数的大小相对于驱动程序对VARCHAR值的限制)。
        参数
        parameterName - 参数的名称
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
        另请参见:
        ResultSet.getString(int)
      • setBytes

        void setBytes​(int parameterIndex,
                      byte[] x)
               throws SQLException
        将此RowSet对象命令中的指定参数设置为给定的byte值的Java数组。 在将其发送到数据库之前,驱动程序将其转换为SQL VARBINARYLONGVARBINARY值,具体取决于参数的大小相对于驱动程序对VARBINARY值的限制。
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误
      • setBytes

        void setBytes​(String parameterName,
                      byte[] x)
               throws SQLException
        将指定参数设置为给定的Java字节数组。 当驱动程序将其发送到数据库时,驱动程序将其转换为SQL VARBINARYLONGVARBINARY (取决于参数的大小相对于驱动程序对VARBINARY值的限制)。
        参数
        parameterName - 参数的名称
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误或在关闭时调用此方法 CallableStatement
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
        另请参见:
        ResultSet.getBytes(int)
      • setDate

        void setDate​(int parameterIndex,
                     Date x)
              throws SQLException
        将此RowSet对象命令中的指定参数设置为给定的java.sql.Date值。 在将值发送到数据库之前,驱动程序将其转换为SQL DATE值,使用默认值java.util.Calendar计算日期。
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误
      • setTime

        void setTime​(int parameterIndex,
                     Time x)
              throws SQLException
        将此RowSet对象命令中的指定参数设置为给定的java.sql.Time值。 驱动程序在将其发送到数据库之前将其转换为SQL TIME值,使用默认值java.util.Calendar进行计算。
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误
      • setTimestamp

        void setTimestamp​(int parameterIndex,
                          Timestamp x)
                   throws SQLException
        将此RowSet对象命令中的指定参数设置为给定的java.sql.Timestamp值。 驱动程序在将其发送到数据库之前将其转换为SQL TIMESTAMP值,使用默认值java.util.Calendar进行计算。
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误
      • setTimestamp

        void setTimestamp​(String parameterName,
                          Timestamp x)
                   throws SQLException
        将指定参数设置为给定的java.sql.Timestamp值。 驱动程序将其发送到数据库时将其转换为SQL TIMESTAMP值。
        参数
        parameterName - 参数的名称
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误或在关闭时调用此方法 CallableStatement
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
        另请参见:
        ResultSet.getTimestamp(int)
      • setAsciiStream

        void setAsciiStream​(int parameterIndex,
                            InputStream x,
                            int length)
                     throws SQLException
        将此RowSet对象命令中的指定参数设置为给定的java.io.InputStream值。 通过java.io.InputStream而不是LONGVARCHAR参数发送非常大的ASCII值可能更实际。 驱动程序将根据需要从流中读取数据,直到它到达文件结尾。

        注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。

        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 包含ASCII参数值的Java输入流
        length - 流中的字节数
        异常
        SQLException - 如果发生数据库访问错误
      • setAsciiStream

        void setAsciiStream​(String parameterName,
                            InputStream x,
                            int length)
                     throws SQLException
        将指定参数设置为给定输入流,该输入流将具有指定的字节数。 当一个非常大的ASCII值输入到LONGVARCHAR参数时,通过java.io.InputStream发送它可能更实际。 将根据需要从流中读取数据,直到达到文件结尾。 JDBC驱动程序将执行从ASCII到数据库char格式的任何必要转换。

        注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。

        参数
        parameterName - 参数的名称
        x - 包含ASCII参数值的Java输入流
        length - 流中的字节数
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
      • setBinaryStream

        void setBinaryStream​(int parameterIndex,
                             InputStream x,
                             int length)
                      throws SQLException
        将此RowSet对象命令中的指定参数设置为给定的java.io.InputStream值。 通过java.io.InputStream而不是LONGVARBINARY参数发送非常大的二进制值可能更实际。 驱动程序将根据需要从流中读取数据,直到它到达文件结尾。

        注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。

        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 包含二进制参数值的java输入流
        length - 流中的字节数
        异常
        SQLException - 如果发生数据库访问错误
      • setBinaryStream

        void setBinaryStream​(String parameterName,
                             InputStream x,
                             int length)
                      throws SQLException
        将指定参数设置为给定输入流,该输入流将具有指定的字节数。 当一个非常大的二进制值输入到LONGVARBINARY参数时,通过java.io.InputStream对象发送它可能更实际。 将根据需要从流中读取数据,直到达到文件结尾。

        注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。

        参数
        parameterName - 参数的名称
        x - 包含二进制参数值的java输入流
        length - 流中的字节数
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
      • setCharacterStream

        void setCharacterStream​(int parameterIndex,
                                Reader reader,
                                int length)
                         throws SQLException
        将此RowSet对象命令中的指定参数设置为给定的java.io.Reader值。 通过java.io.Reader而不是LONGVARCHAR参数发送非常大的UNICODE值可能更实际。 驱动程序将根据需要从流中读取数据,直到它到达文件结尾。

        注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。

        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        reader - 包含要设置的UNICODE数据的 Reader对象
        length - 流中的字符数
        异常
        SQLException - 如果发生数据库访问错误
      • setCharacterStream

        void setCharacterStream​(String parameterName,
                                Reader reader,
                                int length)
                         throws SQLException
        将指定参数设置为给定的Reader对象,该对象是给定的字符长度。 当一个非常大的UNICODE值输入到LONGVARCHAR参数时,通过java.io.Reader对象发送它可能更实际。 将根据需要从流中读取数据,直到达到文件结尾。 JDBC驱动程序将执行从UNICODE到数据库char格式的任何必要转换。

        注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。

        参数
        parameterName - 参数的名称
        reader - 包含用作指定参数的UNICODE数据的 java.io.Reader对象
        length - 流中的字符数
        异常
        SQLException - 如果发生数据库访问错误或在关闭时调用此方法 CallableStatement
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
      • setAsciiStream

        void setAsciiStream​(int parameterIndex,
                            InputStream x)
                     throws SQLException
        将此RowSet对象命令中的指定参数设置为给定输入流。 当一个非常大的ASCII值输入到LONGVARCHAR参数时,通过java.io.InputStream发送它可能更实用。 将根据需要从流中读取数据,直到达到文件结尾。 JDBC驱动程序将执行从ASCII到数据库char格式的任何必要转换。

        注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。

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

        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 包含ASCII参数值的Java输入流
        异常
        SQLException - 如果发生数据库访问错误或在关闭时调用此方法 PreparedStatement
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setAsciiStream

        void setAsciiStream​(String parameterName,
                            InputStream x)
                     throws SQLException
        将指定参数设置为给定输入流。 当一个非常大的ASCII值输入到LONGVARCHAR参数时,通过java.io.InputStream发送它可能更实用。 将根据需要从流中读取数据,直到达到文件结尾。 JDBC驱动程序将执行从ASCII到数据库char格式的任何必要转换。

        注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。

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

        参数
        parameterName - 参数的名称
        x - 包含ASCII参数值的Java输入流
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setBinaryStream

        void setBinaryStream​(int parameterIndex,
                             InputStream x)
                      throws SQLException
        将此RowSet对象命令中的指定参数设置为给定输入流。 当一个非常大的二进制值输入到LONGVARBINARY参数时,通过java.io.InputStream对象发送它可能更实际。 将根据需要从流中读取数据,直到达到文件结尾。

        注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。

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

        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 包含二进制参数值的java输入流
        异常
        SQLException - 如果发生数据库访问错误或在关闭时调用此方法 PreparedStatement
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setBinaryStream

        void setBinaryStream​(String parameterName,
                             InputStream x)
                      throws SQLException
        将指定参数设置为给定输入流。 当一个非常大的二进制值输入到LONGVARBINARY参数时,通过java.io.InputStream对象发送它可能更实际。 将根据需要从流中读取数据,直到达到文件结尾。

        注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。

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

        参数
        parameterName - 参数的名称
        x - 包含二进制参数值的java输入流
        异常
        SQLException - 如果发生数据库访问错误或在关闭时调用此方法 CallableStatement
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setCharacterStream

        void setCharacterStream​(int parameterIndex,
                                Reader reader)
                         throws SQLException
        将此RowSet对象命令中的指定参数设置为给定的Reader对象。 当一个非常大的UNICODE值输入到LONGVARCHAR参数时,通过java.io.Reader对象发送它可能更实际。 将根据需要从流中读取数据,直到达到文件结尾。 JDBC驱动程序将执行从UNICODE到数据库char格式的任何必要转换。

        注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。

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

        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        reader - 包含Unicode数据的 java.io.Reader对象
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 PreparedStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setCharacterStream

        void setCharacterStream​(String parameterName,
                                Reader reader)
                         throws SQLException
        将指定参数设置为给定的Reader对象。 当一个非常大的UNICODE值输入到LONGVARCHAR参数时,通过java.io.Reader对象发送它可能更实用。 将根据需要从流中读取数据,直到达到文件结尾。 JDBC驱动程序将执行从UNICODE到数据库char格式的任何必要转换。

        注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。

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

        参数
        parameterName - 参数的名称
        reader - 包含Unicode数据的 java.io.Reader对象
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setNCharacterStream

        void setNCharacterStream​(int parameterIndex,
                                 Reader value)
                          throws SQLException
        将此RowSet对象命令中的指定参数设置为Reader对象。 Reader读取数据,直到达到文件结尾。 驱动程序执行从Java字符格式到数据库中的国家字符集的必要转换。

        注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。

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

        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        value - 参数值
        异常
        SQLException - 如果驾驶员不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误; 或者在关闭的PreparedStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setObject

        void setObject​(int parameterIndex,
                       Object x,
                       int targetSqlType,
                       int scaleOrLength)
                throws SQLException
        使用给定的Java Object设置此RowSet对象命令中的指定参数。 对于整数值,应使用java.lang等效对象(例如,对于int ,类Integerint )。 如果第二个参数是InputStream则流必须包含scaleOrLength指定的字节数。 如果第二个参数是ReaderReader必须包含scaleOrLength指定的字符数。 如果这些条件不成立,则在执行SQLException准备语句时,驱动程序将生成SQLException

        在发送到数据库之前,给定的Java对象将转换为targetSqlType。

        如果对象是实现SQLData的类,则行集应调用方法SQLData.writeSQL将对象写入SQLOutput数据流。 如果,在另一方面,对象是实现一类的RefBlobClobNClobStructjava.net.URL ,或Array ,驾驶员应把它传递给数据库作为相应SQL类型的值。

        请注意,此方法可用于传递特定于数据库的抽象数据类型。

        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 包含输入参数值的对象
        targetSqlType - 要发送到数据库的SQL类型(在java.sql.Types定义)。 scale参数可以进一步限定此类型。
        scaleOrLength - 对于java.sql.Types.DECIMALjava.sql.Types.NUMERIC types ,这是小数点后的位数。 对于Java对象类型InputStreamReader ,这是流中的数据长度或Reader 对于所有其他类型,将忽略此值。
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        Types
      • setObject

        void setObject​(String parameterName,
                       Object x,
                       int targetSqlType,
                       int scale)
                throws SQLException
        使用给定对象设置指定参数的值。 第二个参数必须是对象类型; 对于积分值,应使用java.lang等效对象。

        在发送到数据库之前,给定的Java对象将转换为给定的targetSqlType。 如果对象具有自定义映射(是实现接口SQLData的类),则JDBC驱动程序应调用方法SQLData.writeSQL将其写入SQL数据流。 如果,在另一方面,对象是实现一类的RefBlobClobNClobStructjava.net.URL ,或Array ,驾驶员应把它传递给数据库作为相应SQL类型的值。

        请注意,此方法可用于传递特定于数据库的抽象数据类型。

        参数
        parameterName - 参数的名称
        x - 包含输入参数值的对象
        targetSqlType - 要发送到数据库的SQL类型(在java.sql.Types中定义)。 scale参数可以进一步限定此类型。
        scale - 对于java.sql.Types.DECIMAL或java.sql.Types.NUMERIC类型,这是小数点后的位数。 对于所有其他类型,将忽略此值。
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement上调用此方法
        SQLFeatureNotSupportedException -如果 targetSqlTypeARRAYBLOBCLOBDATALINKJAVA_OBJECTNCHARNCLOBNVARCHARLONGNVARCHARREFROWIDSQLXMLSTRUCT数据类型和JDBC驱动程序不支持此数据类型
        从以下版本开始:
        1.4
        另请参见:
        TypesResultSet.getObject(int)
      • setObject

        void setObject​(int parameterIndex,
                       Object x,
                       int targetSqlType)
                throws SQLException
        使用Java Object在此RowSet对象的命令中设置指定参数。 对于积分值,应使用java.lang等效对象。 此方法与上面的setObject类似,但使用的比例是第二个参数的比例。 标量值的标度为零。 文字值在文字中具有比例。

        即使支持它,也不建议使用浮点输入值调用此方法。

        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 包含输入参数值的对象
        targetSqlType - 要发送到数据库的SQL类型(在 java.sql.Types定义)
        异常
        SQLException - 如果发生数据库访问错误
      • setObject

        void setObject​(String parameterName,
                       Object x,
                       int targetSqlType)
                throws SQLException
        使用给定对象设置指定参数的值。 该方法类似于上面的方法setObject ,不同之处在于它假定比例为零。
        参数
        parameterName - 参数的名称
        x - 包含输入参数值的对象
        targetSqlType - 要发送到数据库的SQL类型(在java.sql.Types中定义)
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement上调用此方法
        SQLFeatureNotSupportedException -如果 targetSqlTypeARRAYBLOBCLOBDATALINKJAVA_OBJECTNCHARNCLOBNVARCHARLONGNVARCHARREFROWIDSQLXMLSTRUCT数据类型和JDBC驱动程序不支持此数据类型
        从以下版本开始:
        1.4
        另请参见:
        ResultSet.getObject(int)
      • setObject

        void setObject​(String parameterName,
                       Object x)
                throws SQLException
        使用给定对象设置指定参数的值。 第二个参数必须是Object ; 因此, java.lang等效对象应该用于内置类型。

        JDBC规范指定了从Java Object类型到SQL类型的标准映射。 在发送到数据库之前,给定的参数将转换为相应的SQL类型。

        请注意,此方法可用于通过使用特定于驱动程序的Java类型来传递特定于数据库的抽象数据类型。 如果对象是实现接口SQLData的类,则JDBC驱动程序应调用方法SQLData.writeSQL将其写入SQL数据流。 如果,在另一方面,对象是实现一类的RefBlobClobNClobStructjava.net.URL ,或Array ,驾驶员应把它传递给数据库作为相应SQL类型的值。

        如果存在歧义,则此方法抛出异常,例如,如果对象是实现多个上述接口的类的类。

        参数
        parameterName - 参数的名称
        x - 包含输入参数值的对象
        异常
        SQLException - 如果发生数据库访问错误,则在关闭的 CallableStatement上调用此方法,或者如果给定的 Object参数不明确
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
        另请参见:
        ResultSet.getObject(int)
      • setObject

        void setObject​(int parameterIndex,
                       Object x)
                throws SQLException
        使用Java Object在此RowSet对象的命令中设置指定的参数。 对于整数值,应使用java.lang等效对象。

        JDBC规范提供了从Java对象类型到SQL类型的标准映射。 在将给定Java对象发送到数据库之前,驱动程序会将其转换为标准SQL映射。

        请注意,此方法可用于通过使用特定于驱动程序的Java类型传递特定于数据库的抽象数据类型。 如果对象是实现SQLData的类,则行集应调用方法SQLData.writeSQL将对象写入SQLOutput数据流。 如果,在另一方面,对象是实现一类的RefBlobClobNClobStructjava.net.URL ,或Array ,驾驶员应把它传递给数据库作为相应SQL类型的值。

        如果存在歧义,则抛出异常,例如,如果对象是实现多个这些接口的类。

        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 包含输入参数值的对象
        异常
        SQLException - 如果发生数据库访问错误
      • setRef

        void setRef​(int i,
                    Ref x)
             throws SQLException
        使用给定的Ref值设置此RowSet对象命令中的指定参数。 驱动程序会将其转换为适当的REF(<structured-type>)值。
        参数
        i - 第一个参数是1,第二个参数是2,...
        x - 表示SQL REF类型数据的对象
        异常
        SQLException - 如果发生数据库访问错误
      • setBlob

        void setBlob​(int i,
                     Blob x)
              throws SQLException
        使用给定的Blob值设置此RowSet对象命令中的指定参数。 在将数据发送到数据库之前,驱动程序会将其转换为Blob对象所代表的BLOB值。
        参数
        i - 第一个参数是1,第二个参数是2,...
        x - 表示BLOB的对象
        异常
        SQLException - 如果发生数据库访问错误
      • setBlob

        void setBlob​(int parameterIndex,
                     InputStream inputStream,
                     long length)
              throws SQLException
        将指定参数设置为InputStream对象。 InputStream必须包含由length指定的字符数,否则在执行SQLException将生成PreparedStatement 此方法与setBinaryStream (int, InputStream, int)方法不同,因为它通知驱动程序参数值应作为BLOB发送到服务器。 使用setBinaryStream方法时,驱动程序可能需要做额外的工作来确定是否应将参数数据作为LONGVARBINARYBLOB发送到服务器
        参数
        parameterIndex - 第一个参数的索引是1,第二个参数是2,...
        inputStream - 包含要将参数值设置为的数据的对象。
        length - 参数数据中的字节数。
        异常
        SQLException -如果发生数据库访问错误,该方法被称为在关闭的 PreparedStatement ,如果parameterIndex不对应于在SQL语句中的参数标记,如果指定的长度小于零,或者如果字节在数目 InputStream确实不符合指定的长度。
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setBlob

        void setBlob​(int parameterIndex,
                     InputStream inputStream)
              throws SQLException
        将指定参数设置为InputStream对象。 此方法与setBinaryStream (int, InputStream)方法不同,因为它通知驱动程序参数值应作为BLOB发送到服务器。 使用setBinaryStream方法时,驱动程序可能需要做额外的工作来确定参数数据是否应作为LONGVARBINARYBLOB发送到服务器

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

        参数
        parameterIndex - 第一个参数的索引是1,第二个参数是2,...
        inputStream - 包含要将参数值设置为的数据的对象。
        异常
        SQLException - 如果发生数据库访问错误,则在关闭的 PreparedStatement上调用此方法,或者如果parameterIndex与SQL语句中的参数标记不对应,
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setBlob

        void setBlob​(String parameterName,
                     InputStream inputStream,
                     long length)
              throws SQLException
        将指定参数设置为InputStream对象。 InputStream必须包含由length指定的字符数,否则在执行SQLException将生成CallableStatement 此方法与setBinaryStream (int, InputStream, int)方法不同,因为它通知驱动程序参数值应作为BLOB发送到服务器。 使用setBinaryStream方法时,驱动程序可能必须执行额外的工作以确定是否应将参数数据作为LONGVARBINARYBLOB发送到服务器
        参数
        parameterName - 要设置的参数名称第二个是2,...
        inputStream - 包含要将参数值设置为的数据的对象。
        length - 参数数据中的字节数。
        异常
        SQLException - 如果parameterIndex与SQL语句中的参数标记不对应,或者指定的长度小于零; 如果InputStream中的字节数与指定的长度不匹配; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setBlob

        void setBlob​(String parameterName,
                     Blob x)
              throws SQLException
        将指定参数设置为给定的java.sql.Blob对象。 驱动程序将其发送到数据库时将其转换为SQL BLOB值。
        参数
        parameterName - 参数的名称
        x - 一个映射SQL BLOB值的 Blob对象
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setBlob

        void setBlob​(String parameterName,
                     InputStream inputStream)
              throws SQLException
        将指定参数设置为InputStream对象。 此方法与setBinaryStream (int, InputStream)方法不同,因为它通知驱动程序参数值应作为BLOB发送到服务器。 使用setBinaryStream方法时,驱动程序可能需要做额外的工作来确定参数数据是否应作为LONGVARBINARYBLOB发送到服务器

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

        参数
        parameterName - 参数的名称
        inputStream - 包含要将参数值设置为的数据的对象。
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setClob

        void setClob​(int i,
                     Clob x)
              throws SQLException
        使用给定的Clob值设置此RowSet对象命令中的指定参数。 在将Clob对象发送到数据库之前,驱动程序将其转换为CLOB值。
        参数
        i - 第一个参数是1,第二个参数是2,...
        x - 表示CLOB的对象
        异常
        SQLException - 如果发生数据库访问错误
      • setClob

        void setClob​(int parameterIndex,
                     Reader reader,
                     long length)
              throws SQLException
        将指定参数设置为Reader对象。 Reader必须包含由length指定的字符数,否则在执行SQLException将生成PreparedStatement 此方法与setCharacterStream (int, Reader, int)方法不同,因为它通知驱动程序参数值应作为CLOB发送到服务器。 使用setCharacterStream方法时,驱动程序可能需要做额外的工作来确定参数数据是否应作为LONGVARCHARCLOB发送到服务器
        参数
        parameterIndex - 第一个参数的索引是1,第二个参数是2,...
        reader - 包含要将参数值设置为的数据的对象。
        length - 参数数据中的字符数。
        异常
        SQLException - 如果发生数据库访问错误,则在关闭的 PreparedStatement上调用此方法,如果parameterIndex与SQL语句中的参数标记不对应,或者指定的长度小于零。
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setClob

        void setClob​(int parameterIndex,
                     Reader reader)
              throws SQLException
        将指定参数设置为Reader对象。 此方法与setCharacterStream (int, Reader)方法不同,因为它通知驱动程序参数值应作为CLOB发送到服务器。 使用setCharacterStream方法时,驱动程序可能需要做额外的工作来确定参数数据是否应作为LONGVARCHARCLOB发送到服务器

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

        参数
        parameterIndex - 第一个参数的索引是1,第二个参数是2,...
        reader - 包含要将参数值设置为的数据的对象。
        异常
        SQLException - 如果发生数据库访问错误,则在关闭的 PreparedStatement上调用此方法,或者如果parameterIndex与SQL语句中的参数标记不对应
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setClob

        void setClob​(String parameterName,
                     Reader reader,
                     long length)
              throws SQLException
        将指定参数设置为Reader对象。 Reader必须包含由length指定的字符数,否则在执行SQLException将生成CallableStatement 此方法与setCharacterStream (int, Reader, int)方法不同,因为它通知驱动程序参数值应作为CLOB发送到服务器。 使用setCharacterStream方法时,驱动程序可能需要做额外的工作来确定参数数据是否应作为LONGVARCHARCLOB发送到服务器
        参数
        parameterName - 要设置的参数的名称
        reader - 包含要将参数值设置为的数据的对象。
        length - 参数数据中的字符数。
        异常
        SQLException - 如果parameterIndex与SQL语句中的参数标记不对应; 如果指定的长度小于零; 发生数据库访问错误或在关闭的CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setClob

        void setClob​(String parameterName,
                     Clob x)
              throws SQLException
        将指定参数设置为给定的java.sql.Clob对象。 驱动程序在将其发送到数据库时将其转换为SQL CLOB值。
        参数
        parameterName - 参数的名称
        x - 映射SQL CLOB值的 Clob对象
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setClob

        void setClob​(String parameterName,
                     Reader reader)
              throws SQLException
        将指定参数设置为Reader对象。 此方法与setCharacterStream (int, Reader)方法不同,因为它通知驱动程序参数值应作为CLOB发送到服务器。 使用setCharacterStream方法时,驱动程序可能需要做额外的工作来确定参数数据是否应作为LONGVARCHARCLOB发送到服务器

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

        参数
        parameterName - 参数的名称
        reader - 包含要将参数值设置为的数据的对象。
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setArray

        void setArray​(int i,
                      Array x)
               throws SQLException
        使用给定的Array值设置此RowSet对象命令中的指定参数。 驱动程序将此转换为ARRAY的价值Array对象将它发送到数据库之前代表。
        参数
        i - 第一个参数是1,第二个参数是2,...
        x - 表示SQL数组的对象
        异常
        SQLException - 如果发生数据库访问错误
      • setDate

        void setDate​(int parameterIndex,
                     Date x,
                     Calendar cal)
              throws SQLException
        使用给定的java.sql.Date值设置此RowSet对象命令中的指定参数。 驱动程序DATE值转换为SQL DATE值,使用给定的java.util.Calendar对象来计算日期。
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 参数值
        cal - 用于计算日期的 java.util.Calendar对象
        异常
        SQLException - 如果发生数据库访问错误
      • setDate

        void setDate​(String parameterName,
                     Date x)
              throws SQLException
        使用运行应用程序的虚拟机的默认时区将指定参数设置为给定的java.sql.Date值。 驱动程序在将其发送到数据库时将其转换为SQL DATE值。
        参数
        parameterName - 参数的名称
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误或在关闭时调用此方法 CallableStatement
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
        另请参见:
        ResultSet.getDate(int)
      • setDate

        void setDate​(String parameterName,
                     Date x,
                     Calendar cal)
              throws SQLException
        使用给定的Calendar对象将指定参数设置为给定的java.sql.Date值。 驱动程序使用Calendar对象构造SQL DATE值,然后驱动程序将其发送到数据库。 使用Calendar对象,驱动程序可以计算考虑自定义时区的日期。 如果未指定Calendar对象,则驱动程序将使用默认时区,即运行应用程序的虚拟机的时区。
        参数
        parameterName - 参数的名称
        x - 参数值
        cal - 驱动程序将用于构造日期的 Calendar对象
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
        另请参见:
        ResultSet.getDate(int)
      • setTime

        void setTime​(int parameterIndex,
                     Time x,
                     Calendar cal)
              throws SQLException
        使用给定的java.sql.Time值设置此RowSet对象命令中的指定参数。 在将数据发送到数据库之前,驱动程序将使用给定的java.util.Calendar对象将其转换为SQL TIME值。
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 参数值
        cal - 用于计算时间的 java.util.Calendar对象
        异常
        SQLException - 如果发生数据库访问错误
      • setTime

        void setTime​(String parameterName,
                     Time x)
              throws SQLException
        将指定参数设置为给定的java.sql.Time值。 驱动程序将其发送到数据库时将其转换为SQL TIME值。
        参数
        parameterName - 参数的名称
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
        另请参见:
        ResultSet.getTime(int)
      • setTime

        void setTime​(String parameterName,
                     Time x,
                     Calendar cal)
              throws SQLException
        使用给定的Calendar对象将指定参数设置为给定的java.sql.Time值。 驱动程序使用Calendar对象构造SQL TIME值,然后驱动程序将其发送到数据库。 使用Calendar对象,驱动程序可以计算考虑自定义时区的时间。 如果未指定Calendar对象,则驱动程序将使用默认时区,即运行应用程序的虚拟机的时区。
        参数
        parameterName - 参数的名称
        x - 参数值
        cal - 驱动程序将用于构造时间的 Calendar对象
        异常
        SQLException - 如果发生数据库访问错误或在关闭时调用此方法 CallableStatement
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
        另请参见:
        ResultSet.getTime(int)
      • setTimestamp

        void setTimestamp​(int parameterIndex,
                          Timestamp x,
                          Calendar cal)
                   throws SQLException
        使用给定的java.sql.Timestamp值设置此RowSet对象命令中的指定参数。 在将数据发送到数据库之前,驱动程序将使用给定的java.util.Calendar对象将其转换为SQL TIMESTAMP值。
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 参数值
        cal - 用于计算时间戳的 java.util.Calendar对象
        异常
        SQLException - 如果发生数据库访问错误
      • setTimestamp

        void setTimestamp​(String parameterName,
                          Timestamp x,
                          Calendar cal)
                   throws SQLException
        使用给定的Calendar对象将指定参数设置为给定的java.sql.Timestamp值。 驱动程序使用Calendar对象构造SQL TIMESTAMP值,然后驱动程序将其发送到数据库。 使用Calendar对象,驱动程序可以计算考虑自定义时区的时间戳。 如果未指定Calendar对象,则驱动程序将使用默认时区,即运行应用程序的虚拟机的时区。
        参数
        parameterName - 参数的名称
        x - 参数值
        cal - 驱动程序将用于构造时间戳的 Calendar对象
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
        另请参见:
        ResultSet.getTimestamp(int)
      • clearParameters

        void clearParameters()
                      throws SQLException
        清除为此RowSet对象命令设置的参数。

        通常,参数值对于重复使用RowSet对象仍然有效。 设置参数值会自动清除其先前的值。 但是,在某些情况下,立即释放当前参数值使用的资源很有用,这可以通过调用方法clearParameters来完成。

        异常
        SQLException - 如果发生数据库访问错误
      • execute

        void execute()
              throws SQLException
        用数据填充此RowSet对象。

        execute方法可以使用以下属性来创建用于读取数据的连接:url,数据源名称,用户名,密码,事务隔离和类型映射。 execute方法可以使用以下属性来创建执行命令的语句:command,read only,maximum field size,maximum rows,escape processing和query timeout。

        如果尚未设置所需的属性,则抛出异常。 如果此方法成功,则会丢弃行集的当前内容,并且还(重新)设置行集的元数据。 如果有未完成的更新,则会忽略它们。

        如果此RowSet对象未与其数据源保持连续连接,则可以使用ReaderRowSetReader对象)来填充数据。 在这种情况下, Reader将在此RowSet对象中注册,方法execute将调用ReaderreadData方法作为其实现的一部分。

        异常
        SQLException - 如果发生数据库访问错误或者尚未设置建立连接和创建语句所需的任何属性
      • addRowSetListener

        void addRowSetListener​(RowSetListener listener)
        注册给定的侦听器,以便通知此 RowSet对象上发生的事件。
        参数
        listener - 已实现 RowSetListener接口并希望在此 RowSet对象上发生事件时收到通知的 RowSet
        另请参见:
        removeRowSetListener(javax.sql.RowSetListener)
      • removeRowSetListener

        void removeRowSetListener​(RowSetListener listener)
        从此 RowSet对象上发生事件时将通知的组件列表中删除指定的侦听器。
        参数
        listener - 已注册为此 RowSet对象的侦听器的 RowSet
        另请参见:
        addRowSetListener(javax.sql.RowSetListener)
      • setSQLXML

        void setSQLXML​(int parameterIndex,
                       SQLXML xmlObject)
                throws SQLException
        将指定参数设置为给定的java.sql.SQLXML对象。 将驱动程序发送到数据库时,驱动程序将其转换为SQL XML值。
        参数
        parameterIndex - 第一个参数的索引是1,第二个参数是2,...
        xmlObject - 映射SQL XML值的 SQLXML对象
        异常
        SQLException -如果发生数据库访问错误,该方法被称为上关闭的结果集, java.xml.transform.ResultWriterOutputStream尚未收为SQLXML对象或者如果存在一个错误处理XML值。 异常的getCause方法可能会提供更详细的异常,例如,如果流不包含有效的XML。
        从以下版本开始:
        1.6
      • setSQLXML

        void setSQLXML​(String parameterName,
                       SQLXML xmlObject)
                throws SQLException
        将指定参数设置为给定的java.sql.SQLXML对象。 将驱动程序发送到数据库时,驱动程序将其转换为SQL XML值。
        参数
        parameterName - 参数的名称
        xmlObject - 映射 SQL XML值的 SQLXML对象
        异常
        SQLException -如果发生数据库访问错误,该方法被称为上关闭的结果集, java.xml.transform.ResultWriterOutputStream尚未收为SQLXML对象或者如果存在一个错误处理XML值。 异常的getCause方法可能会提供更详细的异常,例如,如果流不包含有效的XML。
        从以下版本开始:
        1.6
      • setRowId

        void setRowId​(int parameterIndex,
                      RowId x)
               throws SQLException
        将指定参数设置为给定的java.sql.RowId对象。 驱动程序在将其发送到数据库时将其转换为SQL ROWID
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误
        从以下版本开始:
        1.6
      • setRowId

        void setRowId​(String parameterName,
                      RowId x)
               throws SQLException
        将指定参数设置为给定的java.sql.RowId对象。 将驱动程序发送到数据库时,驱动程序将其转换为SQL ROWID
        参数
        parameterName - 参数的名称
        x - 参数值
        异常
        SQLException - 如果发生数据库访问错误
        从以下版本开始:
        1.6
      • setNString

        void setNString​(int parameterIndex,
                        String value)
                 throws SQLException
        将指定参数设置为给定的String对象。 将驱动程序发送到数据库时,驱动程序将其转换为SQL NCHARNVARCHARLONGNVARCHAR值(取决于参数的大小相对于驱动程序对NVARCHAR值的限制)。
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        value - 参数值
        异常
        SQLException - 如果驾驶员不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 或者如果发生数据库访问错误
        从以下版本开始:
        1.6
      • setNString

        void setNString​(String parameterName,
                        String value)
                 throws SQLException
        将指定参数设置为给定的String对象。 驱动程序将其转换为SQL NCHARNVARCHARLONGNVARCHAR
        参数
        parameterName - 要设置的列的名称
        value - 参数值
        异常
        SQLException - 如果驱动程序不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 或者如果发生数据库访问错误
        从以下版本开始:
        1.6
      • setNCharacterStream

        void setNCharacterStream​(int parameterIndex,
                                 Reader value,
                                 long length)
                          throws SQLException
        将指定参数设置为Reader对象。 Reader读取数据,直到达到文件结尾。 驱动程序执行从Java字符格式到数据库中的国家字符集的必要转换。
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        value - 参数值
        length - 参数数据中的字符数。
        异常
        SQLException - 如果驾驶员不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 或者如果发生数据库访问错误
        从以下版本开始:
        1.6
      • setNCharacterStream

        void setNCharacterStream​(String parameterName,
                                 Reader value,
                                 long length)
                          throws SQLException
        将指定参数设置为Reader对象。 Reader读取数据,直到达到文件结尾。 驱动程序执行从Java字符格式到数据库中的国家字符集的必要转换。
        参数
        parameterName - 要设置的列的名称
        value - 参数值
        length - 参数数据中的字符数。
        异常
        SQLException - 如果驾驶员不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 或者如果发生数据库访问错误
        从以下版本开始:
        1.6
      • setNCharacterStream

        void setNCharacterStream​(String parameterName,
                                 Reader value)
                          throws SQLException
        将指定参数设置为Reader对象。 Reader读取数据直到达到文件结尾。 驱动程序执行从Java字符格式到数据库中的国家字符集的必要转换。

        注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。

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

        参数
        parameterName - 参数的名称
        value - 参数值
        异常
        SQLException - 如果驾驶员不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误; 或者在关闭的CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setNClob

        void setNClob​(String parameterName,
                      NClob value)
               throws SQLException
        将指定参数设置为java.sql.NClob对象。 该对象实现了java.sql.NClob接口。 NClob对象映射到SQL NCLOB
        参数
        parameterName - 要设置的列的名称
        value - 参数值
        异常
        SQLException - 如果驱动程序不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 或者如果发生数据库访问错误
        从以下版本开始:
        1.6
      • setNClob

        void setNClob​(String parameterName,
                      Reader reader,
                      long length)
               throws SQLException
        将指定参数设置为Reader对象。 Reader必须包含由length指定的字符数,否则在执行SQLException将生成CallableStatement 此方法与setCharacterStream (int, Reader, int)方法不同,因为它通知驱动程序参数值应作为NCLOB发送到服务器。 使用setCharacterStream方法时,驱动程序可能需要做额外的工作来确定参数数据是否应作为LONGNVARCHARNCLOB发送到服务器
        参数
        parameterName - 要设置的参数的名称
        reader - 包含要将参数值设置为的数据的对象。
        length - 参数数据中的字符数。
        异常
        SQLException - 如果parameterIndex与SQL语句中的参数标记不对应; 如果指定的长度小于零; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setNClob

        void setNClob​(String parameterName,
                      Reader reader)
               throws SQLException
        将指定参数设置为Reader对象。 此方法与setCharacterStream (int, Reader)方法不同,因为它通知驱动程序参数值应作为NCLOB发送到服务器。 使用setCharacterStream方法时,驱动程序可能需要做额外的工作来确定参数数据是否应作为LONGNVARCHARNCLOB发送到服务器

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

        参数
        parameterName - 参数的名称
        reader - 包含要将参数值设置为的数据的对象。
        异常
        SQLException - 如果驱动程序不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setNClob

        void setNClob​(int parameterIndex,
                      Reader reader,
                      long length)
               throws SQLException
        将指定参数设置为Reader对象。 Reader必须包含由length指定的字符数,否则在执行SQLException将生成PreparedStatement 此方法与setCharacterStream (int, Reader, int)方法不同,因为它通知驱动程序参数值应作为NCLOB发送到服务器。 使用setCharacterStream方法时,驱动程序可能需要做额外的工作来确定参数数据是否应作为LONGNVARCHARNCLOB发送到服务器
        参数
        parameterIndex - 第一个参数的索引是1,第二个参数是2,...
        reader - 包含要将参数值设置为的数据的对象。
        length - 参数数据中的字符数。
        异常
        SQLException - 如果parameterIndex与SQL语句中的参数标记不对应; 如果指定的长度小于零; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误或在关闭的PreparedStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setNClob

        void setNClob​(int parameterIndex,
                      NClob value)
               throws SQLException
        将指定参数设置为java.sql.NClob对象。 驱动程序在将其发送到数据库时将其转换为SQL NCLOB值。
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        value - 参数值
        异常
        SQLException - 如果驱动程序不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 或者如果发生数据库访问错误
        从以下版本开始:
        1.6
      • setNClob

        void setNClob​(int parameterIndex,
                      Reader reader)
               throws SQLException
        将指定参数设置为Reader对象。 此方法与setCharacterStream (int, Reader)方法不同,因为它通知驱动程序参数值应作为NCLOB发送到服务器。 使用setCharacterStream方法时,驱动程序可能需要做额外的工作以确定参数数据是否应作为LONGNVARCHARNCLOB发送到服务器

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

        参数
        parameterIndex - 第一个参数的索引是1,第二个参数是2,...
        reader - 包含要将参数值设置为的数据的对象。
        异常
        SQLException - 如果parameterIndex与SQL语句中的参数标记不对应; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误或在关闭的PreparedStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setURL

        void setURL​(int parameterIndex,
                    URL x)
             throws SQLException
        将指定参数设置为给定的java.net.URL值。 驱动程序在将其发送到数据库时将其转换为SQL DATALINK值。
        参数
        parameterIndex - 第一个参数是1,第二个参数是2,...
        x - 要设置的 java.net.URL对象
        异常
        SQLException - 如果发生数据库访问错误或在关闭的 PreparedStatement上调用此方法
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4