-
- All Superinterfaces:
-
AutoCloseable
,ResultSet
,Wrapper
- All Known Subinterfaces:
-
CachedRowSet
,FilteredRowSet
,JdbcRowSet
,JoinRowSet
,SyncResolver
,WebRowSet
public interface RowSet extends ResultSet
为JavaBeans™组件模型添加JDBC API支持的接口。 可以在可视Bean开发环境中用作JavaBeans组件的行集可以在设计时创建和配置,并在运行时执行。RowSet
接口提供了一组JavaBeans属性,这些属性允许将RowSet
实例配置为连接到JDBC数据源并从数据源读取一些数据。 A组的设置方法(setInt
,setBytes
,setString
,等)提供了一种方式来传递输入参数行集的命令属性。 此命令是行集从关系数据库获取数据时使用的SQL查询,通常就是这种情况。RowSet
接口支持JavaBeans事件,允许RowSet
集上发生事件时通知应用程序中的其他组件,例如其值的更改。RowSet
接口的独特之处在于它旨在使用其余的JDBC API实现。 换句话说,RowSet
实现是一个在JDBC驱动程序“顶部”执行的软件层。 任何人都可以提供RowSet
接口的实现,包括希望提供RowSet
实现作为其JDBC产品的一部分的JDBC驱动程序供应商。RowSet
对象可以与数据源建立连接,并在整个生命周期内维护该连接,在这种情况下,它被称为连接的行集。 行集还可以与数据源建立连接,从中获取数据,然后关闭连接。 这样的行集称为断开连接的行集。 断开连接的行集可能会在断开连接时对其数据进行更改,然后将更改发送回原始数据源,但必须重新建立连接才能执行此操作。断开连接的行集可以具有
Reader
(RowSetReader
对象)和与其关联的写入器(RowSetWriter
对象)。Reader
可以以许多不同的方式实现,以用数据填充行集,包括从非关系数据源获取数据。 编写器还可以以许多不同的方式实现,以将对行集数据所做的更改传播回底层数据源。行集易于使用。
RowSet
接口扩展了标准java.sql.ResultSet
接口。RowSetMetaData
接口扩展了java.sql.ResultSetMetaData
接口。 因此,熟悉JDBC API的开发人员必须学习使用行集的最少数量的新API。 此外,还可以轻松地使用与JDBCResultSet
对象一起使用的第三方软件工具来处理行集。- 从以下版本开始:
- 1.4
-
-
字段汇总
-
Fields declared in interface 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,类<?>>
getTypeMap()
检索与此Map
对象关联的RowSet
对象,该对象指定SQL用户定义类型的自定义映射(如果有)。String
getUrl()
如果它使用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
对象命令中的指定参数设置为给定的Javaboolean
值。void
setBoolean(String parameterName, boolean x)
将指定参数设置为给定的Javaboolean
值。void
setByte(int parameterIndex, byte x)
将此RowSet
对象命令中的指定参数设置为给定的Javabyte
值。void
setByte(String parameterName, byte x)
将指定参数设置为给定的Javabyte
值。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
对象命令中的指定参数设置为给定的Javadouble
值。void
setDouble(String parameterName, double x)
将指定参数设置为给定的Javadouble
值。void
setEscapeProcessing(boolean enable)
打开或关闭此RowSet
对象的转义处理。void
setFloat(int parameterIndex, float x)
将此RowSet
对象命令中的指定参数设置为给定的Javafloat
值。void
setFloat(String parameterName, float x)
将指定参数设置为给定的Javafloat
值。void
setInt(int parameterIndex, int x)
将此RowSet
对象命令中的指定参数设置为给定的Javaint
值。void
setInt(String parameterName, int x)
将指定参数设置为给定的Javaint
值。void
setLong(int parameterIndex, long x)
将此RowSet
对象命令中的指定参数设置为给定的Javalong
值。void
setLong(String parameterName, long x)
将指定参数设置为给定的Javalong
值。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命令中的指定参数设置为SQLNULL
。void
setNull(int paramIndex, int sqlType, String typeName)
将此RowSet
对象的SQL命令中的指定参数设置为SQLNULL
。void
setNull(String parameterName, int sqlType)
将指定参数设置为SQLNULL
。void
setNull(String parameterName, int sqlType, String typeName)
将指定的参数设置为SQLNULL
。void
setObject(int parameterIndex, Object x)
使用JavaObject
在此RowSet
对象的命令中设置指定参数。void
setObject(int parameterIndex, Object x, int targetSqlType)
使用JavaObject
在此RowSet
对象的命令中设置指定参数。void
setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength)
使用给定的JavaObject
设置此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
对象命令中的指定参数设置为给定的Javashort
值。void
setShort(String parameterName, short x)
将指定参数设置为给定的Javashort
值。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
对象命令中的指定参数设置为给定的JavaString
值。void
setString(String parameterName, String x)
将指定参数设置为给定的JavaString
值。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,类<?>> 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
对象的username属性设置为给定的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 SQLException
如果它使用DriverManager
而不是DataSource
对象来建立连接,则检索此RowSet
对象将用于创建连接的url属性。 默认值为null
。- 结果
- 一个字符串网址
- 异常
-
SQLException
- 如果发生数据库访问错误 - 另请参见:
-
setUrl(java.lang.String)
-
setUrl
void setUrl(String url) throws SQLException
设置RowSet
对象在使用DriverManager
创建连接时将使用的URL。 设置此属性是可选的。 如果使用URL,则必须先加载接受URL的JDBC驱动程序,然后才能使用行集连接到数据库。 在读取或写入数据时,行集将在内部使用URL来创建数据库连接。 URL或数据源名称用于创建连接,最近设置为非null值。- 参数
-
url
- 字符串值; 可能是null
- 异常
-
SQLException
- 如果发生数据库访问错误 - 另请参见:
-
getUrl()
-
getDataSourceName
String getDataSourceName()
检索标识此RowSet
对象的数据源的逻辑名称。- 结果
- 数据源名称
- 另请参见:
-
setDataSourceName(java.lang.String)
,setUrl(java.lang.String)
-
setDataSourceName
void setDataSourceName(String name) throws SQLException
将此RowSet
对象的数据源名称属性设置为给定的String
。数据源名称属性的值可用于查找已使用命名服务注册的
DataSource
对象。 检索后,DataSource
对象可用于创建与其表示的数据源的连接。- 参数
-
name
- 此RowSet
对象的数据源的逻辑名称; 可能是null
- 异常
-
SQLException
- 如果发生数据库访问错误 - 另请参见:
-
getDataSourceName()
-
getUsername
String getUsername()
检索用于为此RowSet
对象创建数据库连接的用户名。 在调用方法execute
之前,在运行时设置username属性。 它通常不是RowSet
对象的序列化状态的一部分。- 结果
- 用户名属性
- 另请参见:
-
setUsername(java.lang.String)
-
setUsername
void setUsername(String name) throws SQLException
将此RowSet
对象的username属性设置为给定的String
。- 参数
-
name
- 用户名 - 异常
-
SQLException
- 如果发生数据库访问错误 - 另请参见:
-
getUsername()
-
getPassword
String getPassword()
检索用于创建数据库连接的密码。 在调用方法execute
之前,在运行时设置password属性。 它通常不是RowSet
对象的序列化状态的一部分。- 结果
- 用于建立数据库连接的密码
- 另请参见:
-
setPassword(java.lang.String)
-
setPassword
void setPassword(String password) throws SQLException
将此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 SQLException
设置此RowSet
对象的事务隔离级别。- 参数
-
level
- 事务隔离级别; 之一Connection.TRANSACTION_READ_UNCOMMITTED
,Connection.TRANSACTION_READ_COMMITTED
,Connection.TRANSACTION_REPEATABLE_READ
,或Connection.TRANSACTION_SERIALIZABLE
- 异常
-
SQLException
- 如果发生数据库访问错误 - 另请参见:
-
getTransactionIsolation()
-
getTypeMap
Map<String,类<?>> getTypeMap() throws SQLException
检索与此Map
对象关联的RowSet
对象,该对象指定SQL用户定义类型的自定义映射(如果有)。 默认情况下,类型映射为空。- 结果
-
java.util.Map
对象,包含SQL用户定义类型的名称以及要将其映射到的Java类 - 异常
-
SQLException
- 如果发生数据库访问错误 - 另请参见:
-
setTypeMap(java.util.Map<java.lang.String, java.lang.Class<?>>)
-
setTypeMap
void setTypeMap(Map<String,类<?>> map) throws SQLException
安装给定的java.util.Map
对象的默认类型映射此RowSet
对象。 除非提供另一个类型映射作为方法参数,否则将使用此类型映射。- 参数
-
map
- 一个java.util.Map
对象,包含SQL用户定义类型的名称以及要将其映射到的Java类 - 异常
-
SQLException
- 如果发生数据库访问错误 - 另请参见:
-
getTypeMap()
-
getCommand
String getCommand()
检索此RowSet
对象的命令属性。 command属性包含一个命令字符串,该字符串必须是SQL查询,可以执行该命令字符串以使用数据填充行集。 默认值为null
。- 结果
-
命令字符串;
可能是
null
- 另请参见:
-
setCommand(java.lang.String)
-
setCommand
void setCommand(String cmd) throws SQLException
将此RowSet
对象的命令属性设置为给定的SQL查询。 当行集从不支持命令的数据源(如电子表格)获取其数据时,此属性是可选的。- 参数
-
cmd
- 将用于获取此RowSet
对象的数据的SQL查询; 可能是null
- 异常
-
SQLException
- 如果发生数据库访问错误 - 另请参见:
-
getCommand()
-
isReadOnly
boolean isReadOnly()
检索此RowSet
对象是否为只读。 如果可以进行更新,则默认情况下,行集可以更新。尝试更新只读行集将导致抛出
SQLException
。- 结果
-
true
如果此RowSet
对象是只读的;false
如果可以更新 - 另请参见:
-
setReadOnly(boolean)
-
setReadOnly
void setReadOnly(boolean value) throws SQLException
设置此RowSet
对象是否对给定的boolean
是只读的。- 参数
-
value
-true
如果只读;false
如果可以更新 - 异常
-
SQLException
- 如果发生数据库访问错误 - 另请参见:
-
isReadOnly()
-
getMaxFieldSize
int getMaxFieldSize() throws SQLException
检索可能为某些列值返回的最大字节数。 此限制仅适用于BINARY
,VARBINARY
,LONGVARBINARYBINARY
,CHAR
,VARCHAR
,LONGVARCHAR
,NCHAR
个NVARCHAR
列。 如果超出限制,则会以静默方式丢弃多余的数据。- 结果
- 当前最大列大小限制; 零意味着没有限制
- 异常
-
SQLException
- 如果发生数据库访问错误 - 另请参见:
-
setMaxFieldSize(int)
-
setMaxFieldSize
void setMaxFieldSize(int max) throws SQLException
将可以为列值返回的最大字节数设置为给定的字节数。 此限制仅适用于BINARY
,VARBINARY
,LONGVARBINARYBINARY
,CHAR
,VARCHAR
,LONGVARCHAR
,NCHAR
个NVARCHAR
列。 如果超出限制,则会以静默方式丢弃多余的数据。 为获得最大的可移植性,请使用大于256的值。- 参数
-
max
- 新的最大列大小限制(以字节为单位); 零意味着无限 - 异常
-
SQLException
- 如果发生数据库访问错误 - 另请参见:
-
getMaxFieldSize()
-
getMaxRows
int getMaxRows() throws SQLException
检索此RowSet
对象可包含的最大行数。 如果超出限制,则会以静默方式删除多余的行。- 结果
-
此
RowSet
对象可包含的当前最大行数; 零意味着无限 - 异常
-
SQLException
- 如果发生数据库访问错误 - 另请参见:
-
setMaxRows(int)
-
setMaxRows
void setMaxRows(int max) throws SQLException
将此RowSet
对象可包含的最大行数设置为指定的数字。 如果超出限制,则会以静默方式删除多余的行。- 参数
-
max
- 新的最大行数; 零意味着无限 - 异常
-
SQLException
- 如果发生数据库访问错误 - 另请参见:
-
getMaxRows()
-
getEscapeProcessing
boolean getEscapeProcessing() throws SQLException
检索是否为此RowSet
对象启用了转义处理。 如果启用了转义扫描(默认情况下),则在将SQL语句发送到数据库之前,驱动程序将执行转义替换。- 结果
-
true
如果启用了转义处理;false
如果被禁用 - 异常
-
SQLException
- 如果发生数据库访问错误 - 另请参见:
-
setEscapeProcessing(boolean)
-
setEscapeProcessing
void setEscapeProcessing(boolean enable) throws SQLException
打开或关闭此RowSet
对象的转义处理。 如果启用了转义扫描(默认设置),则在将SQL语句发送到数据库之前,驱动程序将执行转义替换。- 参数
-
enable
-true
启用转义处理;false
禁用它 - 异常
-
SQLException
- 如果发生数据库访问错误 - 另请参见:
-
getEscapeProcessing()
-
getQueryTimeout
int getQueryTimeout() throws SQLException
检索驱动程序等待语句执行的最大秒数。 如果超出此限制,则抛出SQLException
。- 结果
- 当前查询超时限制,以秒为单位; 零意味着无限
- 异常
-
SQLException
- 如果发生数据库访问错误 - 另请参见:
-
setQueryTimeout(int)
-
setQueryTimeout
void setQueryTimeout(int seconds) throws SQLException
将驱动程序等待语句执行的最长时间设置为给定的秒数。 如果超出此限制,则抛出SQLException
。- 参数
-
seconds
- 新的查询超时限制,以秒为单位; 零意味着没有限制 - 异常
-
SQLException
- 如果发生数据库访问错误 - 另请参见:
-
getQueryTimeout()
-
setType
void setType(int type) throws SQLException
将此RowSet
对象的类型设置为给定类型。 此方法用于更改行集的类型,默认情况下为只读且不可滚动。- 参数
-
type
-之一的ResultSet
常数指定类型:ResultSet.TYPE_FORWARD_ONLY
,ResultSet.TYPE_SCROLL_INSENSITIVE
,或ResultSet.TYPE_SCROLL_SENSITIVE
- 异常
-
SQLException
- 如果发生数据库访问错误 - 另请参见:
-
ResultSet.getType()
-
setConcurrency
void setConcurrency(int concurrency) throws SQLException
将此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 SQLException
将此RowSet
对象的SQL命令中的指定参数设置为SQLNULL
。注意:您必须指定参数的SQL类型。
- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
sqlType
- 由java.sql.Types
定义的SQL类型代码 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setNull
void setNull(String parameterName, int sqlType) throws SQLException
将指定参数设置为SQLNULL
。注意:您必须指定参数的SQL类型。
- 参数
-
parameterName
- 参数的名称 -
sqlType
-java.sql.Types
定义的SQL类型代码 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
setNull
void setNull(int paramIndex, int sqlType, String typeName) throws SQLException
将此RowSet
对象的SQL命令中的指定参数设置为SQLNULL
。 此版本的方法setNull
应该用于SQL用户定义类型(UDT)和REF
类型参数。 的UDT的实例包括:STRUCT
,DISTINCT
,JAVA_OBJECT
,和指定数组类型。注意:为了便于移植,应用程序必须在指定NULL UDT或
REF
参数时提供SQL类型代码和完全限定的SQL类型名称。 对于UDT,名称是参数本身的类型名称。 对于REF
参数,名称是引用类型的类型名称。 如果JDBC驱动程序不需要类型代码或类型名称信息,则可能会忽略它。 虽然它适用于UDT和REF
参数,但此方法可用于设置任何JDBC类型的null参数。 如果参数没有用户定义的类型或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 SQLException
将指定参数设置为SQLNULL
。 此版本的方法setNull
应该用于用户定义的类型和REF类型参数。 用户定义类型的示例包括:STRUCT,DISTINCT,JAVA_OBJECT和命名数组类型。注意:为了便于移植,应用程序必须在指定NULL用户定义或REF参数时提供SQL类型代码和完全限定的SQL类型名称。 在用户定义类型的情况下,名称是参数本身的类型名称。 对于REF参数,名称是引用类型的类型名称。 如果JDBC驱动程序不需要类型代码或类型名称信息,则可能会忽略它。 虽然它适用于用户定义和Ref参数,但此方法可用于设置任何JDBC类型的null参数。 如果参数没有用户定义或REF类型,则忽略给定的typeName。
- 参数
-
parameterName
- 参数的名称 -
sqlType
- 数值范围为java.sql.Types
-
typeName
- SQL用户定义类型的完全限定名称; 如果参数不是用户定义的类型或SQLREF
值,则忽略该值 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭时调用此方法CallableStatement
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
setBoolean
void setBoolean(int parameterIndex, boolean x) throws SQLException
将此RowSet
对象命令中的指定参数设置为给定的Javaboolean
值。 在将数据发送到数据库之前,驱动程序将其转换为SQLBIT
值。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setBoolean
void setBoolean(String parameterName, boolean x) throws SQLException
将指定参数设置为给定的Javaboolean
值。 驱动程序在将其发送到数据库时将其转换为SQLBIT
或BOOLEAN
值。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭时调用此方法CallableStatement
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
ResultSet.getBoolean(int)
-
setByte
void setByte(int parameterIndex, byte x) throws SQLException
将此RowSet
对象命令中的指定参数设置为给定的Javabyte
值。 在将其发送到数据库之前,驱动程序将其转换为SQLTINYINT
值。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setByte
void setByte(String parameterName, byte x) throws SQLException
将指定参数设置为给定的Javabyte
值。 驱动程序在将其发送到数据库时将其转换为SQLTINYINT
值。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
ResultSet.getByte(int)
-
setShort
void setShort(int parameterIndex, short x) throws SQLException
将此RowSet
对象命令中的指定参数设置为给定的Javashort
值。 在将其发送到数据库之前,驱动程序将其转换为SQLSMALLINT
值。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setShort
void setShort(String parameterName, short x) throws SQLException
将指定参数设置为给定的Javashort
值。 驱动程序在将其发送到数据库时将其转换为SQLSMALLINT
值。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
ResultSet.getShort(int)
-
setInt
void setInt(int parameterIndex, int x) throws SQLException
将此RowSet
对象命令中的指定参数设置为给定的Javaint
值。 在将其发送到数据库之前,驱动程序将其转换为SQLINTEGER
值。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setInt
void setInt(String parameterName, int x) throws SQLException
将指定参数设置为给定的Javaint
值。 驱动程序在将其发送到数据库时将其转换为SQLINTEGER
值。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭时调用此方法CallableStatement
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
ResultSet.getInt(int)
-
setLong
void setLong(int parameterIndex, long x) throws SQLException
将此RowSet
对象命令中的指定参数设置为给定的Javalong
值。 在将其发送到数据库之前,驱动程序将其转换为SQLBIGINT
值。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setLong
void setLong(String parameterName, long x) throws SQLException
将指定参数设置为给定的Javalong
值。 驱动程序在将其发送到数据库时将其转换为SQLBIGINT
值。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
ResultSet.getLong(int)
-
setFloat
void setFloat(int parameterIndex, float x) throws SQLException
将此RowSet
对象命令中的指定参数设置为给定的Javafloat
值。 在将其发送到数据库之前,驱动程序将其转换为SQLREAL
值。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setFloat
void setFloat(String parameterName, float x) throws SQLException
将指定参数设置为给定的Javafloat
值。 驱动程序将其发送到数据库时将其转换为SQLFLOAT
值。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭时调用此方法CallableStatement
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
ResultSet.getFloat(int)
-
setDouble
void setDouble(int parameterIndex, double x) throws SQLException
将此RowSet
对象命令中的指定参数设置为给定的Javadouble
值。 在将其发送到数据库之前,驱动程序将其转换为SQLDOUBLE
值。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setDouble
void setDouble(String parameterName, double x) throws SQLException
将指定参数设置为给定的Javadouble
值。 驱动程序在将其发送到数据库时将其转换为SQLDOUBLE
值。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
ResultSet.getDouble(int)
-
setBigDecimal
void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException
将此RowSet
对象命令中的指定参数设置为给定的java.math.BigDecimal
值。 在将其发送到数据库之前,驱动程序将其转换为SQLNUMERIC
值。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setBigDecimal
void setBigDecimal(String parameterName, BigDecimal x) throws SQLException
将指定参数设置为给定的java.math.BigDecimal
值。 驱动程序在将其发送到数据库时将其转换为SQLNUMERIC
值。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭时调用此方法CallableStatement
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
ResultSet.getBigDecimal(int, int)
-
setString
void setString(int parameterIndex, String x) throws SQLException
将此RowSet
对象命令中的指定参数设置为给定的JavaString
值。 在将其发送到数据库之前,驱动程序将其转换为SQLVARCHAR
或LONGVARCHAR
值,具体取决于参数的大小相对于VARCHAR
值的驱动程序限制。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setString
void setString(String parameterName, String x) throws SQLException
将指定参数设置为给定的JavaString
值。 将驱动程序发送到数据库时,驱动程序将其转换为SQLVARCHAR
或LONGVARCHAR
值(取决于参数的大小相对于驱动程序对VARCHAR
值的限制)。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
ResultSet.getString(int)
-
setBytes
void setBytes(int parameterIndex, byte[] x) throws SQLException
将此RowSet
对象命令中的指定参数设置为给定的byte
值的Java数组。 在将其发送到数据库之前,驱动程序将其转换为SQLVARBINARY
或LONGVARBINARY
值,具体取决于参数的大小相对于驱动程序对VARBINARY
值的限制。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setBytes
void setBytes(String parameterName, byte[] x) throws SQLException
将指定参数设置为给定的Java字节数组。 当驱动程序将其发送到数据库时,驱动程序将其转换为SQLVARBINARY
或LONGVARBINARY
(取决于参数的大小相对于驱动程序对VARBINARY
值的限制)。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭时调用此方法CallableStatement
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
ResultSet.getBytes(int)
-
setDate
void setDate(int parameterIndex, Date x) throws SQLException
将此RowSet
对象命令中的指定参数设置为给定的java.sql.Date
值。 在将值发送到数据库之前,驱动程序将其转换为SQLDATE
值,使用默认值java.util.Calendar
计算日期。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setTime
void setTime(int parameterIndex, Time x) throws SQLException
将此RowSet
对象命令中的指定参数设置为给定的java.sql.Time
值。 驱动程序在将其发送到数据库之前将其转换为SQLTIME
值,使用默认值java.util.Calendar
进行计算。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setTimestamp
void setTimestamp(int parameterIndex, Timestamp x) throws SQLException
将此RowSet
对象命令中的指定参数设置为给定的java.sql.Timestamp
值。 驱动程序在将其发送到数据库之前将其转换为SQLTIMESTAMP
值,使用默认值java.util.Calendar
进行计算。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setTimestamp
void setTimestamp(String parameterName, Timestamp x) throws SQLException
将指定参数设置为给定的java.sql.Timestamp
值。 驱动程序将其发送到数据库时将其转换为SQLTIMESTAMP
值。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭时调用此方法CallableStatement
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
ResultSet.getTimestamp(int)
-
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
- 流中的字节数 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setAsciiStream
void setAsciiStream(String parameterName, InputStream x, int length) throws SQLException
将指定参数设置为给定输入流,该输入流将具有指定的字节数。 当一个非常大的ASCII值输入到LONGVARCHAR
参数时,通过java.io.InputStream
发送它可能更实际。 将根据需要从流中读取数据,直到达到文件结尾。 JDBC驱动程序将执行从ASCII到数据库char格式的任何必要转换。注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。
- 参数
-
parameterName
- 参数的名称 -
x
- 包含ASCII参数值的Java输入流 -
length
- 流中的字节数 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 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
- 流中的字节数 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setBinaryStream
void setBinaryStream(String parameterName, InputStream x, int length) throws SQLException
将指定参数设置为给定输入流,该输入流将具有指定的字节数。 当一个非常大的二进制值输入到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 SQLException
将此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 SQLException
将指定参数设置为给定的Reader
对象,该对象是给定的字符长度。 当一个非常大的UNICODE值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更实际。 将根据需要从流中读取数据,直到达到文件结尾。 JDBC驱动程序将执行从UNICODE到数据库char格式的任何必要转换。注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。
- 参数
-
parameterName
- 参数的名称 -
reader
- 包含用作指定参数的UNICODE数据的java.io.Reader
对象 -
length
- 流中的字符数 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭时调用此方法CallableStatement
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
setAsciiStream
void setAsciiStream(int parameterIndex, InputStream x) throws SQLException
将此RowSet
对象命令中的指定参数设置为给定输入流。 当一个非常大的ASCII值输入到LONGVARCHAR
参数时,通过java.io.InputStream
发送它可能更实用。 将根据需要从流中读取数据,直到达到文件结尾。 JDBC驱动程序将执行从ASCII到数据库char格式的任何必要转换。注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。
注意:请参阅JDBC驱动程序文档,以确定使用带有长度参数的
setAsciiStream
版本是否更有效。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
x
- 包含ASCII参数值的Java输入流 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭时调用此方法PreparedStatement
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
setAsciiStream
void setAsciiStream(String parameterName, InputStream x) throws SQLException
将指定参数设置为给定输入流。 当一个非常大的ASCII值输入到LONGVARCHAR
参数时,通过java.io.InputStream
发送它可能更实用。 将根据需要从流中读取数据,直到达到文件结尾。 JDBC驱动程序将执行从ASCII到数据库char格式的任何必要转换。注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。
注意:请参阅JDBC驱动程序文档,以确定使用带有长度参数的
setAsciiStream
版本是否更有效。- 参数
-
parameterName
- 参数的名称 -
x
- 包含ASCII参数值的Java输入流 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
setBinaryStream
void setBinaryStream(int parameterIndex, InputStream x) throws SQLException
将此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 SQLException
将指定参数设置为给定输入流。 当一个非常大的二进制值输入到LONGVARBINARY
参数时,通过java.io.InputStream
对象发送它可能更实际。 将根据需要从流中读取数据,直到达到文件结尾。注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。
注意:请参阅JDBC驱动程序文档以确定使用带有长度参数的
setBinaryStream
版本是否更有效。- 参数
-
parameterName
- 参数的名称 -
x
- 包含二进制参数值的java输入流 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭时调用此方法CallableStatement
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
setCharacterStream
void setCharacterStream(int parameterIndex, Reader reader) throws SQLException
将此RowSet
对象命令中的指定参数设置为给定的Reader
对象。 当一个非常大的UNICODE值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更实际。 将根据需要从流中读取数据,直到达到文件结尾。 JDBC驱动程序将执行从UNICODE到数据库char格式的任何必要转换。注意:此流对象可以是标准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 SQLException
将指定参数设置为给定的Reader
对象。 当一个非常大的UNICODE值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更实用。 将根据需要从流中读取数据,直到达到文件结尾。 JDBC驱动程序将执行从UNICODE到数据库char格式的任何必要转换。注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。
注意:请参阅JDBC驱动程序文档以确定使用带有长度参数的
setCharacterStream
版本是否更有效。- 参数
-
parameterName
- 参数的名称 -
reader
- 包含Unicode数据的java.io.Reader
对象 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
setNCharacterStream
void setNCharacterStream(int parameterIndex, Reader value) throws SQLException
将此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 SQLException
使用给定的JavaObject
设置此RowSet
对象命令中的指定参数。 对于整数值,应使用java.lang
等效对象(例如,对于int
,类Integer
的int
)。 如果第二个参数是InputStream
则流必须包含scaleOrLength指定的字节数。 如果第二个参数是Reader
则Reader
必须包含scaleOrLength指定的字符数。 如果这些条件不成立,则在执行SQLException
准备语句时,驱动程序将生成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 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类型,这是小数点后的位数。 对于所有其他类型,将忽略此值。 - 异常
-
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 SQLException
使用JavaObject
在此RowSet
对象的命令中设置指定参数。 对于积分值,应使用java.lang
等效对象。 此方法与上面的setObject
类似,但使用的比例是第二个参数的比例。 标量值的标度为零。 文字值在文字中具有比例。即使支持它,也不建议使用浮点输入值调用此方法。
- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
x
- 包含输入参数值的对象 -
targetSqlType
- 要发送到数据库的SQL类型(在java.sql.Types
定义) - 异常
-
SQLException
- 如果发生数据库访问错误
-
setObject
void setObject(String parameterName, Object x, int targetSqlType) throws SQLException
使用给定对象设置指定参数的值。 该方法类似于上面的方法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 SQLException
使用给定对象设置指定参数的值。 第二个参数必须是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 SQLException
使用JavaObject
在此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 SQLException
使用给定的Ref
值设置此RowSet
对象命令中的指定参数。 驱动程序会将其转换为适当的REF(<structured-type>)
值。- 参数
-
i
- 第一个参数是1,第二个参数是2,... -
x
- 表示SQLREF
类型数据的对象 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setBlob
void setBlob(int i, Blob x) throws SQLException
使用给定的Blob
值设置此RowSet
对象命令中的指定参数。 在将数据发送到数据库之前,驱动程序会将其转换为Blob
对象所代表的BLOB
值。- 参数
-
i
- 第一个参数是1,第二个参数是2,... -
x
- 表示BLOB的对象 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setBlob
void setBlob(int parameterIndex, InputStream inputStream, long length) throws SQLException
将指定参数设置为InputStream
对象。InputStream
必须包含由length指定的字符数,否则在执行SQLException
将生成PreparedStatement
。 此方法与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 SQLException
将指定参数设置为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 SQLException
将指定参数设置为InputStream
对象。InputStream
必须包含由length指定的字符数,否则在执行SQLException
将生成CallableStatement
。 此方法与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 SQLException
将指定参数设置为给定的java.sql.Blob
对象。 驱动程序将其发送到数据库时将其转换为SQLBLOB
值。- 参数
-
parameterName
- 参数的名称 -
x
- 一个映射SQLBLOB
值的Blob
对象 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
setBlob
void setBlob(String parameterName, InputStream inputStream) throws SQLException
将指定参数设置为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 SQLException
使用给定的Clob
值设置此RowSet
对象命令中的指定参数。 在将Clob
对象发送到数据库之前,驱动程序将其转换为CLOB
值。- 参数
-
i
- 第一个参数是1,第二个参数是2,... -
x
- 表示CLOB的对象 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setClob
void setClob(int parameterIndex, Reader reader, long length) throws SQLException
将指定参数设置为Reader
对象。Reader
必须包含由length指定的字符数,否则在执行SQLException
将生成PreparedStatement
。 此方法与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 SQLException
将指定参数设置为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 SQLException
将指定参数设置为Reader
对象。Reader
必须包含由length指定的字符数,否则在执行SQLException
将生成CallableStatement
。 此方法与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 SQLException
将指定参数设置为给定的java.sql.Clob
对象。 驱动程序在将其发送到数据库时将其转换为SQLCLOB
值。- 参数
-
parameterName
- 参数的名称 -
x
- 映射SQLCLOB
值的Clob
对象 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
setClob
void setClob(String parameterName, Reader reader) throws SQLException
将指定参数设置为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 SQLException
使用给定的Array
值设置此RowSet
对象命令中的指定参数。 驱动程序将此转换为ARRAY
的价值Array
对象将它发送到数据库之前代表。- 参数
-
i
- 第一个参数是1,第二个参数是2,... -
x
- 表示SQL数组的对象 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setDate
void setDate(int parameterIndex, Date x, Calendar cal) throws SQLException
使用给定的java.sql.Date
值设置此RowSet
对象命令中的指定参数。 驱动程序DATE
值转换为SQLDATE
值,使用给定的java.util.Calendar
对象来计算日期。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
x
- 参数值 -
cal
- 用于计算日期的java.util.Calendar
对象 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setDate
void setDate(String parameterName, Date x) throws SQLException
使用运行应用程序的虚拟机的默认时区将指定参数设置为给定的java.sql.Date
值。 驱动程序在将其发送到数据库时将其转换为SQLDATE
值。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭时调用此方法CallableStatement
-
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
ResultSet.getDate(int)
-
setDate
void setDate(String parameterName, Date x, Calendar cal) throws SQLException
使用给定的Calendar
对象将指定参数设置为给定的java.sql.Date
值。 驱动程序使用Calendar
对象构造SQLDATE
值,然后驱动程序将其发送到数据库。 使用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 SQLException
使用给定的java.sql.Time
值设置此RowSet
对象命令中的指定参数。 在将数据发送到数据库之前,驱动程序将使用给定的java.util.Calendar
对象将其转换为SQLTIME
值。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
x
- 参数值 -
cal
- 用于计算时间的java.util.Calendar
对象 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setTime
void setTime(String parameterName, Time x) throws SQLException
将指定参数设置为给定的java.sql.Time
值。 驱动程序将其发送到数据库时将其转换为SQLTIME
值。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
ResultSet.getTime(int)
-
setTime
void setTime(String parameterName, Time x, Calendar cal) throws SQLException
使用给定的Calendar
对象将指定参数设置为给定的java.sql.Time
值。 驱动程序使用Calendar
对象构造SQLTIME
值,然后驱动程序将其发送到数据库。 使用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 SQLException
使用给定的java.sql.Timestamp
值设置此RowSet
对象命令中的指定参数。 在将数据发送到数据库之前,驱动程序将使用给定的java.util.Calendar
对象将其转换为SQLTIMESTAMP
值。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
x
- 参数值 -
cal
- 用于计算时间戳的java.util.Calendar
对象 - 异常
-
SQLException
- 如果发生数据库访问错误
-
setTimestamp
void setTimestamp(String parameterName, Timestamp x, Calendar cal) throws SQLException
使用给定的Calendar
对象将指定参数设置为给定的java.sql.Timestamp
值。 驱动程序使用Calendar
对象构造SQLTIMESTAMP
值,然后驱动程序将其发送到数据库。 使用Calendar
对象,驱动程序可以计算考虑自定义时区的时间戳。 如果未指定Calendar
对象,则驱动程序将使用默认时区,即运行应用程序的虚拟机的时区。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 -
cal
- 驱动程序将用于构造时间戳的Calendar
对象 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
ResultSet.getTimestamp(int)
-
clearParameters
void clearParameters() throws SQLException
清除为此RowSet
对象命令设置的参数。通常,参数值对于重复使用
RowSet
对象仍然有效。 设置参数值会自动清除其先前的值。 但是,在某些情况下,立即释放当前参数值使用的资源很有用,这可以通过调用方法clearParameters
来完成。- 异常
-
SQLException
- 如果发生数据库访问错误
-
execute
void execute() throws SQLException
用数据填充此RowSet
对象。execute
方法可以使用以下属性来创建用于读取数据的连接:url,数据源名称,用户名,密码,事务隔离和类型映射。execute
方法可以使用以下属性来创建执行命令的语句:command,read only,maximum field size,maximum rows,escape processing和query timeout。如果尚未设置所需的属性,则抛出异常。 如果此方法成功,则会丢弃行集的当前内容,并且还(重新)设置行集的元数据。 如果有未完成的更新,则会忽略它们。
如果此
RowSet
对象未与其数据源保持连续连接,则可以使用Reader
(RowSetReader
对象)来填充数据。 在这种情况下,Reader
将在此RowSet
对象中注册,方法execute
将调用Reader
的readData
方法作为其实现的一部分。- 异常
-
SQLException
- 如果发生数据库访问错误或者尚未设置建立连接和创建语句所需的任何属性
-
addRowSetListener
void addRowSetListener(RowSetListener listener)
注册给定的侦听器,以便通知此RowSet
对象上发生的事件。- 参数
-
listener
- 已实现RowSetListener
接口并希望在此RowSet
对象上发生事件时收到通知的RowSet
- 另请参见:
-
removeRowSetListener(javax.sql.RowSetListener)
-
removeRowSetListener
void removeRowSetListener(RowSetListener listener)
从此RowSet
对象上发生事件时将通知的组件列表中删除指定的侦听器。- 参数
-
listener
- 已注册为此RowSet
对象的侦听器的RowSet
- 另请参见:
-
addRowSetListener(javax.sql.RowSetListener)
-
setSQLXML
void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException
将指定参数设置为给定的java.sql.SQLXML
对象。 将驱动程序发送到数据库时,驱动程序将其转换为SQLXML
值。- 参数
-
parameterIndex
- 第一个参数的索引是1,第二个参数是2,... -
xmlObject
- 映射SQLXML
值的SQLXML
对象 - 异常
-
SQLException
-如果发生数据库访问错误,该方法被称为上关闭的结果集,java.xml.transform.Result
,Writer
或OutputStream
尚未收为SQLXML
对象或者如果存在一个错误处理XML值。 异常的getCause
方法可能会提供更详细的异常,例如,如果流不包含有效的XML。 - 从以下版本开始:
- 1.6
-
setSQLXML
void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException
将指定参数设置为给定的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 SQLException
将指定参数设置为给定的java.sql.RowId
对象。 驱动程序在将其发送到数据库时将其转换为SQLROWID
值- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误 - 从以下版本开始:
- 1.6
-
setRowId
void setRowId(String parameterName, RowId x) throws SQLException
将指定参数设置为给定的java.sql.RowId
对象。 将驱动程序发送到数据库时,驱动程序将其转换为SQLROWID
。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 - 异常
-
SQLException
- 如果发生数据库访问错误 - 从以下版本开始:
- 1.6
-
setNString
void setNString(int parameterIndex, String value) throws SQLException
将指定参数设置为给定的String
对象。 将驱动程序发送到数据库时,驱动程序将其转换为SQLNCHAR
或NVARCHAR
或LONGNVARCHAR
值(取决于参数的大小相对于驱动程序对NVARCHAR
值的限制)。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
value
- 参数值 - 异常
-
SQLException
- 如果驾驶员不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 或者如果发生数据库访问错误 - 从以下版本开始:
- 1.6
-
setNString
void setNString(String parameterName, String value) throws SQLException
将指定参数设置为给定的String
对象。 驱动程序将其转换为SQLNCHAR
或NVARCHAR
或LONGNVARCHAR
- 参数
-
parameterName
- 要设置的列的名称 -
value
- 参数值 - 异常
-
SQLException
- 如果驱动程序不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 或者如果发生数据库访问错误 - 从以下版本开始:
- 1.6
-
setNCharacterStream
void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException
将指定参数设置为Reader
对象。Reader
读取数据,直到达到文件结尾。 驱动程序执行从Java字符格式到数据库中的国家字符集的必要转换。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
value
- 参数值 -
length
- 参数数据中的字符数。 - 异常
-
SQLException
- 如果驾驶员不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 或者如果发生数据库访问错误 - 从以下版本开始:
- 1.6
-
setNCharacterStream
void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException
将指定参数设置为Reader
对象。Reader
读取数据,直到达到文件结尾。 驱动程序执行从Java字符格式到数据库中的国家字符集的必要转换。- 参数
-
parameterName
- 要设置的列的名称 -
value
- 参数值 -
length
- 参数数据中的字符数。 - 异常
-
SQLException
- 如果驾驶员不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 或者如果发生数据库访问错误 - 从以下版本开始:
- 1.6
-
setNCharacterStream
void setNCharacterStream(String parameterName, Reader value) throws SQLException
将指定参数设置为Reader
对象。Reader
读取数据直到达到文件结尾。 驱动程序执行从Java字符格式到数据库中的国家字符集的必要转换。注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。
注意:请参阅JDBC驱动程序文档,以确定使用带有长度参数的
setNCharacterStream
版本是否更有效。- 参数
-
parameterName
- 参数的名称 -
value
- 参数值 - 异常
-
SQLException
- 如果驾驶员不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误; 或者在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
setNClob
void setNClob(String parameterName, NClob value) throws SQLException
将指定参数设置为java.sql.NClob
对象。 该对象实现了java.sql.NClob
接口。 此NClob
对象映射到SQLNCLOB
。- 参数
-
parameterName
- 要设置的列的名称 -
value
- 参数值 - 异常
-
SQLException
- 如果驱动程序不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 或者如果发生数据库访问错误 - 从以下版本开始:
- 1.6
-
setNClob
void setNClob(String parameterName, Reader reader, long length) throws SQLException
将指定参数设置为Reader
对象。Reader
必须包含由length指定的字符数,否则在执行SQLException
将生成CallableStatement
。 此方法与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 SQLException
将指定参数设置为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 SQLException
将指定参数设置为Reader
对象。Reader
必须包含由length指定的字符数,否则在执行SQLException
将生成PreparedStatement
。 此方法与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 SQLException
将指定参数设置为java.sql.NClob
对象。 驱动程序在将其发送到数据库时将其转换为SQLNCLOB
值。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
value
- 参数值 - 异常
-
SQLException
- 如果驱动程序不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 或者如果发生数据库访问错误 - 从以下版本开始:
- 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
- 包含要将参数值设置为的数据的对象。 - 异常
-
SQLException
- 如果parameterIndex与SQL语句中的参数标记不对应; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误或在关闭的PreparedStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
setURL
void setURL(int parameterIndex, URL x) throws SQLException
将指定参数设置为给定的java.net.URL
值。 驱动程序在将其发送到数据库时将其转换为SQLDATALINK
值。- 参数
-
parameterIndex
- 第一个参数是1,第二个参数是2,... -
x
- 要设置的java.net.URL
对象 - 异常
-
SQLException
- 如果发生数据库访问错误或在关闭的PreparedStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
-