鸿蒙OS RowSet

RowSet

public interface RowSet
extends ResultSet

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

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

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

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

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

断开连接的行集可能具有与之关联的读取器（RowSetReader 对象）和写入器（RowSetWriter 对象）。读取器可以以许多不同的方式实现，以使用数据填充行集，包括从非关系数据源获取数据。编写器还可以以多种不同方式实现，以将对行集数据所做的更改传播回底层数据源。

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

Since:

1.4

字段摘要

方法总结

方法详情

getUrl

String getUrl() throws SQLException

如果此 RowSet 对象使用 DriverManager 而不是 DataSource 对象来建立连接，则检索此 RowSet 对象将用于创建连接的 url 属性。 默认值为空。

返回:

一个字符串网址

Throws:

setUrl

void setUrl(String url) throws SQLException

设置此 RowSet 对象在使用 DriverManager 创建连接时将使用的 URL。 设置此属性是可选的。 如果使用 URL，则必须在使用行集连接到数据库之前加载接受 URL 的 JDBC 驱动程序。 读取或写入数据时，行集将在内部使用 URL 来创建数据库连接。 URL 或数据源名称用于创建连接，以最近设置为非空值为准。

参数：

Throws:

getDataSourceName

String getDataSourceName()

检索标识此 RowSet 对象的数据源的逻辑名称。

返回:

数据源名称

setDataSourceName

void setDataSourceName(String name) throws SQLException

将此 RowSet 对象的数据源名称属性设置为给定的字符串。

数据源名称属性的值可用于查找已向命名服务注册的 DataSource 对象。 检索后，DataSource 对象可用于创建与它所代表的数据源的连接。

参数：

Throws:

getUsername

String getUsername()

检索用于为此 RowSet 对象创建数据库连接的用户名。 username 属性在调用方法执行之前在运行时设置。 它通常不是 RowSet 对象的序列化状态的一部分。

返回:

用户名属性

setUsername

void setUsername(String name) throws SQLException

将此 RowSet 对象的用户名属性设置为给定的字符串。

参数：

Throws:

getPassword

String getPassword()

检索用于创建数据库连接的密码。 在调用方法执行之前，在运行时设置密码属性。 它通常不是 RowSet 对象的序列化状态的一部分。

返回:

建立数据库连接的密码

setPassword

void setPassword(String password) throws SQLException

将此 RowSet 对象的数据库密码设置为给定的字符串。

参数：

Throws:

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 对象的事务隔离级别。

参数：

Throws:

getTypeMap

MapString,Class<?> getTypeMap() throws SQLException

检索与此 RowSet 对象关联的 Map 对象，该对象指定 SQL 用户定义类型的自定义映射（如果有）。 默认类型映射为空。

返回:

一个 java.util.Map 对象，其中包含 SQL 用户定义类型的名称以及它们要映射到的 Java 类

Throws:

setTypeMap

void setTypeMap(MapString,Class<?> map) throws SQLException

将给定的 java.util.Map 对象安装为此 RowSet 对象的默认类型映射。 除非提供另一个类型映射作为方法参数，否则将使用此类型映射。

参数：

Throws:

getCommand

String getCommand()

检索此 RowSet 对象的命令属性。 command 属性包含一个命令字符串，它必须是一个 SQL 查询，可以执行它来用数据填充行集。 默认值为空。

返回:

命令字符串； 可能为空

setCommand

void setCommand(String cmd) throws SQLException

将此 RowSet 对象的命令属性设置为给定的 SQL 查询。 当行集从不支持命令的数据源（例如电子表格）获取其数据时，此属性是可选的。

参数：

Throws:

isReadOnly

boolean isReadOnly()

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

尝试更新只读行集将导致引发 SQLException。

返回:

如果此 RowSet 对象是只读的，则为 true； 如果它是可更新的，则为 false

setReadOnly

void setReadOnly(boolean value) throws SQLException

将此 RowSet 对象设置为给定布尔值是否为只读。

参数：

Throws:

getMaxFieldSize

int getMaxFieldSize() throws SQLException

检索可以为某些列值返回的最大字节数。 此限制仅适用于 BINARY、VARBINARY、LONGVARBINARYBINARY、CHAR、VARCHAR、LONGVARCHAR、NCHAR 和 NVARCHAR 列。 如果超出限制，多余的数据将被静默丢弃。

