Module java.sql
Package javax.sql

Interface RowSet

所有超接口:
AutoCloseable, ResultSet, Wrapper
所有已知子接口:
CachedRowSet, FilteredRowSet, JdbcRowSet, JoinRowSet, SyncResolver, WebRowSet
public interface RowSet extends ResultSet
该接口为JDBC API添加了对JavaBeans组件模型的支持。行集（可以在视觉Bean开发环境中作为JavaBeans组件使用）可以在设计时创建和配置，并在运行时执行。

RowSet接口提供了一组JavaBeans属性，允许配置RowSet实例以连接到JDBC数据源并从数据源中读取一些数据。一组setter方法（setInt、setBytes、setString等）提供了一种将输入参数传递给行集命令属性的方法。该命令是行集从关系数据库获取数据时使用的SQL查询，这通常是情况。

RowSet接口支持JavaBeans事件，允许应用程序中的其他组件在行集发生事件时得到通知，例如值发生变化。

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

  • Method Details

    • getUrl

      String getUrl() throws SQLException
      如果使用DriverManager而不是DataSource对象建立连接，检索此RowSet对象将使用的url属性。默认值为null。
      返回:
      一个字符串url
      抛出:
      SQLException - 如果发生数据库访问错误
      参见:

    • setUrl

      void setUrl(String url) throws SQLException
      设置此RowSet对象在使用DriverManager创建连接时将使用的URL。设置此属性是可选的。如果使用URL，则必须在使用rowset连接到数据库之前加载接受URL的JDBC驱动程序。rowset将在读取或写入数据时内部使用URL创建数据库连接。使用URL或数据源名称创建连接，以最近设置为非空值的方式。
      参数:
      url - 一个字符串值；可以为null
      抛出:
      SQLException - 如果发生数据库访问错误
      参见:

    • getDataSourceName

      String getDataSourceName()
      检索标识此RowSet对象的数据源的逻辑名称。
      返回:
      一个数据源名称
      参见:

    • setDataSourceName

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

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

      参数:
      name - 此RowSet对象的数据源的逻辑名称；可以为null
      抛出:
      SQLException - 如果发生数据库访问错误
      参见:

    • getUsername

      String getUsername()
      检索用于创建此RowSet对象的数据库连接的用户名。用户名属性在调用方法execute之前在运行时设置。它通常不是RowSet对象的序列化状态的一部分。
      返回:
      用户名属性
      参见:

    • setUsername

      void setUsername(String name) throws SQLException
      将此RowSet对象的用户名属性设置为给定的String。
      参数:
      name - 用户名
      抛出:
      SQLException - 如果发生数据库访问错误
      参见:

    • getPassword

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

    • setPassword

      void setPassword(String password) throws SQLException
      为此RowSet对象设置数据库密码为给定的String。
      参数:
      password - 密码字符串
      抛出:
      SQLException - 如果发生数据库访问错误
      参见:

    • getTransactionIsolation

      int getTransactionIsolation()
      检索为此RowSet对象设置的事务隔离级别。
      返回值:
      事务隔离级别；其中之一为 Connection.TRANSACTION_READ_UNCOMMITTED、Connection.TRANSACTION_READ_COMMITTED、Connection.TRANSACTION_REPEATABLE_READ 或 Connection.TRANSACTION_SERIALIZABLE
      参见:

    • setTransactionIsolation

      void setTransactionIsolation(int level) throws SQLException
      设置此 RowSet 对象的事务隔离级别。
      参数:
      level - 事务隔离级别；其中之一为 Connection.TRANSACTION_READ_UNCOMMITTED、Connection.TRANSACTION_READ_COMMITTED、Connection.TRANSACTION_REPEATABLE_READ 或 Connection.TRANSACTION_SERIALIZABLE
      抛出:
      SQLException - 如果发生数据库访问错误
      参见:

    • getTypeMap

      Map<String,Class<?>> getTypeMap() throws SQLException
      检索与此 RowSet 对象关联的 Map 对象，该对象指定了 SQL 用户定义类型的自定义映射（如果有）。默认情况下，类型映射为空。
      返回值:
      包含 SQL 用户定义类型名称和它们要映射到的 Java 类的 java.util.Map 对象
      抛出:
      SQLException - 如果发生数据库访问错误
      参见:

    • setTypeMap

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

    • getCommand

      String getCommand()
      检索此 RowSet 对象的命令属性。命令属性包含一个命令字符串，必须是一个 SQL 查询，可用于填充行集合数据。默认值为 null。
      返回值:
      命令字符串；可能为 null
      参见:

    • setCommand

      void setCommand(String cmd) throws SQLException
      将此 RowSet 对象的命令属性设置为给定的 SQL 查询。当行集合从不支持命令的数据源（例如电子表格）获取数据时，此属性是可选的。
      参数:
      cmd - 用于获取此 RowSet 对象数据的 SQL 查询；可能为 null
      抛出:
      SQLException - 如果发生数据库访问错误
      参见:

    • isReadOnly

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

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

      返回值:
      如果此 RowSet 对象为只读，则为 true；如果为可更新，则为 false
      参见:

    • setReadOnly

      void setReadOnly(boolean value) throws SQLException
      将此 RowSet 对象的只读属性设置为给定的 boolean 值。
      参数:
      value - 如果只读则为 true；如果可更新则为 false
      抛出:
      SQLException - 如果发生数据库访问错误
      参见:

    • getMaxFieldSize

      int getMaxFieldSize() throws SQLException
      检索可能返回的某些列值的最大字节数限制。此限制仅适用于 BINARY、VARBINARY、LONGVARBINARYBINARY、CHAR、VARCHAR、LONGVARCHAR、NCHAR 和 NVARCHAR 列。如果超出限制，多余的数据将被静默丢弃。
      返回值:
      当前最大列大小限制；零表示没有限制
      抛出:
      SQLException - 如果发生数据库访问错误
      参见:

    • setMaxFieldSize

      void setMaxFieldSize(int max) throws SQLException
      将可返回的列值的最大字节数限制设置为给定的字节数。此限制仅适用于 BINARY、VARBINARY、LONGVARBINARYBINARY、CHAR、VARCHAR、LONGVARCHAR、NCHAR 和 NVARCHAR 列。如果超出限制，多余的数据将被静默丢弃。为了最大可移植性，请使用大于 256 的值。
      参数:
      max - 新的最大列大小限制（以字节为单位）；零表示无限制
      抛出:
      SQLException - 如果发生数据库访问错误
      参见:

    • getMaxRows

      int getMaxRows() throws SQLException
      检索此 RowSet 对象可以包含的最大行数。如果超出限制，多余的行将被静默丢弃。
      返回值:
      此 RowSet 对象可以包含的当前最大行数；零表示无限制
      抛出:
      SQLException - 如果发生数据库访问错误
      参见:

    • setMaxRows

      void setMaxRows(int max) throws SQLException
      将此 RowSet 对象可以包含的最大行数设置为指定的行数。如果超出限制，多余的行将被静默丢弃。
      参数:
      max - 新的最大行数；零表示无限制
      抛出:
      SQLException - 如果发生数据库访问错误
      参见:

    • getEscapeProcessing

      boolean getEscapeProcessing() throws SQLException
      检索此 RowSet 对象是否启用转义处理。如果启用了转义扫描（默认情况下），驱动程序将在将 SQL 语句发送到数据库之前执行转义替换。
      返回值:
      如果启用了转义处理，则为 true；如果禁用，则为 false
      抛出:
      SQLException - 如果发生数据库访问错误
      参见:

    • setEscapeProcessing

      void setEscapeProcessing(boolean enable) throws SQLException
      设置此 RowSet 对象的转义处理为打开或关闭。如果启用了转义扫描（默认情况下），驱动程序将在将 SQL 语句发送到数据库之前执行转义替换。
      参数:
      enable - true 以启用转义处理；false 以禁用它
      抛出:
      SQLException - 如果发生数据库访问错误
      参见:

    • getQueryTimeout

      int getQueryTimeout() throws SQLException
      检索驱动程序将等待语句执行的最大秒数。如果超出此限制，将抛出 SQLException。
      返回值:
      当前查询超时限制（以秒为单位）；零表示无限制
      抛出:
      SQLException - 如果发生数据库访问错误
      参见:

    • setQueryTimeout

      void setQueryTimeout(int seconds) throws SQLException
      将驱动程序等待语句执行的最大时间设置为给定的秒数。如果超出此限制，将抛出 SQLException。
      参数:
      seconds - 新的查询超时限制（以秒为单位）；零表示无限制
      抛出:
      SQLException - 如果发生数据库访问错误
      参见:

    • setType

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

    • setConcurrency

      void setConcurrency(int concurrency) throws SQLException
      将此RowSet对象的并发性设置为给定的并发级别。此方法用于更改行集的并发级别，默认为ResultSet.CONCUR_READ_ONLY
      参数:
      concurrency - 指定并发级别的ResultSet常量之一: ResultSet.CONCUR_READ_ONLY 或 ResultSet.CONCUR_UPDATABLE
      抛出:
      SQLException - 如果发生数据库访问错误
      参见:

    • 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用户定义类型（UDTs）和REF类型参数。UDT的示例包括：STRUCT、DISTINCT、JAVA_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驱动程序不需要类型代码或类型名称信息，则可以忽略它。尽管此方法旨在用于用户定义和Ref参数，但也可用于设置任何JDBC类型的空参数。如果参数没有用户定义或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 BIT或 BOOLEAN值。
      参数:
      parameterName - 参数的名称
      x - 参数值
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自:
      1.4
      参见:

    • 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
      参见:

    • 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
      参见:

    • 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
      参见:

    • 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
      参见:

    • 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
      参见:

    • 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
      参见:

    • 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
      参见:

    • setString

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

    • setString

      void setString(String parameterName, String x) throws SQLException
      将指定的参数设置为给定的Java String值。驱动程序在将其发送到数据库时将其转换为SQL VARCHAR或LONGVARCHAR值（取决于参数相对于驱动程序对VARCHAR值的限制）。
      参数:
      parameterName - 参数的名称
      x - 参数值
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.4
      参见:

    • setBytes

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

    • setBytes

      void setBytes(String parameterName, byte[] x) throws SQLException
      将指定的参数设置为给定的byte值数组。驱动程序在将其发送到数据库时将其转换为SQL VARBINARY或LONGVARBINARY值（取决于参数相对于驱动程序对VARBINARY值的限制）。
      参数:
      parameterName - 参数的名称
      x - 参数值
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自版本:
      1.4
      参见:

    • 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版本起:
      1.4
      参见:

    • setAsciiStream

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

      注意: 此流对象可以是标准的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版本起:
      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版本起:
      1.4

    • setCharacterStream

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

      注意: 此流对象可以是标准的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版本起:
      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版本起:
      1.6

    • setAsciiStream

      void setAsciiStream(String parameterName, InputStream x) throws SQLException
      将指定的参数设置为给定的输入流。当向LONGVARCHAR参数输入非常大的ASCII值时，通过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上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自：
      1.6

    • setCharacterStream

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

      注意：此流对象可以是标准的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对象。当向LONGVARCHAR参数输入非常大的UNICODE值时，通过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
      将此RowSet对象的命令中的指定参数设置为给定的Java Object。对于整数值，应使用java.lang等效对象（例如，对于int，应使用Integer类的实例）。如果第二个参数是InputStream，则流必须包含由scaleOrLength指定的字节数。如果第二个参数是Reader，则Reader必须包含由scaleOrLength指定的字符数。如果这些条件不成立，当执行准备好的语句时，驱动程序将生成SQLException。

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

      如果对象是实现SQLData的类，行集应调用方法SQLData.writeSQL将对象写入SQLOutput数据流。另一方面，如果对象是实现Ref、Blob、Clob、NClob、Struct、java.net.URL或Array的类，则驱动程序应将其作为相应SQL类型的值传递给数据库。

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

      参数：
      parameterIndex - 第一个参数为1，第二个为2，...
      x - 包含输入参数值的对象
      targetSqlType - 要发送到数据库的SQL类型（如java.sql.Types中定义）。scale参数可能进一步限定此类型。
      scaleOrLength - 对于java.sql.Types.DECIMAL或java.sql.Types.NUMERIC types，这是小数点后的位数。对于Java对象类型InputStream和Reader，这是流或Reader中的数据长度。对于所有其他类型，此值将被忽略。
      抛出：
      SQLException - 如果发生数据库访问错误
      参见：

    • setObject

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

      给定的Java对象将在发送到数据库之前转换为给定的targetSqlType。如果对象具有自定义映射（属于实现SQLData接口的类），JDBC驱动程序应调用方法SQLData.writeSQL将其写入SQL数据流。另一方面，如果对象属于实现Ref、Blob、Clob、NClob、Struct、java.net.URL或Array的类，则驱动程序应将其作为相应SQL类型的值传递到数据库。

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

      参数:
      parameterName - 参数的名称
      x - 包含输入参数值的对象
      targetSqlType - 要发送到数据库的SQL类型（如在java.sql.Types中定义）。scale参数可能进一步限定此类型。
      scale - 对于java.sql.Types.DECIMAL或java.sql.Types.NUMERIC类型，这是小数点后的位数。对于所有其他类型，此值将被忽略。
      抛出:
      SQLException - 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法
      SQLFeatureNotSupportedException - 如果targetSqlType是ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML或STRUCT数据类型，且JDBC驱动程序不支持此数据类型
      自从:
      1.4
      参见:

    • 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 - 如果targetSqlType是ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML或STRUCT数据类型，且JDBC驱动程序不支持此数据类型
      自从:
      1.4
      参见:

    • setObject

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

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

      请注意，此方法可用于通过使用特定于驱动程序的Java类型传递特定于数据库的抽象数据类型。如果对象属于实现SQLData接口的类，则JDBC驱动程序应调用方法SQLData.writeSQL将其写入SQL数据流。另一方面，如果对象属于实现Ref、Blob、Clob、NClob、Struct、java.net.URL或Array的类，则驱动程序应将其作为相应SQL类型的值传递到数据库。

      如果存在歧义，例如，如果对象属于实现上述多个接口的类，则会抛出异常。

      参数:
      parameterName - 参数的名称
      x - 包含输入参数值的对象
      抛出:
      SQLException - 如果发生数据库访问错误，此方法在关闭的CallableStatement上调用，或者给定的Object参数存在歧义
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自从:
      1.4
      参见:

    • setObject

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

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

      请注意，此方法可用于通过使用特定于驱动程序的Java类型传递特定于数据库的抽象数据类型。如果对象属于实现SQLData接口的类，则行集应调用方法SQLData.writeSQL将对象写入SQLOutput数据流。另一方面，如果对象属于实现Ref、Blob、Clob、NClob、Struct、java.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必须包含长度指定的字符数，否则在执行PreparedStatement时将生成SQLException。此方法与setBinaryStream (int, InputStream, int)方法不同，因为它通知驱动程序参数值应作为BLOB发送到服务器。当使用setBinaryStream方法时，驱动程序可能需要额外工作来确定参数数据应作为LONGVARBINARY还是BLOB发送到服务器。
      参数:
      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方法时，驱动程序可能需要额外工作来确定参数数据应作为LONGVARBINARY还是BLOB发送到服务器。

      注意：请查阅您的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必须包含长度指定的字符数，否则在执行CallableStatement时将生成SQLException。此方法与setBinaryStream (int, InputStream, int)方法不同，因为它通知驱动程序应将参数值作为BLOB发送到服务器。当使用setBinaryStream方法时，驱动程序可能需要额外工作来确定参数数据应作为LONGVARBINARY还是BLOB发送到服务器。
      参数:
      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方法时，驱动程序可能需要额外工作来确定参数数据应作为LONGVARBINARY还是BLOB发送到服务器。

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

      参数:
      parameterName - 参数的名称
      inputStream - 包含要设置参数值的数据的对象。
      抛出:
      SQLException - 如果发生数据库访问错误或者在关闭的CallableStatement上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自：
      1.6

    • setClob

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

    • setClob

      void setClob(int parameterIndex, Reader reader, long length) throws SQLException
      将指定的参数设置为Reader对象。 Reader必须包含长度指定的字符数，否则在执行PreparedStatement时将生成SQLException。此方法与setCharacterStream (int, Reader, int)方法不同，因为它通知驱动程序应将参数值作为CLOB发送到服务器。当使用setCharacterStream方法时，驱动程序可能需要额外工作来确定参数数据应作为LONGVARCHAR还是CLOB发送到服务器。
      参数:
      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方法时，驱动程序可能需要额外工作来确定参数数据应作为LONGVARCHAR还是CLOB发送到服务器。

      注意：请查阅您的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必须包含长度指定的字符数，否则在执行CallableStatement时将生成SQLException。此方法与setCharacterStream (int, Reader, int)方法不同，因为它通知驱动程序应将参数值作为CLOB发送到服务器。当使用setCharacterStream方法时，驱动程序可能需要额外工作来确定参数数据应作为LONGVARCHAR还是CLOB发送到服务器。
      参数:
      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方法时，驱动程序可能需要额外工作来确定参数数据应该作为LONGVARCHAR还是CLOB发送到服务器。

      注意：请查阅您的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对象的命令中设置指定的参数。驱动程序将使用给定的java.util.Calendar对象计算日期，将其转换为SQL DATE值。
      参数:
      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
      参见：

    • 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
      参见：

    • 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
      参见：

    • 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
      参见：

    • 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
      参见：

    • clearParameters

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

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

      抛出:
      SQLException - 如果发生数据库访问错误

    • execute

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

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

      如果未设置所需属性，则会抛出异常。如果此方法成功，将丢弃行集的当前内容，并且行集的元数据也将被重新设置。如果存在未完成的更新，则将被忽略。

      如果此RowSet对象未与其数据源保持连续连接，则可能使用Reader（RowSetReader对象）来填充自身数据。在这种情况下，Reader将已向此RowSet对象注册，并且方法execute将调用Reader的readData方法作为其实现的一部分。

      抛出:
      SQLException - 如果发生数据库访问错误或未设置用于建立连接和创建语句的任何必要属性

    • addRowSetListener

      void addRowSetListener(RowSetListener listener)
      注册给定的监听器，以便在此RowSet对象上发生事件时通知它。
      参数:
      listener - 已实现RowSetListener接口并希望在此RowSet对象上发生事件时得到通知的组件
      参见:

    • removeRowSetListener

      void removeRowSetListener(RowSetListener listener)
      从将会在此RowSet对象上发生事件时通知的组件列表中移除指定的监听器。
      参数:
      listener - 已注册为此RowSet对象的监听器的组件
      参见:

    • 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.Result、Writer或OutputStream未关闭用于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.Result、Writer或OutputStream未关闭用于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 NCHAR或NVARCHAR或LONGNVARCHAR值（取决于参数大小相对于驱动程序对NVARCHAR值的限制）。
      参数:
      parameterIndex - 第一个参数为1，第二个为2，...
      value - 参数值
      抛出:
      SQLException - 如果驱动程序不支持国家字符集；如果驱动程序可以检测到可能发生数据转换错误；或者如果发生数据库访问错误
      自:
      1.6

    • setNString

      void setNString(String parameterName, String value) throws SQLException
      将指定的参数设置为给定的String对象。当驱动程序将其发送到数据库时，将此对象转换为SQL NCHAR或NVARCHAR或LONGNVARCHAR值
      参数:
      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必须包含由长度指定的字符数，否则在执行CallableStatement时将生成SQLException。此方法与setCharacterStream (int, Reader, int)方法不同，因为它通知驱动程序应将参数值作为NCLOB发送到服务器。当使用setCharacterStream方法时，驱动程序可能需要额外的工作来确定参数数据应该作为LONGNVARCHAR还是NCLOB发送到服务器
      参数:
      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方法时，驱动程序可能需要额外的工作来确定参数数据应该作为LONGNVARCHAR还是NCLOB发送到服务器

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

      参数:
      parameterName - 参数的名称
      reader - 包含要设置参数值的数据的对象。
      抛出:
      SQLException - 如果驱动程序不支持国家字符集；如果驱动程序可以检测到可能发生数据转换错误；如果发生数据库访问错误或在关闭的CallableStatement上调用此方法
      SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
      自：
      1.6

    • setNClob

      void setNClob(int parameterIndex, Reader reader, long length) throws SQLException
      将指定的参数设置为Reader对象。 Reader必须包含由长度指定的字符数，否则在执行PreparedStatement时将生成SQLException。此方法与setCharacterStream (int, Reader, int)方法不同，因为它通知驱动程序应将参数值作为NCLOB发送到服务器。当使用setCharacterStream方法时，驱动程序可能需要额外的工作来确定参数数据应该作为LONGNVARCHAR还是NCLOB发送到服务器
      参数:
      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方法时，驱动程序可能需要额外的工作来确定参数数据应该作为LONGNVARCHAR还是NCLOB发送到服务器

      注意：请查阅您的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