创新互联鸿蒙OS教程:鸿蒙OSRowSet

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

字段摘要

从接口 java.sql.ResultSet 继承的字段
CLOSE_CURSORS_AT_COMMIT, CONCUR_READ_ONLY, CONCUR_UPDATABLE, FETCH_FORWARD, FETCH_REVERSE, FETCH_UNKNOWN, HOLD_CURSORS_OVER_COMMIT, TYPE_FORWARD_ONLY, TYPE_SCROLL_INSENSITIVE, TYPE_SCROLL_SENSITIVE

方法总结

修饰符和类型 方法 描述
void addRowSetListener(RowSetListener listener) 注册给定的侦听器,以便将在此 RowSet 对象上发生的事件通知它。
void clearParameters() 清除为此 RowSet 对象的命令设置的参数。
void execute() 用数据填充此 RowSet 对象。
String getCommand() 检索此 RowSet 对象的命令属性。
String getDataSourceName() 检索标识此 RowSet 对象的数据源的逻辑名称。
boolean getEscapeProcessing() 检索是否为此 RowSet 对象启用了转义处理。
int getMaxFieldSize() 检索可以为某些列值返回的最大字节数。
int getMaxRows() 检索此 RowSet 对象可以包含的最大行数。
String getPassword() 检索用于创建数据库连接的密码。
int getQueryTimeout() 检索驱动程序等待语句执行的最大秒数。
int getTransactionIsolation() 检索为此 RowSet 对象设置的事务隔离级别。
MapString,Class getTypeMap() 检索与此 RowSet 对象关联的 Map 对象,该对象指定 SQL 用户定义类型的自定义映射(如果有)。
String getUrl() 如果此 RowSet 对象使用 DriverManager 而不是 DataSource 对象来建立连接,则检索此 RowSet 对象将用于创建连接的 url 属性。
String getUsername() 检索用于为此 RowSet 对象创建数据库连接的用户名。
boolean isReadOnly() 检索此 RowSet 对象是否为只读。
void removeRowSetListener(RowSetListener listener) 当此 RowSet 对象上发生事件时,从将通知的组件列表中删除指定的侦听器。
void setArray(int i, Array x) 使用给定的 Array 值设置此 RowSet 对象命令中的指定参数。
void setAsciiStream(int parameterIndex, InputStream x) 将此 RowSet 对象的命令中的指定参数设置为给定的输入流。
void setAsciiStream(int parameterIndex, InputStream x, int length) 将此 RowSet 对象的命令中的指定参数设置为给定的 java.io.InputStream 值。
void setAsciiStream(String parameterName, InputStream x) 将指定参数设置为给定的输入流。
void setAsciiStream(String parameterName, InputStream x, int length) 将指定参数设置为给定的输入流,该输入流将具有指定的字节数。
void setBigDecimal(int parameterIndex, BigDecimal x) 将此 RowSet 对象命令中的指定参数设置为给定的 java.math.BigDecimal 值。
void setBigDecimal(String parameterName, BigDecimal x) 将指定参数设置为给定的 java.math.BigDecimal 值。
void setBinaryStream(int parameterIndex, InputStream x) 将此 RowSet 对象的命令中的指定参数设置为给定的输入流。
void setBinaryStream(int parameterIndex, InputStream x, int length) 将此 RowSet 对象的命令中的指定参数设置为给定的 java.io.InputStream 值。
void setBinaryStream(String parameterName, InputStream x) 将指定参数设置为给定的输入流。
void setBinaryStream(String parameterName, InputStream x, int length) 将指定参数设置为给定的输入流,该输入流将具有指定的字节数。
void setBlob(int parameterIndex, InputStream inputStream) 将指定参数设置为 InputStream 对象。
void setBlob(int parameterIndex, InputStream inputStream, long length) 将指定参数设置为 InputStream 对象。
void setBlob(int i, Blob x) 使用给定的 Blob 值设置此 RowSet 对象命令中的指定参数。
void setBlob(String parameterName, InputStream inputStream) 将指定参数设置为 InputStream 对象。
void setBlob(String parameterName, InputStream inputStream, long length) 将指定参数设置为 InputStream 对象。
void setBlob(String parameterName, Blob x) 将指定参数设置为给定的 java.sql.Blob 对象。
void setBoolean(int parameterIndex, boolean x) 将此 RowSet 对象的命令中的指定参数设置为给定的 Java 布尔值。
void setBoolean(String parameterName, boolean x) 将指定参数设置为给定的 Java 布尔值。
void setByte(int parameterIndex, byte x) 将此 RowSet 对象的命令中的指定参数设置为给定的 Java 字节值。
void setByte(String parameterName, byte x) 将指定参数设置为给定的 Java 字节值。
void setBytes(int parameterIndex, byte[] x) 将此 RowSet 对象的命令中的指定参数设置为给定的 Java 字节值数组。
void setBytes(String parameterName, byte[] x) 将指定参数设置为给定的 Java 字节数组。
void setCharacterStream(int parameterIndex, Reader reader) 将此 RowSet 对象的命令中的指定参数设置为给定的 Reader 对象。
void setCharacterStream(int parameterIndex, Reader reader, int length) 将此 RowSet 对象的命令中的指定参数设置为给定的 java.io.Reader 值。
void setCharacterStream(String parameterName, Reader reader) 将指定参数设置为给定的 Reader 对象。
void setCharacterStream(String parameterName, Reader reader, int length) 将指定参数设置为给定的 Reader 对象,它是给定的字符数。
void setClob(int parameterIndex, Reader reader) 将指定参数设置为 Reader 对象。
void setClob(int parameterIndex, Reader reader, long length) 将指定参数设置为 Reader 对象。
void setClob(int i, Clob x) 使用给定的 Clob 值设置此 RowSet 对象命令中的指定参数。
void setClob(String parameterName, Reader reader) 将指定参数设置为 Reader 对象。
void setClob(String parameterName, Reader reader, long length) 将指定参数设置为 Reader 对象。
void setClob(String parameterName, Clob x) 将指定参数设置为给定的 java.sql.Clob 对象。
void setCommand(String cmd) 将此 RowSet 对象的命令属性设置为给定的 SQL 查询。
void setConcurrency(int concurrency) 将此 RowSet 对象的并发设置为给定的并发级别。
void setDataSourceName(String name) 将此 RowSet 对象的数据源名称属性设置为给定的字符串。
void setDate(int parameterIndex, Date x) 将此 RowSet 对象的命令中的指定参数设置为给定的 java.sql.Date 值。
void setDate(int parameterIndex, Date x, Calendar cal) 使用给定的 java.sql.Date 值设置此 RowSet 对象命令中的指定参数。
void setDate(String parameterName, Date x) 使用运行应用程序的虚拟机的默认时区将指定参数设置为给定的 java.sql.Date 值。
void setDate(String parameterName, Date x, Calendar cal) 使用给定的 Calendar 对象将指定参数设置为给定的 java.sql.Date 值。
void setDouble(int parameterIndex, double x) 将此 RowSet 对象的命令中的指定参数设置为给定的 Java 双精度值。
void setDouble(String parameterName, double x) 将指定参数设置为给定的 Java 双精度值。
void setEscapeProcessing(boolean enable) 将此 RowSet 对象的转义处理设置为打开或关闭。
void setFloat(int parameterIndex, float x) 将此 RowSet 对象的命令中的指定参数设置为给定的 Java 浮点值。
void setFloat(String parameterName, float x) 将指定参数设置为给定的 Java 浮点值。
void setInt(int parameterIndex, int x) 将此 RowSet 对象的命令中的指定参数设置为给定的 Java int 值。
void setInt(String parameterName, int x) 将指定参数设置为给定的 Java int 值。
void setLong(int parameterIndex, long x) 将此 RowSet 对象的命令中的指定参数设置为给定的 Java long 值。
void setLong(String parameterName, long x) 将指定参数设置为给定的 Java long 值。
void setMaxFieldSize(int max) 将可以为列值返回的最大字节数设置为给定的字节数。
void setMaxRows(int max) 将此 RowSet 对象可以包含的最大行数设置为指定的数目。
void setNCharacterStream(int parameterIndex, Reader value) 将此 RowSet 对象的命令中的指定参数设置为 Reader 对象。
void setNCharacterStream(int parameterIndex, Reader value, long length) 将指定参数设置为 Reader 对象。
void setNCharacterStream(String parameterName, Reader value) 将指定参数设置为 Reader 对象。
void setNCharacterStream(String parameterName, Reader value, long length) 将指定参数设置为 Reader 对象。
void setNClob(int parameterIndex, Reader reader) 将指定参数设置为 Reader 对象。
void setNClob(int parameterIndex, Reader reader, long length) 将指定参数设置为 Reader 对象。
void setNClob(int parameterIndex, NClob value) 将指定参数设置为 java.sql.NClob 对象。
void setNClob(String parameterName, Reader reader) 将指定参数设置为 Reader 对象。
void setNClob(String parameterName, Reader reader, long length) 将指定参数设置为 Reader 对象。
void setNClob(String parameterName, NClob value) 将指定参数设置为 java.sql.NClob 对象。
void setNString(int parameterIndex, String value) 将指定参数设置为给定的 String 对象。
void setNString(String parameterName, String value) 将指定参数设置为给定的 String 对象。
void setNull(int parameterIndex, int sqlType) 将此 RowSet 对象的 SQL 命令中的指定参数设置为 SQL NULL。
void setNull(int paramIndex, int sqlType, String typeName) 将此 RowSet 对象的 SQL 命令中的指定参数设置为 SQL NULL。
void setNull(String parameterName, int sqlType) 将指定参数设置为 SQL NULL。
void setNull(String parameterName, int sqlType, String typeName) 将指定参数设置为 SQL NULL。
void setObject(int parameterIndex, Object x) 使用 Java 对象设置此 RowSet 对象命令中的指定参数。
void setObject(int parameterIndex, Object x, int targetSqlType) 使用 Java 对象设置此 RowSet 对象命令中的指定参数。
void setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength) 使用给定的 Java 对象设置此 RowSet 对象的命令中的指定参数。
void setObject(String parameterName, Object x) 使用给定对象设置指定参数的值。
void setObject(String parameterName, Object x, int targetSqlType) 使用给定对象设置指定参数的值。
void setObject(String parameterName, Object x, int targetSqlType, int scale) 使用给定对象设置指定参数的值。
void setPassword(String password) 将此 RowSet 对象的数据库密码设置为给定的字符串。
void setQueryTimeout(int seconds) 将驱动程序等待语句执行的最长时间设置为给定的秒数。
void setReadOnly(boolean value) 将此 RowSet 对象设置为给定布尔值是否为只读。
void setRef(int i, Ref x) 使用给定的 Ref 值设置此 RowSet 对象命令中的指定参数。
void setRowId(int parameterIndex, RowId x) 将指定参数设置为给定的 java.sql.RowId 对象。
void setRowId(String parameterName, RowId x) 将指定参数设置为给定的 java.sql.RowId 对象。
void setShort(int parameterIndex, short x) 将此 RowSet 对象的命令中的指定参数设置为给定的 Java 短值。
void setShort(String parameterName, short x) 将指定参数设置为给定的 Java 短值。
void setSQLXML(int parameterIndex, SQLXML xmlObject) 将指定参数设置为给定的 java.sql.SQLXML 对象。
void setSQLXML(String parameterName, SQLXML xmlObject) 将指定参数设置为给定的 java.sql.SQLXML 对象。
void setString(int parameterIndex, String x) 将此 RowSet 对象的命令中的指定参数设置为给定的 Java 字符串值。
void setString(String parameterName, String x) 将指定参数设置为给定的 Java 字符串值。
void setTime(int parameterIndex, Time x) 将此 RowSet 对象的命令中的指定参数设置为给定的 java.sql.Time 值。
void setTime(int parameterIndex, Time x, Calendar cal) 使用给定的 java.sql.Time 值设置此 RowSet 对象命令中的指定参数。
void setTime(String parameterName, Time x) 将指定参数设置为给定的 java.sql.Time 值。
void setTime(String parameterName, Time x, Calendar cal) 使用给定的 Calendar 对象将指定参数设置为给定的 java.sql.Time 值。
void setTimestamp(int parameterIndex, Timestamp x) 将此 RowSet 对象的命令中的指定参数设置为给定的 java.sql.Timestamp 值。
void setTimestamp(int parameterIndex, Timestamp x, Calendar cal) 使用给定的 java.sql.Timestamp 值设置此 RowSet 对象命令中的指定参数。
void setTimestamp(String parameterName, Timestamp x) 将指定参数设置为给定的 java.sql.Timestamp 值。
void setTimestamp(String parameterName, Timestamp x, Calendar cal) 使用给定的 Calendar 对象将指定参数设置为给定的 java.sql.Timestamp 值。
void setTransactionIsolation(int level) 设置此 RowSet 对象的事务隔离级别。
void setType(int type) 将此 RowSet 对象的类型设置为给定类型。
void setTypeMap(MapString,Class map) 将给定的 java.util.Map 对象安装为此 RowSet 对象的默认类型映射。
void setUrl(String url) 设置此 RowSet 对象在使用 DriverManager 创建连接时将使用的 URL。
void setURL(int parameterIndex, URL x) 将指定参数设置为给定的 java.net.URL 值。
void setUsername(String name) 将此 RowSet 对象的用户名属性设置为给定的字符串。
从接口 java.sql.ResultSet 继承的方法
absolute, afterLast, beforeFirst, cancelRowUpdates, clearWarnings, close, deleteRow, findColumn, first, getArray, getArray, getAsciiStream, getAsciiStream, getBigDecimal, getBigDecimal, getBigDecimal, getBigDecimal, getBinaryStream, getBinaryStream, getBlob, getBlob, getBoolean, getBoolean, getByte, getByte, getBytes, getBytes, getCharacterStream, getCharacterStream, getClob, getClob, getConcurrency, getCursorName, getDate, getDate, getDate, getDate, getDouble, getDouble, getFetchDirection, getFetchSize, getFloat, getFloat, getHoldability, getInt, getInt, getLong, getLong, getMetaData, getNCharacterStream, getNCharacterStream, getNClob, getNClob, getNString, getNString, getObject, getObject, getObject, getObject, getRef, getRef, getRow, getRowId, getRowId, getShort, getShort, getSQLXML, getSQLXML, getStatement, getString, getString, getTime, getTime, getTime, getTime, getTimestamp, getTimestamp, getTimestamp, getTimestamp, getType, getUnicodeStream, getUnicodeStream, getURL, getURL, getWarnings, insertRow, isAfterLast, isBeforeFirst, isClosed, isFirst, isLast, last, moveToCurrentRow, moveToInsertRow, next, previous, refreshRow, relative, rowDeleted, rowInserted, rowUpdated, setFetchDirection, setFetchSize, updateArray, updateArray, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateBigDecimal, updateBigDecimal, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBlob, updateBlob, updateBlob, updateBlob, updateBlob, updateBlob, updateBoolean, updateBoolean, updateByte, updateByte, updateBytes, updateBytes, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateClob, updateClob, updateClob, updateClob, updateClob, updateClob, updateDate, updateDate, updateDouble, updateDouble, updateFloat, updateFloat, updateInt, updateInt, updateLong, updateLong, updateNCharacterStream, updateNCharacterStream, updateNCharacterStream, updateNCharacterStream, updateNClob, updateNClob, updateNClob, updateNClob, updateNClob, updateNClob, updateNString, updateNString, updateNull, updateNull, updateObject, updateObject, updateObject, updateObject, updateRef, updateRef, updateRow, updateRowId, updateRowId, updateShort, updateShort, updateSQLXML, updateSQLXML, updateString, updateString, updateTime, updateTime, updateTimestamp, updateTimestamp, wasNull
从接口 java.sql.Wrapper 继承的方法
isWrapperFor, unwrap