返回:

当前最大列大小限制； 零表示没有限制

Throws:

setMaxFieldSize

void setMaxFieldSize(int max) throws SQLException

将可以为列值返回的最大字节数设置为给定的字节数。 此限制仅适用于 BINARY、VARBINARY、LONGVARBINARYBINARY、CHAR、VARCHAR、LONGVARCHAR、NCHAR 和 NVARCHAR 列。 如果超出限制，多余的数据将被静默丢弃。 为获得最大的可移植性，请使用大于 256 的值。

参数：

Throws:

getMaxRows

int getMaxRows() throws SQLException

检索此 RowSet 对象可以包含的最大行数。 如果超出限制，则会静默删除多余的行。

返回:

此 RowSet 对象可以包含的当前最大行数； 零意味着无限

Throws:

setMaxRows

void setMaxRows(int max) throws SQLException

将此 RowSet 对象可以包含的最大行数设置为指定的数目。 如果超出限制，则会静默删除多余的行。

参数：

Throws:

getEscapeProcessing

boolean getEscapeProcessing() throws SQLException

检索是否为此 RowSet 对象启用了转义处理。 如果启用了转义扫描（这是默认设置），驱动程序将在向数据库发送 SQL 语句之前执行转义替换。

返回:

如果启用了转义处理，则为 true； 如果它被禁用，则为 false

Throws:

setEscapeProcessing

void setEscapeProcessing(boolean enable) throws SQLException

将此 RowSet 对象的转义处理设置为打开或关闭。 如果转义扫描打开（默认），驱动程序将在向数据库发送 SQL 语句之前执行转义替换。

参数：

Throws:

getQueryTimeout

int getQueryTimeout() throws SQLException

检索驱动程序等待语句执行的最大秒数。 如果超出此限制，则会引发 SQLException。

返回:

当前查询超时限制（以秒为单位）； 零意味着无限

Throws:

setQueryTimeout

void setQueryTimeout(int seconds) throws SQLException

将驱动程序等待语句执行的最长时间设置为给定的秒数。 如果超出此限制，则会引发 SQLException。

参数：

Throws:

setType

void setType(int type) throws SQLException

将此 RowSet 对象的类型设置为给定类型。 此方法用于更改行集的类型，默认为只读且不可滚动。

参数：

Throws:

setConcurrency

void setConcurrency(int concurrency) throws SQLException

将此 RowSet 对象的并发设置为给定的并发级别。 此方法用于更改行集的并发级别，默认为 ResultSet.CONCUR_READ_ONLY

参数：

Throws:

setNull

void setNull(int parameterIndex, int sqlType) throws SQLException

将此 RowSet 对象的 SQL 命令中的指定参数设置为 SQL NULL。

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

参数：

Throws:

setNull

void setNull(String parameterName, int sqlType) throws SQLException

将指定参数设置为 SQL NULL。

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

参数：

Throws:

Since:

1.4

setNull

void setNull(int paramIndex, int sqlType, String typeName) throws SQLException

将此 RowSet 对象的 SQL 命令中的指定参数设置为 SQL NULL。 此版本的方法 setNull 应用于 SQL 用户定义类型 (UDT) 和 REF 类型参数。 UDT 的示例包括：STRUCT、DISTINCT、JAVA_OBJECT 和命名数组类型。

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

参数：

Throws:

setNull

void setNull(String parameterName, int sqlType, String typeName) throws SQLException

将指定参数设置为 SQL NULL。 此版本的方法 setNull 应用于用户定义类型和 REF 类型参数。 用户定义类型的示例包括：STRUCT、DISTINCT、JAVA_OBJECT 和命名数组类型。

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

参数：

Throws:

Since:

1.4

setBoolean

void setBoolean(int parameterIndex, boolean x) throws SQLException

将此 RowSet 对象的命令中的指定参数设置为给定的 Java 布尔值。 驱动程序在将其发送到数据库之前将其转换为 SQL BIT 值。

参数：

Throws:

setBoolean

void setBoolean(String parameterName, boolean x) throws SQLException

将指定参数设置为给定的 Java 布尔值。 驱动程序在将其发送到数据库时将其转换为 SQL BIT 或 BOOLEAN 值。

