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 |
String getUrl() throws SQLException
如果此 RowSet 对象使用 DriverManager 而不是 DataSource 对象来建立连接,则检索此 RowSet 对象将用于创建连接的 url 属性。 默认值为空。
返回:
一个字符串网址
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
void setUrl(String url) throws SQLException
设置此 RowSet 对象在使用 DriverManager 创建连接时将使用的 URL。 设置此属性是可选的。 如果使用 URL,则必须在使用行集连接到数据库之前加载接受 URL 的 JDBC 驱动程序。 读取或写入数据时,行集将在内部使用 URL 来创建数据库连接。 URL 或数据源名称用于创建连接,以最近设置为非空值为准。
参数:
参数名称 | 参数描述 |
---|---|
url | 一个字符串值; 可能为空 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
String getDataSourceName()
检索标识此 RowSet 对象的数据源的逻辑名称。
返回:
数据源名称
void setDataSourceName(String name) throws SQLException
将此 RowSet 对象的数据源名称属性设置为给定的字符串。
数据源名称属性的值可用于查找已向命名服务注册的 DataSource 对象。 检索后,DataSource 对象可用于创建与它所代表的数据源的连接。
参数:
参数名称 | 参数描述 |
---|---|
name | 此 RowSet 对象的数据源的逻辑名称; 可能为空 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
String getUsername()
检索用于为此 RowSet 对象创建数据库连接的用户名。 username 属性在调用方法执行之前在运行时设置。 它通常不是 RowSet 对象的序列化状态的一部分。
返回:
用户名属性
void setUsername(String name) throws SQLException
将此 RowSet 对象的用户名属性设置为给定的字符串。
参数:
参数名称 | 参数描述 |
---|---|
name | 用户名 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
String getPassword()
检索用于创建数据库连接的密码。 在调用方法执行之前,在运行时设置密码属性。 它通常不是 RowSet 对象的序列化状态的一部分。
返回:
建立数据库连接的密码
void setPassword(String password) throws SQLException
将此 RowSet 对象的数据库密码设置为给定的字符串。
参数:
参数名称 | 参数描述 |
---|---|
password | 密码字符串 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
int getTransactionIsolation()
检索为此 RowSet 对象设置的事务隔离级别。
返回:
事务隔离级别; Connection.TRANSACTION_READ_UNCOMMITTED、Connection.TRANSACTION_READ_COMMITTED、Connection.TRANSACTION_REPEATABLE_READ 或 Connection.TRANSACTION_SERIALIZABLE 之一
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 | 如果发生数据库访问错误 |
MapString,Class> getTypeMap() throws SQLException
检索与此 RowSet 对象关联的 Map 对象,该对象指定 SQL 用户定义类型的自定义映射(如果有)。 默认类型映射为空。
返回:
一个 java.util.Map 对象,其中包含 SQL 用户定义类型的名称以及它们要映射到的 Java 类
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
void setTypeMap(MapString,Class> map) throws SQLException
将给定的 java.util.Map 对象安装为此 RowSet 对象的默认类型映射。 除非提供另一个类型映射作为方法参数,否则将使用此类型映射。
参数:
参数名称 | 参数描述 |
---|---|
map | 一个 java.util.Map 对象,其中包含 SQL 用户定义类型的名称以及它们要映射到的 Java 类 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
String getCommand()
检索此 RowSet 对象的命令属性。 command 属性包含一个命令字符串,它必须是一个 SQL 查询,可以执行它来用数据填充行集。 默认值为空。
返回:
命令字符串; 可能为空
void setCommand(String cmd) throws SQLException
将此 RowSet 对象的命令属性设置为给定的 SQL 查询。 当行集从不支持命令的数据源(例如电子表格)获取其数据时,此属性是可选的。
参数:
参数名称 | 参数描述 |
---|---|
cmd | 用于获取此 RowSet 对象数据的 SQL 查询; 可能为空 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
boolean isReadOnly()
检索此 RowSet 对象是否为只读。 如果可以更新,则默认情况下行集是可更新的。
尝试更新只读行集将导致引发 SQLException。
返回:
如果此 RowSet 对象是只读的,则为 true; 如果它是可更新的,则为 false
void setReadOnly(boolean value) throws SQLException
将此 RowSet 对象设置为给定布尔值是否为只读。
参数:
参数名称 | 参数描述 |
---|---|
value | 如果只读,则为 true; 如果可更新则为 false |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
int getMaxFieldSize() throws SQLException
检索可以为某些列值返回的最大字节数。 此限制仅适用于 BINARY、VARBINARY、LONGVARBINARYBINARY、CHAR、VARCHAR、LONGVARCHAR、NCHAR 和 NVARCHAR 列。 如果超出限制,多余的数据将被静默丢弃。
返回:
当前最大列大小限制; 零表示没有限制
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
void setMaxFieldSize(int max) throws SQLException
将可以为列值返回的最大字节数设置为给定的字节数。 此限制仅适用于 BINARY、VARBINARY、LONGVARBINARYBINARY、CHAR、VARCHAR、LONGVARCHAR、NCHAR 和 NVARCHAR 列。 如果超出限制,多余的数据将被静默丢弃。 为获得最大的可移植性,请使用大于 256 的值。
参数:
参数名称 | 参数描述 |
---|---|
max | 新的最大列大小限制(以字节为单位); 零意味着无限 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
int getMaxRows() throws SQLException
检索此 RowSet 对象可以包含的最大行数。 如果超出限制,则会静默删除多余的行。
返回:
此 RowSet 对象可以包含的当前最大行数; 零意味着无限
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
void setMaxRows(int max) throws SQLException
将此 RowSet 对象可以包含的最大行数设置为指定的数目。 如果超出限制,则会静默删除多余的行。
参数:
参数名称 | 参数描述 |
---|---|
max | 新的最大行数; 零意味着无限 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
boolean getEscapeProcessing() throws SQLException
检索是否为此 RowSet 对象启用了转义处理。 如果启用了转义扫描(这是默认设置),驱动程序将在向数据库发送 SQL 语句之前执行转义替换。
返回:
如果启用了转义处理,则为 true; 如果它被禁用,则为 false
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
void setEscapeProcessing(boolean enable) throws SQLException
将此 RowSet 对象的转义处理设置为打开或关闭。 如果转义扫描打开(默认),驱动程序将在向数据库发送 SQL 语句之前执行转义替换。
参数:
参数名称 | 参数描述 |
---|---|
enable | true 启用转义处理; false 禁用它 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
int getQueryTimeout() throws SQLException
检索驱动程序等待语句执行的最大秒数。 如果超出此限制,则会引发 SQLException。
返回:
当前查询超时限制(以秒为单位); 零意味着无限
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
void setQueryTimeout(int seconds) throws SQLException
将驱动程序等待语句执行的最长时间设置为给定的秒数。 如果超出此限制,则会引发 SQLException。
参数:
参数名称 | 参数描述 |
---|---|
seconds | 以秒为单位的新查询超时限制; 零表示没有限制 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
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 | 如果发生数据库访问错误 |
void setConcurrency(int concurrency) throws SQLException
将此 RowSet 对象的并发设置为给定的并发级别。 此方法用于更改行集的并发级别,默认为 ResultSet.CONCUR_READ_ONLY
参数:
参数名称 | 参数描述 |
---|---|
concurrency | 指定并发级别的 ResultSet 常量之一:ResultSet.CONCUR_READ_ONLY 或 ResultSet.CONCUR_UPDATABLE |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
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 | 如果发生数据库访问错误 |
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
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 | 如果发生数据库访问错误 |
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
void setBoolean(int parameterIndex, boolean x) throws SQLException
将此 RowSet 对象的命令中的指定参数设置为给定的 Java 布尔值。 驱动程序在将其发送到数据库之前将其转换为 SQL BIT 值。
参数:
参数名称 | 参数描述 |
---|---|
parameterIndex | 第一个参数是1,第二个是2,... |
x | 参数值 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
void setBoolean(String parameterName, boolean x) throws SQLException
将指定参数设置为给定的 Java 布尔值。 驱动程序在将其发送到数据库时将其转换为 SQL BIT 或 BOOLEAN 值。
参数:
参数名称 | 参数描述 |
---|---|
parameterName | 参数名称 |
x | 参数值 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法 |
SQLFeatureNotSupportedException | 如果 JDBC 驱动程序不支持此方法 |
Since:
1.4
void setByte(int parameterIndex, byte x) throws SQLException
将此 RowSet 对象的命令中的指定参数设置为给定的 Java 字节值。 驱动程序在将其发送到数据库之前将其转换为 SQL TINYINT 值。
参数:
参数名称 | 参数描述 |
---|---|
parameterIndex | 第一个参数是1,第二个是2,... |
x | 参数值 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
void setByte(String parameterName, byte x) throws SQLException
将指定参数设置为给定的 Java 字节值。 驱动程序在将其发送到数据库时将其转换为 SQL TINYINT 值。
参数:
参数名称 | 参数描述 |
---|---|
parameterName | 参数名称 |
x | 参数值 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法 |
SQLFeatureNotSupportedException | 如果 JDBC 驱动程序不支持此方法 |
Since:
1.4
void setShort(int parameterIndex, short x) throws SQLException
将此 RowSet 对象的命令中的指定参数设置为给定的 Java 短值。 驱动程序在将其发送到数据库之前将其转换为 SQL SMALLINT 值。
参数:
参数名称 | 参数描述 |
---|---|
parameterIndex | 第一个参数是1,第二个是2,... |
x | 参数值 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
void setShort(String parameterName, short x) throws SQLException
将指定参数设置为给定的 Java 短值。 驱动程序在将其发送到数据库时将其转换为 SQL SMALLINT 值。
参数:
参数名称 | 参数描述 |
---|---|
parameterName | 参数名称 |
x | 参数值 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法 |
SQLFeatureNotSupportedException | 如果 JDBC 驱动程序不支持此方法 |
Since:
1.4
void setInt(int parameterIndex, int x) throws SQLException
将此 RowSet 对象的命令中的指定参数设置为给定的 Java int 值。 驱动程序在将其发送到数据库之前将其转换为 SQL INTEGER 值。
参数:
参数名称 | 参数描述 |
---|---|
parameterIndex | 第一个参数是1,第二个是2,... |
x | 参数值 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
void setInt(String parameterName, int x) throws SQLException
将指定参数设置为给定的 Java int 值。 驱动程序在将其发送到数据库时将其转换为 SQL INTEGER 值。
参数:
参数名称 | 参数描述 |
---|---|
parameterName | 参数名称 |
x | 参数值 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法 |
SQLFeatureNotSupportedException | 如果 JDBC 驱动程序不支持此方法 |
Since:
1.4
void setLong(int parameterIndex, long x) throws SQLException
将此 RowSet 对象的命令中的指定参数设置为给定的 Java long 值。 驱动程序在将其发送到数据库之前将其转换为 SQL BIGINT 值。
参数:
参数名称 | 参数描述 |
---|---|
parameterIndex | 第一个参数是1,第二个是2,... |
x | 参数值 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
void setLong(String parameterName, long x) throws SQLException
将指定参数设置为给定的 Java long 值。 驱动程序在将其发送到数据库时将其转换为 SQL BIGINT 值。
参数:
参数名称 | 参数描述 |
---|---|
parameterName | 参数名称 |
x | 参数值 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法 |
SQLFeatureNotSupportedException | 如果 JDBC 驱动程序不支持此方法 |
Since:
1.4
void setFloat(int parameterIndex, float x) throws SQLException
将此 RowSet 对象的命令中的指定参数设置为给定的 Java 浮点值。 驱动程序在将其发送到数据库之前将其转换为 SQL REAL 值。
参数:
参数名称 | 参数描述 |
---|---|
parameterIndex | 第一个参数是1,第二个是2,... |
x | 参数值 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
void setFloat(String parameterName, float x) throws SQLException
将指定参数设置为给定的 Java 浮点值。 驱动程序在将其发送到数据库时将其转换为 SQL FLOAT 值。
参数:
参数名称 | 参数描述 |
---|---|
parameterName | 参数名称 |
x | 参数值 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法 |
SQLFeatureNotSupportedException | 如果 JDBC 驱动程序不支持此方法 |
Since:
1.4
void setDouble(int parameterIndex, double x) throws SQLException
将此 RowSet 对象的命令中的指定参数设置为给定的 Java 双精度值。 驱动程序在将其发送到数据库之前将其转换为 SQL DOUBLE 值。
参数:
参数名称 | 参数描述 |
---|---|
parameterIndex | 第一个参数是1,第二个是2,... |
x | 参数值 |
Throws:
Throw名称 | Throw描述 |
---|---|
SQLException | 如果发生数据库访问错误 |
void setDouble(String para
当前标题:创新互联鸿蒙OS教程:鸿蒙OSRowSet
本文URL:http://www.shufengxianlan.com/qtweb/news22/450272.html
网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等
声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联