方法详情

getUrl

String getUrl() throws SQLException

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

返回:

一个字符串网址

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

setUrl

void setUrl(String url) throws SQLException

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

参数:

参数名称 参数描述
url 一个字符串值; 可能为空

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

getDataSourceName

String getDataSourceName()

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

返回:

数据源名称

setDataSourceName

void setDataSourceName(String name) throws SQLException

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

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

参数:

参数名称 参数描述
name 此 RowSet 对象的数据源的逻辑名称; 可能为空

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

getUsername

String getUsername()

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

返回:

用户名属性

setUsername

void setUsername(String name) throws SQLException

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

参数:

参数名称 参数描述
name 用户名

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

getPassword

String getPassword()

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

返回:

建立数据库连接的密码

setPassword

void setPassword(String password) throws SQLException

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

参数:

参数名称 参数描述
password 密码字符串

Throws:

Throw名称 Throw描述
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 之一

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

getTypeMap

MapString,Class getTypeMap() throws SQLException

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

返回:

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

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

setTypeMap

void setTypeMap(MapString,Class map) throws SQLException

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

参数:

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

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

getCommand

String getCommand()

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

返回:

命令字符串; 可能为空

setCommand

void setCommand(String cmd) throws SQLException

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

参数:

参数名称 参数描述
cmd 用于获取此 RowSet 对象数据的 SQL 查询; 可能为空

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

