鸿蒙OS RowSet

2022-11-02 16:46 更新

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 parameterName, double x) throws SQLException

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

参数:

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

Throws:

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

Since:

1.4

setBigDecimal

void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException

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

参数:

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

Throws:

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

setBigDecimal

void setBigDecimal(String parameterName, BigDecimal x) throws SQLException

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

参数:

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

Throws:

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

Since:

1.4

setString

void setString(int parameterIndex, String x) throws SQLException

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

参数:

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

Throws:

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

setString

void setString(String parameterName, String x) throws SQLException

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

参数:

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

Throws:

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

Since:

1.4

setBytes

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

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

参数:

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

Throws:

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

setBytes

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

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

参数:

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

Throws:

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

Since:

1.4

setDate

void setDate(int parameterIndex, Date x) throws SQLException

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

参数:

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

Throws:

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

setTime

void setTime(int parameterIndex, Time x) throws SQLException

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

参数:

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

Throws:

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

setTimestamp

void setTimestamp(int parameterIndex, Timestamp x) throws SQLException

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

参数:

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

Throws:

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

setTimestamp

void setTimestamp(String parameterName, Timestamp x) throws SQLException

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

参数:

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

Throws:

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

Since:

1.4

setAsciiStream

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

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

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

参数:

参数名称 参数描述
parameterIndex 第一个参数是1,第二个是2,...
x 包含 ASCII 参数值的 Java 输入流
length 流中的字节数

Throws:

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

setAsciiStream

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

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

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

参数:

参数名称 参数描述
parameterName 参数名称
x 包含 ASCII 参数值的 Java 输入流
length 流中的字节数

Throws:

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

Since:

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 流中的字节数

Throws:

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

setBinaryStream

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

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

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

参数:

参数名称 参数描述
parameterName 参数名称
x 包含二进制参数值的 java 输入流
length 流中的字节数

Throws:

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

Since:

1.4

setCharacterStream

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

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

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

参数:

参数名称 参数描述
parameterIndex 第一个参数是1,第二个是2,...
reader 包含要设置的 UNICODE 数据的 Reader 对象
length 流中的字符数

Throws:

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

setCharacterStream

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

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

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

参数:

参数名称 参数描述
parameterName 参数名称
reader 包含用作指定参数的 UNICODE 数据的 java.io.Reader 对象
length 流中的字符数

Throws:

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

Since:

1.4

setAsciiStream

void setAsciiStream(int parameterIndex, InputStream x) throws SQLException

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

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

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

参数:

参数名称 参数描述
parameterIndex 第一个参数是1,第二个是2,...
x 包含 ASCII 参数值的 Java 输入流

Throws:

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

Since:

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 输入流

Throws:

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

Since:

1.6

setBinaryStream

void setBinaryStream(int parameterIndex, InputStream x) throws SQLException

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

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

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

参数:

参数名称 参数描述
parameterIndex 第一个参数是1,第二个是2,...
x 包含二进制参数值的 java 输入流

Throws:

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

Since:

1.6

setBinaryStream

void setBinaryStream(String parameterName, InputStream x) throws SQLException

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

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

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

参数:

参数名称 参数描述
parameterName 参数名称
x 包含二进制参数值的 java 输入流

Throws:

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

Since:

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 对象

Throws:

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

Since:

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 对象

Throws:

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

Since:

1.6

setNCharacterStream

void setNCharacterStream(int parameterIndex, Reader value) throws SQLException

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

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

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

参数:

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

Throws:

Throw名称 Throw描述
SQLException 如果驱动程序不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误; 或者在关闭的 PreparedStatement 上调用此方法
SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法

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

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

参数:

参数名称 参数描述
parameterIndex 第一个参数是1,第二个是2,...
x 包含输入参数值的对象
targetSqlType 要发送到数据库的 SQL 类型(在 java.sql.Types 中定义)。 scale 参数可以进一步限定这种类型。
scaleOrLength 对于 java.sql.Types.DECIMAL 或 java.sql.Types.NUMERIC 类型,这是小数点后的位数。 对于 Java 对象类型 InputStream 和 Reader,这是流或读取器中数据的长度。 对于所有其他类型,此值将被忽略。

