Module  java.sql
软件包  javax.sql

Interface RowSet

  • All Superinterfaces:
    AutoCloseableResultSetWrapper
    All Known Subinterfaces:
    CachedRowSetFilteredRowSetJdbcRowSetJoinRowSetSyncResolverWebRowSet


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

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

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

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

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

    断开的行集可能有一个Reader (一个RowSetReader对象)和一个与它相关联的写入器(一个RowSetWriter对象)。 Reader可以以许多不同的方式实现,以便使用数据填充行集,包括从非关系数据源获取数据。 作者也可以以许多不同的方式实施,将对行集数据的更改传播回底层数据源。

    行列易于使用。 RowSet接口扩展了标准的java.sql.ResultSet接口。 RowSetMetaData接口扩展了java.sql.ResultSetMetaData接口。 因此,熟悉JDBC API的开发人员将不得不学习使用行集的最少数量的新API。 此外,使用JDBC ResultSet对象的第三方软件工具也将很容易地与行集合一起使用。

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

      • getUrl

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

        void setUrl​(String url)
             throws SQLException
        设置RowSet对象在使用DriverManager创建连接时将使用的URL。 设置此属性是可选的。 如果使用URL,则必须先加载接受URL的JDBC驱动程序,然后才能使用行集连接到数据库。 当读取或写入数据时,行将在内部使用URL来创建数据库连接。 使用URL或数据源名称来创建连接,最近设置为非空值。
        参数
        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对象的用户名属性设置为给定的 String
        参数
        name - 用户名
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        getUsername()
      • getPassword

        String getPassword​()
        检索用于创建数据库连接的密码。 密码属性在运行时设置,然后再调用方法execute 它通常不是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,Class<?>> map)
                 throws SQLException
        安装给定java.util.Map对象的默认类型映射此RowSet对象。 除非另有类型地图作为方法参数提供,否则将使用此类型地图。
        参数
        map - 一个 java.util.Map对象,其中包含SQL用户定义类型的名称以及要映射到的Java类
        异常
        SQLException - 如果发生数据库访问错误
        另请参见:
        getTypeMap()
      • getCommand

        String getCommand​()
        检索此RowSet对象的命令属性。 命令属性包含一个命令字符串,它必须是一个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类型的空参数。 如果该参数不具有用户定义或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驱动程序不需要类型代码或类型名称信息,它可能会忽略它。 尽管它是用于用户定义的和参数的参数,但是该方法可以用于设置任何JDBC类型的空值参数。 如果参数没有用户定义或REF类型,则给定的typeName将被忽略。

        参数
        parameterName - 参数的名称
        sqlType - 一个来自 java.sql.Types的值
        typeName - SQL用户定义类型的全限定名称; 如果参数不是用户定义的类型或SQL REF值,则忽略该值
        异常
        SQLException - 如果发生数据库访问错误或者在关闭的 CallableStatement调用此方法 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调用此方法 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调用 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调用此方法 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调用此方法 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调用此方法 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 - 如果发生数据库访问错误
      • 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调用此方法 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调用此方法 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到数据库字符格式进行任何必要的转换。

        注意:此流对象可以是标准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调用此方法 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到数据库字符格式进行任何必要的转换。

        注意:此流对象可以是标准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到数据库字符格式进行任何必要的转换。

        注意:此流对象可以是标准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到数据库字符格式进行任何必要的转换。

        注意:此流对象可以是标准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调用此方法 CallableStatement
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • setCharacterStream

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

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

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

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

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

        注意:此流对象可以是标准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等效对象(例如Integerint类的实例)。 如果第二个参数是一个InputStream则流必须包含scaleOrLength指定的字节数。 如果第二个参数是ReaderReader必须包含scaleOrLength指定的字符数。 如果这些条件不正确,驱动程序将在执行准备好的语句时生成SQLException

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

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

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

        参数
        parameterIndex - 第一个参数是1,第二个是2,...
        x - 包含输入参数值的对象
        targetSqlType - 要发送到数据库的SQL类型(定义在java.sql.Types )。 比例参数可能进一步限定此类型。
        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 - 对于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 ,但是使用的比例是第二个参数的比例。 标量值为0。 字面值在文字中具有比例。

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

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

        void setObject​(String parameterName,
                       Object x,
                       int targetSqlType)
                throws SQLException
        使用给定对象设置指定参数的值。 该方法类似于上述方法setObject ,除了它假定为0的比例。
        参数
        parameterName - 参数的名称
        x - 包含输入参数值的对象
        targetSqlType - 要发送到数据库的SQL类型(定义在java.sql.Types中)
        异常
        SQLException - 如果发生数据库访问错误或者在关闭的 CallableStatement调用此方法 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必须包含长度另有指定的字符数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必须包含长度指定的字符数,否则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必须包含长度另有指定的字符数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必须包含长度另有指定的字符数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对象的命令中设置指定的参数。 驱动程序将其转换为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调用此方法 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值,然后驱动程序将其发送到数据库。 使用aa Calendar对象,驱动程序可以计算考虑到自定义时区的日期。 如果未指定Calendar对象,则驱动程序将使用默认时区,即运行应用程序的虚拟机的时区。
        参数
        parameterName - 参数的名称
        x - 参数值
        cal - 驱动程序将用于构建日期的 Calendar对象
        异常
        SQLException - 如果发生数据库访问错误或者在关闭的 CallableStatement调用此方法 CallableStatement
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
        另请参见:
        ResultSet.getDate(int)
      • setTime

        void setTime​(int parameterIndex,
                     Time x,
                     Calendar cal)
              throws SQLException
        使用给定的java.sql.Time值在此RowSet对象的命令中设置指定的参数。 驱动程序将其转换为SQL TIME值,使用给定的java.util.Calendar对象进行计算,然后再将其发送到数据库。
        参数
        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值,然后驱动程序将其发送到数据库。 使用aa 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对象的命令中设置指定的参数。 驱动程序将其转换为SQL TIMESTAMP值,使用给定的java.util.Calendar对象进行计算,然后再将其发送到数据库。
        参数
        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值,然后驱动程序将其发送到数据库。 使用aa Calendar对象,驱动程序可以计算考虑到自定义时区的时间戳。 如果未指定Calendar对象,则驱动程序使用默认时区,即运行应用程序的虚拟机的时区。
        参数
        parameterName - 参数的名称
        x - 参数值
        cal - 驱动程序用于构建时间戳的 Calendar对象
        异常
        SQLException - 如果发生数据库访问错误或者在关闭的 CallableStatement调用此方法 CallableStatement
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
        另请参见:
        ResultSet.getTimestamp(int)
      • clearParameters

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

        一般来说,参数值保持有效,以重复使用RowSet对象。 设置参数值将自动清除其以前的值。 然而,在某些情况下,立即释放当前参数值所使用的资源是有用的,可以通过调用方法clearParameters来完成。

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

        void execute​()
              throws SQLException
        RowSet这个RowSet对象的数据。

        execute方法可以使用以下属性来创建用于读取数据的连接:url,数据源名称,用户名,密码,事务隔离和类型映射。 execute方法可以使用以下属性来创建一个语句来执行命令:command,只读,最大字段大小,最大行,转义处理和查询超时。

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

        如果此RowSet对象与其数据源不保持连续连接,则可以使用Reader (一个RowSetReader对象)填充数据。 在这种情况下, 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 - 一个 SQLXML对象,映射 SQL XML
        异常
        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必须包含长度另有指定的字符数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必须包含长度另有指定的字符数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