isReadOnly

boolean isReadOnly()

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

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

返回:

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

setReadOnly

void setReadOnly(boolean value) throws SQLException

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

参数:

参数名称 参数描述
value 如果只读,则为 true; 如果可更新则为 false

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

getMaxFieldSize

int getMaxFieldSize() throws SQLException

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

返回:

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

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

setMaxFieldSize

void setMaxFieldSize(int max) throws SQLException

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

参数:

参数名称 参数描述
max 新的最大列大小限制(以字节为单位); 零意味着无限

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

getMaxRows

int getMaxRows() throws SQLException

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

返回:

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

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

setMaxRows

void setMaxRows(int max) throws SQLException

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

参数:

参数名称 参数描述
max 新的最大行数; 零意味着无限

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

getEscapeProcessing

boolean getEscapeProcessing() throws SQLException

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

返回:

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

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

setEscapeProcessing

void setEscapeProcessing(boolean enable) throws SQLException

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

参数:

参数名称 参数描述
enable true 启用转义处理; false 禁用它

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

getQueryTimeout

int getQueryTimeout() throws SQLException

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

返回:

当前查询超时限制(以秒为单位); 零意味着无限

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

setQueryTimeout

void setQueryTimeout(int seconds) throws SQLException

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

参数:

参数名称 参数描述
seconds 以秒为单位的新查询超时限制; 零表示没有限制

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