Throws:

Throw名称 Throw描述
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 类型,这是小数点后的位数。 对于所有其他类型,此值将被忽略。

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法
SQLFeatureNotSupportedException 如果 targetSqlType 是 ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML 或 STRUCT 数据类型并且 JDBC 驱动程序不支持此数据类型

Since:

1.4

setObject

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

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

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

参数:

参数名称 参数描述
parameterIndex 第一个参数是1,第二个是2,...
x 包含输入参数值的对象
targetSqlType 要发送到数据库的 SQL 类型(在 java.sql.Types 中定义)

Throws:

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

setObject

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

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

参数:

参数名称 参数描述
parameterName 参数名称
x 包含输入参数值的对象
targetSqlType 要发送到数据库的 SQL 类型(在 java.sql.Types 中定义)

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法
SQLFeatureNotSupportedException 如果 targetSqlType 是 ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML 或 STRUCT 数据类型并且 JDBC 驱动程序不支持此数据类型

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

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

参数:

参数名称 参数描述
parameterName 参数名称
x 包含输入参数值的对象

Throws:

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

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

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

参数:

参数名称 参数描述
parameterIndex 第一个参数是1,第二个是2,...
x 包含输入参数值的对象

Throws:

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

setRef

void setRef(int i, Ref x) throws SQLException

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

参数:

参数名称 参数描述
i 第一个参数是1,第二个是2,...
x 表示 SQL REF 类型数据的对象

Throws:

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

setBlob

void setBlob(int i, Blob x) throws SQLException

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

参数:

参数名称 参数描述
i 第一个参数是1,第二个是2,...
x 表示 BLOB 的对象

Throws:

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

setBlob

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

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

参数:

参数名称 参数描述
parameterIndex 第一个参数的索引是 1,第二个是 2,...
inputStream 一个对象,其中包含要设置参数值的数据。
length 参数数据中的字节数。

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误,则在关闭的 PreparedStatement 上调用此方法,如果 parameterIndex 与 SQL 语句中的参数标记不对应,如果指定的长度小于零或输入流中的字节数不匹配 指定的长度。
SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法

Since:

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 一个对象,其中包含要设置参数值的数据。

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误,则在关闭的 PreparedStatement 上调用此方法,或者如果 parameterIndex 与 SQL 语句中的参数标记不对应,
SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法

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 发送到服务器

参数:

参数名称 参数描述
parameterName 第二个要设置的参数的名称是2,...
inputStream 一个对象,其中包含要设置参数值的数据。
length 参数数据中的字节数。

Throws:

Throw名称 Throw描述
SQLException 如果 parameterIndex 不对应 SQL 语句中的参数标记,或者指定的长度小于零; 如果输入流中的字节数与指定的长度不匹配; 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法
SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法

Since:

1.6

setBlob

void setBlob(String parameterName, Blob x) throws SQLException

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

参数:

参数名称 参数描述
parameterName 参数名称
x 映射 SQL BLOB 值的 Blob 对象

Throws:

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

Since:

1.6

setBlob

void setBlob(String parameterName, InputStream inputStream) throws SQLException

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

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

参数:

参数名称 参数描述
parameterName 参数名称
inputStream 一个对象,其中包含要设置参数值的数据。

Throws:

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

Since:

1.6

setClob

void setClob(int i, Clob x) throws SQLException

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

参数:

参数名称 参数描述
i 第一个参数是1,第二个是2,...
x 表示 CLOB 的对象

Throws:

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

setClob

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

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

参数:

参数名称 参数描述
parameterIndex 第一个参数的索引是 1,第二个是 2,...
reader 一个对象,其中包含要设置参数值的数据。
length 参数数据中的字符数。

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误,则在关闭的 PreparedStatement 上调用此方法,如果 parameterIndex 与 SQL 语句中的参数标记不对应,或者指定的长度小于零。
SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法