参数：

Throws:

Since:

1.4

setByte

void setByte(int parameterIndex, byte x) throws SQLException

将此 RowSet 对象的命令中的指定参数设置为给定的 Java 字节值。 驱动程序在将其发送到数据库之前将其转换为 SQL TINYINT 值。

参数：

Throws:

setByte

void setByte(String parameterName, byte x) throws SQLException

将指定参数设置为给定的 Java 字节值。 驱动程序在将其发送到数据库时将其转换为 SQL TINYINT 值。

参数：

Throws:

Since:

1.4

setShort

void setShort(int parameterIndex, short x) throws SQLException

将此 RowSet 对象的命令中的指定参数设置为给定的 Java 短值。 驱动程序在将其发送到数据库之前将其转换为 SQL SMALLINT 值。

参数：

Throws:

setShort

void setShort(String parameterName, short x) throws SQLException

将指定参数设置为给定的 Java 短值。 驱动程序在将其发送到数据库时将其转换为 SQL SMALLINT 值。

参数：

Throws:

Since:

1.4

setInt

void setInt(int parameterIndex, int x) throws SQLException

将此 RowSet 对象的命令中的指定参数设置为给定的 Java int 值。 驱动程序在将其发送到数据库之前将其转换为 SQL INTEGER 值。

参数：

Throws:

setInt

void setInt(String parameterName, int x) throws SQLException

将指定参数设置为给定的 Java int 值。 驱动程序在将其发送到数据库时将其转换为 SQL INTEGER 值。

参数：

Throws:

Since:

1.4

setLong

void setLong(int parameterIndex, long x) throws SQLException

将此 RowSet 对象的命令中的指定参数设置为给定的 Java long 值。 驱动程序在将其发送到数据库之前将其转换为 SQL BIGINT 值。

参数：

Throws:

setLong

void setLong(String parameterName, long x) throws SQLException

将指定参数设置为给定的 Java long 值。 驱动程序在将其发送到数据库时将其转换为 SQL BIGINT 值。

参数：

Throws:

Since:

1.4

setFloat

void setFloat(int parameterIndex, float x) throws SQLException

将此 RowSet 对象的命令中的指定参数设置为给定的 Java 浮点值。 驱动程序在将其发送到数据库之前将其转换为 SQL REAL 值。

参数：

Throws:

setFloat

void setFloat(String parameterName, float x) throws SQLException

将指定参数设置为给定的 Java 浮点值。 驱动程序在将其发送到数据库时将其转换为 SQL FLOAT 值。

参数：

Throws:

Since:

1.4

setDouble

void setDouble(int parameterIndex, double x) throws SQLException

将此 RowSet 对象的命令中的指定参数设置为给定的 Java 双精度值。 驱动程序在将其发送到数据库之前将其转换为 SQL DOUBLE 值。

参数：

Throws:

setDouble

void setDouble(String parameterName, double x) throws SQLException

将指定参数设置为给定的 Java 双精度值。 驱动程序在将其发送到数据库时将其转换为 SQL DOUBLE 值。

参数：

Throws:

Since:

1.4

setBigDecimal

void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException

将此 RowSet 对象命令中的指定参数设置为给定的 java.math.BigDecimal 值。 驱动程序在将其发送到数据库之前将其转换为 SQL NUMERIC 值。

参数：

Throws:

setBigDecimal

void setBigDecimal(String parameterName, BigDecimal x) throws SQLException

将指定参数设置为给定的 java.math.BigDecimal 值。 驱动程序在将其发送到数据库时将其转换为 SQL NUMERIC 值。

参数：

Throws:

Since:

1.4

setString

void setString(int parameterIndex, String x) throws SQLException

将此 RowSet 对象的命令中的指定参数设置为给定的 Java 字符串值。 在将其发送到数据库之前，驱动程序将其转换为 SQL VARCHAR 或 LONGVARCHAR 值，具体取决于参数的大小相对于驱动程序对 VARCHAR 值的限制。

参数：

Throws:

setString

void setString(String parameterName, String x) throws SQLException

将指定参数设置为给定的 Java 字符串值。 驱动程序在将其发送到数据库时将其转换为 SQL VARCHAR 或 LONGVARCHAR 值（取决于参数的大小相对于驱动程序对 VARCHAR 值的限制）。

