模块 java.sql

包 javax.sql

接口 RowSet

所有父级接口：

AutoCloseable , ResultSet , Wrapper

所有已知的子接口：

CachedRowSet , FilteredRowSet , JdbcRowSet , JoinRowSet , SyncResolver , WebRowSet

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

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

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

自从：

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 对象设置的事务隔离级别。
Map<String,Class<?>>	getTypeMap()	检索与此 RowSet 对象关联的 Map 对象，它指定 SQL 用户定义类型的自定义映射（如果有）。
String	getUrl()	检索此 RowSet 对象将用于创建连接的 url 属性（如果它使用 DriverManager 而不是 DataSource 对象来建立连接）。
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 boolean 值。
void	setBoolean(String parameterName, boolean x)	将指定参数设置为给定的 Java boolean 值。
void	setByte(int parameterIndex, byte x)	将此 RowSet 对象命令中的指定参数设置为给定的 Java byte 值。
void	setByte(String parameterName, byte x)	将指定参数设置为给定的 Java byte 值。
void	setBytes(int parameterIndex, byte[] x)	将此 RowSet 对象命令中的指定参数设置为给定的 byte 值 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 对象的数据源名称属性设置为给定的 String。
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 double 值。
void	setDouble(String parameterName, double x)	将指定参数设置为给定的 Java double 值。
void	setEscapeProcessing(boolean enable)	打开或关闭此 RowSet 对象的转义处理。
void	setFloat(int parameterIndex, float x)	将此 RowSet 对象命令中的指定参数设置为给定的 Java float 值。
void	setFloat(String parameterName, float x)	将指定参数设置为给定的 Java float 值。
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 Object 在此 RowSet 对象的命令中设置指定参数。
void	setObject(int parameterIndex, Object x, int targetSqlType)	使用 Java Object 在此 RowSet 对象的命令中设置指定参数。
void	setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength)	使用给定的 Java Object 在此 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 对象的数据库密码设置为给定的 String 。
void	setQueryTimeout(int seconds)	将驱动程序等待语句执行的最长时间设置为给定的秒数。
void	setReadOnly(boolean value)	设置此 RowSet 对象是否对给定的 boolean 只读。
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 short 值。
void	setShort(String parameterName, short x)	将指定参数设置为给定的 Java short 值。
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 String 值。
void	setString(String parameterName, String x)	将指定参数设置为给定的 Java String 值。
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(Map<String,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 对象的用户名属性设置为给定的 String。

在接口 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, 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, 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 SQL异常 
            

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

返回：

一个字符串 url

抛出：

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

参见：

• setUrl(java.lang.String)

setUrl

void setUrl(String  url) throws SQL异常 
            

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

参数：

url - 字符串值；可能是null

抛出：

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

参见：

• getUrl()

getDataSourceName

String  getDataSourceName()
            

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

返回：

数据源名称

参见：

• setDataSourceName(java.lang.String)
• setUrl(java.lang.String)

setDataSourceName

void setDataSourceName(String  name) throws SQL异常 
            

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

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

参数：

name - 此 RowSet 对象的数据源的逻辑名称；可能是null

抛出：

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

参见：

• getDataSourceName()

getUsername

String  getUsername()
            

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

返回：

用户名属性

参见：

• setUsername(java.lang.String)

setUsername

void setUsername(String  name) throws SQL异常 
            

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

参数：

name - 用户名

抛出：

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

参见：

• getUsername()

getPassword

String  getPassword()
            

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

返回：

建立数据库连接的密码

参见：

• setPassword(java.lang.String)

setPassword

void setPassword(String  password) throws SQL异常 
            

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

参数：

password - 密码字符串

抛出：

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

参见：

• getPassword()

getTransactionIsolation

int getTransactionIsolation()
            

检索为此 RowSet 对象设置的事务隔离级别。

返回：

事务隔离级别； Connection.TRANSACTION_READ_UNCOMMITTED、Connection.TRANSACTION_READ_COMMITTED、Connection.TRANSACTION_REPEATABLE_READ 或 Connection.TRANSACTION_SERIALIZABLE 之一

参见：

• setTransactionIsolation(int)

setTransactionIsolation

void setTransactionIsolation(int level) throws SQL异常 
            

为此 RowSet 对象设置事务隔离级别。

参数：

level - 事务隔离级别； Connection.TRANSACTION_READ_UNCOMMITTED、Connection.TRANSACTION_READ_COMMITTED、Connection.TRANSACTION_REPEATABLE_READ 或 Connection.TRANSACTION_SERIALIZABLE 之一

抛出：

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

参见：

• getTransactionIsolation()

getTypeMap

Map <String ,Class <?>> getTypeMap() throws SQL异常 
            

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

返回：

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

抛出：

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

参见：

• setTypeMap(java.util.Map<java.lang.String, java.lang.Class<?>>)

setTypeMap

void setTypeMap(Map <String ,Class <?>> map) throws SQL异常 
            

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

参数：

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

抛出：

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

参见：

• getTypeMap()

getCommand

String  getCommand()
            

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

返回：

命令字符串；可能是null

参见：

• setCommand(java.lang.String)

setCommand

void setCommand(String  cmd) throws SQL异常 
            

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

参数：

cmd - 将用于获取此 RowSet 对象的数据的 SQL 查询；可能是null

抛出：

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

参见：

• getCommand()

isReadOnly

boolean isReadOnly()
            

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

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

返回：

true 如果这个 RowSet 对象是只读的； false 如果它是可更新的

参见：

• setReadOnly(boolean)

setReadOnly

void setReadOnly(boolean value) throws SQL异常 
            

设置此 RowSet 对象是否对给定的 boolean 只读。

参数：

value - true 如果只读； false 如果可更新

抛出：

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

参见：

• isReadOnly()

getMaxFieldSize

int getMaxFieldSize() throws SQL异常 
            

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

返回：

当前的最大列大小限制；零意味着没有限制

抛出：

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

参见：

• setMaxFieldSize(int)

setMaxFieldSize

void setMaxFieldSize(int max) throws SQL异常 
            

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

参数：

max - 新的最大列大小限制（以字节为单位）；零意味着无限

抛出：

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

参见：

• getMaxFieldSize()

getMaxRows

int getMaxRows() throws SQL异常 
            

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

返回：

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

抛出：

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

参见：

• setMaxRows(int)

setMaxRows

void setMaxRows(int max) throws SQL异常 
            

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

参数：

max - 新的最大行数；零意味着无限

抛出：

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

参见：

• getMaxRows()

getEscapeProcessing

boolean getEscapeProcessing() throws SQL异常 
            

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

返回：

true 如果启用转义处理； false 如果它被禁用

抛出：

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

参见：

• setEscapeProcessing(boolean)

setEscapeProcessing

void setEscapeProcessing(boolean enable) throws SQL异常 
            

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

参数：

enable - true 启用转义处理； false 禁用它

抛出：

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

参见：

• getEscapeProcessing()

getQueryTimeout

int getQueryTimeout() throws SQL异常 
            

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

返回：

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

抛出：

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

参见：

• setQueryTimeout(int)

setQueryTimeout

void setQueryTimeout(int seconds) throws SQL异常 
            

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

参数：

seconds - 以秒为单位的新查询超时限制；零意味着没有限制

抛出：

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

参见：

• getQueryTimeout()

setType

void setType(int type) throws SQL异常 
            

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

参数：

type - 指定类型的 ResultSet 常量之一：ResultSet.TYPE_FORWARD_ONLY、ResultSet.TYPE_SCROLL_INSENSITIVE 或 ResultSet.TYPE_SCROLL_SENSITIVE

抛出：

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

参见：

• ResultSet.getType()

setConcurrency

void setConcurrency(int concurrency) throws SQL异常 
            

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

参数：

concurrency - 指定并发级别的 ResultSet 常量之一：ResultSet.CONCUR_READ_ONLY 或 ResultSet.CONCUR_UPDATABLE

抛出：

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

参见：

• ResultSet.getConcurrency()

setNull

void setNull(int parameterIndex, int sqlType) throws SQL异常 
            

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

笔记：您必须指定参数的 SQL 类型。

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

sqlType - 由 java.sql.Types 定义的 SQL 类型代码

抛出：

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

setNull

void setNull(String  parameterName, int sqlType) throws SQL异常 
            

将指定参数设置为 SQL NULL。

笔记：您必须指定参数的 SQL 类型。

参数：

parameterName - 参数名称

sqlType - java.sql.Types 中定义的 SQL 类型代码

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

setNull

void setNull(int paramIndex, int sqlType, String  typeName) throws SQL异常 
            

将此 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 类型则忽略

抛出：

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

setNull

void setNull(String  parameterName, int sqlType, String  typeName) throws SQL异常 
            

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

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

参数：

parameterName - 参数名称

sqlType - 来自 java.sql.Types 的值

typeName - SQL 用户定义类型的完全限定名称；如果参数不是用户定义的类型或 SQL REF 值，则忽略

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

setBoolean

void setBoolean(int parameterIndex, boolean x) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 参数值

抛出：

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

setBoolean

void setBoolean(String  parameterName, boolean x) throws SQL异常 
            

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

参数：

parameterName - 参数名称

x - 参数值

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

参见：

• ResultSet.getBoolean(int)

setByte

void setByte(int parameterIndex, byte x) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 参数值

抛出：

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

setByte

void setByte(String  parameterName, byte x) throws SQL异常 
            

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

参数：

parameterName - 参数名称

x - 参数值

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

参见：

• ResultSet.getByte(int)

setShort

void setShort(int parameterIndex, short x) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 参数值

抛出：

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

setShort

void setShort(String  parameterName, short x) throws SQL异常 
            

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

参数：

parameterName - 参数名称

x - 参数值

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

参见：

• ResultSet.getShort(int)

setInt

void setInt(int parameterIndex, int x) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 参数值

抛出：

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

setInt

void setInt(String  parameterName, int x) throws SQL异常 
            

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

参数：

parameterName - 参数名称

x - 参数值

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

参见：

• ResultSet.getInt(int)

setLong

void setLong(int parameterIndex, long x) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 参数值

抛出：

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

setLong

void setLong(String  parameterName, long x) throws SQL异常 
            

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

参数：

parameterName - 参数名称

x - 参数值

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

参见：

• ResultSet.getLong(int)

setFloat

void setFloat(int parameterIndex, float x) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 参数值

抛出：

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

setFloat

void setFloat(String  parameterName, float x) throws SQL异常 
            

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

参数：

parameterName - 参数名称

x - 参数值

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

参见：

• ResultSet.getFloat(int)

setDouble

void setDouble(int parameterIndex, double x) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 参数值

抛出：

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

setDouble

void setDouble(String  parameterName, double x) throws SQL异常 
            

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

参数：

parameterName - 参数名称

x - 参数值

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

参见：

• ResultSet.getDouble(int)

setBigDecimal

void setBigDecimal(int parameterIndex, BigDecimal  x) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 参数值

抛出：

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

setBigDecimal

void setBigDecimal(String  parameterName, BigDecimal  x) throws SQL异常 
            

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

参数：

parameterName - 参数名称

x - 参数值

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

参见：

• ResultSet.getBigDecimal(int, int)

setString

void setString(int parameterIndex, String  x) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 参数值

抛出：

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

setString

void setString(String  parameterName, String  x) throws SQL异常 
            

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

参数：

parameterName - 参数名称

x - 参数值

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

参见：

• ResultSet.getString(int)

setBytes

void setBytes(int parameterIndex, byte[] x) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 参数值

抛出：

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

setBytes

void setBytes(String  parameterName, byte[] x) throws SQL异常 
            

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

参数：

parameterName - 参数名称

x - 参数值

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

参见：

• ResultSet.getBytes(int)

setDate

void setDate(int parameterIndex, Date  x) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 参数值

抛出：

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

setTime

void setTime(int parameterIndex, Time  x) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 参数值

抛出：

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

setTimestamp

void setTimestamp(int parameterIndex, Timestamp  x) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 参数值

抛出：

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

setTimestamp

void setTimestamp(String  parameterName, Timestamp  x) throws SQL异常 
            

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

参数：

parameterName - 参数名称

x - 参数值

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

参见：

• ResultSet.getTimestamp(int)

setAsciiStream

void setAsciiStream(int parameterIndex, InputStream  x, int length) throws SQL异常 
            

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

笔记：此流对象可以是标准 Java 流对象，也可以是您自己实现标准接口的子类。

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 包含 ASCII 参数值的 Java 输入流

length - 流中的字节数

抛出：

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

setAsciiStream

void setAsciiStream(String  parameterName, InputStream  x, int length) throws SQL异常 
            

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

笔记：此流对象可以是标准 Java 流对象，也可以是您自己实现标准接口的子类。

参数：

parameterName - 参数名称

x - 包含 ASCII 参数值的 Java 输入流

length - 流中的字节数

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

setBinaryStream

void setBinaryStream(int parameterIndex, InputStream  x, int length) throws SQL异常 
            

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

笔记：此流对象可以是标准 Java 流对象，也可以是您自己实现标准接口的子类。

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 包含二进制参数值的 java 输入流

length - 流中的字节数

抛出：

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

setBinaryStream

void setBinaryStream(String  parameterName, InputStream  x, int length) throws SQL异常 
            

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

笔记：此流对象可以是标准 Java 流对象，也可以是您自己实现标准接口的子类。

参数：

parameterName - 参数名称

x - 包含二进制参数值的 java 输入流

length - 流中的字节数

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

setCharacterStream

void setCharacterStream(int parameterIndex, Reader  reader, int length) throws SQL异常 
            

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

笔记：此流对象可以是标准 Java 流对象，也可以是您自己实现标准接口的子类。

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

reader - 包含要设置的 UNICODE 数据的 Reader 对象

length - 流中的字符数

抛出：

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

setCharacterStream

void setCharacterStream(String  parameterName, Reader  reader, int length) throws SQL异常 
            

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

笔记：此流对象可以是标准 Java 流对象，也可以是您自己实现标准接口的子类。

参数：

parameterName - 参数名称

reader - 包含用作指定参数的 UNICODE 数据的 java.io.Reader 对象

length - 流中的字符数

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

setAsciiStream

void setAsciiStream(int parameterIndex, InputStream  x) throws SQL异常 
            

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

笔记：此流对象可以是标准 Java 流对象，也可以是您自己实现标准接口的子类。

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 包含 ASCII 参数值的 Java 输入流

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 PreparedStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setAsciiStream

void setAsciiStream(String  parameterName, InputStream  x) throws SQL异常 
            

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

笔记：此流对象可以是标准 Java 流对象，也可以是您自己实现标准接口的子类。

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

参数：

parameterName - 参数名称

x - 包含 ASCII 参数值的 Java 输入流

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setBinaryStream

void setBinaryStream(int parameterIndex, InputStream  x) throws SQL异常 
            

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

笔记：此流对象可以是标准 Java 流对象，也可以是您自己实现标准接口的子类。

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 包含二进制参数值的 java 输入流

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 PreparedStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setBinaryStream

void setBinaryStream(String  parameterName, InputStream  x) throws SQL异常 
            

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

笔记：此流对象可以是标准 Java 流对象，也可以是您自己实现标准接口的子类。

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

参数：

parameterName - 参数名称

x - 包含二进制参数值的 java 输入流

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setCharacterStream

void setCharacterStream(int parameterIndex, Reader  reader) throws SQL异常 
            

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

笔记：此流对象可以是标准 Java 流对象，也可以是您自己实现标准接口的子类。

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

reader - 包含 Unicode 数据的 java.io.Reader 对象

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 PreparedStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setCharacterStream

void setCharacterStream(String  parameterName, Reader  reader) throws SQL异常 
            

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

笔记：此流对象可以是标准 Java 流对象，也可以是您自己实现标准接口的子类。

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

参数：

parameterName - 参数名称

reader - 包含 Unicode 数据的 java.io.Reader 对象

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setNCharacterStream

void setNCharacterStream(int parameterIndex, Reader  value) throws SQL异常 
            

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

笔记：此流对象可以是标准 Java 流对象，也可以是您自己实现标准接口的子类。

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

value - 参数值

抛出：

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

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setObject

void setObject(int parameterIndex, Object  x, int targetSqlType, int scaleOrLength) throws SQL异常 
            

使用给定的 Java Object 在此 RowSet 对象的命令中设置指定参数。对于整数值，应使用 java.lang 等效对象（例如，类 Integer 的实例用于 int ）。如果第二个参数是 InputStream，则流必须包含由 scaleOrLength 指定的字节数。如果第二个参数是 Reader，则 Reader 必须包含 scaleOrLength 指定的字符数。如果这些条件不成立，驱动程序将在执行准备好的语句时生成SQLException。

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

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

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 包含输入参数值的对象

targetSqlType - 要发送到数据库的 SQL 类型（在 java.sql.Types 中定义）。 scale 参数可以进一步限定这种类型。

scaleOrLength - 对于 java.sql.Types.DECIMAL 或 java.sql.Types.NUMERIC types ，这是小数点后的位数。对于 Java 对象类型 InputStream 和 Reader，这是流中数据的长度或 Reader。对于所有其他类型，此值将被忽略。

抛出：

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

参见：

• Types

setObject

void setObject(String  parameterName, Object  x, int targetSqlType, int scale) throws SQL异常 
            

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

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

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

参数：

parameterName - 参数名称

x - 包含输入参数值的对象

targetSqlType - 要发送到数据库的 SQL 类型（在 java.sql.Types 中定义）。 scale 参数可以进一步限定这种类型。

scale - 对于 java.sql.Types.DECIMAL 或 java.sql.Types.NUMERIC 类型，这是小数点后的位数。对于所有其他类型，此值将被忽略。

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 targetSqlType 是 ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR , REF , ROWID , SQLXML 或 STRUCT 数据类型并且 JDBC 驱动程序不支持此数据类型

自从：

1.4

参见：

• Types
• ResultSet.getObject(int)

setObject

void setObject(int parameterIndex, Object  x, int targetSqlType) throws SQL异常 
            

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

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 包含输入参数值的对象

targetSqlType - 要发送到数据库的 SQL 类型（在 java.sql.Types 中定义）

抛出：

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

setObject

void setObject(String  parameterName, Object  x, int targetSqlType) throws SQL异常 
            

使用给定对象设置指定参数的值。此方法与上面的方法setObject 类似，只是它假定比例为零。

参数：

parameterName - 参数名称

x - 包含输入参数值的对象

targetSqlType - 要发送到数据库的 SQL 类型（在 java.sql.Types 中定义）

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 targetSqlType 是 ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR , REF , ROWID , SQLXML 或 STRUCT 数据类型并且 JDBC 驱动程序不支持此数据类型

自从：

1.4

参见：

• ResultSet.getObject(int)

setObject

void setObject(String  parameterName, Object  x) throws SQL异常 
            

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

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

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

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

参数：

parameterName - 参数名称

x - 包含输入参数值的对象

抛出：

SQLException - 如果发生数据库访问错误，则在关闭的 CallableStatement 上调用此方法，或者如果给定的 Object 参数不明确

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

参见：

• ResultSet.getObject(int)

setObject

void setObject(int parameterIndex, Object  x) throws SQL异常 
            

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

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

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

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 包含输入参数值的对象

抛出：

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

setRef

void setRef(int i, Ref  x) throws SQL异常 
            

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

参数：

i - 第一个参数是 1，第二个是 2，...

x - 表示 SQL REF 类型数据的对象

抛出：

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

setBlob

void setBlob(int i, Blob  x) throws SQL异常 
            

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

参数：

i - 第一个参数是 1，第二个是 2，...

x - 表示 BLOB 的对象

抛出：

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

setBlob

void setBlob(int parameterIndex, InputStream  inputStream, long length) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数的索引是 1，第二个是 2，...

inputStream - 包含要将参数值设置到的数据的对象。

length - 参数数据中的字节数。

抛出：

SQLException - 如果发生数据库访问错误，则在关闭的 PreparedStatement 上调用此方法，如果 parameterIndex 不对应于 SQL 语句中的参数标记，如果指定的长度小于零或 InputStream 中的字节数确实如此与指定的长度不匹配。

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setBlob

void setBlob(int parameterIndex, InputStream  inputStream) throws SQL异常 
            

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

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

参数：

parameterIndex - 第一个参数的索引是 1，第二个是 2，...

inputStream - 包含要将参数值设置到的数据的对象。

抛出：

SQLException - 如果发生数据库访问错误，则在关闭的 PreparedStatement 上调用此方法，或者如果 parameterIndex 不对应于 SQL 语句中的参数标记，

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setBlob

void setBlob(String  parameterName, InputStream  inputStream, long length) throws SQL异常 
            

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

参数：

parameterName - 第二个要设置的参数名称是 2，...

inputStream - 包含要将参数值设置到的数据的对象。

length - 参数数据中的字节数。

抛出：

SQLException - 如果 parameterIndex 不对应于 SQL 语句中的参数标记，或者指定的长度小于零；如果 InputStream 中的字节数与指定长度不匹配；如果发生数据库访问错误或在关闭的CallableStatement上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setBlob

void setBlob(String  parameterName, Blob  x) throws SQL异常 
            

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

参数：

parameterName - 参数名称

x - 映射 SQL BLOB 值的 Blob 对象

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setBlob

void setBlob(String  parameterName, InputStream  inputStream) throws SQL异常 
            

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

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

参数：

parameterName - 参数名称

inputStream - 包含要将参数值设置到的数据的对象。

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setClob

void setClob(int i, Clob  x) throws SQL异常 
            

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

参数：

i - 第一个参数是 1，第二个是 2，...

x - 表示 CLOB 的对象

抛出：

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

setClob

void setClob(int parameterIndex, Reader  reader, long length) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数的索引是 1，第二个是 2，...

reader - 包含要将参数值设置到的数据的对象。

length - 参数数据中的字符数。

抛出：

SQLException - 如果发生数据库访问错误，则在关闭的 PreparedStatement 上调用此方法，如果 parameterIndex 不对应于 SQL 语句中的参数标记，或者如果指定的长度小于零。

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setClob

void setClob(int parameterIndex, Reader  reader) throws SQL异常 
            

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

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

参数：

parameterIndex - 第一个参数的索引是 1，第二个是 2，...

reader - 包含要将参数值设置到的数据的对象。

抛出：

SQLException - 如果发生数据库访问错误，则在关闭的 PreparedStatement 上调用此方法，或者如果 parameterIndex 不对应于 SQL 语句中的参数标记

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setClob

void setClob(String  parameterName, Reader  reader, long length) throws SQL异常 
            

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

参数：

parameterName - 要设置的参数名称

reader - 包含要将参数值设置到的数据的对象。

length - 参数数据中的字符数。

抛出：

SQLException - 如果 parameterIndex 不对应于 SQL 语句中的参数标记；如果指定的长度小于零；发生数据库访问错误或在关闭的CallableStatement上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setClob

void setClob(String  parameterName, Clob  x) throws SQL异常 
            

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

参数：

parameterName - 参数名称

x - 映射 SQL CLOB 值的 Clob 对象

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setClob

void setClob(String  parameterName, Reader  reader) throws SQL异常 
            

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

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

参数：

parameterName - 参数名称

reader - 包含要将参数值设置到的数据的对象。

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setArray

void setArray(int i, Array  x) throws SQL异常 
            

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

参数：

i - 第一个参数是 1，第二个是 2，...

x - 表示 SQL 数组的对象

抛出：

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

setDate

void setDate(int parameterIndex, Date  x, Calendar  cal) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 参数值

cal - 用于计算日期的 java.util.Calendar 对象

抛出：

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

setDate

void setDate(String  parameterName, Date  x) throws SQL异常 
            

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

参数：

parameterName - 参数名称

x - 参数值

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

参见：

• ResultSet.getDate(int)

setDate

void setDate(String  parameterName, Date  x, Calendar  cal) throws SQL异常 
            

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

参数：

parameterName - 参数名称

x - 参数值

cal - 驱动程序将用于构建日期的 Calendar 对象

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

参见：

• ResultSet.getDate(int)

setTime

void setTime(int parameterIndex, Time  x, Calendar  cal) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 参数值

cal - 用于计算时间的 java.util.Calendar 对象

抛出：

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

setTime

void setTime(String  parameterName, Time  x) throws SQL异常 
            

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

参数：

parameterName - 参数名称

x - 参数值

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

参见：

• ResultSet.getTime(int)

setTime

void setTime(String  parameterName, Time  x, Calendar  cal) throws SQL异常 
            

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

参数：

parameterName - 参数名称

x - 参数值

cal - 驱动程序将用于构建时间的 Calendar 对象

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

参见：

• ResultSet.getTime(int)

setTimestamp

void setTimestamp(int parameterIndex, Timestamp  x, Calendar  cal) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 参数值

cal - 用于计算时间戳的 java.util.Calendar 对象

抛出：

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

setTimestamp

void setTimestamp(String  parameterName, Timestamp  x, Calendar  cal) throws SQL异常 
            

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

参数：

parameterName - 参数名称

x - 参数值

cal - 驱动程序将用于构建时间戳的 Calendar 对象

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 CallableStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4

参见：

• ResultSet.getTimestamp(int)

clearParameters

void clearParameters() throws SQL异常 
            

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

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

抛出：

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

execute

void execute() throws SQL异常 
            

用数据填充这个 RowSet 对象。

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

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

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

抛出：

SQLException - 如果发生数据库访问错误或未设置建立连接和创建语句所需的任何属性

addRowSetListener

void addRowSetListener(RowSetListener  listener)
            

注册给定的监听器，以便它会收到此 RowSet 对象上发生的事件的通知。

参数：

listener - 已实现 RowSetListener 接口并希望在此 RowSet 对象上发生事件时得到通知的组件

参见：

• removeRowSetListener(javax.sql.RowSetListener)

removeRowSetListener

void removeRowSetListener(RowSetListener  listener)
            

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

参数：

listener - 已注册为此 RowSet 对象的监听器的组件

参见：

• addRowSetListener(javax.sql.RowSetListener)

setSQLXML

void setSQLXML(int parameterIndex, SQLXML  xmlObject) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数的索引是 1，第二个是 2，...

xmlObject - 映射 SQL XML 值的 SQLXML 对象

抛出：

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

自从：

1.6

setSQLXML

void setSQLXML(String  parameterName, SQLXML  xmlObject) throws SQL异常 
            

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

参数：

parameterName - 参数名称

xmlObject - 映射 SQL XML 值的 SQLXML 对象

抛出：

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

自从：

1.6

setRowId

void setRowId(int parameterIndex, RowId  x) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 参数值

抛出：

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

自从：

1.6

setRowId

void setRowId(String  parameterName, RowId  x) throws SQL异常 
            

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

参数：

parameterName - 参数名称

x - 参数值

抛出：

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

自从：

1.6

setNString

void setNString(int parameterIndex, String  value) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

value - 参数值

抛出：

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

自从：

1.6

setNString

void setNString(String  parameterName, String  value) throws SQL异常 
            

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

参数：

parameterName - 要设置的列的名称

value - 参数值

抛出：

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

自从：

1.6

setNCharacterStream

void setNCharacterStream(int parameterIndex, Reader  value, long length) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

value - 参数值

length - 参数数据中的字符数。

抛出：

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

自从：

1.6

setNCharacterStream

void setNCharacterStream(String  parameterName, Reader  value, long length) throws SQL异常 
            

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

参数：

parameterName - 要设置的列的名称

value - 参数值

length - 参数数据中的字符数。

抛出：

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

自从：

1.6

setNCharacterStream

void setNCharacterStream(String  parameterName, Reader  value) throws SQL异常 
            

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

笔记：此流对象可以是标准 Java 流对象，也可以是您自己实现标准接口的子类。

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

参数：

parameterName - 参数名称

value - 参数值

抛出：

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

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setNClob

void setNClob(String  parameterName, NClob  value) throws SQL异常 
            

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

参数：

parameterName - 要设置的列的名称

value - 参数值

抛出：

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

自从：

1.6

setNClob

void setNClob(String  parameterName, Reader  reader, long length) throws SQL异常 
            

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

参数：

parameterName - 要设置的参数名称

reader - 包含要将参数值设置到的数据的对象。

length - 参数数据中的字符数。

抛出：

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

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setNClob

void setNClob(String  parameterName, Reader  reader) throws SQL异常 
            

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

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

参数：

parameterName - 参数名称

reader - 包含要将参数值设置到的数据的对象。

抛出：

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

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setNClob

void setNClob(int parameterIndex, Reader  reader, long length) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数的索引是 1，第二个是 2，...

reader - 包含要将参数值设置到的数据的对象。

length - 参数数据中的字符数。

抛出：

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

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setNClob

void setNClob(int parameterIndex, NClob  value) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

value - 参数值

抛出：

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

自从：

1.6

setNClob

void setNClob(int parameterIndex, Reader  reader) throws SQL异常 
            

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

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

参数：

parameterIndex - 第一个参数的索引是 1，第二个是 2，...

reader - 包含要将参数值设置到的数据的对象。

抛出：

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

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.6

setURL

void setURL(int parameterIndex, URL  x) throws SQL异常 
            

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

参数：

parameterIndex - 第一个参数是 1，第二个是 2，...

x - 要设置的 java.net.URL 对象

抛出：

SQLException - 如果发生数据库访问错误或在关闭的 PreparedStatement 上调用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法

自从：

1.4