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, wasNullisWrapperFor, unwrapString 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.