参数：

Throws:

Since:

1.4

setBytes

void setBytes(int parameterIndex, byte[] x) throws SQLException

将此 RowSet 对象的命令中的指定参数设置为给定的 Java 字节值数组。 在将其发送到数据库之前，驱动程序将其转换为 SQL VARBINARY 或 LONGVARBINARY 值，具体取决于参数相对于驱动程序对 VARBINARY 值的限制的大小。

参数：

Throws:

setBytes

void setBytes(String parameterName, byte[] x) throws SQLException

将指定参数设置为给定的 Java 字节数组。 驱动程序在将其发送到数据库时将其转换为 SQL VARBINARY 或 LONGVARBINARY（取决于参数的大小相对于驱动程序对 VARBINARY 值的限制）。

参数：

Throws:

Since:

1.4

setDate

void setDate(int parameterIndex, Date x) throws SQLException

将此 RowSet 对象的命令中的指定参数设置为给定的 java.sql.Date 值。 驱动程序在将其发送到数据库之前将其转换为 SQL DATE 值，使用默认的 java.util.Calendar 来计算日期。

参数：

Throws:

setTime

void setTime(int parameterIndex, Time x) throws SQLException

将此 RowSet 对象的命令中的指定参数设置为给定的 java.sql.Time 值。 驱动程序在将其发送到数据库之前将其转换为 SQL TIME 值，使用默认的 java.util.Calendar 来计算它。

参数：

Throws:

setTimestamp

void setTimestamp(int parameterIndex, Timestamp x) throws SQLException

将此 RowSet 对象的命令中的指定参数设置为给定的 java.sql.Timestamp 值。 驱动程序在将其发送到数据库之前将其转换为 SQL TIMESTAMP 值，使用默认的 java.util.Calendar 来计算它。

参数：

Throws:

setTimestamp

void setTimestamp(String parameterName, Timestamp x) throws SQLException

将指定参数设置为给定的 java.sql.Timestamp 值。 驱动程序在将其发送到数据库时将其转换为 SQL TIMESTAMP 值。

参数：

Throws:

Since:

1.4

setAsciiStream

void setAsciiStream(int parameterIndex, InputStream x, int length) throws SQLException

将此 RowSet 对象的命令中的指定参数设置为给定的 java.io.InputStream 值。 通过 java.io.InputStream 而不是作为 LONGVARCHAR 参数发送非常大的 ASCII 值可能更实用。 驱动程序将根据需要从流中读取数据，直到到达文件末尾。

注意：这个流对象可以是标准的 Java 流对象，也可以是您自己的实现标准接口的子类。

参数：

Throws:

setAsciiStream

void setAsciiStream(String parameterName, InputStream x, int length) throws SQLException

将指定参数设置为给定的输入流，该输入流将具有指定的字节数。 当向 LONGVARCHAR 参数输入非常大的 ASCII 值时，通过 java.io.InputStream 发送它可能更实际。 将根据需要从流中读取数据，直到到达文件结尾。 JDBC 驱动程序将执行从 ASCII 到数据库字符格式的任何必要转换。

注意：这个流对象可以是标准的 Java 流对象，也可以是您自己的实现标准接口的子类。

参数：

Throws:

Since:

1.4

setBinaryStream

void setBinaryStream(int parameterIndex, InputStream x, int length) throws SQLException

将此 RowSet 对象的命令中的指定参数设置为给定的 java.io.InputStream 值。 通过 java.io.InputStream 而不是作为 LONGVARBINARY 参数发送非常大的二进制值可能更实用。 驱动程序将根据需要从流中读取数据，直到到达文件末尾。

注意：这个流对象可以是标准的 Java 流对象，也可以是您自己的实现标准接口的子类。

参数：

Throws:

setBinaryStream

void setBinaryStream(String parameterName, InputStream x, int length) throws SQLException

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

注意：这个流对象可以是标准的 Java 流对象，也可以是您自己的实现标准接口的子类。

参数：

Throws:

Since:

1.4

setCharacterStream

void setCharacterStream(int parameterIndex, Reader reader, int length) throws SQLException

