public abstract class BaseRowSet extends Object implements Serializable, Cloneable
RowSet
对象及其基本功能。
基本功能包括具有所有JavaBeans组件必须实现的属性和发送事件通知。
BaseRowSet
类提供了所有RowSet
实现的核心功能,所有标准实现都可以将此类与一个或多个RowSet
接口组合使用,以提供标准的供应商特定实现。
为了澄清,所有实现都必须实现的中的至少一个RowSet
接口( JdbcRowSet
, CachedRowSet
, JoinRowSet
, FilteredRowSet
,或WebRowSet
)。
这意味着,扩展了任何实现BaseRowSet
类也必须实现的一个RowSet
接口。
BaseRowSet
类提供以下内容:
RowSet
对象的命令中设置参数 RowSet
实现的方式以及它获取数据的方式。
例如,从ResultSet
对象获取其数据的行集需要设置进行数据库连接所需的属性。
如果RowSet
对象使用DriverManager
工具进行连接,则需要为标识适当驱动程序的JDBC URL设置属性,并且需要设置提供用户名和密码的属性。
另一方面,如果行集使用DataSource
对象进行连接,这是首选方法,则不需要为JDBC URL设置属性。
相反,它需要为数据源的逻辑名称以及用户名和密码的属性设置属性。
注意:为了使用DataSource
对象进行连接, DataSource
对象必须已被注册到使用Java命名和目录接口(JNDI)API的命名服务。 这种注册通常由以系统管理员身份行事的人员完成。
ResultSet
对象的命令(一个查询)。
此查询是为RowSet
对象的命令属性设置的命令。
行集通过从ResultSet
对象读取数据本身来填充数据。
如果查询包含要设置的值的BaseRowSet
,则使用BaseRowSet
setter方法来设置这些值。
如果需要,所有设置器方法都允许将这些值设置为null
。
以下代码片段说明了CachedRowSet
对象crs
如何设置其命令属性。 请注意,如果使用工具来设置属性,则这是该工具将使用的代码。
crs.setCommand("SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS" + "WHERE CREDIT_LIMIT > ? AND REGION = ?");
在这个例子中, CREDIT_LIMIT
和REGION
的值是占位符参数,它们用问号(?)表示。 第一个问号是占位符参数号1
,第二个问号是占位符参数号2
,依此类推。 在执行查询之前,必须使用值设置任何占位符参数。 要设置这些占位符参数,该BaseRowSet
类别提供一组的设置方法,类似于由提供的那些PreparedStatement
接口,用于设置每个数据类型的值。 RowSet
对象在内部存储参数值,其execute
方法在内部使用它们来设置占位符参数的值,然后将其发送到要执行的DBMS。
以下代码片段演示如何从上一个示例中设置查询中的两个参数。
crs.setInt(1, 5000); crs.setString(2, "West");
如果此时execute
方法,发送到DBMS的查询将是:
"SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS" + "WHERE CREDIT_LIMIT > 5000 AND REGION = 'West'"
注:设置Array
, Clob
, Blob
和Ref
对象作为命令参数,存储这些值作为SerialArray
, SerialClob
, SerialBlob
和SerialRef
分别对象。
BaseRowSet
类提供了两种设置方法,即设置属性和设置占位符参数的方法。
本节讨论的setter方法是设置占位符参数的方法。
使用BaseRowSet
setter方法设置的占位符参数作为对象存储在内部Hashtable
对象中。 基元存储为Object
类型。 例如, byte
存储为Byte
对象,而int
存储为Integer
对象。 当调用方法execute
时, Hashtable
对象中的值将Hashtable
命令中适当的占位符参数。
该方法的调用getParams
返回存储在所述值Hashtable
对象的阵列Object
实例。 该数组中的一个元素可能是一个简单的Object
实例或一个数组(它是一种类型的Object
)。 使用的特定setter方法确定此数组中的元素是否为Object
或数组。
用于设置占位符参数的大多数方法都有两个参数,第一个参数指示要设置的占位符参数,第二个参数给出要设置的值。 法如setInt
, setString
, setBoolean
和setLong
都属于这一类。 调用这些方法之后,对方法getParams
的调用将返回一个已经设置的值的数组。 数组中的每个元素都是一个Object
实例,表示已设置的值。 数组中这些值的顺序由传递给setter方法的int
(第一个参数)确定。 数组中的值是传递给setter方法的值(第二个参数)。 换句话说,数组中的第一个元素是在RowSet
对象的命令中为第一个占位符参数设置的值。 第二个元素是为第二个占位符参数设置的值,依此类推。
几个setter方法发送驱动程序和DBMS信息超出要设置的值。 当方法getParams
在使用这些设置器方法之一之后被调用时,数组中的元素本身将是数组以容纳附加信息。 在此类别中,方法setNull
是一种特殊情况,因为一个版本只需要两个参数( setNull(int parameterIndex, int SqlType)
)。 然而,它需要一个数组来包含传递给驱动程序和DBMS的信息。 该数组中的第一个元素是要设置的值,即null
,第二个元素是为sqlType提供的int
,它指示正在设置为null
的SQL值的类型。 某些DBMS需要此信息,因此需要这些信息才能确保应用程序可移植。 当要设置为null
的值是用户定义的类型时,将使用其他版本。 它需要三个参数( setNull(int parameterIndex, int sqlType, String typeName)
),并且还需要一个数组来包含要传递给驱动程序和DBMS的信息。 此阵列中的前两个元素与第一个版本的setNull
。 第三个元素typeName给出了用户定义类型的SQL名称。 与其他setter方法一样,要设置的占位符参数的数量由元素在getParams
返回的数组中的位置getParams
。 因此,举例来说,如果供应到参数setNull
是2
,所述阵列中由返回的第二元件getParams
将两个或三个元素的阵列。
一些方法,例如setObject
和setDate
具有采用两个以上setDate
的版本,额外的参数给驱动程序或DBMS提供信息。 例如,该方法setDate
, setTime
和setTimestamp
可以采取Calendar
对象作为其第三个参数。 如果DBMS不存储时区信息时,驱动程序使用Calendar
对象构造Date
, Time
,或Timestamp
对象被设置。 由于是与提供附加信息的其他方法为真,由返回的数组中的元素getParams
是一个数组,而不是一个简单的Object
实例。
方法setAsciiStream
, setBinaryStream
, setCharacterStream
和setUnicodeStream
(其已过时,所以应用程序应使用getCharacterStream
代替)取三个参数,因此对他们来说,由返回的数组中的元素getParams
也是一个数组。 这些setter方法的不同之处在于,除了由参数提供的信息之外,该数组还包含一个BaseRowSet
常量,指示正在设置的流的类型。
注意:方法getParams
由RowSet
此类的RowSet实现内部调用; 应用程序员通常不会直接调用它。
BaseRowSet
类为行集提供事件通知机制。
它包含字段listeners
,用于添加和删除侦听器的方法,以及通知侦听器更改的方法。
监听器是一个实现了RowSetListener
接口的对象。 如果已将其添加到RowSet
对象的RowSet
器列表中,那么在RowSet
对象发生事件时将被通知。 每个听者的实施RowSetListener
方法定义,当被通知已发生的事件对象会做些什么。
RowSet
对象有三个可能的事件:
RowSet
对象的内容发生变化 用于BaseRowSet
方法指示发生的事件的类型。 例如,方法notifyRowChanged
表示行已被更新,删除或插入。 每个通知方法都创建一个RowSetEvent
对象,该对象提供给侦听器,以便识别发生事件的RowSet
对象。 监听者对这些信息的处理方式取决于实现方式。
BaseRowSet
对象被初始化为许多起始值。
以下是扩展BaseRowSet
类的默认RowSet
实例:
RowSet
对象的命令可能需要多长时间。 BINARY
, VARBINARY
, LONGVARBINARY
, CHAR
, VARCHAR
和LONGVARCHAR
。 null
。 Vector
对象,用于存储在RowSet
对象的命令中为RowSet
参数设置的值。 如果需要其他值,则应用程序必须显式设置属性值。 例如,以下代码行将CachedRowSet
对象crs的最大行数设置为500。
crs.setMaxRows(500);
在此的扩展实现的方法BaseRowSet
类必须抛出一个SQLException
对象对任何违反规定的断言。
此外,如果扩展类覆盖并重新实现任何BaseRowSet
方法并遇到连接或基础数据源问题,那么该方法可能会由于该原因而抛出一个SQLException
对象。
Modifier and Type | Field and Description |
---|---|
static int |
ASCII_STREAM_PARAM
一个常量,表示一个给定参数是一个ASCII流的
RowSetReaderImpl 对象。
|
protected InputStream |
asciiStream
InputStream 对象将由方法
getAsciiStream 返回,该方法在
ResultSet 界面中指定。
|
static int |
BINARY_STREAM_PARAM
一个常量,指示一个给定的参数是一个二进制流的一个
RowSetReaderImpl 对象。
|
protected InputStream |
binaryStream
InputStream 对象将通过
getBinaryStream 方法返回,该方法在
ResultSet 接口中指定。
|
protected Reader |
charStream
Reader 对象将通过方法
getCharacterStream 返回,该方法在
ResultSet 接口中指定。
|
static int |
UNICODE_STREAM_PARAM
一个常量,表示一个
RowSetReaderImpl 对象,一个给定的参数是一个Unicode流。
|
protected InputStream |
unicodeStream
InputStream 对象将由方法
getUnicodeStream 返回,该方法在
ResultSet 界面中指定。
|
Constructor and Description |
---|
BaseRowSet()
构造一个新的
BaseRowSet 对象,其
listeners 为其
listeners 字段的默认
Vector 对象。
|
Modifier and Type | Method and Description |
---|---|
void |
addRowSetListener(RowSetListener listener)
当这个
RowSet 对象发生事件时,监听器将被通知。
|
void |
clearParameters()
清除此
RowSet 对象在执行此
RowSet 对象的命令时要设置的参数的内部表示形式中的所有当前参数值。
|
String |
getCommand()
检索作为此
RowSet 对象的命令的SQL查询。
|
int |
getConcurrency()
返回此
RowSet 对象的
RowSet 。
|
String |
getDataSourceName()
返回逻辑名称,当提供给使用Java命名和目录接口(JNDI)API的命名服务时,它将检索
javax.sql.DataSource 对象。
|
boolean |
getEscapeProcessing()
确定是否为此
RowSet 对象启用了转义处理。
|
int |
getFetchDirection()
检索此
RowSet 对象的抓取方向的当前设置。
|
int |
getFetchSize()
返回此
RowSet 对象的提取大小。
|
int |
getMaxFieldSize()
检索此
RowSet 对象中可用于列值的最大字节数。
|
int |
getMaxRows()
检索此
RowSet 对象可能包含的最大行数。
|
Object[] |
getParams()
检索一个数组,其中包含已为此
RowSet 对象的命令设置的参数值(对象和基元),如果尚未设置所有参数,则抛出一个
SQLException 对象。
|
String |
getPassword()
用于创建此
RowSet 对象的数据库连接的密码。
|
int |
getQueryTimeout()
检索驱动程序等待查询执行的最大秒数。
|
boolean |
getShowDeleted()
检索一个
boolean 指示标记为删除的行是否显示在当前行的集合中。
|
int |
getTransactionIsolation()
返回此
RowSet 对象的连接的事务隔离属性。
|
int |
getType()
返回此
RowSet 对象的类型。
|
Map<String,类<?>> |
getTypeMap()
检索与该关联的类型映射
Connection 对象此
RowSet 对象。
|
String |
getUrl()
检索此
RowSet 对象的
javax.sql.Reader 对象用于使用启用了JDBC技术的驱动程序与关系数据库建立连接的JDBC URL。
|
String |
getUsername()
返回用于创建数据库连接的用户名。
|
protected void |
initParams()
执行必需的内部配置和初始化,从而允许所有JDBC
RowSet 实现开始使用由提供的标准设施
BaseRowSet 实例。
|
boolean |
isReadOnly()
返回一个
boolean 指示此
RowSet 对象是否为只读。
|
protected void |
notifyCursorMoved()
通知所有注册此
RowSet 对象的
RowSet 器,它的光标已经移动。
|
protected void |
notifyRowChanged()
通知所有注册此
RowSet 对象的
RowSet 器,其中一行已更改。
|
protected void |
notifyRowSetChanged()
通知所有注册此
RowSet 对象的
RowSet ,其全部内容已更改。
|
void |
removeRowSetListener(RowSetListener listener)
从这个
RowSet 对象的
RowSet 器列表中删除指定的对象。
|
void |
setArray(int parameterIndex, Array array)
将指定的参数设置为Java编程语言中的
Array 对象。
|
void |
setAsciiStream(int parameterIndex, InputStream x)
将此
RowSet 对象的命令中的指定参数设置为给定的输入流。
|
void |
setAsciiStream(int parameterIndex, InputStream x, int length)
将指定的参数设置为给定的
java.io.InputStream 对象,该对象将具有指定的字节数。
|
void |
setAsciiStream(String parameterName, InputStream x)
将指定的参数设置为给定的输入流。
|
void |
setAsciiStream(String parameterName, InputStream x, int length)
将指定的参数设置为给定的输入流,它将具有指定的字节数。
|
void |
setBigDecimal(int parameterIndex, BigDecimal x)
将指定的参数设置为给定的
java.lang.BigDecimal 值。
|
void |
setBigDecimal(String parameterName, BigDecimal x)
将指定的参数设置为给定的
java.math.BigDecimal 值。
|
void |
setBinaryStream(int parameterIndex, InputStream x)
将此
RowSet 对象的命令中的指定参数设置为给定的输入流。
|
void |
setBinaryStream(int parameterIndex, InputStream x, int length)
将指定的参数设置为给定的
java.io.InputStream 对象,该对象将具有指定的字节数。
|
void |
setBinaryStream(String parameterName, InputStream x)
将指定的参数设置为给定的输入流。
|
void |
setBinaryStream(String parameterName, InputStream x, int length)
将指定的参数设置为给定的输入流,它将具有指定的字节数。
|
void |
setBlob(int parameterIndex, Blob x)
将指定的参数设置为Java编程语言中给定的
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)
将指定的参数设置为Java编程语言中给定的
boolean 。
|
void |
setBoolean(String parameterName, boolean x)
将指定的参数设置为给定的Java
boolean 值。
|
void |
setByte(int parameterIndex, byte x)
将指定的参数设置为Java编程语言中给定的
byte 。
|
void |
setByte(String parameterName, byte x)
将指定的参数设置为给定的Java
byte 值。
|
void |
setBytes(int parameterIndex, byte[] x)
将指定的参数设置为给定的字节数组。
|
void |
setBytes(String parameterName, byte[] x)
将指定的参数设置为给定的Java字节数组。
|
void |
setCharacterStream(int parameterIndex, Reader reader)
将此
RowSet 对象的命令中的指定参数设置为给定的
Reader 对象。
|
void |
setCharacterStream(int parameterIndex, Reader reader, int length)
将指定的参数设置为给定的
java.io.Reader 对象,该对象将具有指定的字符数。
|
void |
setCharacterStream(String parameterName, Reader reader)
将指定的参数设置为给定的
Reader 对象。
|
void |
setCharacterStream(String parameterName, Reader reader, int length)
将指定的参数设置为给定的
Reader 对象,这是给定的长度的字符数。
|
void |
setClob(int parameterIndex, Clob x)
将指定的参数设置为Java编程语言中给定的
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 对象的
command 属性设置为给定的
String 对象,并清除为先前命令设置的参数(如果有)。
|
void |
setConcurrency(int concurrency)
将此
RowSet 对象的并发设置为指定的并发。
|
void |
setDataSourceName(String name)
将此
RowSet 对象的
DataSource 名称属性设置为给定的逻辑名称,并将此
RowSet 对象的Url属性设置为
null 。
|
void |
setDate(int parameterIndex, Date x)
将指定的参数设置为给定的
java.sql.Date 值。
|
void |
setDate(int parameterIndex, Date x, Calendar cal)
将指定的参数设置为给定的
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)
将指定的参数设置为Java编程语言中给定的
double 。
|
void |
setDouble(String parameterName, double x)
将指定的参数设置为给定的Java
double 值。
|
void |
setEscapeProcessing(boolean enable)
设置为给定的
boolean 驱动程序是否将扫描转义语法,并在将SQL语句发送到数据库之前执行转义替换。
|
void |
setFetchDirection(int direction)
给驱动程序提供一个关于将处理此
RowSet 对象中的行的方向的性能提示。
|
void |
setFetchSize(int rows)
将此
RowSet 对象的提取大小设置为给定的行数。
|
void |
setFloat(int parameterIndex, float x)
将指定的参数设置为Java编程语言中给定的
float 。
|
void |
setFloat(String parameterName, float x)
将指定的参数设置为给定的Java
float 值。
|
void |
setInt(int parameterIndex, int x)
将指定参数设置到
int 在Java编程语言。
|
void |
setInt(String parameterName, int x)
将指定的参数设置为给定的Java
int 值。
|
void |
setLong(int parameterIndex, long x)
将指定的参数设置为Java编程语言中给定的
long 。
|
void |
setLong(String parameterName, long x)
将指定的参数设置为给定的Java
long 值。
|
void |
setMaxFieldSize(int max)
将此
RowSet 对象中的列值的最大字节数设置为给定的数字。
|
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)
将指定的参数设置为SQL
NULL 。
|
void |
setNull(int parameterIndex, int sqlType, String typeName)
将指定的参数设置为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)
将指定参数设置到
Object 在Java编程语言。
|
void |
setObject(int parameterIndex, Object x, int targetSqlType)
使用给定的
Object 值设置指定
Object 值。
|
void |
setObject(int parameterIndex, Object x, int targetSqlType, int scale)
将指定参数设置到
Object 在Java编程语言。
|
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 pass)
设置用于创建此数据库连接的密码
RowSet 对象与给定
String 对象。
|
void |
setQueryTimeout(int seconds)
将给定的数字设置为驱动程序等待查询执行的最大秒数。
|
void |
setReadOnly(boolean value)
将此
RowSet 对象的readOnly属性设置为给定的
boolean 。
|
void |
setRef(int parameterIndex, Ref ref)
将指定的参数设置为Java编程语言中给定的
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)
将指定的参数设置为Java编程语言中给定的
short 。
|
void |
setShort(String parameterName, short x)
将指定的参数设置为给定的Java
short 值。
|
void |
setShowDeleted(boolean value)
将属性
showDeleted 设置为给定的
boolean 值,该值确定标记为删除的行是否显示在当前行的集合中。
|
void |
setSQLXML(int parameterIndex, SQLXML xmlObject)
将指定的参数设置为给定的
java.sql.SQLXML 对象。
|
void |
setSQLXML(String parameterName, SQLXML xmlObject)
将指定的参数设置为给定的
java.sql.SQLXML 对象。
|
void |
setString(int parameterIndex, String x)
将指定的参数设置为给定的
String 值。
|
void |
setString(String parameterName, String x)
将指定的参数设置为给定的Java
String 值。
|
void |
setTime(int parameterIndex, Time x)
将指定的参数设置为给定的
java.sql.Time 值。
|
void |
setTime(int parameterIndex, Time x, Calendar cal)
将指定的参数设置为给定的
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)
将指定的参数设置为给定的
java.sql.Timestamp 值。
|
void |
setTimestamp(int parameterIndex, Timestamp x, Calendar cal)
将指定的参数设置为给定的
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)
将此JDBC
RowSet 对象的事务隔离属性设置为给定常量。
|
void |
setType(int type)
将此
RowSet 对象的类型设置为指定的类型。
|
void |
setTypeMap(Map<String,类<?>> map)
将给定的
java.util.Map 对象作为与该
Connection 对象的
RowSet 对象相关
Connection 的类型映射。
|
void |
setUnicodeStream(int parameterIndex, InputStream x, int length)
已弃用
getCharacterStream应该用于它的位置
|
void |
setURL(int parameterIndex, URL x)
将指定的参数设置为给定的
java.net.URL 值。
|
void |
setUrl(String url)
将此
RowSet 对象的Url属性设置为给定的
String 对象,并将dataSource名称属性设置为
null 。
|
void |
setUsername(String name)
将此
RowSet 对象的用户名属性设置为给定的用户名。
|
public static final int UNICODE_STREAM_PARAM
RowSetReaderImpl
对象。
该RowSetReaderImpl
对象作为SyncFactory
静态工厂SPI机制中定义的SyncProvider
抽象类的SyncFactory
提供。
public static final int BINARY_STREAM_PARAM
RowSetReaderImpl
对象。
RowSetReaderImpl
对象被提供作为SyncFactory
静态工厂SPI机制中定义的SyncProvider
抽象类的扩展。
public static final int ASCII_STREAM_PARAM
RowSetReaderImpl
对象。
RowSetReaderImpl
对象被提供作为SyncFactory
静态工厂SPI机制中定义的SyncProvider
抽象类的扩展。
protected InputStream binaryStream
InputStream
对象将由方法
getBinaryStream
返回,该方法在
ResultSet
接口中指定。
protected InputStream unicodeStream
InputStream
对象将由方法
getUnicodeStream
返回,该方法在
ResultSet
界面中指定。
protected InputStream asciiStream
InputStream
对象将由方法
getAsciiStream
返回,该方法在
ResultSet
界面中指定。
protected Reader charStream
Reader
对象将通过方法
getCharacterStream
返回,该方法在
ResultSet
接口中指定。
public BaseRowSet()
BaseRowSet
对象,其listeners
为其listeners
字段的默认Vector
对象。
其初始化的其他默认值在该类的类注释的第6.0节中列出。
protected void initParams()
RowSet
实现开始使用由提供的标准设施BaseRowSet
实例。
在RowSet
对象被实例化以正确初始化所有参数之后, 应该调用此方法。
此方法永远不应该由应用程序调用,而是从一个叫做RowSet
实现扩展此类。
public void addRowSetListener(RowSetListener listener)
RowSet
对象发生事件时,将通知侦听器。
例如,监听器可能是需要更新的表或图表,以便准确地反映RowSet
对象的当前状态。
注意 :如果RowSetListener
对象为null
,则此方法将静默地丢弃null
值,并且不会向该组侦听器添加空引用。
注意 :如果侦听器已设置,并且新的RowSetListerner
实例被添加到已经注册接收来自此RowSet
事件通知的侦听器的集合中。
listener
- 一个已实现javax.sql.RowSetListener
接口并希望通知发生在此RowSet
对象上的任何事件的对象;
可能为null。
removeRowSetListener(javax.sql.RowSetListener)
public void removeRowSetListener(RowSetListener listener)
RowSet
器列表中删除指定的对象。
如果给定的参数不是注册的侦听器,则此方法不执行任何操作。
注意 :如果RowSetListener
对象为null
,则此方法将静默地丢弃null
值。
listener
- 一个
RowSetListener
对象,该对象位于此
RowSet
对象的侦听器列表上
addRowSetListener(javax.sql.RowSetListener)
protected void notifyCursorMoved() throws SQLException
RowSet
对象的RowSet
器,其光标已移动。
当应用程序调用移动光标的方法时,该方法会移动光标,然后在内部调用此方法。 应用程序永远不应直接调用此方法。
SQLException
- 如果扩展
BaseRowSet
抽象类的类不实现
RowSet
接口或其一个子接口。
protected void notifyRowChanged() throws SQLException
RowSet
对象的RowSet
器,其中一行已更改。
当应用程序调用发生改变的行,如一个方法CachedRowSet
方法insertRow
, updateRow
,或deleteRow
,该方法调用notifyRowChanged
内部。 应用程序永远不应直接调用此方法。
SQLException
- 如果扩展
BaseRowSet
抽象类的类不实现
RowSet
接口或其一个子接口。
protected void notifyRowSetChanged() throws SQLException
RowSet
对象的RowSet
,其全部内容已更改。
当应用程序调用该改变的全部内容的方法RowSet
对象,如CachedRowSet
方法execute
, populate
, restoreOriginal
,或release
,该方法调用notifyRowSetChanged
内部(直接或间接)。 应用程序永远不应直接调用此方法。
SQLException
- 如果扩展
BaseRowSet
抽象类的类不实现
RowSet
接口或其一个子接口。
public String getCommand()
RowSet
对象的命令的SQL查询。
该命令属性包含将要执行的查询来填充此RowSet
对象。
该方法返回的SQL查询由RowSet
方法(例如execute
和populate
,可以由扩展BaseRowSet
抽象类并实现一个或多个标准JSR-114 RowSet
接口的任何类实现。
该命令由RowSet
对象的读者使用以获取一个ResultSet
对象。 然后,读者从ResultSet
对象读取数据,并使用它来填充此RowSet
对象。
command
属性的默认值为null
。
String
的价值是这个RowSet
对象的command
属性的值;
可能是null
setCommand(java.lang.String)
public void setCommand(String cmd) throws SQLException
RowSet
对象的command
属性设置为给定的String
对象,并清除为先前命令设置的参数(如果有)。
如果RowSet
对象从不支持命令的源(例如电子表格或其他表格文件)获取其数据,则可能不需要command
属性。 因此,此属性是可选的,可以是null
。
cmd
- 一个String
对象,包含一个将被设置RowSet
对象的命令属性的SQL查询;
可能是null
但可能不是一个空字符串
SQLException
- 如果提供空字符串作为命令值
getCommand()
public String getUrl() throws SQLException
RowSet
对象的javax.sql.Reader
对象用于使用启用JDBC技术的驱动程序与关系数据库建立连接的JDBC URL。
如果基础数据源是非SQL数据源(如电子表格或XML数据源),则Url
属性将为null
。
String
对象,它包含用于建立该连接的JDBC URL RowSet
对象;
可能是null
(默认值)如果没有设置
SQLException
- 如果检索URL值发生错误
setUrl(java.lang.String)
public void setUrl(String url) throws SQLException
RowSet
对象的Url属性设置为给定的String
对象,并将dataSource名称属性设置为null
。
Url属性是使用启用JDBC技术的驱动程序(“JDBC驱动程序”)和DriverManager
创建连接时使用的JDBC DriverManager
。
驱动程序文档中可以找到要使用的特定驱动程序的正确JDBC URL。
尽管有如何形成JDBC URL的准则,但驱动程序供应商可以指定任何String
对象,但长度为0
(空字符串)的对象除外。
设置Url属性是可选的,如果使用的是已建立的连接DataSource
的对象,而不是DriverManager
。 驱动程序将使用URL属性或dataSourceName属性创建连接,以最近指定的方式。 如果应用程序使用JDBC URL,则必须加载接受JDBC URL的JDBC驱动程序,然后才能使用RowSet
对象连接到数据库。 RowSet
对象将在内部使用URL来创建数据库连接,以便读取或写入数据。
url
- 一个String
对象,其中包含将用于建立与此RowSet
对象的数据库的连接的JDBC URL;
可能是null
但不能是空字符串
SQLException
- 如果发生错误,设置Url属性或提供的参数是长度为
0
(空字符串)的字符串,
getUrl()
public String getDataSourceName()
javax.sql.DataSource
对象的逻辑名称。
此DataSource
对象可用于建立与其所代表的数据源的连接。
用户应该设置url或数据源名称属性。 驱动程序将使用最近设置的属性来建立连接。
String
用于进行连接的DataSource
对象的DataSource
对象;
如果没有设置逻辑名称,则返回null
。
setDataSourceName(java.lang.String)
public void setDataSourceName(String name) throws SQLException
RowSet
对象的DataSource
名称属性设置为给定的逻辑名称,并将此RowSet
对象的Url属性设置为null
。
该名称必须已绑定到JNDI命名服务中的DataSource
对象,以便应用程序可以使用该名称查找使用该对象绑定的DataSource
对象。
然后可以使用DataSource
对象来建立与其表示的数据源的连接。
用户应该设置Url属性或dataSourceName属性。 如果两个属性均已设置,驱动程序将使用最近设置的属性。
name
- 一个String
对象,其名称可以基于JNDI技术提供给命名服务来检索可用于获取连接的DataSource
对象;
可能是null
但不能是一个空字符串
SQLException
- 如果提供一个空字符串作为
DataSource
名称
getDataSourceName()
public String getUsername()
execute
之前,username属性是在运行时设置的。
String
对象包含提供给数据源以创建连接的用户名;
可能是null
(默认值)如果没有设置
setUsername(java.lang.String)
public void setUsername(String name)
RowSet
对象的用户名属性设置为给定的用户名。
因为没有序列化,所以在调用方法execute
之前,在运行时设置了username属性。
name
- 包含提供给数据源以创建连接的用户名的String
对象。
它可能为null。
getUsername()
public String getPassword()
RowSet
对象的数据库连接的密码。
因为password属性未被序列化,所以在调用方法execute
之前,它将在运行时设置。
默认值为null
String
对象
setPassword(java.lang.String)
public void setPassword(String pass)
RowSet
对象与给定String
对象。
因为password属性未被序列化,所以在调用方法execute
之前,它将在运行时设置。
pass
- 表示提供给数据库创建连接的密码的String
对象。
它可能为null。
getPassword()
public void setType(int type) throws SQLException
RowSet
对象的类型设置为指定的类型。
默认类型为ResultSet.TYPE_SCROLL_INSENSITIVE
。
type
-一个以下常量:
ResultSet.TYPE_FORWARD_ONLY
,
ResultSet.TYPE_SCROLL_INSENSITIVE
,或
ResultSet.TYPE_SCROLL_SENSITIVE
SQLException
- 如果提供的参数不是以下常数之一:
ResultSet.TYPE_FORWARD_ONLY
或
ResultSet.TYPE_SCROLL_INSENSITIVE
ResultSet.TYPE_SCROLL_SENSITIVE
getConcurrency()
,
getType()
public int getType() throws SQLException
RowSet
对象的类型。
该类型最初由创建RowSet
对象的RowSet
。
RowSet
对象可以随时调用方法setType
来更改其类型。
默认值为TYPE_SCROLL_INSENSITIVE
。
RowSet
对象,它必须是下列之一:
ResultSet.TYPE_FORWARD_ONLY
,
ResultSet.TYPE_SCROLL_INSENSITIVE
,或
ResultSet.TYPE_SCROLL_SENSITIVE
SQLException
- 如果发生错误,得到此
RowSet
对象的类型
setType(int)
public void setConcurrency(int concurrency) throws SQLException
RowSet
对象的并发设置为指定的并发。
任何RowSet
对象(连接或断开连接)的默认并发性为ResultSet.CONCUR_UPDATABLE
,但是可以随时调用此方法来更改并发。
concurrency
- 以下常数之一:
ResultSet.CONCUR_READ_ONLY
或
ResultSet.CONCUR_UPDATABLE
SQLException
- 如果提供的参数不是以下常数之一:
ResultSet.CONCUR_UPDATABLE
或
ResultSet.CONCUR_READ_ONLY
getConcurrency()
,
isReadOnly()
public boolean isReadOnly()
boolean
指示此RowSet
对象是否为只读。
任何尝试更新只读RowSet
对象将导致SQLException
被抛出。
默认情况下,如果可以进行更新,则行集可更新。
true
如果这个RowSet
对象无法更新;
false
否则
setConcurrency(int)
,
setReadOnly(boolean)
public void setReadOnly(boolean value)
RowSet
对象的readOnly属性设置为给定的
boolean
。
value
- true
以表示此RowSet
对象是只读的;
false
表示它是可更新的
public int getTransactionIsolation()
RowSet
对象的连接的事务隔离属性。
此属性表示请求用于事务的事务隔离级别。
对于RowSet
实现,例如在CachedRowSet
中工作的SyncProvider
对象提供了互补的锁定和数据完整性选项。 下面描述的选项仅与连接的RowSet
对象( JdbcRowSet
对象)相关。
Connection.TRANSACTION_NONE
,
Connection.TRANSACTION_READ_UNCOMMITTED
,
Connection.TRANSACTION_READ_COMMITTED
,
Connection.TRANSACTION_REPEATABLE_READ
,或
Connection.TRANSACTION_SERIALIZABLE
SyncFactory
, SyncProvider
, setTransactionIsolation(int)
public void setTransactionIsolation(int level) throws SQLException
RowSet
对象的事务隔离属性设置为给定的常量。
如果可以,DBMS将使用此事务隔离级别进行事务处理。
对于RowSet
实现,例如在CachedRowSet
中运行的CachedRowSet,所使用的SyncProvider
对象提供了互补的锁定和数据完整性选项。 下面描述的选项仅与连接的RowSet
对象( JdbcRowSet
对象)相关。
level
-一个以下常量,以升序列出:
Connection.TRANSACTION_NONE
,
Connection.TRANSACTION_READ_UNCOMMITTED
,
Connection.TRANSACTION_READ_COMMITTED
,
Connection.TRANSACTION_REPEATABLE_READ
,或
Connection.TRANSACTION_SERIALIZABLE
SQLException
- 如果给定的参数不是连接常量之一
SyncFactory
, SyncProvider
, getTransactionIsolation()
public Map<String,类<?>> getTypeMap()
Connection
对象此RowSet
对象。
支持JDBC 3.0 API的驱动程序将创建具有关联类型映射的Connection
对象。 最初为空的此类型映射可以包含一个或多个完全限定的SQL名称和类
对象,指示将命名的SQL值映射到的类。 连接类型映射中指定的类型映射在没有其他类型映射取代时用于自定义类型映射。
如果将类型映射显式提供给可执行自定义映射的方法,则该类型映射将取代连接的类型映射。
java.util.Map
对象是该
RowSet
对象的连接的类型映射
public void setTypeMap(Map<String,类<?>> map)
java.util.Map
对象作为与此Connection
对象的RowSet
对象相关Connection
的类型映射。
将使用此类型映射中指定的自定义映射,除非向方法明确提供不同类型的映射,否则将使用提供的类型映射。
map
- 一个java.util.Map
对象,其中包含从用户定义类型(UDT)的SQL类型名称到Java编程语言中的类的映射。
在每个条目Map
对象包括UDT的完全限定SQL名称和的类
对象为SQLData
的实现,UDT的。
可能是null
。
public int getMaxFieldSize() throws SQLException
RowSet
对象中可用于列值的最大字节数。
此限制仅适用于持有下列类型的值列: BINARY
, VARBINARY
, LONGVARBINARY
, CHAR
, VARCHAR
和LONGVARCHAR
。
如果超出限制,则会忽略多余的数据。
int
当前最大列大小限制的int
;
零意味着没有限制
SQLException
- 如果内部发生错误确定列大小的最大限制
public void setMaxFieldSize(int max) throws SQLException
RowSet
对象中的列值的最大字节数设置为给定的数字。
此限制仅适用于持有下列类型的值列: BINARY
, VARBINARY
, LONGVARBINARY
, CHAR
, VARCHAR
和LONGVARCHAR
。
如果超出限制,则会忽略多余的数据。
为了最大的可移植性,建议使用大于256的值。
max
- 表示新的最大列大小限制的int
;
零意味着没有限制
SQLException
- 如果(1)内部发生错误设置列大小的最大限制,或(2)设置小于0的大小
public int getMaxRows() throws SQLException
RowSet
对象可能包含的最大行数。
如果超出此限制,多余的行将被静默地删除。
int
指示当前最大行数;
零意味着没有限制
SQLException
- 如果内部发生错误确定
Rowset
对象可能包含的行的最大限制
public void setMaxRows(int max) throws SQLException
RowSet
对象可能包含的给定数量的最大行数。
如果超出此限制,多余的行将被静默地删除。
max
- 表示当前最大行数的int
;
零意味着没有限制
SQLException
- 如果内部发生错误,则设置JDBC RowSet
对象可以包含的行数的最大限制;
或者如果max小于0
;
或者如果max小于fetchSize
的RowSet
public void setEscapeProcessing(boolean enable) throws SQLException
boolean
驱动程序是否将扫描转义语法,并在将SQL语句发送到数据库之前执行转义替换。
默认是为了让司机做逃生处理。
注意:由于PreparedStatement
对象通常在进行此呼叫之前已被解析,所以禁用预处理语句的转义处理可能不起作用。
enable
- true
以实现逃生处理;
false
禁用它
SQLException
- 如果发生错误,设置启用基于JDBC技术的驱动程序来处理转义语法
public int getQueryTimeout() throws SQLException
SQLException
。
SQLException
- 如果在确定查询超时值时发生错误
public void setQueryTimeout(int seconds) throws SQLException
SQLException
。
seconds
- 新的查询超时限制(以秒为单位)
零意味着没有限制;
不得小于零
SQLException
- 如果发生错误,设置查询超时或查询超时值小于0
public boolean getShowDeleted() throws SQLException
boolean
指示标记为删除的行是否显示在当前行的集合中。
默认值为false
。
注意:允许删除的行保持可见会使某些方法的行为复杂化。 然而,大多数RowSet
对象用户可以简单地忽略这个额外的细节,因为只有复杂的应用程序可能希望利用此功能。
true
如果删除的行是可见的;
false
否则
SQLException
- 如果发生错误,确定删除的行是否可见
setShowDeleted(boolean)
public void setShowDeleted(boolean value) throws SQLException
showDeleted
设置为给定的
boolean
值,该值确定标记为删除的行是否显示在当前行的集合中。
value
- true
如果删除的行应显示;
false
否则
SQLException
- 如果发生错误设置删除的行是否可见
getShowDeleted()
public boolean getEscapeProcessing() throws SQLException
RowSet
对象启用了转义处理。
true
如果启用逃生处理;
false
否则
SQLException
- 如果发生错误,确定是否启用转义处理,或者内部转义处理触发器是否未启用
public void setFetchDirection(int direction) throws SQLException
RowSet
对象中的行的方向的性能提示。
司机可能会忽略这个提示。
一个RowSet
对象继承了它获取数据的ResultSet
对象的默认属性。 ResultSet
对象的默认抓取方向由创建它的Statement
对象设置。
只有当使用JDBC驱动程序连接到数据库时,此方法才适用于RowSet
对象。
RowSet
对象可以随时使用此方法来更改其提取方向的设置。
direction
-一个
ResultSet.FETCH_FORWARD
,
ResultSet.FETCH_REVERSE
,或
ResultSet.FETCH_UNKNOWN
SQLException
- 如果(1)
RowSet
类型是
TYPE_FORWARD_ONLY
,并且给定的提取方向不是
FETCH_FORWARD
或(2)给定的提取方向不是以下之一:ResultSet.FETCH_FORWARD,ResultSet.FETCH_REVERSE或ResultSet.FETCH_UNKNOWN
getFetchDirection()
public int getFetchDirection() throws SQLException
RowSet
对象的当前提取方向设置。
默认类型为ResultSet.FETCH_FORWARD
ResultSet.FETCH_FORWARD
,
ResultSet.FETCH_REVERSE
,或
ResultSet.FETCH_UNKNOWN
SQLException
- 如果在确定提取行的当前提取方向发生错误
setFetchDirection(int)
public void setFetchSize(int rows) throws SQLException
RowSet
对象的提取大小设置为给定的行数。
获取大小为启用JDBC技术的驱动程序(“JDBC驱动程序”)提供了一个提示,当该RowSet
对象需要更多行时,应从数据库中获取的行数。
如果指定的获取大小为零,则驱动程序将忽略该值,并且可以自由地对于获取大小应该是最自然的猜测。
一个RowSet
对象继承了它获取其数据的ResultSet
对象的默认属性。 ResultSet
对象的默认提取大小由创建它的Statement
对象设置。
此方法仅在使用JDBC驱动程序连接到数据库时适用于RowSet
对象。 对于连接的RowSet
实现(如JdbcRowSet
,此方法对底层JDBC驱动程序具有直接和即时的影响。
RowSet
对象可以随时使用此方法来更改其提取大小的设置。
对于RowSet
实现,例如在CachedRowSet
中操作的CachedRowSet,正在使用的SyncProvider
对象可以利用获取大小轮询数据源并检索不超过获取大小的多个行,并且可以形成原始查询返回的实际行。 这是由断开的SyncProvider
对象使用的特定SyncProvider
对象确定的实现RowSet
。
rows
- 要获取的行数;
0
让司机决定最佳抓取大小是多少?
不能小于0
或超过此RowSet
对象允许的最大行数(通过调用方法getMaxRows()
返回的数字 )
SQLException
- 如果指定的提取大小小于
0
或超过最大行数的限制
getFetchSize()
public int getFetchSize() throws SQLException
RowSet
对象的获取大小。
默认值为零。
RowSet
对象需要数据库中的更多行时,建议作为提取大小的行数
SQLException
- 如果发生错误,确定当前提取大小中的行数
setFetchSize(int)
public int getConcurrency() throws SQLException
RowSet
对象的RowSet
。
默认值为CONCUR_UPDATABLE
,用于连接和断开的RowSet
对象。
一个应用程序可以随时调用方法setConcurrency
来更改RowSet
对象的并发性。
RowSet
对象的并发类型必须是以下之一:
ResultSet.CONCUR_READ_ONLY
或
ResultSet.CONCUR_UPDATABLE
SQLException
- 如果发生错误,获得此
RowSet
对象的并发性
setConcurrency(int)
,
isReadOnly()
public void setNull(int parameterIndex, int sqlType) throws SQLException
NULL
。
需要注意的是参数的SQL类型必须使用规定的类型代码之一指定java.sql.Types
。
此SQL类型在第二个参数中指定。
请注意,第二个参数告诉DBMS该值的数据类型设置为NULL
。 一些DBMS需要这些信息,所以需要这样才能使代码更便于携带。
当方法execute
被调用时,由此方法设置的参数值在内部存储,并将作为该RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
之类的方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
该方法的调用getParams
这个版本后setNull
被称为会返回一个Object
阵列包含已经设置的参数值。 在该数组中,表示使用此方法设置的值的元素本身将是一个数组。 该数组的第一个元素是null
。 第二个元素是为sqlType设置的值。 参数号由元素在方法getParams
返回的数组中的位置getParams
,第一个元素是第一个占位符参数的值,第二个元素是第二个占位符参数的值,依此类推。 换句话说,如果第二个占位符参数被设置为null
,则包含它的数组将是由getParams
返回的数组中的第二个元素。
请注意,由于数组中元素的编号从零开始,与占位符参数号parameterIndex对应的数组元素为parameterIndex -1。
parameterIndex
- 此RowSet
对象的命令中要设置的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更大
sqlType
- 一个int
,它是Types
类中定义的SQL类型代码之一 。
如果提供了非标准的sqlType ,则此方法不会抛出一个SQLException
。
这允许非标准SQL类型的隐式支持。
SQLException
- 如果发生数据库访问错误或给定的参数索引超出范围
getParams()
public void setNull(int parameterIndex, int sqlType, String typeName) throws SQLException
NULL
。
尽管此版本的方法setNull
旨在用于用户定义和REF
参数,但此方法可用于为任何JDBC类型设置空参数。
下面是用户定义的类型: STRUCT
, DISTINCT
和JAVA_OBJECT
,和指定数组类型。
注意:为了便于携带,当指定NULL
用户定义或REF
参数时,应用程序必须给出SQL类型代码和完全限定的SQL类型名称。 在用户定义类型的情况下,名称是参数本身的类型名称。 对于REF
参数,名称是引用类型的类型名称。 如果启用JDBC技术的驱动程序不需要类型代码或类型名称信息,则可能会忽略它。
如果参数没有用户定义或REF
类型,则给定的typeName
参数将被忽略。
此方法设置的参数值在内部存储,当调用方法execute
时,将作为此RowSet
对象命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
之类的方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
该方法的调用getParams
这个版本后setNull
被称为会返回一个Object
阵列包含已经设置的参数值。 在该数组中,表示使用此方法设置的值的元素本身将是一个数组。 该数组的第一个元素是null
。 第二个元素是为sqlType设置的值,第三个元素是为typeName设置的值。 参数号由元素在方法getParams
返回的数组中的位置getParams
,第一个元素是第一个占位符参数的值,第二个元素是第二个占位符参数的值,依此类推。 换句话说,如果第二个占位符参数设置为null
,则包含它的数组将是getParams
返回的数组中的第二个元素。
请注意,由于数组中元素的编号从零开始,与占位符参数号parameterIndex对应的数组元素为parameterIndex -1。
parameterIndex
- 要设置的RowSet
对象的命令中的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更大
sqlType
- 一个来自
java.sql.Types
的值
typeName
- SQL用户定义类型的完全限定名称,如果该参数不是用户定义的类型或
REF
值,则将被忽略
SQLException
- 如果发生错误或给定的参数索引超出范围
getParams()
public void setBoolean(int parameterIndex, boolean x) throws SQLException
boolean
。
当驱动程序将其发送到数据库时将其转换为SQL BIT
值。
此方法设置的参数值在内部存储,当调用方法execute
时,将作为此RowSet
对象的命令中的execute
提供。 方法,如execute
, populate
必须在扩展此类和实现一个或多个标准的JSR-114中任类提供RowSet
接口。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
parameterIndex
- 要设置的RowSet
对象的命令中的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须为1
或更高
x
- 参数值
SQLException
- 如果发生错误或参数索引超出范围
getParams()
public void setByte(int parameterIndex, byte x) throws SQLException
byte
。
当驱动程序将其发送到数据库时,将其转换为SQL TINYINT
值。
当方法execute
被调用时,由该方法设置的参数值在内部存储,并将作为该RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
之类的方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
parameterIndex
- 要设置的RowSet
对象的命令中的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
x
- 参数值
SQLException
- 如果发生错误或参数索引超出范围
getParams()
public void setShort(int parameterIndex, short x) throws SQLException
short
。
当驱动程序将其发送到数据库时,将其转换为SQL SMALLINT
值。
当方法execute
被调用时,由此方法设置的参数值将内部存储,并将作为此RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
之类的方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
parameterIndex
- 要设置的RowSet
对象的命令中的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
x
- 参数值
SQLException
- 如果发生错误或参数索引超出范围
getParams()
public void setInt(int parameterIndex, int x) throws SQLException
int
在Java编程语言。
当驱动程序将其发送到数据库时,将其转换为SQL INTEGER
值。
当方法execute
被调用时,由此方法设置的参数值将内部存储,并将作为此RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
等方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
parameterIndex
- 要设置的RowSet
对象的命令中占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
x
- 参数值
SQLException
- 如果发生错误或参数索引超出范围
getParams()
public void setLong(int parameterIndex, long x) throws SQLException
long
。
当驱动程序将其发送到数据库时,将其转换为SQL BIGINT
值。
此方法设置的参数值在内部存储,当调用方法execute
时,将作为此RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
等方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
parameterIndex
- 此RowSet
对象的命令中要设置的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
x
- 参数值
SQLException
- 如果发生错误或参数索引超出范围
getParams()
public void setFloat(int parameterIndex, float x) throws SQLException
float
。
当驱动程序将其发送到数据库时,将其转换为SQL FLOAT
值。
此方法设置的参数值在内部存储,当调用方法execute
时,将作为此RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
之类的方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
parameterIndex
- 要设置的RowSet
对象的命令中占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
x
- 参数值
SQLException
- 如果发生错误或参数索引超出范围
getParams()
public void setDouble(int parameterIndex, double x) throws SQLException
double
。
当驱动程序将其发送到数据库时,将其转换为SQL DOUBLE
值。
此方法设置的参数值在内部存储,当调用方法execute
时,将作为此RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
等方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。 S
parameterIndex
- 要设置的RowSet
对象的命令中的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
x
- 参数值
SQLException
- 如果发生错误或参数索引超出范围
getParams()
public void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException
java.lang.BigDecimal
值。
当驱动程序将其发送到数据库时,将其转换为SQL NUMERIC
值。
当方法execute
被调用时,由该方法设置的参数值在内部存储,并将作为该RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
之类的方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
parameterIndex
- 此RowSet
对象的命令中要设置的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须为1
或更高
x
- 参数值
SQLException
- 如果发生错误或参数索引超出范围
getParams()
public void setString(int parameterIndex, String x) throws SQLException
String
值。
驱动程序将其转换为SQL VARCHAR
或LONGVARCHAR
值(取决于相对于VARCHAR
值的驱动程序限制的参数大小)将其发送到数据库时。
此方法设置的参数值在内部存储,当调用方法execute
时,将作为此RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
之类的方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
parameterIndex
- 要设置的RowSet
对象的命令中的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须为1
或更高
x
- 参数值
SQLException
- 如果发生错误或参数索引超出范围
getParams()
public void setBytes(int parameterIndex, byte[] x) throws SQLException
VARBINARY
或LONGVARBINARY
值(取决于参数相对于VARBINARY
值的驱动程序限制的大小),当它发送到数据库时。
此方法设置的参数值在内部存储,当调用方法execute
时,将作为此RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
等方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
parameterIndex
- 此RowSet
对象的命令中要设置的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
x
- 参数值
SQLException
- 如果发生错误或参数索引超出范围
getParams()
public void setDate(int parameterIndex, Date x) throws SQLException
java.sql.Date
值。
当驱动程序将其发送到数据库时,将其转换为SQL DATE
值。
此方法设置的参数值在内部存储,并在调用方法execute
时作为此RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
等方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
该方法进行的呼叫getParams
这个版本的后setDate
被称为将返回的数组与值为占位符参数编号parameterIndex作为被设置Date
作为第二个参数提供的对象。 请注意,由于数组中元素的编号从零开始,与占位符参数号parameterIndex对应的数组元素为parameterIndex -1。
parameterIndex
- 要设置的RowSet
对象的命令中占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
x
- 参数值
SQLException
- 如果发生错误或参数索引超出范围
getParams()
public void setTime(int parameterIndex, Time x) throws SQLException
java.sql.Time
值。
当驱动程序将其发送到数据库时,将其转换为SQL TIME
值。
当方法execute
被调用时,由此方法设置的参数值将内部存储,并将作为该RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
之类的方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
在调用此方法getParams
之后,对方法setTime
调用将返回已设置的参数的数组。 要为参数占位符号parameterIndex设置的参数将是设置为此方法的第二个参数的Time
对象。
请注意,由于数组中元素的编号从零开始,与占位符参数号parameterIndex对应的数组元素为parameterIndex -1。
parameterIndex
- 要设置的RowSet
对象的命令中占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
x
- 一个
java.sql.Time
对象,它将被设置为占位符
参数parameterIndex的值
SQLException
- 如果发生错误或参数索引超出范围
getParams()
public void setTimestamp(int parameterIndex, Timestamp x) throws SQLException
java.sql.Timestamp
值。
当驱动程序将其发送到数据库时将其转换为SQL TIMESTAMP
值。
当方法execute
被调用时,由此方法设置的参数值将内部存储,并将作为此RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
之类的方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
该方法进行的呼叫getParams
这个版本的后setTimestamp
被称为将返回一个阵列具有用于参数占位符编号parameterIndex是所述值Timestamp
这是供给作为第二个参数,以这种方法的对象。 请注意,由于数组中元素的编号从零开始,与占位符参数号parameterIndex对应的数组元素为parameterIndex -1。
parameterIndex
- 此RowSet
对象的命令中要设置的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
x
- a
java.sql.Timestamp
对象
SQLException
- 如果发生错误或参数索引超出范围
getParams()
public void setAsciiStream(int parameterIndex, InputStream x, int length) throws SQLException
java.io.InputStream
对象,该对象将具有指定的字节数。
流的内容将被读取并发送到数据库。
如果读取并发送到数据库的字节数不等于长度,此方法将抛出一个SQLException
对象。
当一个非常大的ASCII值输入到LONGVARCHAR
参数时,通过java.io.InputStream
对象发送它可能更实用。 启用JDBC技术的驱动程序将根据需要从流中读取数据,直到达到文件结尾。 驱动程序将从ASCII到数据库CHAR
格式进行任何CHAR
转换。
注意:此流对象可以是标准Java流对象或实现标准接口的自己的子类。
当方法execute
被调用时,由此方法设置的参数值将内部存储,并将作为此RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
等方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
该方法进行的呼叫getParams
后setAsciiStream
被称为将返回包含已设定的参数值的数组。 数组中表示使用此方法设置的值的元素本身将是一个数组。 该数组的第一个元素是给定的java.io.InputStream
对象。 第二个元素是为长度设置的值。 第三个元素是内部的BaseRowSet
常量,指定传递给此方法的流是ASCII流。 参数号由元素在方法getParams
返回的数组中的位置getParams
,第一个元素是第一个占位符参数的值,第二个元素是第二个占位符参数的值,依此类推。 换句话说,如果设置的输入流是第二个占位符参数的值,则包含它的数组将是getParams
返回的数组中的第二个元素。
请注意,由于数组中的元素编号从零开始 ,所以与占位符参数号parameterIndex对应的数组元素是元素号parameterIndex -1。
parameterIndex
- 此RowSet
对象的命令中要设置的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
x
- 包含ASCII参数值的Java输入流
length
- 流中的字节数。
这是驱动程序发送给DBMS的字节数;
0或更小的长度未定义,但会导致无效的长度异常被抛出到底层JDBC驱动程序中。
SQLException
- 如果发生错误,参数索引超出界限,或连接到数据源时,驱动程序读取和发送到数据库的字节数不等于
长度指定的字节数
getParams()
public 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
调用此方法
PreparedStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public void setBinaryStream(int parameterIndex, InputStream x, int length) throws SQLException
java.io.InputStream
对象,该对象将具有指定的字节数。
流的内容将被读取并发送到数据库。
如果读取并发送到数据库的字节数不等于长度,则此方法将抛出一个SQLException
对象。
当一个非常大的二进制值输入到一个LONGVARBINARY
参数时,通过一个java.io.InputStream
对象发送它可能比较实用。 启用JDBC技术的驱动程序将根据需要从流中读取数据,直到达到文件结尾。
注意:此流对象可以是标准Java流对象或实现标准接口的自己的子类。
此方法设置的参数值在内部存储,当调用方法execute
时,将作为此RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
等方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
该方法进行的呼叫getParams
后setBinaryStream
被称为将返回包含已设定的参数值的数组。 在该数组中,表示使用此方法设置的值的元素本身将是一个数组。 该数组的第一个元素是给定的java.io.InputStream
对象。 第二个元素是为长度设置的值。 第三个元素是内部BaseRowSet
常量,指定传递给此方法的流是二进制流。 参数号由元素在方法getParams
返回的数组中的位置getParams
,第一个元素是第一个占位符参数的值,第二个元素是第二个占位符参数的值,依此类推。 换句话说,如果设置的输入流是第二个占位符参数的值,则包含它的数组将是getParams
返回的数组中的第二个元素。
请注意,由于数组中的元素编号从零开始 ,所以与占位符参数号parameterIndex对应的数组元素是元素号parameterIndex -1。
parameterIndex
- 此RowSet
对象的命令中要设置的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
x
- 包含要设置的二进制值的输入流
length
- 流中的字节数;
0或更小的长度未定义,但会导致无效的长度异常被抛出到底层JDBC驱动程序中。
SQLException
- 如果发生错误,参数索引超出界限,或连接到数据源时,驱动程序读取和发送到数据库的字节数不等于
长度指定的字节数
getParams()
public 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驱动程序不支持此方法
@Deprecated public void setUnicodeStream(int parameterIndex, InputStream x, int length) throws SQLException
java.io.InputStream
对象,该对象将具有指定的字节数。
流的内容将被读取并发送到数据库。
如果读取并发送到数据库的字节数不等于长度,则此方法将抛出SQLException
。
当一个非常大的Unicode值输入到LONGVARCHAR
参数时,通过java.io.InputStream
对象发送它可能更实用。 启用JDBC技术的驱动程序将根据需要读取流中的数据,直到达到文件结尾。 驱动程序将从Unicode到数据库CHAR
格式进行任何CHAR
转换。 Unicode流的字节格式必须是Java虚拟机规范中定义的Java UTF-8。
注意:此流对象可以是标准Java流对象或实现标准接口的自己的子类。
此方法已弃用; 应该使用方法getCharacterStream
。
此方法设置的参数值在内部存储,当调用方法execute
时,将作为此RowSet
对象的命令中的execute
提供。 该方法进行的呼叫getParams
后setUnicodeStream
被称为将返回包含已设定的参数值的数组。 在该数组中,表示使用此方法设置的值的元素本身将是一个数组。 该数组的第一个元素是给定的java.io.InputStream
对象。 第二个元素是为长度设置的值。 第三个元素是内部的BaseRowSet
常量,指定传递给此方法的流是Unicode流。 参数号由元素在方法getParams
返回的数组中的位置getParams
,第一个元素是第一个占位符参数的值,第二个元素是第二个占位符参数的值,依此类推。 换句话说,如果设置的输入流是第二个占位符参数的值,则包含它的数组将是getParams
返回的数组中的第二个元素。
请注意,由于数组中的元素编号从零开始 ,所以与占位符参数号parameterIndex对应的数组元素是元素号parameterIndex -1。
parameterIndex
- 此RowSet
对象的命令中要设置的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须为1
或更高
x
- 包含UNICODE参数值的
java.io.InputStream
对象
length
- 输入流中的字节数
SQLException
- 如果发生错误,参数索引超出范围,或驱动程序读取和发送到数据库的字节数不等于
长度指定的字节数
getParams()
public void setCharacterStream(int parameterIndex, Reader reader, int length) throws SQLException
java.io.Reader
对象,该对象将具有指定的字符数。
阅读器的内容将被读取并发送到数据库。
如果读取并发送到数据库的字节数不等于长度,则此方法将抛出SQLException
。
当一个非常大的Unicode值输入到LONGVARCHAR
参数时,通过Reader
对象发送它可能更实用。 启用JDBC技术的驱动程序将根据需要从流中读取数据,直到达到文件结尾。 驱动程序将从Unicode到数据库CHAR
格式进行任何CHAR
转换。 Unicode流的字节格式必须是Java虚拟机规范中定义的Java UTF-8。
注意:此流对象可以是标准Java流对象或实现标准接口的自己的子类。
当调用方法execute时,由此方法设置的参数值将内部存储,并将作为此RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
等方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
该方法进行的呼叫getParams
后setCharacterStream
被称为将返回包含已设定的参数值的数组。 在该数组中,表示使用此方法设置的值的元素本身将是一个数组。 该数组的第一个元素是给定的java.io.Reader
对象。 第二个元素是为长度设置的值。 参数号由元素在方法getParams
返回的数组中的位置getParams
,第一个元素是第一个占位符参数的值,第二个元素是第二个占位符参数的值,依此类推。 换句话说,如果设置的读取器是第二个占位符参数的值,则包含它的数组将是getParams
返回的数组中的第二个元素。
请注意,由于数组中的元素编号从零开始 ,所以与占位符参数号parameterIndex对应的数组元素是元素号parameterIndex -1。
parameterIndex
- 要设置的RowSet
对象的命令中的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
reader
- 包含Unicode数据的
Reader
对象
length
- 流中的字符数;
0或更小的长度未定义,但会导致在底层JDBC驱动程序中抛出无效的长度异常。
SQLException
- 如果发生错误,参数索引超出界限,或连接到数据源时,驱动程序读取和发送到数据库的字节数不等于以
长度指定的字节数
getParams()
public void setCharacterStream(int parameterIndex, Reader reader) throws SQLException
RowSet
对象的命令中的指定参数设置为给定的Reader
对象。
当一个非常大的UNICODE值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更实用。
数据将根据需要从流中读取,直到达到文件结尾。
JDBC驱动程序将从UNICODE到数据库字符格式进行任何必要的转换。
注意:此流对象可以是标准Java流对象,也可以是实现标准接口的自己的子类。
注:请参考JDBC驱动程序文档,以确定它可能是更有效地使用一个版本的setCharacterStream
其带长度参数。
parameterIndex
- 第一个参数是1,第二个是2,...
reader
- 包含Unicode数据的
java.io.Reader
对象
SQLException
- 如果发生数据库访问错误或在封闭的方法上调用此方法
PreparedStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public void setObject(int parameterIndex, Object x, int targetSqlType, int scale) throws SQLException
Object
在Java编程语言。
第二个参数必须是Object
类型。
对于积分值,应使用java.lang
等效对象。
例如,使用Integer
类的int
。
驱动程序将此对象转换为指定的目标SQL类型,然后再将其发送到数据库。 如果对象具有自定义映射(是实现一类SQLData
),驾驶员应调用方法SQLData.writeSQL
写对象到SQL数据流。 如果,在另一方面,对象是实现一类Ref
, Blob
, Clob
, Struct
,或Array
,则驱动程序应当将它传递给数据库作为相应SQL类型的值。
请注意,此方法可用于传递数据库特定的抽象数据类型。
此方法设置的参数值在内部存储,当调用方法execute
时,将作为此RowSet
对象的命令中的相应参数execute
。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
之类的方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
该方法的调用getParams
这个版本后setObject
被称为将返回包含已经设置的参数值的数组。 在该数组中,表示使用此方法设置的值的元素本身将是一个数组。 该数组的第一个元素是给定的Object
实例,第二个元素是为targetSqlType设置的值。 第三个元素是为scale设置的值,如果正在设置的对象的类型不是java.sql.Types.NUMERIC
或java.sql.Types.DECIMAL
,则驱动程序将忽略该值。 参数号由元素在方法getParams
返回的数组中的位置getParams
,第一个元素是第一个占位符参数的值,第二个元素是第二个占位符参数的值,依此类推。 换句话说,如果要设置的对象是第二个占位符参数的值,则包含它的数组将是getParams
返回的数组中的第二个元素。
请注意,由于数组中的元素编号从零开始 ,所以与占位符参数号parameterIndex对应的数组元素是元素号parameterIndex -1。
parameterIndex
- 要设置的RowSet
对象的命令中的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
x
-所述Object
包含输入参数值;
必须是Object
类型
targetSqlType
- 要发送到数据库的SQL类型(定义在java.sql.Types
)。
scale
参数可能会进一步限定此类型。
如果提供了非标准的targetSqlType ,则此方法不会抛出SQLException
。
这允许非标准SQL类型的隐式支持。
scale
- 对于类型java.sql.Types.DECIMAL
和java.sql.Types.NUMERIC
,这是小数点后的位数。
对于所有其他类型,此值将被忽略。
SQLException
- 如果发生错误或参数索引超出范围
getParams()
public void setObject(int parameterIndex, Object x, int targetSqlType) throws SQLException
Object
值设置指定Object
值。
该方法类似于setObject(int parameterIndex, Object x, int targetSqlType, int scale)
除了它假定为零。
此方法设置的参数值在内部存储,当调用方法execute
时,将作为此RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
之类的方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
该方法的调用getParams
这个版本后setObject
被称为将返回包含已经设置的参数值的数组。 在该数组中,表示使用此方法设置的值的元素本身将是一个数组。 该数组的第一个元素是给定的Object
实例。 第二个元素是为targetSqlType设置的值。 参数号由元素在方法getParams
返回的数组中的位置getParams
,第一个元素是第一个占位符参数的值,第二个元素是第二个占位符参数的值,依此类推。 换句话说,如果要设置的对象是第二个占位符参数的值,则包含它的数组将是getParams
返回的数组中的第二个元素。
请注意,由于数组中的元素编号从零开始 ,所以与占位符参数号parameterIndex对应的数组元素是元素号parameterIndex -1。
parameterIndex
- 要设置的RowSet
对象的命令中的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更大
x
-所述Object
包含输入参数值;
必须是Object
类型
targetSqlType
- 要发送到数据库的SQL类型(定义在java.sql.Types
)。
如果提供了非标准的targetSqlType ,则此方法不会抛出一个SQLException
。
这允许非标准SQL类型的隐式支持。
SQLException
- 如果发生错误或参数索引超出范围
getParams()
public void setObject(int parameterIndex, Object x) throws SQLException
Object
在Java编程语言。
第二个参数必须是Object
类型。
对于积分值,应使用java.lang
等效对象。
例如,使用Integer
类的int
。
JDBC规范定义了从Java Object
类型到SQL类型的标准映射。 驱动程序将使用此标准映射将给定对象转换为其对应的SQL类型,然后再将其发送到数据库。 如果对象具有自定义映射(是实现一类SQLData
),驾驶员应调用方法SQLData.writeSQL
写对象到SQL数据流。
如果,在另一方面,对象是实现一类Ref
, Blob
, Clob
, Struct
,或Array
,则驱动程序应当将它传递给数据库作为相应SQL类型的值。
如果存在歧义,则此方法会引发异常,例如,如果对象是实现多个接口的类。
请注意,此方法可能用于传递数据库特定的抽象数据类型。
此方法设置的参数值在内部存储,当调用方法execute
时,将作为此RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
之类的方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
调用此方法后,方法getParams
的调用将返回当前命令参数的对象数组,其中包括Object
设置的占位符参数号parameterIndex
。 请注意,由于数组中的元素编号从零开始 ,所以与占位符参数号parameterIndex对应的数组元素是元素号parameterIndex -1。
parameterIndex
- 要设置的RowSet
对象的命令中占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须为1
或更高
x
- 包含输入参数值的对象
SQLException
- 如果出现错误,参数索引超出范围,或者正在设置的对象的实现中存在歧义
getParams()
public void setRef(int parameterIndex, Ref ref) throws SQLException
Ref
对象。
当驱动程序将其发送到数据库时,将其转换为SQL REF
值。
在内部, Ref
被表示为SerialRef
以确保可序列化。
此方法设置的参数值在内部存储,当调用方法execute
时,将作为该RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
之类的方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
调用此方法后,对方法getParams
的调用将返回当前命令参数的对象数组,其中包括Ref
对象集,用于占位符参数号为parameterIndex
。 请注意,由于数组中的元素编号从零开始 ,所以与占位符参数号parameterIndex对应的数组元素是元素号parameterIndex -1。
parameterIndex
- 此RowSet
对象的命令中要设置的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
ref
- 表示SQL REF
值的Ref
对象;
不能为空
SQLException
- 如果发生错误;
参数索引超出范围或Ref
对象为null
;
或Ref
对象返回一个null
基类型名称。
getParams()
, SerialRef
public void setBlob(int parameterIndex, Blob x) throws SQLException
Blob
对象。
当驱动程序将其发送到数据库时,将其转换为SQL BLOB
值。
在内部, Blob
表示为SerialBlob
以确保可序列化。
此方法设置的参数值在内部存储,当调用方法execute
时,将作为此RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
之类的方法。 注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
在调用此方法之后,对方法getParams
的调用将返回当前命令参数的对象数组,其中包括用于占位符参数号parameterIndex
的Blob
对象集。 请注意,由于数组中的元素编号从零开始 ,所以与占位符参数号parameterIndex对应的数组元素是元素号parameterIndex -1。
parameterIndex
- 要设置的RowSet
对象的命令中占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
x
- 表示SQL
BLOB
值的
Blob
对象
SQLException
- 如果发生错误或参数索引超出范围
getParams()
, SerialBlob
public void setClob(int parameterIndex, Clob x) throws SQLException
Clob
对象。
当驱动程序将其发送到数据库时将其转换为SQL CLOB
值。
在内部, Clob
表示为SerialClob
以确保可序列化。
此方法设置的参数值在内部存储,当调用方法execute
时,将作为此RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
等方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
调用此方法之后,对方法getParams
的调用将返回当前命令参数的对象数组,其中包括用于占位符参数号parameterIndex
的Clob
对象集。 请注意,由于数组中的元素编号从零开始 ,所以与占位符参数号parameterIndex对应的数组元素是元素号parameterIndex -1。
parameterIndex
- 此RowSet
对象的命令中要设置的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
x
- 表示SQL CLOB
值的Clob
对象;
不能为空
SQLException
- 如果发生错误;
参数索引超出范围或Clob
为null
getParams()
, SerialBlob
public void setArray(int parameterIndex, Array array) throws SQLException
Array
对象。
当驱动程序将其发送到数据库时,将其转换为SQL ARRAY
值。
在内部, Array
表示为SerialArray
以确保可序列化。
此方法设置的参数值在内部存储,当调用方法execute
时,将作为此RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
之类的方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
调用此方法后,对方法getParams
的调用将返回当前命令参数的对象数组,其中包括Array
对象集,用于占位符参数号为parameterIndex
。 请注意,由于数组中的元素编号从零开始 ,所以与占位符参数号parameterIndex对应的数组元素是元素号parameterIndex -1。
parameterIndex
- 此RowSet
对象的命令中要设置的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
array
- 表示SQL ARRAY
值的Array
对象;
不能为空。
传递给此方法的Array
对象必须为所有getArray()
方法调用返回非空对象。
空值将导致抛出SQLException
。
SQLException
- 如果发生错误;
参数索引超出范围或ARRAY
为空
getParams()
, SerialArray
public void setDate(int parameterIndex, Date x, Calendar cal) throws SQLException
java.sql.Date
对象。
当DBMS不存储时区信息时,驱动程序将使用给定的Calendar
对象来构造要发送到数据库的SQL DATE
值。
使用Calendar
对象,驱动程序可以计算考虑到自定义时区的日期。
如果未Calendar
对象,则驱动程序将使用正在运行应用程序的虚拟机的时区。
此方法设置的参数值在内部存储,当调用方法execute
时,将作为该RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
之类的方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
该方法的调用getParams
这个版本后setDate
被称为将返回包含已经设置的参数值的数组。 在该数组中,表示使用此方法设置的值的元素本身将是一个数组。 该数组的第一个元素是给定的java.sql.Date
对象。 第二个元素是为cal设置的值 。 参数号由元素在方法getParams
返回的数组中的位置getParams
,第一个元素是第一个占位符参数的值,第二个元素是第二个占位符参数的值,依此类推。 换句话说,如果设置的日期是第二个占位符参数的值,则包含它的数组将是getParams
返回的数组中的第二个元素。
请注意,由于数组中元素的编号从零开始,与占位符参数号parameterIndex对应的数组元素为parameterIndex -1。
parameterIndex
- 此RowSet
对象的命令中要设置的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
x
-
java.sql.Date
SQL
DATE
值的
java.sql.Date
对象
cal
- 在
java.util.Calendar
日期时使用的
java.util.Calendar
对象
SQLException
- 如果发生错误或参数索引超出范围
getParams()
public void setTime(int parameterIndex, Time x, Calendar cal) throws SQLException
java.sql.Time
对象。
当驱动程序将其发送到数据库时,将其转换为SQL TIME
值。
当DBMS不存储时区信息时,驱动程序将使用给定的Calendar
对象来构造要发送到数据库的SQL TIME
值。 使用Calendar
对象,驱动程序可以计算考虑到自定义时区的日期。 如果未Calendar
对象,则驱动程序将使用正在运行应用程序的虚拟机的时区。
此方法设置的参数值在内部存储,当调用方法execute
时,将作为此RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
之类的方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
该方法的调用getParams
这个版本后setTime
被称为将返回包含已经设置的参数值的数组。 在该数组中,表示使用此方法设置的值的元素本身将是一个数组。 该数组的第一个元素是给定的java.sql.Time
对象。 第二个元素是为cal设置的值 。 参数号由元素在方法getParams
返回的数组中的位置getParams
,第一个元素是第一个占位符参数的值,第二个元素是第二个占位符参数的值,依此类推。 换句话说,如果设置的时间是第二个占位符参数的值,则包含它的数组将是getParams
返回的数组中的第二个元素。
请注意,由于数组中元素的编号从零开始,与占位符参数号parameterIndex对应的数组元素为parameterIndex -1。
parameterIndex
- 要设置的RowSet
对象的命令中的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
x
- 一个
java.sql.Time
对象
cal
- 驱动程序可以用来构建时间的
java.util.Calendar
对象
SQLException
- 如果发生错误或参数索引超出范围
getParams()
public void setTimestamp(int parameterIndex, Timestamp x, Calendar cal) throws SQLException
java.sql.Timestamp
对象。
当驱动程序将其发送到数据库时,将其转换为SQL TIMESTAMP
值。
当DBMS不存储时区信息时,驱动程序将使用给定的Calendar
对象来构造要发送到数据库的SQL TIMESTAMP
值。 使用Calendar
对象,驱动程序可以计算考虑到自定义时区的时间戳。 如果未Calendar
对象,则驱动程序将使用正在运行应用程序的虚拟机的时区。
当方法execute
被调用时,由该方法设置的参数值在内部存储,并将作为该RowSet
对象的命令中的execute
提供。 必须在扩展此类并实现一个或多个标准JSR-114 RowSet
接口的任何类中提供诸如execute
和populate
之类的方法。
注意: JdbcRowSet
不需要populate
方法,因为它在此类中未定义。
该方法的调用getParams
这个版本后setTimestamp
被称为将返回包含已经设置的参数值的数组。 在该数组中,表示使用此方法设置的值的元素本身将是一个数组。 该数组的第一个元素是给定的java.sql.Timestamp
对象。 第二个元素是为cal设置的值 。 参数号由元素在方法getParams
返回的数组中的位置getParams
,第一个元素是第一个占位符参数的值,第二个元素是第二个占位符参数的值,依此类推。 换句话说,如果设置的时间戳是第二个占位符参数的值,则包含它的数组将是getParams
返回的数组中的第二个元素。
请注意,由于数组中元素的编号从零开始,与占位符参数号parameterIndex对应的数组元素为parameterIndex -1。
parameterIndex
- 此RowSet
对象的命令中要设置的占位符参数的序号。
第一个参数是1,第二个是2,等等;
必须是1
或更高
x
- 一个
java.sql.Timestamp
对象
cal
-在
java.util.Calendar
对象的驱动程序可以用来构造时间戳
SQLException
- 如果发生错误或参数索引超出范围
getParams()
public void clearParameters() throws SQLException
RowSet
对象在执行此RowSet
对象的命令时要设置的参数的内部表示形式中的所有当前参数值。
一般来说,在RowSet
对象的命令中,参数值仍然有效重复使用。 使用setter方法设置参数值会自动清除指定参数的值,并用新的指定值替换它。
该方法由setCommand
调用,以清除上一个命令设置的所有参数。
此外,该方法不同于initParams
方法,它保持的模式RowSet
对象。
SQLException
- 如果出现错误,清除参数
public Object[] getParams() throws SQLException
RowSet
对象的命令设置的参数值(对象和基元),如果尚未设置所有参数,则抛出一个SQLException
对象。
在将命令发送到要执行的DBMS之前,这些参数将替换为PreparedStatement对象中的PreparedStatement
符参数,该对象是扩展BaseRowSet
类的RowSet
实现的命令。
返回的数组中的每个元素都是一个Object
实例,其中包含提供给setter方法的参数的值。 元素的顺序由为parameterIndex提供的值确定 。 如果setter方法仅使用参数索引和要设置的值(可能为空),则数组元素将包含要设置的值(将被表示为Object
)。 如果有其他参数,则数组元素本身将是一个数组,其中包含要设置的值加上提供给setter方法的任何附加参数值。 如果方法设置流,则数组元素包括提供给该方法的流的类型。 这些附加参数用于使用驱动程序或DBMS,并且可以使用也可以不使用。
注意事项:储存类型的参数值Array
, Blob
, Clob
和Ref
返回为SerialArray
, SerialBlob
, SerialClob
和SerialRef
分别。
Object
实例的数组,其中包含可在此RowSet
对象的命令中设置的参数值;
如果没有设置参数,则为空数组
SQLException
-如果发生错误检索的这个参数的对象阵列
RowSet
对象或如果不是所有的参数都被设定
public void setNull(String parameterName, int sqlType) throws SQLException
NULL
。
注意:您必须指定参数的SQL类型。
parameterName
- 参数的名称
sqlType
- 在
java.sql.Types
定义的SQL类型代码
SQLException
- 如果发生数据库访问错误或此方法在关闭时调用
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public 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驱动程序不支持此方法
public void setBoolean(String parameterName, boolean x) throws SQLException
boolean
值。
当驱动程序将其发送到数据库时,将其转换为SQL BIT
或BOOLEAN
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或此方法在关闭时调用
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
getParams()
public void setByte(String parameterName, byte x) throws SQLException
byte
值。
当驱动程序将其发送到数据库时,将其转换为SQL TINYINT
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或者在关闭的
CallableStatement
调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
getParams()
public void setShort(String parameterName, short x) throws SQLException
short
值。
当驱动程序将其发送到数据库时,将其转换为SQL SMALLINT
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或此方法在关闭时调用
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
getParams()
public void setInt(String parameterName, int x) throws SQLException
int
值。
当驱动程序将其发送到数据库时,将其转换为SQL INTEGER
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或在封闭的方法上调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
getParams()
public void setLong(String parameterName, long x) throws SQLException
long
值。
当驱动程序将其发送到数据库时,将其转换为SQL BIGINT
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或在关闭的
CallableStatement
调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
getParams()
public void setFloat(String parameterName, float x) throws SQLException
float
值。
当驱动程序将其发送到数据库时,将其转换为SQL FLOAT
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或在封闭的方法上调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
getParams()
public void setDouble(String parameterName, double x) throws SQLException
double
值。
当驱动程序将其发送到数据库时,将其转换为SQL DOUBLE
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或此方法在关闭时调用
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
getParams()
public void setBigDecimal(String parameterName, BigDecimal x) throws SQLException
java.math.BigDecimal
值。
当驱动程序将其发送到数据库时将其转换为SQL NUMERIC
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或者在关闭的
CallableStatement
调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
getParams()
public void setString(String parameterName, String x) throws SQLException
String
值。
驱动程序将其转换为SQL VARCHAR
或LONGVARCHAR
值(取决于参数相对于VARCHAR
值的驱动程序限制的大小),当它发送到数据库时。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或在封闭的方法上调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
getParams()
public void setBytes(String parameterName, byte[] x) throws SQLException
VARBINARY
或LONGVARBINARY
(取决于参数相对于驱动程序对VARBINARY
的限制的大小),当它发送到数据库时。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或此方法在封闭的
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
getParams()
public void setTimestamp(String parameterName, Timestamp x) throws SQLException
java.sql.Timestamp
值。
当驱动程序将其发送到数据库时,将其转换为SQL TIMESTAMP
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误,或者在关闭的
CallableStatement
调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
getParams()
public 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
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public void setBinaryStream(String parameterName, InputStream x, int length) throws SQLException
LONGVARBINARY
参数时,通过一个java.io.InputStream
对象发送它可能会比较实用。
数据将根据需要从流中读取,直到达到文件结尾。
注意:此流对象可以是标准Java流对象,也可以是实现标准接口的自己的子类。
parameterName
- 参数的名称
x
- 包含二进制参数值的java输入流
length
- 流中的字节数
SQLException
- 如果发生数据库访问错误或在封闭的方法上调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public 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
调用此方法
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public 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驱动程序不支持此方法
public void setBinaryStream(String parameterName, InputStream x) throws SQLException
LONGVARBINARY
参数时,通过一个java.io.InputStream
对象发送它可能比较实用。
数据将根据需要从流中读取,直到达到文件结尾。
注意:此流对象可以是标准Java流对象,也可以是实现标准接口的自己的子类。
注:请参考JDBC驱动程序文档,以确定它可能是更有效地使用一个版本的setBinaryStream
其带长度参数。
parameterName
- 参数的名称
x
- 包含二进制参数值的java输入流
SQLException
- 如果发生数据库访问错误或此方法在封闭的
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public 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驱动程序不支持此方法
public void setNCharacterStream(int parameterIndex, Reader value) throws SQLException
RowSet
对象的命令中的Reader
参数设置为Reader
对象。
Reader
读取数据,直到达到文件结尾。
驱动程序必须从Java字符格式转换为数据库中的国家字符集。
注意:此流对象可以是标准Java流对象,也可以是实现标准接口的自己的子类。
注:请参考JDBC驱动程序文档,以确定它可能是更有效地使用一个版本的setNCharacterStream
其带长度参数。
parameterIndex
- 第一个参数是1,第二个是2,...
value
- 参数值
SQLException
- 如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
如果发生数据库访问错误;
或者这种方法在封闭的PreparedStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public 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
, getParams()
public 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驱动程序不支持此数据类型
getParams()
public 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驱动程序不支持此方法
getParams()
public 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驱动程序不支持此方法
public void setBlob(int parameterIndex, InputStream inputStream) throws SQLException
InputStream
对象。
该方法与setBinaryStream (int, InputStream)
方法不同,因为它通知驱动程序参数值应该作为BLOB
发送到服务器。
当使用setBinaryStream
方法时,驱动程序可能需要进行额外的工作才能确定是否应将参数数据作为LONGVARBINARY
或BLOB
发送到服务器
注:请参考JDBC驱动程序文档,以确定它可能是更有效地使用一个版本的setBlob
其带长度参数。
parameterIndex
- 第一个参数的索引为1,第二个为2,...
inputStream
- 包含将参数值设置为的数据的对象。
SQLException
- 如果发生数据库访问错误,此方法在封闭的
PreparedStatement
上调用,或者如果parameterIndex与SQL语句中的参数标记不对应,
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException
InputStream
对象。
inputstream
必须包含由长度指定的SQLException
,否则当执行CallableStatement时将CallableStatement
。
该方法与setBinaryStream (int, InputStream, int)
方法不同,因为它通知驱动程序参数值应该作为BLOB
发送到服务器。
当使用setBinaryStream
方法时,驱动程序可能必须进行额外的工作,以确定参数数据是否应以LONGVARBINARY
或BLOB
发送到服务器
parameterName
- 要设置的第二个参数的名称是2,...
inputStream
- 包含将参数值设置为的数据的对象。
length
- 参数数据中的字节数。
SQLException
- 如果parameterIndex与SQL语句中的参数标记不对应,或者指定的长度小于零;
如果输入流中的字节数与指定长度不匹配;
如果发生数据库访问错误或在封闭的CallableStatement
上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public void setBlob(String parameterName, Blob x) throws SQLException
java.sql.Blob
对象。
当驱动程序将其发送到数据库时,将其转换为SQL BLOB
值。
parameterName
- 参数的名称
x
- 映射SQL
BLOB
值的
Blob
对象
SQLException
- 如果发生数据库访问错误或此方法在封闭的
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public void setBlob(String parameterName, InputStream inputStream) throws SQLException
InputStream
对象。
该方法与setBinaryStream (int, InputStream)
方法不同,因为它通知驱动程序参数值应该作为BLOB
发送到服务器。
当使用setBinaryStream
方法时,驱动程序可能需要额外的工作才能确定参数数据是否应以LONGVARBINARY
或BLOB
发送到服务器
注:请参考JDBC驱动程序文档,以确定它可能是更有效地使用一个版本的setBlob
其带长度参数。
parameterName
- 参数的名称
inputStream
- 包含用于设置参数值的数据的对象。
SQLException
- 如果发生数据库访问错误或此方法在关闭的
CallableStatement
调用
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public void setClob(int parameterIndex, Reader reader, long length) throws SQLException
Reader
对象。
读者必须包含由长度指定的SQLException
数,否则当执行PreparedStatement时将PreparedStatement
。
该方法与setCharacterStream (int, Reader, int)
方法不同,因为它通知驱动程序参数值应该作为CLOB
发送到服务器。
当使用setCharacterStream
方法时,驱动程序可能需要额外的工作才能确定参数数据是否应以LONGVARCHAR
或CLOB
发送到服务器
parameterIndex
- 第一个参数的索引为1,第二个为2,...
reader
- 包含用于设置参数值的数据的对象。
length
- 参数数据中的字符数。
SQLException
- 如果发生数据库访问错误,如果parameterIndex与SQL语句中的参数标记不对应,或者指定的长度小于零,则会在封闭的
PreparedStatement
上调用此方法。
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public void setClob(int parameterIndex, Reader reader) throws SQLException
Reader
对象。
该方法与setCharacterStream (int, Reader)
方法不同,因为它通知驱动程序参数值应该作为CLOB
发送到服务器。
当使用setCharacterStream
方法时,驱动程序可能需要额外的工作才能确定参数数据是否应以LONGVARCHAR
或CLOB
发送到服务器
注意:请参阅您的JDBC驱动程序文档,以确定使用setClob
版本的setClob
是否更有效,该版本需要一个长度参数。
parameterIndex
- 第一个参数的索引是1,第二个是2,...
reader
- 包含用于设置参数值的数据的对象。
SQLException
- 如果发生数据库访问错误,此方法在封闭的
PreparedStatement
上调用,或者如果parameterIndex不对应于SQL语句中的参数标记
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public void setClob(String parameterName, Reader reader, long length) throws SQLException
Reader
对象。
reader
必须包含由长度指定的SQLException
数, CallableStatement
在执行CallableStatement时将CallableStatement
。
该方法与setCharacterStream (int, Reader, int)
方法不同,因为它通知驱动程序参数值应该作为CLOB
发送到服务器。
当使用setCharacterStream
方法时,驱动程序可能需要额外的工作才能确定参数数据是否应以LONGVARCHAR
或CLOB
发送到服务器
parameterName
- 要设置的参数的名称
reader
- 包含将参数值设置为的数据的对象。
length
- 参数数据中的字符数。
SQLException
- 如果parameterIndex不对应于SQL语句中的参数标记;
如果指定的长度小于零;
发生数据库访问错误,或者在封闭的CallableStatement
上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public void setClob(String parameterName, Clob x) throws SQLException
java.sql.Clob
对象。
当驱动程序将其发送到数据库时,将其转换为SQL CLOB
值。
parameterName
- 参数的名称
x
- 映射SQL
CLOB
值的
Clob
对象
SQLException
- 如果发生数据库访问错误或此方法在封闭的
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public void setClob(String parameterName, Reader reader) throws SQLException
Reader
对象。
该方法与setCharacterStream (int, Reader)
方法不同,因为它通知驱动程序参数值应该作为CLOB
发送到服务器。
当使用setCharacterStream
方法时,驱动程序可能需要额外的工作才能确定参数数据是否应以LONGVARCHAR
或CLOB
发送到服务器
注:请参考JDBC驱动程序文档,以确定它可能是更有效地使用一个版本的setClob
其带长度参数。
parameterName
- 参数的名称
reader
- 包含将参数值设置为的数据的对象。
SQLException
- 如果发生数据库访问错误或此方法在关闭时调用
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public void setDate(String parameterName, Date x) throws SQLException
java.sql.Date
设置为给定的java.sql.Date
值。
当驱动程序将其发送到数据库时,将其转换为SQL DATE
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或此方法在已关闭的
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
getParams()
public 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驱动程序不支持此方法
getParams()
public void setTime(String parameterName, Time x) throws SQLException
java.sql.Time
值。
当驱动程序将其发送到数据库时,将其转换为SQL TIME
值。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误或此方法在关闭时调用
CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
getParams()
public 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驱动程序不支持此方法
getParams()
public 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驱动程序不支持此方法
getParams()
public 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。
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public 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。
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public void setRowId(int parameterIndex, RowId x) throws SQLException
java.sql.RowId
对象。
当驱动程序将其发送到数据库时,将其转换为SQL ROWID
值
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 参数值
SQLException
- 如果发生数据库访问错误
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public void setRowId(String parameterName, RowId x) throws SQLException
java.sql.RowId
对象。
当驱动程序将其发送到数据库时,将其转换为SQL ROWID
。
parameterName
- 参数的名称
x
- 参数值
SQLException
- 如果发生数据库访问错误
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public void setNString(int parameterIndex, String value) throws SQLException
String
对象。
驱动程序将其转换为SQL NCHAR
或NVARCHAR
或LONGNVARCHAR
值(取决于相对于NVARCHAR
值的驱动程序限制的参数大小),当它发送到数据库时。
parameterIndex
- 第一个参数是1,第二个是2,...
value
- 参数值
SQLException
- 如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
或者发生数据库访问错误
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public void setNString(String parameterName, String value) throws SQLException
String
对象。
驱动程序将其转换为SQL NCHAR
或NVARCHAR
或LONGNVARCHAR
parameterName
- 要设置的列的名称
value
- 参数值
SQLException
- 如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
或者发生数据库访问错误
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException
Reader
对象。
Reader
读取数据,直到达到文件结尾。
驱动程序必须从Java字符格式转换为数据库中的国家字符集。
parameterIndex
- 第一个参数是1,第二个是2,...
value
- 参数值
length
- 参数数据中的字符数。
SQLException
- 如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
或者发生数据库访问错误
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException
Reader
对象。
Reader
读取数据,直到文件到达。
驱动程序必须从Java字符格式转换为数据库中的国家字符集。
parameterName
- 要设置的列的名称
value
- 参数值
length
- 参数数据中的字符数。
SQLException
- 如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
或者发生数据库访问错误
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public void setNCharacterStream(String parameterName, Reader value) throws SQLException
Reader
对象。
Reader
读取数据,直到达到文件结尾。
驱动程序必须从Java字符格式转换为数据库中的国家字符集。
注意:此流对象可以是标准Java流对象,也可以是实现标准接口的自己的子类。
注意:请参阅您的JDBC驱动程序文档,以确定使用setNCharacterStream
版本的长度参数可能会更有效。
parameterName
- 参数的名称
value
- 参数值
SQLException
- 如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
如果发生数据库访问错误;
或者这种方法在封闭的CallableStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public void setNClob(String parameterName, NClob value) throws SQLException
java.sql.NClob
对象。
该对象实现了java.sql.NClob
接口。
此NClob
对象映射到SQL NCLOB
。
parameterName
- 要设置的列的名称
value
- 参数值
SQLException
- 如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
或者发生数据库访问错误
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public 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驱动程序不支持此方法
public void setNClob(String parameterName, Reader reader) throws SQLException
Reader
对象。
此方法从不同setCharacterStream (int, Reader)
方法,因为它通知参数值应该被发送到服务器作为驾驶员NCLOB
。
当使用setCharacterStream
方法时,驱动程序可能需要进行额外的工作才能确定参数数据是否应以LONGNVARCHAR
或NCLOB
发送到服务器
注意:请参阅您的JDBC驱动程序文档,以确定使用setNClob
版本的setNClob
是否更有效,该版本需要一个长度参数。
parameterName
- 参数的名称
reader
- 包含用于设置参数值的数据的对象。
SQLException
- 如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
如果发生数据库访问错误或在封闭的CallableStatement
上调用此方法
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public 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驱动程序不支持此方法
public void setNClob(int parameterIndex, NClob value) throws SQLException
java.sql.NClob
对象。
驱动程序将此值发送到数据库时将其转换为SQL NCLOB
值。
parameterIndex
- 第一个参数是1,第二个是2,...
value
- 参数值
SQLException
- 如果司机不支持国家字符集;
如果驱动程序可以检测到可能发生数据转换错误;
或者发生数据库访问错误
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法
public 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驱动程序不支持此方法
public void setURL(int parameterIndex, URL x) throws SQLException
java.net.URL
值。
当驱动程序将其发送到数据库时,将其转换为SQL DATALINK
值。
parameterIndex
- 第一个参数是1,第二个是2,...
x
- 要设置的
java.net.URL
对象
SQLException
- 如果发生数据库访问错误或此方法在封闭的
PreparedStatement
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法