setType

void setType(int type) throws SQLException

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

参数:

参数名称 参数描述
type 指定类型的 ResultSet 常量之一:ResultSet.TYPE_FORWARD_ONLY、ResultSet.TYPE_SCROLL_INSENSITIVE 或 ResultSet.TYPE_SCROLL_SENSITIVE

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

setConcurrency

void setConcurrency(int concurrency) throws SQLException

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

参数:

参数名称 参数描述
concurrency 指定并发级别的 ResultSet 常量之一:ResultSet.CONCUR_READ_ONLY 或 ResultSet.CONCUR_UPDATABLE

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

setNull

void setNull(int parameterIndex, int sqlType) throws SQLException

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

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

参数:

参数名称 参数描述
parameterIndex 第一个参数是1,第二个是2,...
sqlType 由 java.sql.Types 定义的 SQL 类型代码

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

setNull

void setNull(String parameterName, int sqlType) throws SQLException

将指定参数设置为 SQL NULL。

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

参数:

参数名称 参数描述
parameterName 参数名称
sqlType java.sql.Types 中定义的 SQL 类型代码

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法
SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法

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 参数。

参数:

参数名称 参数描述
paramIndex 第一个参数是1,第二个是2,...
sqlType 来自 java.sql.Types 的值
typeName SQL UDT 的完全限定名称或 REF 类型引用的 SQL 结构化类型的类型名称; 如果参数不是 UDT 或 REF 类型,则忽略

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