将此 RowSet 对象的命令中的指定参数设置为给定的 java.io.Reader 值。 通过 java.io.Reader 而不是作为 LONGVARCHAR 参数发送非常大的 UNICODE 值可能更实用。 驱动程序将根据需要从流中读取数据，直到到达文件末尾。

注意：这个流对象可以是标准的 Java 流对象，也可以是您自己的实现标准接口的子类。

参数：

Throws:

setCharacterStream

void setCharacterStream(String parameterName, Reader reader, int length) throws SQLException

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

注意：这个流对象可以是标准的 Java 流对象，也可以是您自己的实现标准接口的子类。

参数：

Throws:

Since:

1.4

setAsciiStream

void setAsciiStream(int parameterIndex, InputStream x) throws SQLException

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

注意：这个流对象可以是标准的 Java 流对象，也可以是您自己的实现标准接口的子类。

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

参数：

Throws:

Since:

1.6

setAsciiStream

void setAsciiStream(String parameterName, InputStream x) throws SQLException

将指定参数设置为给定的输入流。 当向 LONGVARCHAR 参数输入非常大的 ASCII 值时，通过 java.io.InputStream 发送它可能更实际。 将根据需要从流中读取数据，直到到达文件结尾。 JDBC 驱动程序将执行从 ASCII 到数据库字符格式的任何必要转换。

注意：这个流对象可以是标准的 Java 流对象，也可以是您自己的实现标准接口的子类。

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

参数：

Throws:

Since:

1.6

setBinaryStream

void setBinaryStream(int parameterIndex, InputStream x) throws SQLException

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

注意：这个流对象可以是标准的 Java 流对象，也可以是您自己的实现标准接口的子类。

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

参数：

Throws:

Since:

1.6

setBinaryStream

void setBinaryStream(String parameterName, InputStream x) throws SQLException

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

注意：这个流对象可以是标准的 Java 流对象，也可以是您自己的实现标准接口的子类。

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

参数：

Throws:

Since:

1.6

setCharacterStream

void setCharacterStream(int parameterIndex, Reader reader) throws SQLException

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

注意：这个流对象可以是标准的 Java 流对象，也可以是您自己的实现标准接口的子类。

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

参数：

Throws:

Since:

1.6

setCharacterStream

void setCharacterStream(String parameterName, Reader reader) throws SQLException

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

注意：这个流对象可以是标准的 Java 流对象，也可以是您自己的实现标准接口的子类。

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

参数：

Throws:

Since:

1.6

setNCharacterStream

void setNCharacterStream(int parameterIndex, Reader value) throws SQLException

将此 RowSet 对象的命令中的指定参数设置为 Reader 对象。 Reader 读取数据直到到达文件末尾。 驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。

注意：这个流对象可以是标准的 Java 流对象，也可以是您自己的实现标准接口的子类。

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

参数：

Throws:

Since:

1.6

setObject

void setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength) throws SQLException

使用给定的 Java 对象设置此 RowSet 对象的命令中的指定参数。对于整数值，应使用 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 类型的值传递给数据库。

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

参数：

Throws:

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 类型的值传递给数据库。

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

参数：

Throws:

Since:

1.4

setObject

void setObject(int parameterIndex, Object x, int targetSqlType) throws SQLException

使用 Java 对象设置此 RowSet 对象命令中的指定参数。 对于整数值，应使用 java.lang 等效对象。 这个方法和上面的setObject类似，但是使用的比例是第二个参数的比例。 标量值的比例为零。 文字值具有文字中存在的比例。

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

参数：

Throws:

setObject

void setObject(String parameterName, Object x, int targetSqlType) throws SQLException

使用给定对象设置指定参数的值。 此方法与上面的方法 setObject 类似，不同之处在于它假定比例为零。

参数：

Throws:

Since:

1.4

setObject

void setObject(String parameterName, Object x) throws SQLException

使用给定对象设置指定参数的值。第二个参数必须是 Object 类型；因此，java.lang 等效对象应该用于内置类型。

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

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

如果存在歧义，例如，如果对象属于实现多个上述接口的类，则此方法将引发异常。

参数：

Throws:

Since:

1.4

setObject

void setObject(int parameterIndex, Object x) throws SQLException

使用 Java 对象设置此 RowSet 对象命令中的指定参数。 对于整数值，应使用 java.lang 等效对象。

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

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

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

