public interface RowSet extends ResultSet
RowSet
接口提供了一组JavaBean属性,允许将RowSet
实例配置为连接到JDBC数据源并从数据源读取一些数据。 A组的设置方法( setInt
, setBytes
, setString
,等)提供了一种方式来传递输入参数行集的命令属性。 此命令是行集在从关系数据库获取其数据时使用的SQL查询,这通常是这种情况。
RowSet
接口支持JavaBeans事件,允许应用程序中的其他组件在行集上发生事件(例如其值更改)时收到通知。
RowSet
接口是独一无二的,因为它旨在使用其余的JDBC API来实现。 换句话说, RowSet
实现是执行JDBC驱动程序“顶部”的一层软件。 的的实现RowSet
接口可以被任何人提供的,包括谁希望提供一个JDBC驱动程序供应商RowSet
实现作为其JDBC产品的一部分。
RowSet
对象可以与数据源建立连接,并在其整个生命周期内保持该连接,在这种情况下,它被称为连接的行集。 行集还可能与数据源建立连接,从中获取数据,然后关闭连接。 这样一个行集被称为一个断开的行集。 断开连接的行集可能在断开连接时对其数据进行更改,然后将更改发送回原始数据源,但必须重新建立连接。
断开的行集可以具有与其相关联的读取器( RowSetReader
对象)和写入器( RowSetWriter
对象)。 阅读器可以以许多不同的方式来实现,用数据填充行集,包括从非关系数据源获取数据。 作者也可以以许多不同的方式实施,将对行集数据的更改传播回底层数据源。
行列易于使用。 RowSet
接口扩展了标准的java.sql.ResultSet
接口。 RowSetMetaData
接口扩展了java.sql.ResultSetMetaData
接口。 因此,熟悉JDBC API的开发人员将不得不学习使用行集的最少数量的新API。 此外,与JDBC 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
Modifier and Type | Method and Description |
---|---|
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()
检索与此
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 对象的命令中的指定
Array 。
|
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.BigDeciaml 值。
|
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 i, Blob x)
使用给定的
Blob 值在此
RowSet 对象的命令中设置指定的
Blob 。
|
void |
setBlob(int parameterIndex, InputStream inputStream)
将指定的参数设置为
InputStream 对象。
|
void |
setBlob(int parameterIndex, InputStream inputStream, long length)
将指定的参数设置为
InputStream 对象。
|
void |
setBlob(String parameterName, Blob x)
将指定的参数设置为给定的
java.sql.Blob 对象。
|
void |
setBlob(String parameterName, InputStream inputStream)
将指定的参数设置为
InputStream 对象。
|
void |
setBlob(String parameterName, InputStream inputStream, long length)
将指定的参数设置为
InputStream 对象。
|
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 i, Clob x)
使用给定的
Clob 值设置此
RowSet 对象的命令中的指定
Clob 。
|
void |
setClob(int parameterIndex, Reader reader)
将指定的参数设置为
Reader 对象。
|
void |
setClob(int parameterIndex, Reader reader, long length)
将指定的参数设置为
Reader 对象。
|
void |
setClob(String parameterName, Clob x)
将指定的参数设置为给定的
java.sql.Clob 对象。
|
void |
setClob(String parameterName, Reader reader)
将指定的参数设置为
Reader 对象。
|
void |
setClob(String parameterName, Reader reader, long length)
将指定的参数设置为
Reader 对象。
|
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 对象的命令中的指定
java.sql.Date 。
|
void |
setDate(String parameterName, Date x)
使用运行应用程序的虚拟机的默认时区将指定的
java.sql.Date 设置为给定的
java.sql.Date 值。
|
void |
setDate(String parameterName, Date x, Calendar cal)
使用给定的
Calendar 对象将指定的
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 参数设置为
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, NClob value)
将指定的参数设置为
java.sql.NClob 对象。
|
void |
setNClob(int parameterIndex, Reader reader)
将指定的参数设置为
Reader 对象。
|
void |
setNClob(int parameterIndex, Reader reader, long length)
将指定的参数设置为
Reader 对象。
|
void |
setNClob(String parameterName, NClob value)
将指定的参数设置为
java.sql.NClob 对象。
|
void |
setNClob(String parameterName, Reader reader)
将指定的参数设置为
Reader 对象。
|
void |
setNClob(String parameterName, Reader reader, long length)
将指定的参数设置为
Reader 对象。
|
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 对象的命令中的
Object 。
|
void |
setObject(int parameterIndex, Object x, int targetSqlType)
使用Java
Object 设置此
RowSet 对象的命令中的
Object 。
|
void |
setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength)
使用给定的Java
Object 在此
RowSet 对象的命令中设置指定的
Object 。
|
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 对象的命令中的指定
Ref 。
|
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 对象的命令中设置指定的
java.sql.Time 。
|
void |
setTime(String parameterName, Time x)
将指定的参数设置为给定的
java.sql.Time 值。
|
void |
setTime(String parameterName, Time x, Calendar cal)
使用给定的
Calendar 对象将指定的
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 对象的命令中设置指定的
java.sql.Timestamp 。
|
void |
setTimestamp(String parameterName, Timestamp x)
将指定的参数设置为给定的
java.sql.Timestamp 值。
|
void |
setTimestamp(String parameterName, Timestamp x, Calendar cal)
使用给定的
Calendar 对象将指定的
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(int parameterIndex, URL x)
将指定的参数设置为给定的
java.net.URL 值。
|
void |
setUrl(String url)
设置
RowSet 对象在使用
DriverManager 创建连接时将使用的URL。
|
void |
setUsername(String name)
将此
RowSet 对象的用户名属性设置为给定的
String 。
|
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
isWrapperFor, unwrap
String getUrl() throws SQLException
RowSet
对象将用于创建连接的url属性,如果使用DriverManager
而不是DataSource
对象来建立连接。
默认值为null
。
SQLException
- 如果发生数据库访问错误
setUrl(java.lang.String)
void setUrl(String url) throws SQLException
RowSet
对象在使用DriverManager
创建连接时将使用的URL。
设置此属性是可选的。
如果使用URL,则必须先加载接受URL的JDBC驱动程序,然后才能使用行集连接到数据库。
当读取或写入数据时,行将在内部使用URL来创建数据库连接。
使用URL或数据源名称来创建连接,最近设置为非空值。
url
- 一个字符串值;
可能是null
SQLException
- 如果发生数据库访问错误
getUrl()
String getDataSourceName()
RowSet
对象的数据源的逻辑名称。
setDataSourceName(java.lang.String)
,
setUrl(java.lang.String)
void setDataSourceName(String name) throws SQLException
RowSet
对象的数据源名称属性设置为给定的String
。
数据源名称属性的值可用于对已经在命名服务中注册的DataSource
对象进行查找。 被检索后, DataSource
对象可用于创建与其所代表的数据源的连接。
name
- 此RowSet
对象的数据源的逻辑名称;
可能是null
SQLException
- 如果发生数据库访问错误
getDataSourceName()
String getUsername()
RowSet
对象的数据库连接的用户名。
在调用方法execute
之前,username属性在运行时设置。
它通常不是RowSet
对象的序列化状态的一部分。
setUsername(java.lang.String)
void setUsername(String name) throws SQLException
RowSet
对象的用户名属性设置为给定的
String
。
name
- 用户名
SQLException
- 如果发生数据库访问错误
getUsername()
String getPassword()
execute
。
它通常不是RowSet
对象的序列化状态的一部分。
setPassword(java.lang.String)
void setPassword(String password) throws SQLException
RowSet
对象的数据库密码设置为给定的
String
。
password
- 密码字符串
SQLException
- 如果发生数据库访问错误
getPassword()
int getTransactionIsolation()
RowSet
对象设置的事务隔离级别。
Connection.TRANSACTION_READ_UNCOMMITTED
, Connection.TRANSACTION_READ_COMMITTED
, Connection.TRANSACTION_REPEATABLE_READ
,或Connection.TRANSACTION_SERIALIZABLE
setTransactionIsolation(int)
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()
Map<String,类<?>> getTypeMap() throws SQLException
RowSet
对象相关联的Map
对象,该对象指定SQL用户定义类型的自定义映射(如果有)。
默认值是将类型映射为空。
java.util.Map
SQL用户定义类型的名称的
java.util.Map
对象以及要映射到的Java类
SQLException
- 如果发生数据库访问错误
setTypeMap(java.util.Map<java.lang.String, java.lang.Class<?>>)
void setTypeMap(Map<String,类<?>> map) throws SQLException
java.util.Map
对象作为此RowSet
对象的默认类型映射。
除非另有类型地图作为方法参数提供,否则将使用此类型的地图。
map
- 一个
java.util.Map
SQL用户定义类型的名称的
java.util.Map
对象以及要映射到的Java类
SQLException
- 如果发生数据库访问错误
getTypeMap()
String getCommand()
RowSet
对象的命令属性。
命令属性包含一个命令字符串,它必须是一个SQL查询,可以执行以使用数据填充行集。
默认值为null
。
null
setCommand(java.lang.String)
void setCommand(String cmd) throws SQLException
RowSet
对象的命令属性设置为给定的SQL查询。
当行集从不支持命令的数据源(如电子表格)获取其数据时,此属性是可选的。
cmd
- 将用于获取此RowSet
对象的数据的SQL查询;
可以是null
SQLException
- 如果发生数据库访问错误
getCommand()
boolean isReadOnly()
RowSet
对象是否为只读。
如果可以进行更新,则默认值是可以更新行集。
尝试更新只读行集将导致抛出SQLException
。
true
如果这个RowSet
对象是只读的;
false
如果它是可更新的
setReadOnly(boolean)
void setReadOnly(boolean value) throws SQLException
RowSet
对象是否为只读到给定的
boolean
。
value
- true
如果只读;
false
如果可更新
SQLException
- 如果发生数据库访问错误
isReadOnly()
int getMaxFieldSize() throws SQLException
BINARY
, VARBINARY
, LONGVARBINARYBINARY
, CHAR
, VARCHAR
, LONGVARCHAR
, NCHAR
个NVARCHAR
列。
如果超出限制,则会忽略多余的数据。
SQLException
- 如果发生数据库访问错误
setMaxFieldSize(int)
void setMaxFieldSize(int max) throws SQLException
BINARY
, VARBINARY
, LONGVARBINARYBINARY
, CHAR
, VARCHAR
, LONGVARCHAR
, NCHAR
个NVARCHAR
列。
如果超出限制,则会忽略多余的数据。
为了最大可移植性,请使用大于256的值。
max
- 新的最大列大小限制(以字节为单位)
零表示无限制
SQLException
- 如果发生数据库访问错误
getMaxFieldSize()
int getMaxRows() throws SQLException
RowSet
对象可以包含的最大行数。
如果超出限制,则多余的行将被静默地丢弃。
RowSet
对象可以包含的当前最大行数;
零表示无限制
SQLException
- 如果发生数据库访问错误
setMaxRows(int)
void setMaxRows(int max) throws SQLException
RowSet
对象的最大行数设置为指定的数字。
如果超出限制,则多余的行将被静默地丢弃。
max
- 新的最大行数;
零表示无限制
SQLException
- 如果发生数据库访问错误
getMaxRows()
boolean getEscapeProcessing() throws SQLException
RowSet
对象的转义处理。
如果启用了转义扫描,默认情况下,驱动程序将在将SQL语句发送到数据库之前进行转义替换。
true
如果启用转义处理;
如果禁用, false
SQLException
- 如果发生数据库访问错误
setEscapeProcessing(boolean)
void setEscapeProcessing(boolean enable) throws SQLException
RowSet
对象的转义处理开启或关闭。
如果启用了远程扫描(默认),驱动程序将在向数据库发送SQL语句之前进行转义替换。
enable
- true
以实现逃生处理;
false
禁用它
SQLException
- 如果发生数据库访问错误
getEscapeProcessing()
int getQueryTimeout() throws SQLException
SQLException
。
SQLException
- 如果发生数据库访问错误
setQueryTimeout(int)
void setQueryTimeout(int seconds) throws SQLException
SQLException
。
seconds
- 新的查询超时限制(以秒为单位)
零意味着没有限制
SQLException
- 如果发生数据库访问错误
getQueryTimeout()
void setType(int type) throws SQLException
RowSet
对象的类型设置为给定类型。
此方法用于更改行集的类型,默认为只读和不可滚动。
type
-所述之一
ResultSet
常量指定类型:
ResultSet.TYPE_FORWARD_ONLY
,
ResultSet.TYPE_SCROLL_INSENSITIVE
,或
ResultSet.TYPE_SCROLL_SENSITIVE
SQLException
- 如果发生数据库访问错误
ResultSet.getType()
void setConcurrency(int concurrency) throws SQLException
RowSet
对象的并发设置为给定的并发级别。
此方法用于更改行集的并发级别,默认值为ResultSet.CONCUR_READ_ONLY
concurrency
- 指定并发级别的
ResultSet
常量之一:
ResultSet.CONCUR_READ_ONLY
或
ResultSet.CONCUR_UPDATABLE
SQLException
- 如果发生数据库访问错误
ResultSet.getConcurrency()
void setNull(int parameterIndex, int sqlType) throws SQLException
RowSet
对象的SQL命令中的指定参数设置为SQL NULL
。
注意:您必须指定参数的SQL类型。
parameterIndex
- 第一个参数是1,第二个是2,...
sqlType
- 由
java.sql.Types
定义的SQL类型代码
SQLException
- 如果发生数据库访问错误
void setNull(String parameterName, int sqlType) throws SQLException
NULL
。
注意:您必须指定参数的SQL类型。
parameterName
- 参数的名称
sqlType
- 在
java.sql.Types
定义的SQL类型代码
SQLException
- 如果发生数据库访问错误或此方法在封闭的
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void setNull(int paramIndex, int sqlType, String typeName) throws SQLException
RowSet
对象的SQL命令中的指定参数设置为SQL NULL
。
此版本的方法setNull
应用于SQL用户定义类型(UDT)和REF
类型参数。
的UDT的实例包括: STRUCT
, DISTINCT
, JAVA_OBJECT
,和指定数组类型。
注意:为了便于携带,当指定NULL UDT或REF
参数时,应用程序必须给出SQL类型代码和完全限定的SQL类型名称。 在UDT的情况下,名称是参数本身的类型名称。 对于REF
参数,名称是引用类型的类型名称。 如果JDBC驱动程序不需要类型代码或类型名称信息,它可能会忽略它。 尽管它适用于UDT和REF
参数,但此方法可用于设置任何JDBC类型的空参数。 如果参数不具有用户定义或REF
类型,则typeName参数将被忽略。
paramIndex
- 第一个参数是1,第二个是2,...
sqlType
- 一个值从
java.sql.Types
typeName
-一个SQL UDT或SQL结构类型的类型名称的完全合格的名称被引用REF
类型;
如果参数不是UDT或REF
类型,则将被忽略
SQLException
- 如果发生数据库访问错误
void setNull(String parameterName, int sqlType, String typeName) throws SQLException
NULL
。
此版本的方法setNull
应用于用户定义的类型和REF类型参数。
用户定义类型的示例包括:STRUCT,DISTINCT,JAVA_OBJECT和命名的数组类型。
注意:为了便于携带,当指定NULL用户定义或REF参数时,应用程序必须给出SQL类型代码和完全限定的SQL类型名称。 在用户定义类型的情况下,名称是参数本身的类型名称。 对于REF参数,名称是引用类型的类型名称。 如果JDBC驱动程序不需要类型代码或类型名称信息,它可能会忽略它。 尽管它是用于用户定义的和参数的参数,但是该方法可以用于设置任何JDBC类型的空值参数。 如果参数没有用户定义或REF类型,则给定的typeName将被忽略。
parameterName
- 参数的名称
sqlType
- 一个值从
java.sql.Types
typeName
- SQL用户定义类型的全限定名称;
如果参数不是用户定义的类型或SQL REF
值,则忽略该值
SQLException
- 如果发生数据库访问错误或此方法在关闭时调用
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void setBoolean(int parameterIndex, boolean x) throws SQLException
RowSet
对象的命令中的指定参数设置为给定的Java boolean
值。
驱动程序将其转换为SQL BIT
值,然后将其发送到数据库。
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 参数值
SQLException
- 如果发生数据库访问错误
void setBoolean(String parameterName, boolean x) throws SQLException
boolean
值。
当驱动程序将其发送到数据库时,将其转换为SQL BIT
或BOOLEAN
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或此方法在封闭的
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
ResultSet.getBoolean(int)
void setByte(int parameterIndex, byte x) throws SQLException
RowSet
对象的命令中的指定参数设置为给定的Java byte
值。
驱动程序将其转换为SQL TINYINT
值,然后再将其发送到数据库。
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 参数值
SQLException
- 如果发生数据库访问错误
void setByte(String parameterName, byte x) throws SQLException
byte
值。
当驱动程序将其发送到数据库时,将其转换为SQL TINYINT
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或在封闭的方法上调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
ResultSet.getByte(int)
void setShort(int parameterIndex, short x) throws SQLException
RowSet
对象的命令中的指定参数设置为给定的Java short
值。
驱动程序将其转换为SQL SMALLINT
值,然后再将其发送到数据库。
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 参数值
SQLException
- 如果发生数据库访问错误
void setShort(String parameterName, short x) throws SQLException
short
值。
当驱动程序将其发送到数据库时,将其转换为SQL SMALLINT
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或在封闭的方法上调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
ResultSet.getShort(int)
void setInt(int parameterIndex, int x) throws SQLException
RowSet
对象的命令中的指定参数设置为给定的Java int
值。
驱动程序将其转换为SQL INTEGER
值,然后再将其发送到数据库。
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 参数值
SQLException
- 如果发生数据库访问错误
void setInt(String parameterName, int x) throws SQLException
int
值。
当驱动程序将其发送到数据库时,将其转换为SQL INTEGER
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或者在关闭的
CallableStatement
调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
ResultSet.getInt(int)
void setLong(int parameterIndex, long x) throws SQLException
RowSet
对象的命令中的指定参数设置为给定的Java long
值。
驱动程序将其转换为SQL BIGINT
值,然后再将其发送到数据库。
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 参数值
SQLException
- 如果发生数据库访问错误
void setLong(String parameterName, long x) throws SQLException
long
值。
当驱动程序将其发送到数据库时,将其转换为SQL BIGINT
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或在封闭的方法上调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
ResultSet.getLong(int)
void setFloat(int parameterIndex, float x) throws SQLException
RowSet
对象的命令中的指定参数设置为给定的Java float
值。
驱动程序将其转换为SQL REAL
值,然后将其发送到数据库。
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 参数值
SQLException
- 如果发生数据库访问错误
void setFloat(String parameterName, float x) throws SQLException
float
值。
当驱动程序将其发送到数据库时,将其转换为SQL FLOAT
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或在封闭的方法上调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
ResultSet.getFloat(int)
void setDouble(int parameterIndex, double x) throws SQLException
RowSet
对象的命令中的指定参数设置为给定的Java double
值。
驱动程序将其转换为SQL DOUBLE
值,然后再将其发送到数据库。
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 参数值
SQLException
- 如果发生数据库访问错误
void setDouble(String parameterName, double x) throws SQLException
double
值。
当驱动程序将其发送到数据库时,将其转换为SQL DOUBLE
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或在封闭的方法上调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
ResultSet.getDouble(int)
void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException
RowSet
对象的命令中的指定参数设置为给定的java.math.BigDeciaml
值。
驱动程序将其转换为SQL NUMERIC
值,然后将其发送到数据库。
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 参数值
SQLException
- 如果发生数据库访问错误
void setBigDecimal(String parameterName, BigDecimal x) throws SQLException
java.math.BigDecimal
值。
当驱动程序将其发送到数据库时,将其转换为SQL NUMERIC
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或此方法在封闭的
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
ResultSet.getBigDecimal(int, int)
void setString(int parameterIndex, String x) throws SQLException
RowSet
对象的命令中的指定参数设置为给定的Java String
值。
在将其发送到数据库之前,驱动程序将其转换为SQL VARCHAR
或LONGVARCHAR
值,具体取决于参数相对于驱动程序对VARCHAR
值的限制的大小。
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 参数值
SQLException
- 如果发生数据库访问错误
void setString(String parameterName, String x) throws SQLException
String
值。
当驱动程序将其发送到数据库时,将其转换为SQL VARCHAR
或LONGVARCHAR
值(取决于参数相对于驱动程序对VARCHAR
的限制的大小)的大小。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或者在关闭的
CallableStatement
调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
ResultSet.getString(int)
void setBytes(int parameterIndex, byte[] x) throws SQLException
RowSet
对象的命令中的指定参数设置为给定的byte
Java数组。
在将其发送到数据库之前,驱动程序将其转换为SQL VARBINARY
或LONGVARBINARY
值,具体取决于参数的大小,相对于驱动程序对VARBINARY
的限制。
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 参数值
SQLException
- 如果发生数据库访问错误
void setBytes(String parameterName, byte[] x) throws SQLException
VARBINARY
或LONGVARBINARY
(取决于参数相对于驱动程序对VARBINARY
的限制的大小)。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或在封闭的方法上调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
ResultSet.getBytes(int)
void setDate(int parameterIndex, Date x) throws SQLException
RowSet
对象的命令中的指定参数设置为给定的java.sql.Date
值。
驱动程序将其转换为SQL DATE
值,然后将其发送到数据库,使用默认值java.util.Calendar
计算日期。
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 参数值
SQLException
- 如果发生数据库访问错误
void setTime(int parameterIndex, Time x) throws SQLException
RowSet
对象的命令中的指定参数设置为给定的java.sql.Time
值。
驱动程序将其转换为SQL TIME
值,然后将其发送到数据库,使用默认值java.util.Calendar
进行计算。
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 参数值
SQLException
- 如果发生数据库访问错误
void setTimestamp(int parameterIndex, Timestamp x) throws SQLException
RowSet
对象的命令中的指定参数设置为给定的java.sql.Timestamp
值。
驱动程序将其转换为SQL TIMESTAMP
值,然后将其发送到数据库,使用默认值java.util.Calendar
进行计算。
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 参数值
SQLException
- 如果发生数据库访问错误
void setTimestamp(String parameterName, Timestamp x) throws SQLException
java.sql.Timestamp
值。
当驱动程序将其发送到数据库时,将其转换为SQL TIMESTAMP
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或者在关闭的
CallableStatement
调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
ResultSet.getTimestamp(int)
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
- 如果发生数据库访问错误
void setAsciiStream(String parameterName, InputStream x, int length) throws SQLException
LONGVARCHAR
参数时,通过java.io.InputStream
发送它可能更java.io.InputStream
。
将根据需要从流中读取数据,直到达到文件结尾。
JDBC驱动程序将从ASCII到数据库字符格式进行任何必要的转换。
注意:此流对象可以是标准Java流对象,也可以是实现标准接口的自己的子类。
parameterName
- 参数的名称
x
- 包含ASCII参数值的Java输入流
length
- 流中的字节数
SQLException
- 如果发生数据库访问错误或者在关闭的
CallableStatement
调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
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
- 如果发生数据库访问错误
void setBinaryStream(String parameterName, InputStream x, int length) throws SQLException
LONGVARBINARY
参数时,通过java.io.InputStream
对象发送它可能更实用。
数据将根据需要从流中读取,直到达到文件结尾。
注意:此流对象可以是标准Java流对象,也可以是实现标准接口的自己的子类。
parameterName
- 参数的名称
x
- 包含二进制参数值的java输入流
length
- 流中的字节数
SQLException
- 如果发生数据库访问错误或在封闭的方法上调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
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
- 如果发生数据库访问错误
void setCharacterStream(String parameterName, Reader reader, int length) throws SQLException
Reader
对象,这是给定的长度的字符数。
当一个非常大的UNICODE值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更实用。
数据将根据需要从流中读取,直到达到文件结尾。
JDBC驱动程序将从UNICODE到数据库字符格式进行任何必要的转换。
注意:此流对象可以是标准Java流对象,也可以是实现标准接口的自己的子类。
parameterName
- 参数的名称
reader
-所述
java.io.Reader
包含用作指定参数的UNICODE数据对象
length
- 流中的字符数
SQLException
- 如果发生数据库访问错误或此方法在关闭时调用
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void setAsciiStream(int parameterIndex, InputStream x) throws SQLException
RowSet
对象的命令中的指定参数设置为给定的输入流。
当一个非常大的ASCII值输入到LONGVARCHAR
参数时,通过java.io.InputStream
发送它可能更java.io.InputStream
。
将根据需要从流中读取数据,直到达到文件结尾。
JDBC驱动程序将从ASCII到数据库字符格式进行任何必要的转换。
注意:此流对象可以是标准Java流对象,也可以是实现标准接口的自己的子类。
注:请参考JDBC驱动程序文档,以确定它可能是更有效地使用一个版本的setAsciiStream
其带长度参数。
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 包含ASCII参数值的Java输入流
SQLException
- 如果发生数据库访问错误或在封闭的方法上调用此方法
PreparedStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void setAsciiStream(String parameterName, InputStream x) throws SQLException
LONGVARCHAR
参数时,通过java.io.InputStream
发送它可能更java.io.InputStream
。
将根据需要从流中读取数据,直到达到文件结尾。
JDBC驱动程序将从ASCII到数据库字符格式进行任何必要的转换。
注意:此流对象可以是标准Java流对象,也可以是实现标准接口的自己的子类。
注:请参考JDBC驱动程序文档,以确定它可能是更有效地使用一个版本的setAsciiStream
其带长度参数。
parameterName
- 参数的名称
x
- 包含ASCII参数值的Java输入流
SQLException
- 如果发生数据库访问错误或在封闭的方法上调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
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驱动程序不支持此方法
void setBinaryStream(String parameterName, InputStream x) throws SQLException
LONGVARBINARY
参数时,通过java.io.InputStream
对象发送它可能更实用。
数据将根据需要从流中读取,直到达到文件结尾。
注意:此流对象可以是标准Java流对象,也可以是实现标准接口的自己的子类。
注意:请参阅您的JDBC驱动程序文档,以确定使用setBinaryStream
版本的setBinaryStream
是否更有效,该版本需要一个长度参数。
parameterName
- 参数的名称
x
- 包含二进制参数值的java输入流
SQLException
- 如果发生数据库访问错误或在封闭的
CallableStatement
上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void setCharacterStream(int parameterIndex, Reader reader) throws SQLException
RowSet
对象的命令中的指定参数设置为给定的Reader
对象。
当一个非常大的UNICODE值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更实用。
数据将根据需要从流中读取,直到达到文件结尾。
JDBC驱动程序将从UNICODE到数据库字符格式进行任何必要的转换。
注意:此流对象可以是标准Java流对象,也可以是实现标准接口的自己的子类。
注意:请参考您的JDBC驱动程序文档,以确定使用setCharacterStream
版本的setCharacterStream
是否更有效。
parameterIndex
- 第一个参数是1,第二个是2,...
reader
- 包含Unicode数据的
java.io.Reader
对象
SQLException
- 如果发生数据库访问错误或在封闭的
PreparedStatement
上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void setCharacterStream(String parameterName, Reader reader) throws SQLException
Reader
对象。
当一个非常大的UNICODE值输入到LONGVARCHAR
参数时,通过一个java.io.Reader
对象发送它可能会更加实用。
数据将根据需要从流中读取,直到达到文件结尾。
JDBC驱动程序将从UNICODE到数据库字符格式进行任何必要的转换。
注意:此流对象可以是标准Java流对象,也可以是实现标准接口的自己的子类。
注:请参考JDBC驱动程序文档,以确定它可能是更有效地使用一个版本的setCharacterStream
其带长度参数。
parameterName
- 参数的名称
reader
- 包含Unicode数据的
java.io.Reader
对象
SQLException
- 如果发生数据库访问错误或在封闭的方法上调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void setNCharacterStream(int parameterIndex, Reader value) throws SQLException
RowSet
对象的命令中的Reader
参数设置为Reader
对象。
Reader
读取数据,直到到达文件结尾。
驱动程序必须从Java字符格式转换为数据库中的国家字符集。
注意:此流对象可以是标准Java流对象,也可以是实现标准接口的自己的子类。
注:请参考JDBC驱动程序文档,以确定它可能是更有效地使用一个版本的setNCharacterStream
其带长度参数。
parameterIndex
- 第一个参数是1,第二个是2,...
value
- 参数值
SQLException
- 如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
如果发生数据库访问错误;
或者这种方法是在封闭的PreparedStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength) throws SQLException
Object
设置此RowSet
对象的命令中的指定Object
。
对于积分值,应使用java.lang
等效对象(例如, Integer
的类别为int
)。
如果第二个参数是InputStream
那么流必须包含由scaleOrLength指定的字节数。
如果第二个参数是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
)。
比例参数可能进一步限定此类型。
scaleOrLength
- 对于java.sql.Types.DECIMAL
或java.sql.Types.NUMERIC types
,这是小数点后的位数。
对于Java对象类型InputStream
和Reader
,这是流或读取器中数据的长度。
对于所有其他类型,此值将被忽略。
SQLException
- 如果发生数据库访问错误
Types
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
- 对于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驱动程序不支持此数据类型
Types
, ResultSet.getObject(int)
void setObject(int parameterIndex, Object x, int targetSqlType) throws SQLException
RowSet
对象的命令中设置指定的Object
。
对于积分值,应使用java.lang
等效对象。
这个方法就像上面的setObject
,但是使用的比例是第二个参数的比例。
标量值为0。
字面值在文字中具有比例。
即使支持它,不建议使用浮点输入值调用此方法。
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 包含输入参数值的对象
targetSqlType
- 要发送到数据库的SQL类型(定义在
java.sql.Types
)
SQLException
- 如果发生数据库访问错误
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驱动程序不支持此数据类型
ResultSet.getObject(int)
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驱动程序不支持此方法
ResultSet.getObject(int)
void setObject(int parameterIndex, Object x) throws SQLException
RowSet
对象的命令中设置指定的Object
。
对于积分值,应使用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
- 如果发生数据库访问错误
void setRef(int i, Ref x) throws SQLException
Ref
值设置此RowSet
对象的命令中的指定Ref
。
该驱动程序会将其转换为相应的REF(<structured-type>)
值。
i
- 第一个参数是1,第二个是2,...
x
- 表示SQL
REF
类型的数据的对象
SQLException
- 如果发生数据库访问错误
void setBlob(int i, Blob x) throws SQLException
Blob
值在此RowSet
对象的命令中设置指定的Blob
。
驱动程序将此转换为BLOB
,该值Blob
对象将它发送到数据库之前代表。
i
- 第一个参数是1,第二个是2,...
x
- 表示BLOB的对象
SQLException
- 如果发生数据库访问错误
void setBlob(int parameterIndex, InputStream inputStream, long length) throws SQLException
InputStream
对象。
输入流必须包含由长度指定的SQLException
数, PreparedStatement
在执行PreparedStatement时将PreparedStatement
。
此方法从不同setBinaryStream (int, InputStream, int)
方法,因为它通知参数值应该被发送到服务器作为驾驶员BLOB
。
当使用setBinaryStream
方法时,驱动程序可能需要进行额外的工作,以确定是否应将参数数据作为LONGVARBINARY
或BLOB
发送到服务器
parameterIndex
- 第一个参数的索引为1,第二个为2,...
inputStream
- 包含用于设置参数值的数据的对象。
length
- 参数数据中的字节数。
SQLException
- 如果发生数据库访问错误,则在关闭的
PreparedStatement
上调用此方法,如果parameterIndex与SQL语句中的参数标记不对应,如果指定的长度小于零,或者输入流中的字节数如何不符合指定的长度。
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void setBlob(int parameterIndex, InputStream inputStream) throws SQLException
InputStream
对象。
该方法与setBinaryStream (int, InputStream)
方法不同,因为它通知驱动程序参数值应该作为BLOB
发送到服务器。
当使用setBinaryStream
方法时,驱动程序可能需要进行额外的工作才能确定参数数据是否应以LONGVARBINARY
或BLOB
发送到服务器
注意:请参考您的JDBC驱动程序文档,以确定使用setBlob
版本的setBlob
是否更有效,该版本需要一个长度参数。
parameterIndex
- 第一个参数的索引是1,第二个是2,...
inputStream
- 包含将参数值设置为的数据的对象。
SQLException
- 如果发生数据库访问错误,此方法在封闭的
PreparedStatement
上调用,或者如果parameterIndex与SQL语句中的参数标记不对应,
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException
InputStream
对象。
inputstream
必须包含由长度指定的SQLException
数, CallableStatement
在执行CallableStatement时将CallableStatement
。
该方法与setBinaryStream (int, InputStream, int)
方法不同,因为它通知驱动程序参数值应该作为BLOB
发送到服务器。
当使用setBinaryStream
方法时,驱动程序可能需要额外的工作才能确定参数数据是否应以LONGVARBINARY
或BLOB
发送到服务器
parameterName
- 要设置的第二个参数的名称是2,...
inputStream
- 包含要将参数值设置为的数据的对象。
length
- 参数数据中的字节数。
SQLException
- 如果parameterIndex与SQL语句中的参数标记不对应,或者指定的长度小于零;
如果输入流中的字节数与指定长度不匹配;
如果发生数据库访问错误或在封闭的CallableStatement
上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void setBlob(String parameterName, Blob x) throws SQLException
java.sql.Blob
对象。
当驱动程序将其发送到数据库时,将其转换为SQL BLOB
值。
parameterName
- 参数的名称
x
- 映射SQL
BLOB
值的
Blob
对象
SQLException
- 如果发生数据库访问错误或在封闭的
CallableStatement
上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void setBlob(String parameterName, InputStream inputStream) throws SQLException
InputStream
对象。
该方法与setBinaryStream (int, InputStream)
方法不同,因为它通知驱动程序参数值应该作为BLOB
发送到服务器。
当使用setBinaryStream
方法时,驱动程序可能需要额外的工作才能确定参数数据是否应以LONGVARBINARY
或BLOB
发送到服务器
注意:请参阅您的JDBC驱动程序文档,以确定使用setBlob
版本的setBlob
是否更有效,该版本需要一个长度参数。
parameterName
- 参数的名称
inputStream
- 包含用于设置参数值的数据的对象。
SQLException
- 如果发生数据库访问错误或在封闭的
CallableStatement
上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void setClob(int i, Clob x) throws SQLException
Clob
值在此RowSet
对象的命令中设置指定的Clob
。
驱动程序会将其转换为Clob
对象所CLOB
值,然后再将其发送到数据库。
i
- 第一个参数是1,第二个是2,...
x
- 表示CLOB的对象
SQLException
- 如果发生数据库访问错误
void setClob(int parameterIndex, Reader reader, long length) throws SQLException
Reader
对象。
读者必须包含由长度指定的SQLException
数, PreparedStatement
在执行PreparedStatement时将PreparedStatement
。
该方法与setCharacterStream (int, Reader, int)
方法不同,因为它通知驱动程序参数值应该作为CLOB
发送到服务器。
当使用setCharacterStream
方法时,驱动程序可能必须进行额外的工作来确定参数数据是否应以LONGVARCHAR
或CLOB
发送到服务器
parameterIndex
- 第一个参数的索引为1,第二个为2,...
reader
- 包含将参数值设置为的数据的对象。
length
- 参数数据中的字符数。
SQLException
- 如果发生数据库访问错误,该方法在封闭的
PreparedStatement
上调用,如果parameterIndex与SQL语句中的参数标记不对应,或者指定的长度小于零。
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
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驱动程序不支持此方法
void setClob(String parameterName, Reader reader, long length) throws SQLException
Reader
对象。
reader
必须包含由长度指定的SQLException
数,否则当执行CallableStatement时将CallableStatement
。
该方法与setCharacterStream (int, Reader, int)
方法不同,因为它通知驱动程序参数值应该作为CLOB
发送到服务器。
当使用setCharacterStream
方法时,驱动程序可能需要进行额外的工作来确定参数数据是否应以LONGVARCHAR
或CLOB
发送到服务器
parameterName
- 要设置的参数的名称
reader
- 包含将参数值设置为的数据的对象。
length
- 参数数据中的字符数。
SQLException
- 如果parameterIndex不对应于SQL语句中的参数标记;
如果指定的长度小于零;
发生数据库访问错误,或者在封闭的CallableStatement
上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void setClob(String parameterName, Clob x) throws SQLException
java.sql.Clob
对象。
当驱动程序将其发送到数据库时,将其转换为SQL CLOB
值。
parameterName
- 参数的名称
x
- 映射SQL
CLOB
值的
Clob
对象
SQLException
- 如果发生数据库访问错误或在封闭的方法上调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void setClob(String parameterName, Reader reader) throws SQLException
Reader
对象。
该方法与setCharacterStream (int, Reader)
方法不同,因为它通知驱动程序参数值应该作为CLOB
发送到服务器。
当使用setCharacterStream
方法时,驱动程序可能需要额外的工作才能确定参数数据是否应以LONGVARCHAR
或CLOB
发送到服务器
注:请参考JDBC驱动程序文档,以确定它可能是更有效地使用一个版本的setClob
其带长度参数。
parameterName
- 参数的名称
reader
- 包含用于设置参数值的数据的对象。
SQLException
- 如果发生数据库访问错误或此方法在封闭的
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void setArray(int i, Array x) throws SQLException
Array
值在此RowSet
对象的命令中设置指定的Array
。
驱动程序将此转换为ARRAY
,该值Array
对象将它发送到数据库之前代表。
i
- 第一个参数是1,第二个是2,...
x
- 表示SQL数组的对象
SQLException
- 如果发生数据库访问错误
void setDate(int parameterIndex, Date x, Calendar cal) throws SQLException
java.sql.Date
值在此RowSet
对象的命令中设置指定的java.sql.Date
。
驱动程序将其转换为SQL DATE
值,使用给定的java.util.Calendar
对象计算日期。
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 参数值
cal
- 用于计算日期的
java.util.Calendar
对象
SQLException
- 如果发生数据库访问错误
void setDate(String parameterName, Date x) throws SQLException
java.sql.Date
设置为给定的java.sql.Date
值。
当驱动程序将其发送到数据库时,将其转换为SQL DATE
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或在封闭的
CallableStatement
上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
ResultSet.getDate(int)
void setDate(String parameterName, Date x, Calendar cal) throws SQLException
Calendar
对象将指定的Calendar
设置为给定的java.sql.Date
值。
驱动程序使用Calendar
对象来构造一个SQL DATE
值,然后驱动程序将其发送到数据库。
使用aa Calendar
对象,驱动程序可以计算考虑到自定义时区的日期。
如果没有Calendar
对象,则驱动程序使用默认时区,即运行应用程序的虚拟机的时区。
parameterName
- 参数的名称
x
- 参数值
cal
- 驱动程序将用于构建日期的
Calendar
对象
SQLException
- 如果发生数据库访问错误或在封闭的方法上调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
ResultSet.getDate(int)
void setTime(int parameterIndex, Time x, Calendar cal) throws SQLException
java.sql.Time
值在此RowSet
对象的命令中设置指定的java.sql.Time
。
驱动程序将其转换为SQL TIME
值,使用给定的java.util.Calendar
对象进行计算,然后再将其发送到数据库。
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 参数值
cal
- 用于计算时间的
java.util.Calendar
对象
SQLException
- 如果发生数据库访问错误
void setTime(String parameterName, Time x) throws SQLException
java.sql.Time
值。
当驱动程序将其发送到数据库时将其转换为SQL TIME
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或者在关闭的
CallableStatement
调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
ResultSet.getTime(int)
void setTime(String parameterName, Time x, Calendar cal) throws SQLException
Calendar
对象将指定的Calendar
设置为给定的java.sql.Time
值。
驱动程序使用Calendar
对象来构造一个SQL TIME
值,然后驱动程序将其发送到数据库。
使用aa Calendar
对象,驱动程序可以计算考虑到自定义时区的时间。
如果没有Calendar
对象,则驱动程序使用默认时区,即运行应用程序的虚拟机的时区。
parameterName
- 参数的名称
x
- 参数值
cal
- 驱动程序将用于构建时间的
Calendar
对象
SQLException
- 如果发生数据库访问错误或此方法在封闭的
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
ResultSet.getTime(int)
void setTimestamp(int parameterIndex, Timestamp x, Calendar cal) throws SQLException
java.sql.Timestamp
值设置此RowSet
对象的命令中的指定java.sql.Timestamp
。
驱动程序将其转换为SQL TIMESTAMP
值,使用给定的java.util.Calendar
对象来计算它,然后将其发送到数据库。
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 参数值
cal
-所述
java.util.Calendar
对象使用用于计算时间戳
SQLException
- 如果发生数据库访问错误
void setTimestamp(String parameterName, Timestamp x, Calendar cal) throws SQLException
Calendar
对象将指定的Calendar
设置为给定的java.sql.Timestamp
值。
驱动程序使用Calendar
对象构造一个SQL TIMESTAMP
值,然后驱动程序将其发送到数据库。
使用aa Calendar
对象,驱动程序可以计算考虑到自定义时区的时间戳。
如果没有Calendar
对象,则驱动程序使用默认时区,即运行应用程序的虚拟机的时区。
parameterName
- 参数的名称
x
- 参数值
cal
-在
Calendar
对象的驱动程序将用来构造时间戳
SQLException
- 如果发生数据库访问错误或此方法在封闭的
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
ResultSet.getTimestamp(int)
void clearParameters() throws SQLException
RowSet
对象的命令设置的参数。
通常,参数值保持有效,以重复使用RowSet
对象。 设置参数值将自动清除其以前的值。 然而,在某些情况下,立即释放当前参数值所使用的资源是有用的,可以通过调用方法clearParameters
来完成。
SQLException
- 如果发生数据库访问错误
void execute() throws SQLException
RowSet
对象。
execute
方法可以使用以下属性创建用于读取数据的连接:url,数据源名称,用户名,密码,事务隔离和类型映射。 execute
方法可以使用以下属性来创建一个语句来执行命令:command,只读,最大字段大小,最大行,转义处理和查询超时。
如果尚未设置必需属性,则抛出异常。 如果此方法成功,则会舍弃行集的当前内容,并重新设置行集的元数据。 如果有未完成的更新,它们将被忽略。
如果此RowSet
对象不与其数据源保持连续的连接,则它可能会使用读取器( RowSetReader
对象)来填充数据。 在这种情况下,读者将已经注册到该RowSet
对象,并且方法execute
将作为其实现的一部分来呼叫读者的readData
方法。
SQLException
- 如果发生数据库访问错误或者没有设置连接和创建语句所需的任何属性
void addRowSetListener(RowSetListener listener)
RowSet
对象上的事件。
listener
- 已实现RowSetListener
RowSetListener
组件,并希望在此
RowSet
对象发生事件时收到通知
removeRowSetListener(javax.sql.RowSetListener)
void removeRowSetListener(RowSetListener listener)
RowSet
对象发生事件时将被通知的组件列表中删除指定的侦听器。
listener
- 已被注册为此
RowSet
对象的侦听器的
RowSet
addRowSetListener(javax.sql.RowSetListener)
void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException
java.sql.SQLXML
对象。
当驱动程序将其发送到数据库时,将其转换为SQL XML
值。
parameterIndex
- 第一个参数的索引是1,第二个是2,...
xmlObject
- 映射SQL
XML
值的
SQLXML
对象
SQLException
-如果发生数据库访问错误,该方法被称为上关闭的结果集, java.xml.transform.Result
, Writer
或OutputStream
尚未收为SQLXML
对象或者如果存在一个错误处理XML值。
getCause
方法可能会提供更详细的异常,例如,如果流不包含有效的XML。
void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException
java.sql.SQLXML
对象。
当驱动程序将其发送到数据库时,将其转换为SQL XML
值。
parameterName
- 参数的名称
xmlObject
- 一个
SQLXML
对象,映射
SQL XML
值
SQLException
-如果发生数据库访问错误,该方法被称为上关闭的结果集, java.xml.transform.Result
, Writer
或OutputStream
尚未收为SQLXML
对象或者如果存在一个错误处理XML值。
getCause
方法可能会提供更详细的异常,例如,如果流不包含有效的XML。
void setRowId(int parameterIndex, RowId x) throws SQLException
java.sql.RowId
对象。
当驱动程序将其发送到数据库时,将其转换为SQL ROWID
值
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 参数值
SQLException
- 如果发生数据库访问错误
void setRowId(String parameterName, RowId x) throws SQLException
java.sql.RowId
对象。
当驱动程序将其发送到数据库时,将其转换为SQL ROWID
。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误
void setNString(int parameterIndex, String value) throws SQLException
String
对象。
驱动程序将其转换为SQL NCHAR
或NVARCHAR
或LONGNVARCHAR
值(取决于相对于NVARCHAR
值的驱动程序限制的参数大小)将其发送到数据库时。
parameterIndex
- 第一个参数是1,第二个是2,...
value
- 参数值
SQLException
- 如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
或者发生数据库访问错误
void setNString(String parameterName, String value) throws SQLException
String
对象。
驱动程序将其转换为SQL NCHAR
或NVARCHAR
或LONGNVARCHAR
parameterName
- 要设置的列的名称
value
- 参数值
SQLException
- 如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
或者发生数据库访问错误
void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException
Reader
对象。
Reader
读取数据,直到达到文件结尾。
驱动程序必须从Java字符格式转换为数据库中的国家字符集。
parameterIndex
- 第一个参数是1,第二个是2,...
value
- 参数值
length
- 参数数据中的字符数。
SQLException
- 如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
或者发生数据库访问错误
void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException
Reader
对象。
Reader
读取数据,直到达到文件结尾。
驱动程序必须从Java字符格式转换为数据库中的国家字符集。
parameterName
- 要设置的列的名称
value
- 参数值
length
- 参数数据中的字符数。
SQLException
- 如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
或者发生数据库访问错误
void setNCharacterStream(String parameterName, Reader value) throws SQLException
Reader
对象。
Reader
读取数据,直到达到文件结尾。
驱动程序必须从Java字符格式转换为数据库中的国家字符集。
注意:此流对象可以是标准Java流对象,也可以是实现标准接口的自己的子类。
注意:请参阅您的JDBC驱动程序文档,以确定使用setNCharacterStream
版本的setNCharacterStream
是否更有效,该版本需要一个长度参数。
parameterName
- 参数的名称
value
- 参数值
SQLException
- 如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
如果发生数据库访问错误;
或者这个方法在封闭的CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void setNClob(String parameterName, NClob value) throws SQLException
java.sql.NClob
对象。
该对象实现了java.sql.NClob
接口。
这个NClob
对象映射到一个SQL NCLOB
。
parameterName
- 要设置的列的名称
value
- 参数值
SQLException
- 如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
或者发生数据库访问错误
void setNClob(String parameterName, Reader reader, long length) throws SQLException
Reader
对象。
reader
必须包含由长度指定的SQLException
数, CallableStatement
在执行CallableStatement时将CallableStatement
。
该方法与setCharacterStream (int, Reader, int)
方法不同,因为它通知驱动程序参数值应该作为NCLOB
发送到服务器。
当使用setCharacterStream
方法时,驱动程序可能需要额外的工作才能确定参数数据是否应以LONGNVARCHAR
或NCLOB
发送到服务器
parameterName
- 要设置的参数的名称
reader
- 包含用于设置参数值的数据的对象。
length
- 参数数据中的字符数。
SQLException
- 如果parameterIndex不对应于SQL语句中的参数标记;
如果指定的长度小于零;
如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
如果发生数据库访问错误或在封闭的CallableStatement
上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void setNClob(String parameterName, Reader reader) throws SQLException
Reader
对象。
该方法不同于setCharacterStream (int, Reader)
方法,因为它通知驱动程序参数值应该作为NCLOB
发送到服务器。
当使用setCharacterStream
方法时,驱动程序可能需要额外的工作才能确定参数数据是否应以LONGNVARCHAR
或NCLOB
发送到服务器
注:请参考JDBC驱动程序文档,以确定它可能是更有效地使用一个版本的setNClob
其带长度参数。
parameterName
- 参数的名称
reader
- 包含将参数值设置为的数据的对象。
SQLException
- 如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
如果发生数据库访问错误或在封闭的CallableStatement
上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void setNClob(int parameterIndex, Reader reader, long length) throws SQLException
Reader
对象。
读者必须包含由长度指定的SQLException
数, PreparedStatement
在执行PreparedStatement时将PreparedStatement
。
该方法与setCharacterStream (int, Reader, int)
方法不同,因为它通知驱动程序参数值应作为NCLOB
发送到服务器。
当使用setCharacterStream
方法时,驱动程序可能需要额外的工作才能确定参数数据是否应以LONGNVARCHAR
或NCLOB
发送到服务器
parameterIndex
- 第一个参数的索引是1,第二个是2,...
reader
- 包含将参数值设置为的数据的对象。
length
- 参数数据中的字符数。
SQLException
- 如果parameterIndex不对应于SQL语句中的参数标记;
如果指定的长度小于零;
如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
如果发生数据库访问错误或在封闭的PreparedStatement
上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
void setNClob(int parameterIndex, NClob value) throws SQLException
java.sql.NClob
对象。
当驱动程序将其发送到数据库时,将其转换为SQL NCLOB
值。
parameterIndex
- 第一个参数是1,第二个是2,...
value
- 参数值
SQLException
- 如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
或者发生数据库访问错误
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驱动程序不支持此方法
void setURL(int parameterIndex, URL x) throws SQLException
java.net.URL
值。
当驱动程序将其发送到数据库时,将其转换为SQL DATALINK
值。
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 要设置的
java.net.URL
对象
SQLException
- 如果发生数据库访问错误或在封闭的方法上调用此方法
PreparedStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.