setNull

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

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

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

参数:

参数名称 参数描述
parameterName 参数名称
sqlType 来自 java.sql.Types 的值
typeName SQL 用户定义类型的完全限定名称; 如果参数不是用户定义的类型或 SQL REF 值,则忽略

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法
SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法

Since:

1.4

setBoolean

void setBoolean(int parameterIndex, boolean x) throws SQLException

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

参数:

参数名称 参数描述
parameterIndex 第一个参数是1,第二个是2,...
x 参数值

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

setBoolean

void setBoolean(String parameterName, boolean x) throws SQLException

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

参数:

参数名称 参数描述
parameterName 参数名称
x 参数值

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法
SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法

Since:

1.4

setByte

void setByte(int parameterIndex, byte x) throws SQLException

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

参数:

参数名称 参数描述
parameterIndex 第一个参数是1,第二个是2,...
x 参数值

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

setByte

void setByte(String parameterName, byte x) throws SQLException

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

参数:

参数名称 参数描述
parameterName 参数名称
x 参数值

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法
SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法

Since:

1.4

setShort

void setShort(int parameterIndex, short x) throws SQLException

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

参数:

参数名称 参数描述
parameterIndex 第一个参数是1,第二个是2,...
x 参数值

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

setShort

void setShort(String parameterName, short x) throws SQLException

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