参数：

Throws:

setRef

void setRef(int i, Ref x) throws SQLException

使用给定的 Ref 值设置此 RowSet 对象命令中的指定参数。 驱动程序会将其转换为适当的 REF(<structured-type>) 值。

参数：

Throws:

setBlob

void setBlob(int i, Blob x) throws SQLException

使用给定的 Blob 值设置此 RowSet 对象命令中的指定参数。 驱动程序将其转换为 Blob 对象表示的 BLOB 值，然后再将其发送到数据库。

参数：

Throws:

setBlob

void setBlob(int parameterIndex, InputStream inputStream, long length) throws SQLException

将指定参数设置为 InputStream 对象。 输入流必须包含长度指定的字符数，否则在执行 PreparedStatement 时将生成 SQLException。 此方法与 setBinaryStream (int, InputStream, int) 方法不同，因为它通知驱动程序应将参数值作为 BLOB 发送到服务器。 当使用 setBinaryStream 方法时，驱动程序可能需要做额外的工作来确定参数数据应该作为 LONGVARBINARY 还是 BLOB 发送到服务器

参数：

Throws:

Since:

1.6

setBlob

void setBlob(int parameterIndex, InputStream inputStream) throws SQLException

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

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

参数：

Throws:

Since:

1.6

setBlob

void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException

将指定参数设置为 InputStream 对象。 输入流必须包含长度指定的字符数，否则执行 CallableStatement 时会产生 SQLException。 此方法与 setBinaryStream (int, InputStream, int) 方法不同，因为它通知驱动程序应将参数值作为 BLOB 发送到服务器。 当使用 setBinaryStream 方法时，驱动程序可能需要做额外的工作来确定参数数据应该作为 LONGVARBINARY 还是 BLOB 发送到服务器

参数：

Throws:

Since:

1.6

setBlob

void setBlob(String parameterName, Blob x) throws SQLException

将指定参数设置为给定的 java.sql.Blob 对象。 驱动程序在将其发送到数据库时将其转换为 SQL BLOB 值。

参数：

Throws:

Since:

1.6

setBlob

void setBlob(String parameterName, InputStream inputStream) throws SQLException

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

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

参数：

Throws:

Since:

1.6

setClob

void setClob(int i, Clob x) throws SQLException

使用给定的 Clob 值设置此 RowSet 对象命令中的指定参数。 驱动程序会将其转换为 Clob 对象表示的 CLOB 值，然后再将其发送到数据库。

参数：

Throws:

setClob

void setClob(int parameterIndex, Reader reader, long length) throws SQLException

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

参数：

Throws:

Since:

1.6

setClob

void setClob(int parameterIndex, Reader reader) throws SQLException

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

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

参数：

Throws:

Since:

1.6

setClob

void setClob(String parameterName, Reader reader, long length) throws SQLException

将指定参数设置为 Reader 对象。 reader 必须包含 length 指定的字符数，否则执行 CallableStatement 时将生成 SQLException。 此方法与 setCharacterStream (int, Reader, int) 方法不同，因为它通知驱动程序应将参数值作为 CLOB 发送到服务器。 当使用 setCharacterStream 方法时，驱动程序可能需要做额外的工作来确定参数数据应该作为 LONGVARCHAR 还是 CLOB 发送到服务器

参数：

Throws:

Since:

1.6

setClob

void setClob(String parameterName, Clob x) throws SQLException

将指定参数设置为给定的 java.sql.Clob 对象。 驱动程序在将其发送到数据库时将其转换为 SQL CLOB 值。

参数：

Throws:

Since:

1.6

setClob

void setClob(String parameterName, Reader reader) throws SQLException

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

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

参数：

Throws:

Since:

1.6

setArray

void setArray(int i, Array x) throws SQLException

使用给定的 Array 值设置此 RowSet 对象命令中的指定参数。 驱动程序会将其转换为 Array 对象表示的 ARRAY 值，然后再将其发送到数据库。

参数：

Throws:

setDate

void setDate(int parameterIndex, Date x, Calendar cal) throws SQLException

使用给定的 java.sql.Date 值设置此 RowSet 对象命令中的指定参数。 驱动程序会将其转换为 SQL DATE 值，使用给定的 java.util.Calendar 对象来计算日期。