Since:

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 一个对象,其中包含要设置参数值的数据。

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误,如果 parameterIndex 与 SQL 语句中的参数标记不对应,则在关闭的 PreparedStatementor 上调用此方法
SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法

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 发送到服务器

参数:

参数名称 参数描述
parameterName 要设置的参数的名称
reader 一个对象,其中包含要设置参数值的数据。
length 参数数据中的字符数。

Throws:

Throw名称 Throw描述
SQLException 如果 parameterIndex 不对应 SQL 语句中的参数标记; 如果指定的长度小于零; 发生数据库访问错误或在关闭的 CallableStatement 上调用此方法
SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法

Since:

1.6

setClob

void setClob(String parameterName, Clob x) throws SQLException

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

参数:

参数名称 参数描述
parameterName 参数名称
x 映射 SQL CLOB 值的 Clob 对象

Throws:

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

Since:

1.6

setClob

void setClob(String parameterName, Reader reader) throws SQLException

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

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

参数:

参数名称 参数描述
parameterName 参数名称
reader 一个对象,其中包含要设置参数值的数据。

Throws:

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

Since:

1.6

setArray

void setArray(int i, Array x) throws SQLException

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

参数:

参数名称 参数描述
i 第一个参数是1,第二个是2,...
x 表示 SQL 数组的对象

Throws:

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

setDate

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

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

参数:

参数名称 参数描述
parameterIndex 第一个参数是1,第二个是2,...
x 参数值
cal 用于计算日期的 java.util.Calendar 对象

Throws:

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

setDate

void setDate(String parameterName, Date x) throws SQLException

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

参数:

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

Throws:

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

Since:

1.4

setDate

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

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

参数:

参数名称 参数描述
parameterName 参数名称
x 参数值
cal 驱动程序将用于构造日期的 Calendar 对象

Throws:

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

Since:

1.4

setTime

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

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

参数:

参数名称 参数描述
parameterIndex 第一个参数是1,第二个是2,...
x 参数值
cal 用于计算时间的 java.util.Calendar 对象

Throws:

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

setTime

void setTime(String parameterName, Time x) throws SQLException

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

参数:

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

Throws:

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

Since:

1.4

setTime

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

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

参数:

参数名称 参数描述
parameterName 参数名称
x 参数值
cal 驱动程序将用于构造时间的 Calendar 对象

Throws:

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

Since:

1.4

setTimestamp

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

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

参数:

参数名称 参数描述
parameterIndex 第一个参数是1,第二个是2,...
x 参数值
cal 用于计算时间戳的 java.util.Calendar 对象

Throws:

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

setTimestamp

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

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

参数:

参数名称 参数描述
parameterName 参数名称
x 参数值
cal 驱动程序将用于构造时间戳的 Calendar 对象

Throws:

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

Since:

1.4

clearParameters

void clearParameters() throws SQLException

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

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

Throws:

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

execute

void execute() throws SQLException

用数据填充此 RowSet 对象。

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

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

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

Throws:

Throw名称 Throw描述
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 对象

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误,则在关闭的结果集上调用此方法,Java.xml.transform.Result、Writer 或 OutputStream 尚未为 SQLXML 对象关闭,或者在处理 XML 值时出现错误。 异常的 getCause 方法可能会提供更详细的异常,例如,如果流不包含有效的 XML。

Since:

1.6

setSQLXML

void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException

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

参数:

参数名称 参数描述
parameterName 参数名称
xmlObject 映射 SQL XML 值的 SQLXML 对象

Throws:

Throw名称 Throw描述
SQLException 如果发生数据库访问错误,则在关闭的结果集上调用此方法,Java.xml.transform.Result、Writer 或 OutputStream 尚未为 SQLXML 对象关闭,或者在处理 XML 值时出现错误。 异常的 getCause 方法可能会提供更详细的异常,例如,如果流不包含有效的 XML。