参数:

参数名称 参数描述
parameterName 参数名称
x 参数值

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法
SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法

Since:

1.4

setInt

void setInt(int parameterIndex, int x) throws SQLException

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

参数:

参数名称 参数描述
parameterIndex 第一个参数是1,第二个是2,...
x 参数值

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

setInt

void setInt(String parameterName, int x) throws SQLException

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

参数:

参数名称 参数描述
parameterName 参数名称
x 参数值

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法
SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法

Since:

1.4

setLong

void setLong(int parameterIndex, long x) throws SQLException

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

参数:

参数名称 参数描述
parameterIndex 第一个参数是1,第二个是2,...
x 参数值

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

setLong

void setLong(String parameterName, long x) throws SQLException

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

参数:

参数名称 参数描述
parameterName 参数名称
x 参数值

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法
SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法

Since:

1.4

setFloat

void setFloat(int parameterIndex, float x) throws SQLException

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

参数:

参数名称 参数描述
parameterIndex 第一个参数是1,第二个是2,...
x 参数值

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

setFloat

void setFloat(String parameterName, float x) throws SQLException

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

参数:

参数名称 参数描述
parameterName 参数名称
x 参数值

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法
SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法

Since:

1.4

setDouble

void setDouble(int parameterIndex, double x) throws SQLException

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

参数:

参数名称 参数描述
parameterIndex 第一个参数是1,第二个是2,...
x 参数值

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误

setDouble

void setDouble(String para

当前标题:创新互联鸿蒙OS教程:鸿蒙OSRowSet
本文URL:http://www.shufengxianlan.com/qtweb/news22/450272.html

网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等

广告

声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联