参数：

Throws:

setDate

void setDate(String parameterName, Date x) throws SQLException

使用运行应用程序的虚拟机的默认时区将指定参数设置为给定的 java.sql.Date 值。 驱动程序在将其发送到数据库时将其转换为 SQL DATE 值。

参数：

Throws:

Since:

1.4

setDate

void setDate(String parameterName, Date x, Calendar cal) throws SQLException

使用给定的 Calendar 对象将指定参数设置为给定的 java.sql.Date 值。 驱动程序使用 Calendar 对象构造 SQL DATE 值，然后驱动程序将其发送到数据库。 使用 Calendar 对象，驱动程序可以在考虑自定义时区的情况下计算日期。 如果未指定日历对象，则驱动程序使用默认时区，即运行应用程序的虚拟机的时区。

参数：

Throws:

Since:

1.4

setTime

void setTime(int parameterIndex, Time x, Calendar cal) throws SQLException

使用给定的 java.sql.Time 值设置此 RowSet 对象命令中的指定参数。 驱动程序会将其转换为 SQL TIME 值，使用给定的 java.util.Calendar 对象进行计算，然后将其发送到数据库。

参数：

Throws:

setTime

void setTime(String parameterName, Time x) throws SQLException

将指定参数设置为给定的 java.sql.Time 值。 驱动程序在将其发送到数据库时将其转换为 SQL TIME 值。

参数：

Throws:

Since:

1.4

setTime

void setTime(String parameterName, Time x, Calendar cal) throws SQLException

使用给定的 Calendar 对象将指定参数设置为给定的 java.sql.Time 值。 驱动程序使用 Calendar 对象构造 SQL TIME 值，然后驱动程序将其发送到数据库。 使用 Calendar 对象，驱动程序可以在考虑自定义时区的情况下计算时间。 如果未指定日历对象，则驱动程序使用默认时区，即运行应用程序的虚拟机的时区。

参数：

Throws:

Since:

1.4

setTimestamp

void setTimestamp(int parameterIndex, Timestamp x, Calendar cal) throws SQLException

使用给定的 java.sql.Timestamp 值设置此 RowSet 对象命令中的指定参数。 驱动程序会将其转换为 SQL TIMESTAMP 值，使用给定的 java.util.Calendar 对象进行计算，然后将其发送到数据库。

参数：

Throws:

setTimestamp

void setTimestamp(String parameterName, Timestamp x, Calendar cal) throws SQLException

使用给定的 Calendar 对象将指定参数设置为给定的 java.sql.Timestamp 值。 驱动程序使用日历对象构造一个 SQL TIMESTAMP 值，然后驱动程序将其发送到数据库。 使用 Calendar 对象，驱动程序可以在考虑自定义时区的情况下计算时间戳。 如果未指定日历对象，则驱动程序使用默认时区，即运行应用程序的虚拟机的时区。

参数：

Throws:

Since:

1.4

clearParameters

void clearParameters() throws SQLException

清除为此 RowSet 对象的命令设置的参数。

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

Throws:

execute

void execute() throws SQLException

用数据填充此 RowSet 对象。

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

如果尚未设置所需的属性，则会引发异常。 如果此方法成功，行集的当前内容将被丢弃，并且行集的元数据也被（重新）设置。 如果有未完成的更新，它们将被忽略。

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

Throws:

addRowSetListener

void addRowSetListener(RowSetListener listener)

注册给定的侦听器，以便将在此 RowSet 对象上发生的事件通知它。

参数：

removeRowSetListener

void removeRowSetListener(RowSetListener listener)

当此 RowSet 对象上发生事件时，从将通知的组件列表中删除指定的侦听器。

参数：

setSQLXML

void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException

将指定参数设置为给定的 java.sql.SQLXML 对象。 驱动程序在将其发送到数据库时将其转换为 SQL XML 值。

参数：

Throws:

Since:

1.6

setSQLXML

void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException

将指定参数设置为给定的 java.sql.SQLXML 对象。 驱动程序在将其发送到数据库时将其转换为 SQL XML 值。

参数：

Throws:

Since:

1.6

setRowId

void setRowId(int parameterIndex, RowId x) throws SQLException