Since:

1.6

setRowId

void setRowId(int parameterIndex, RowId x) throws SQLException

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

参数:

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

Throws:

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

Since:

1.6

setRowId

void setRowId(String parameterName, RowId x) throws SQLException

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

参数:

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

Throws:

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

Since:

1.6

setNString

void setNString(int parameterIndex, String value) throws SQLException

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

参数:

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

Throws:

Throw名称 Throw描述
SQLException 如果驱动程序不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 或者如果发生数据库访问错误

Since:

1.6

setNString

void setNString(String parameterName, String value) throws SQLException

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

参数:

参数名称 参数描述
parameterName 要设置的列的名称
value 参数值

Throws:

Throw名称 Throw描述
SQLException 如果驱动程序不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 或者如果发生数据库访问错误

Since:

1.6

setNCharacterStream

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

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

参数:

参数名称 参数描述
parameterIndex 第一个参数是1,第二个是2,...
value 参数值
length 参数数据中的字符数。

Throws:

Throw名称 Throw描述
SQLException 如果驱动程序不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 或者如果发生数据库访问错误

Since:

1.6

setNCharacterStream

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

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

参数:

参数名称 参数描述
parameterName 要设置的列的名称
value 参数值
length 参数数据中的字符数。

Throws:

Throw名称 Throw描述
SQLException 如果驱动程序不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 或者如果发生数据库访问错误

Since:

1.6

setNCharacterStream

void setNCharacterStream(String parameterName, Reader value) throws SQLException

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

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

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

参数:

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

Throws:

Throw名称 Throw描述
SQLException 如果驱动程序不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误; 或者在关闭的 CallableStatement 上调用此方法
SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法

Since:

1.6

setNClob

void setNClob(String parameterName, NClob value) throws SQLException

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

参数:

参数名称 参数描述
parameterName 要设置的列的名称
value 参数值

Throws:

Throw名称 Throw描述
SQLException 如果驱动程序不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 或者如果发生数据库访问错误

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 发送到服务器

参数:

参数名称 参数描述
parameterName 要设置的参数的名称
reader 一个对象,其中包含要设置参数值的数据。
length 参数数据中的字符数。

Throws:

Throw名称 Throw描述
SQLException 如果 parameterIndex 不对应 SQL 语句中的参数标记; 如果指定的长度小于零; 如果驱动程序不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法
SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法

Since:

1.6

setNClob

void setNClob(String parameterName, Reader reader) throws SQLException

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

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

参数:

参数名称 参数描述
parameterName 参数名称
reader 一个对象,其中包含要设置参数值的数据。

Throws:

Throw名称 Throw描述
SQLException 如果驱动程序不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法
SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法

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 发送到服务器

参数:

参数名称 参数描述
parameterIndex 第一个参数的索引是 1,第二个是 2,...
reader 一个对象,其中包含要设置参数值的数据。
length 参数数据中的字符数。

Throws:

Throw名称 Throw描述
SQLException 如果 parameterIndex 不对应 SQL 语句中的参数标记; 如果指定的长度小于零; 如果驱动程序不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误或在关闭的 PreparedStatement 上调用此方法
SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法

Since:

1.6

setNClob

void setNClob(int parameterIndex, NClob value) throws SQLException

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

参数:

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

Throws:

Throw名称 Throw描述
SQLException 如果驱动程序不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 或者如果发生数据库访问错误

Since:

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 一个对象,其中包含要设置参数值的数据。

Throws:

Throw名称 Throw描述
SQLException 如果 parameterIndex 不对应 SQL 语句中的参数标记; 如果驱动程序不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误或在关闭的 PreparedStatement 上调用此方法
SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法

Since:

1.6

setURL

void setURL(int parameterIndex, URL x) throws SQLException

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

参数:

参数名称 参数描述
parameterIndex 第一个参数是1,第二个是2,...
x 要设置的 java.net.URL 对象

Throws:

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

Since:

1.4

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号