将指定参数设置为给定的 java.sql.RowId 对象。 驱动程序在将其发送到数据库时将其转换为 SQL ROWID 值

参数：

Throws:

Since:

1.6

setRowId

void setRowId(String parameterName, RowId x) throws SQLException

将指定参数设置为给定的 java.sql.RowId 对象。 驱动程序在将其发送到数据库时将其转换为 SQL ROWID。

参数：

Throws:

Since:

1.6

setNString

void setNString(int parameterIndex, String value) throws SQLException

将指定参数设置为给定的 String 对象。 驱动程序在将其发送到数据库时将其转换为 SQL NCHAR 或 NVARCHAR 或 LONGNVARCHAR 值（取决于参数的大小相对于驱动程序对 NVARCHAR 值的限制）。

参数：

Throws:

Since:

1.6

setNString

void setNString(String parameterName, String value) throws SQLException

将指定参数设置为给定的 String 对象。 驱动程序将其转换为 SQL NCHAR 或 NVARCHAR 或 LONGNVARCHAR

参数：

Throws:

Since:

1.6

setNCharacterStream

void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException

将指定参数设置为 Reader 对象。 Reader 读取数据直到到达文件末尾。 驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。

参数：

Throws:

Since:

1.6

setNCharacterStream

void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException

将指定参数设置为 Reader 对象。 Reader 读取数据直到到达文件末尾。 驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。

参数：

Throws:

Since:

1.6

setNCharacterStream

void setNCharacterStream(String parameterName, Reader value) throws SQLException

将指定参数设置为 Reader 对象。 Reader 读取数据直到到达文件末尾。 驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。

注意：这个流对象可以是标准的 Java 流对象，也可以是您自己的实现标准接口的子类。

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

参数：

Throws:

Since:

1.6

setNClob

void setNClob(String parameterName, NClob value) throws SQLException

将指定参数设置为 java.sql.NClob 对象。 该对象实现了 java.sql.NClob 接口。 此 NClob 对象映射到 SQL NCLOB。

参数：

Throws:

Since:

1.6

setNClob

void setNClob(String parameterName, Reader reader, long length) throws SQLException

将指定参数设置为 Reader 对象。 reader 必须包含 length 指定的字符数，否则执行 CallableStatement 时将生成 SQLException。 此方法与 setCharacterStream (int, Reader, int) 方法不同，因为它通知驱动程序应将参数值作为 NCLOB 发送到服务器。 当使用 setCharacterStream 方法时，驱动程序可能需要做额外的工作来确定参数数据应该作为 LONGNVARCHAR 还是 NCLOB 发送到服务器

参数：

Throws:

Since:

1.6

setNClob

void setNClob(String parameterName, Reader reader) throws SQLException

将指定参数设置为 Reader 对象。 此方法与 setCharacterStream (int, Reader) 方法不同，因为它通知驱动程序应将参数值作为 NCLOB 发送到服务器。 当使用 setCharacterStream 方法时，驱动程序可能需要做额外的工作来确定参数数据应该作为 LONGNVARCHAR 还是 NCLOB 发送到服务器

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

参数：

Throws:

Since:

1.6

setNClob

void setNClob(int parameterIndex, Reader reader, long length) throws SQLException

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

参数：

Throws:

Since:

1.6

setNClob

void setNClob(int parameterIndex, NClob value) throws SQLException

将指定参数设置为 java.sql.NClob 对象。 驱动程序在将其发送到数据库时将其转换为 SQL NCLOB 值。

参数：

Throws:

Since:

1.6

setNClob

void setNClob(int parameterIndex, Reader reader) throws SQLException

将指定参数设置为 Reader 对象。 此方法与 setCharacterStream (int, Reader) 方法不同，因为它通知驱动程序应将参数值作为 NCLOB 发送到服务器。 当使用 setCharacterStream 方法时，驱动程序可能需要做额外的工作来确定参数数据应该作为 LONGNVARCHAR 还是 NCLOB 发送到服务器

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

参数：

Throws:

Since:

1.6

setURL

void setURL(int parameterIndex, URL x) throws SQLException

将指定参数设置为给定的 java.net.URL 值。 驱动程序在将其发送到数据库时将其转换为 SQL DATALINK 值。

参数：

Throws:

Since:

1.4