32、浅谈CallableStatement可调用语句!
来源:互联网 发布:linux 设置ntp 编辑:程序博客网 时间:2024/04/30 13:11
CallableStatement 对象为所有的DBMS 提供了一种以标准形式调用已储存过程的方法。已储 存过程储存在数据库中。对已储存过程的调用是 CallableStatement对象所含的内容。这种调用是 用一种换码语法来写的,有两种形式:一种形式带结果参,另一种形式不带结果参数。结果参数是 一种输出 (OUT) 参数,是已储存过程的返回值。两种形式都可带有数量可变的输入(IN 参数)、 输出(OUT 参数)或输入和输出(INOUT 参数)的参数。问号将用作参数的占位符。
java.sql
接口 CallableStatement
- 所有超级接口:
- PreparedStatement, Statement, Wrapper
public interface CallableStatement
- extends PreparedStatement
用于执行 SQL 存储过程的接口。JDBC API 提供了一个存储过程 SQL 转义语法,该语法允许对所有 RDBMS 使用标准方式调用存储过程。此转义语法有一个包含结果参数的形式和一个不包含结果参数的形式。如果使用结果参数,则必须将其注册为 OUT 参数。其他参数可用于输入、输出或同时用于二者。参数是根据编号按顺序引用的,第一个参数的编号是 1。
{?= call <procedure-name>[(<arg1>,<arg2>, ...)]} {call <procedure-name>[(<arg1>,<arg2>, ...)]}
IN 参数值是使用继承自 PreparedStatement 的 set
方法设置的。在执行存储过程之前,必须注册所有 OUT 参数的类型;它们的值是在执行后通过此类提供的 get
方法获取的。
CallableStatement
可以返回一个 ResultSet 对象或多个 ResultSet
对象。多个 ResultSet
对象是使用继承自 Statement 的操作处理的。
为了获得最大的可移植性,某一调用的 ResultSet
对象和更新计数应该在获得输出参数的值之前处理。
- 另请参见:
- Connection.prepareCall(java.lang.String), ResultSet
CLOSE_ALL_RESULTS, CLOSE_CURRENT_RESULT, EXECUTE_FAILED, KEEP_CURRENT_RESULT, NO_GENERATED_KEYS, RETURN_GENERATED_KEYS, SUCCESS_NO_INFO
Array
getArray(int parameterIndex)
以 Java 编程语言中 Array 对象的形式获取指定的 JDBC
ARRAY
参数的值。 Array
getArray(String parameterName)
以 Java 编程语言中
java.sql.ARRAY
对象的形式获取 JDBC ARRAY
参数的值。 BigDecimal
getBigDecimal(int parameterIndex)
以
java.math.BigDecimal
对象的形式获取指定 JDBC NUMERIC
参数的值,小数点右边的位数与该参数值所包含的位数相同。 BigDecimal
getBigDecimal(int parameterIndex, int scale)
已过时。 使用
getBigDecimal(int parameterIndex)
或 getBigDecimal(String parameterName)
BigDecimal
getBigDecimal(String parameterName)
以
java.math.BigDecimal
对象的形式获取 JDBC NUMERIC
参数的值,小数点右边的位数与该参数值所包含的位数相同。 Blob
getBlob(int parameterIndex)
以 Java 编程语言中
java.sql.Clob
对象的形式获取指定的 JDBC CLOB
参数的值。 Blob
getBlob(String parameterName)
以 Java 编程语言中 Blob 对象的形式获取 JDBC
BLOB
参数的值。 boolean
getBoolean(int parameterIndex)
以 Java 编程语言中
boolean
值的形式获取指定的 JDBC BIT
或 BOOLEAN
参数的值。 boolean
getBoolean(String parameterName)
以 Java 编程语言中
boolean
值的形式获取 JDBC BIT
或 BOOLEAN
参数的值。 byte
getByte(int parameterIndex)
以 Java 编程语言中
byte
的形式获取指定的 JDBC TINYINT
参数的值。 byte
getByte(String parameterName)
以 Java 编程语言中
byte
值的形式获取 JDBC TINYINT
参数的值。 byte[]
getBytes(int parameterIndex)
以 Java 编程语言中
byte
数组值的形式获取指定的 JDBC BINARY
或 VARBINARY
参数的值。 byte[]
getBytes(String parameterName)
以 Java 编程语言中
byte
数组值的形式获取 JDBC BINARY
或 VARBINARY
参数的值。 Reader
getCharacterStream(int parameterIndex)
以 Java 编程语言中
java.io.Reader
对象的形式获取指定参数的值。 Reader
getCharacterStream(String parameterName)
以 Java 编程语言中
java.io.Reader
对象的形式获取指定参数的值。 Clob
getClob(int parameterIndex)
以 Java 编程语言中
java.sql.Clob
对象的形式获取指定的 JDBC CLOB
参数的值。 Clob
getClob(String parameterName)
以 Java 编程语言中
java.sql.CLOB
对象的形式获取 JDBC CLOB
参数的值。 Date
getDate(int parameterIndex)
以
java.sql.Date
对象的形式获取指定 JDBC DATE
参数的值。 Date
getDate(int parameterIndex, Calendar cal)
以
java.sql.Date
对象的形式获取指定 JDBC DATE
参数的值,使用给定 Calendar
对象构造日期。 Date
getDate(String parameterName)
以
java.sql.Date
对象的形式获取 JDBC DATE
参数的值。 Date
getDate(String parameterName, Calendar cal)
以
java.sql.Date
对象的形式获取 JDBC DATE
参数的值,使用给定 Calendar
对象构造日期。 double
getDouble(int parameterIndex)
以 Java 编程语言中
double
值的形式获取指定的 JDBC DOUBLE
参数的值。 double
getDouble(String parameterName)
以 Java 编程语言中
double
值的形式获取 JDBC DOUBLE
参数的值。 float
getFloat(int parameterIndex)
以 Java 编程语言中
float
值的形式获取指定的 JDBC FLOAT
参数的值。 float
getFloat(String parameterName)
以 Java 编程语言中
float
值的形式获取 JDBC FLOAT
参数的值。 int
getInt(int parameterIndex)
以 Java 编程语言中
int
值的形式获取指定的 JDBC INTEGER
参数的值。 int
getInt(String parameterName)
以 Java 编程语言中
int
值的形式获取 JDBC INTEGER
参数的值。 long
getLong(int parameterIndex)
以 Java 编程语言中
long
值的形式获取指定的 JDBC BIGINT
参数的值。 long
getLong(String parameterName)
以 Java 编程语言中
long
值的形式获取 JDBC BIGINT
参数的值。 Reader
getNCharacterStream(int parameterIndex)
以 Java 编程语言中
java.io.Reader
对象的形式获取指定参数的值。 Reader
getNCharacterStream(String parameterName)
以 Java 编程语言中
java.io.Reader
对象的形式获取指定参数的值。 NClob
getNClob(int parameterIndex)
以 Java 编程语言中
java.sql.NClob
对象的形式获取指定的 JDBC NCLOB
参数的值。 NClob
getNClob(String parameterName)
以 Java 编程语言中
java.sql.NClob
对象的形式获取 JDBC NCLOB
参数的值。 String
getNString(int parameterIndex)
以 Java 编程语言中
String
的形式获取指定的 NCHAR
、NVARCHAR
或 LONGNVARCHAR
参数的值。 String
getNString(String parameterName)
以 Java 编程语言中
String
的形式获取指定的 NCHAR
、NVARCHAR
或 LONGNVARCHAR
参数的值。 Object
getObject(int parameterIndex)
以 Java 编程语言中
Object
的形式获取指定参数的值。 Object
getObject(int parameterIndex, Map<String,Class<?>> map)
返回一个表示 OUT 参数
parameterIndex
值的对象,并将 map
用于该参数值的自定义映射关系。 Object
getObject(String parameterName)
以 Java 编程语言中
Object
的形式获取参数的值。 Object
getObject(String parameterName, Map<String,Class<?>> map)
返回一个表示 OUT 参数
parameterName
值的对象,并将 map
用于该参数值的自定义映射关系。 Ref
getRef(int parameterIndex)
以 Java 编程语言中 Ref 对象的形式获取指定的 JDBC
REF(<structured-type>)
参数的值。 Ref
getRef(String parameterName)
以 Java 编程语言中 Ref 对象的形式获取 JDBC
REF(<structured-type>)
参数的值。 RowId
getRowId(int parameterIndex)
以
java.sql.RowId
对象的形式获取指定 JDBC ROWID
参数的值。 RowId
getRowId(String parameterName)
以
java.sql.RowId
对象的形式获取指定 JDBC ROWID
参数的值。 short
getShort(int parameterIndex)
以 Java 编程语言中
short
值的形式获取指定的 JDBC SMALLINT
参数的值。 short
getShort(String parameterName)
以 Java 编程语言中
short
值的形式获取 JDBC SMALLINT
参数的值。 SQLXML
getSQLXML(int parameterIndex)
以 Java 编程语言中
java.sql.SQLXML
对象的形式获取指定的 SQL XML
参数的值。 SQLXML
getSQLXML(String parameterName)
以 Java 编程语言中
java.sql.SQLXML
对象的形式获取指定的 SQL XML
参数的值。 String
getString(int parameterIndex)
以 Java 编程语言中
String
的形式获取指定的 JDBC CHAR
、VARCHAR
或 LONGVARCHAR
参数的值。 String
getString(String parameterName)
以 Java 编程语言中
String
的形式获取 JDBC CHAR
、VARCHAR
或 LONGVARCHAR
参数的值。 Time
getTime(int parameterIndex)
以
java.sql.Time
对象的形式获取指定 JDBC TIME
参数的值。 Time
getTime(int parameterIndex, Calendar cal)
以
java.sql.Time
对象的形式获取指定 JDBC TIME
参数的值,使用给定 Calendar
对象构造时间。 Time
getTime(String parameterName)
以
java.sql.Time
对象的形式获取 JDBC TIME
参数的值。 Time
getTime(String parameterName, Calendar cal)
以
java.sql.Time
对象的形式获取 JDBC TIME
参数的值,使用给定 Calendar
对象构造时间。 Timestamp
getTimestamp(int parameterIndex)
以
java.sql.Timestamp
对象的形式获取指定 JDBC TIMESTAMP
参数的值。 Timestamp
getTimestamp(int parameterIndex, Calendar cal)
以
java.sql.Timestamp
对象的形式获取指定 JDBC TIMESTAMP
参数的值,使用给定 Calendar
对象构造 Timestamp
对象。 Timestamp
getTimestamp(String parameterName)
以
java.sql.Timestamp
对象的形式获取 JDBC TIMESTAMP
参数的值。 Timestamp
getTimestamp(String parameterName, Calendar cal)
以
java.sql.Timestamp
对象的形式获取 JDBC TIMESTAMP
参数的值,使用给定 Calendar
对象构造 Timestamp
对象。 URL
getURL(int parameterIndex)
以
java.sql.URL
对象的形式获取指定 JDBC DATALINK
参数的值。 URL
getURL(String parameterName)
以
java.net.URL
对象的形式获取 JDBC DATALINK
参数的值。 void
registerOutParameter(int parameterIndex, int sqlType)
按顺序位置
parameterIndex
将 OUT 参数注册为 JDBC 类型 sqlType
。 void
registerOutParameter(int parameterIndex, int sqlType, int scale)
按顺序位置
parameterIndex
将参数注册为 JDBC 类型 sqlType
。 void
registerOutParameter(int parameterIndex, int sqlType, String typeName)
注册指定的输出参数。
void
registerOutParameter(String parameterName, int sqlType)
将名为
parameterName
的 OUT 参数注册为 JDBC 类型 sqlType
。 void
registerOutParameter(String parameterName, int sqlType, int scale)
将名为
parameterName
的参数注册为 JDBC 类型 sqlType
。 void
registerOutParameter(String parameterName, int sqlType, String typeName)
注册指定的输出参数。
void
setAsciiStream(String parameterName, InputStream x)
将指定参数设置为给定输入流。
void
setAsciiStream(String parameterName, InputStream x, int length)
将指定参数设置为给定输入流,该输入流将拥有指定的字节数。
void
setAsciiStream(String parameterName, InputStream x, long length)
将指定参数设置为给定输入流,该输入流将拥有指定的字节数。
void
setBigDecimal(String parameterName, BigDecimal x)
将指定参数设置为给定
java.math.BigDecimal
值。 void
setBinaryStream(String parameterName, InputStream x)
将指定参数设置为给定输入流。
void
setBinaryStream(String parameterName, InputStream x, int length)
将指定参数设置为给定输入流,该输入流将拥有指定的字节数。
void
setBinaryStream(String parameterName, InputStream x, long length)
将指定参数设置为给定输入流,该输入流将拥有指定字节数。
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(String parameterName, boolean x)
将指定参数设置为给定 Java
boolean
值。 void
setByte(String parameterName, byte x)
将指定参数设置为给定 Java
byte
值。 void
setBytes(String parameterName, byte[] x)
将指定参数设置为给定 Java byte 数组。
void
setCharacterStream(String parameterName, Reader reader)
将指定参数设置为给定
Reader
对象。 void
setCharacterStream(String parameterName, Reader reader, int length)
将指定参数设置为给定
Reader
对象,该对象是给定的字符长度数。 void
setCharacterStream(String parameterName, 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
setDate(String parameterName, Date x)
使用运行应用程序的虚拟机默认时区将指定参数设置为给定
java.sql.Date
值。 void
setDate(String parameterName, Date x, Calendar cal)
使用给定的
Calendar
对象将指定参数设置为给定 java.sql.Date
值。 void
setDouble(String parameterName, double x)
将指定参数设置为给定 Java
double
值。 void
setFloat(String parameterName, float x)
将指定参数设置为给定 Java
float
值。 void
setInt(String parameterName, int x)
将指定参数设置为给定 Java
int
值。 void
setLong(String parameterName, long x)
将指定参数设置为给定 Java
long
值。 void
setNCharacterStream(String parameterName, Reader value)
将指定参数设置为
Reader
对象。 void
setNCharacterStream(String parameterName, Reader value, 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(String parameterName, String value)
将指定参数设置为给定
String
对象。 void
setNull(String parameterName, int sqlType)
将指定参数设置为 SQL
NULL
。 void
setNull(String parameterName, int sqlType, String typeName)
将指定参数设置为 SQL
NULL
。 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
setRowId(String parameterName, RowId x)
将指定参数设置为给定
java.sql.RowId
对象。 void
setShort(String parameterName, short x)
将指定参数设置为给定 Java
short
值。 void
setSQLXML(String parameterName, SQLXML xmlObject)
将指定参数设置为给定
java.sql.SQLXML
对象。 void
setString(String parameterName, String x)
将指定参数设置为给定 Java
String
值。 void
setTime(String parameterName, Time x)
将指定参数设置为给定
java.sql.Time
值。 void
setTime(String parameterName, Time x, Calendar cal)
使用给定的
Calendar
对象将指定参数设置为给定 java.sql.Time
值。 void
setTimestamp(String parameterName, Timestamp x)
将指定参数设置为给定
java.sql.Timestamp
值。 void
setTimestamp(String parameterName, Timestamp x, Calendar cal)
使用给定的
Calendar
对象将指定参数设置为给定 java.sql.Timestamp
值。 void
setURL(String parameterName, URL val)
将指定参数设置为给定
java.net.URL
对象。 boolean
wasNull()
查询最后一个读取的 OUT 参数是否为 SQL
NULL
。 addBatch, clearParameters, execute, executeQuery, executeUpdate, getMetaData, getParameterMetaData, setArray, setAsciiStream, setAsciiStream, setAsciiStream, setBigDecimal, setBinaryStream, setBinaryStream, setBinaryStream, setBlob, setBlob, setBlob, setBoolean, setByte, setBytes, setCharacterStream, setCharacterStream, setCharacterStream, setClob, setClob, setClob, setDate, setDate, setDouble, setFloat, setInt, setLong, setNCharacterStream, setNCharacterStream, setNClob, setNClob, setNClob, setNString, setNull, setNull, setObject, setObject, setObject, setRef, setRowId, setShort, setSQLXML, setString, setTime, setTime, setTimestamp, setTimestamp, setUnicodeStream, setURL
addBatch, cancel, clearBatch, clearWarnings, close, execute, execute, execute, execute, executeBatch, executeQuery, executeUpdate, executeUpdate, executeUpdate, executeUpdate, getConnection, getFetchDirection, getFetchSize, getGeneratedKeys, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSet, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getUpdateCount, getWarnings, isClosed, isPoolable, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setMaxFieldSize, setMaxRows, setPoolable, setQueryTimeout
isWrapperFor, unwrap
registerOutParameter
void registerOutParameter(int parameterIndex, int sqlType) throws SQLException
- 按顺序位置
parameterIndex
将 OUT 参数注册为 JDBC 类型sqlType
。所有 OUT 参数都必须在执行存储过程前注册。sqlType
为 OUT 参数指定的 JDBC 类型确定必须用于get
方法,以读取该参数值的 Java 类型。如果预期返回给此输出参数的 JDBC 类型是取决于此特定数据库的,则
sqlType
应该是java.sql.Types.OTHER
。方法 getObject(int) 获取该值。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推sqlType
-java.sql.Types
定义的 JDBC 类型代码。如果参数是 JDBC 类型NUMERIC
或DECIMAL
,则应使用接受标度值的那种registerOutParameter
。- 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果sqlType
是ARRAY
、BLOB
、CLOB
、DATALINK
、JAVA_OBJECT
、NCHAR
、NCLOB
、NVARCHAR
、LONGNVARCHAR
、REF
、ROWID
、SQLXML
或STRUCT
数据类型之一并且 JDBC 驱动程序不支持此数据类型- 另请参见:
- Types
registerOutParameter
void registerOutParameter(int parameterIndex, int sqlType, int scale) throws SQLException
- 按顺序位置
parameterIndex
将参数注册为 JDBC 类型sqlType
。所有 OUT 参数都必须在执行存储过程前注册。sqlType
为 OUT 参数指定的 JDBC 类型确定必须用于get
方法,以读取该参数值的 Java 类型。这种形式的
registerOutParameter
应该在参数是 JDBC 类型NUMERIC
或DECIMAL
时使用。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推sqlType
- 由java.sql.Types
定义的 SQL 类型代码。scale
- 小数点右边所需的位数。该参数必须大于等于 0。- 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果sqlType
是ARRAY
、BLOB
、CLOB
、DATALINK
、JAVA_OBJECT
、NCHAR
、NCLOB
、NVARCHAR
、LONGNVARCHAR
、REF
、ROWID
、SQLXML
或STRUCT
数据类型之一并且 JDBC 驱动程序不支持此数据类型- 另请参见:
- Types
wasNull
boolean wasNull() throws SQLException
- 查询最后一个读取的 OUT 参数是否为 SQL
NULL
。注意,此方法只应该在调用获取方法之后调用;否则没有用来确定它是否为null
的值。 - 返回:
- 如果最后一个读取的参数为 SQL
NULL
,则返回true
;否则返回false
- 抛出:
SQLException
- 如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法
getString
String getString(int parameterIndex) throws SQLException
- 以 Java 编程语言中
String
的形式获取指定的 JDBCCHAR
、VARCHAR
或LONGVARCHAR
参数的值。对于固定长度类型 SQL
CHAR
,返回的String
对象与数据库中的 JDBCCHAR
值完全相同,包括数据库添加的任何填充数据。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为null
。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法- 另请参见:
- setString(java.lang.String, java.lang.String)
getBoolean
boolean getBoolean(int parameterIndex) throws SQLException
- 以 Java 编程语言中
boolean
值的形式获取指定的 JDBCBIT
或BOOLEAN
参数的值。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为false
。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法- 另请参见:
- setBoolean(java.lang.String, boolean)
getByte
byte getByte(int parameterIndex) throws SQLException
- 以 Java 编程语言中
byte
的形式获取指定的 JDBCTINYINT
参数的值。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为0
。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法- 另请参见:
- setByte(java.lang.String, byte)
getShort
short getShort(int parameterIndex) throws SQLException
- 以 Java 编程语言中
short
值的形式获取指定的 JDBCSMALLINT
参数的值。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为0
。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法- 另请参见:
- setShort(java.lang.String, short)
getInt
int getInt(int parameterIndex) throws SQLException
- 以 Java 编程语言中
int
值的形式获取指定的 JDBCINTEGER
参数的值。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为0
。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法- 另请参见:
- setInt(java.lang.String, int)
getLong
long getLong(int parameterIndex) throws SQLException
- 以 Java 编程语言中
long
值的形式获取指定的 JDBCBIGINT
参数的值。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为0
。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法- 另请参见:
- setLong(java.lang.String, long)
getFloat
float getFloat(int parameterIndex) throws SQLException
- 以 Java 编程语言中
float
值的形式获取指定的 JDBCFLOAT
参数的值。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为0
。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法- 另请参见:
- setFloat(java.lang.String, float)
getDouble
double getDouble(int parameterIndex) throws SQLException
- 以 Java 编程语言中
double
值的形式获取指定的 JDBCDOUBLE
参数的值。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为0
。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法- 另请参见:
- setDouble(java.lang.String, double)
getBigDecimal
BigDecimal getBigDecimal(int parameterIndex, int scale) throws SQLException
- 已过时。 使用
getBigDecimal(int parameterIndex)
或getBigDecimal(String parameterName)
- 以
java.math.BigDecimal
对象的形式获取指定 JDBCNUMERIC
参数的值,小数点右边有 scale 个位数。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推scale
- 小数点右边的位数- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为null
。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 另请参见:
- setBigDecimal(java.lang.String, java.math.BigDecimal)
getBytes
byte[] getBytes(int parameterIndex) throws SQLException
- 以 Java 编程语言中
byte
数组值的形式获取指定的 JDBCBINARY
或VARBINARY
参数的值。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为null
。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法- 另请参见:
- setBytes(java.lang.String, byte[])
getDate
Date getDate(int parameterIndex) throws SQLException
- 以
java.sql.Date
对象的形式获取指定 JDBCDATE
参数的值。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为null
。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法- 另请参见:
- setDate(java.lang.String, java.sql.Date)
getTime
Time getTime(int parameterIndex) throws SQLException
- 以
java.sql.Time
对象的形式获取指定 JDBCTIME
参数的值。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为null
。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法- 另请参见:
- setTime(java.lang.String, java.sql.Time)
getTimestamp
Timestamp getTimestamp(int parameterIndex) throws SQLException
- 以
java.sql.Timestamp
对象的形式获取指定 JDBCTIMESTAMP
参数的值。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为null
。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法- 另请参见:
- setTimestamp(java.lang.String, java.sql.Timestamp)
getObject
Object getObject(int parameterIndex) throws SQLException
- 以 Java 编程语言中
Object
的形式获取指定参数的值。如果值为 SQLNULL
,则驱动程序返回一个 Javanull
。此方法返回一个 Java 对象,其类型对应于使用
registerOutParameter
方法为此参数注册的 JDBC 类型。通过将目标 JDBC 类型注册为java.sql.Types.OTHER
,可以使用此方法来读取特定于数据库的抽象数据类型。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推- 返回:
- 保存 OUT 参数值的
java.lang.Object
- 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法- 另请参见:
- Types, setObject(java.lang.String, java.lang.Object, int, int)
getBigDecimal
BigDecimal getBigDecimal(int parameterIndex) throws SQLException
- 以
java.math.BigDecimal
对象的形式获取指定 JDBCNUMERIC
参数的值,小数点右边的位数与该参数值所包含的位数相同。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推- 返回:
- 全精度参数值。如果值为 SQL
NULL
,则结果为null
。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法- 从以下版本开始:
- 1.2
- 另请参见:
- setBigDecimal(java.lang.String, java.math.BigDecimal)
getObject
Object getObject(int parameterIndex, Map<String,Class<?>> map) throws SQLException
- 返回一个表示 OUT 参数
parameterIndex
值的对象,并将map
用于该参数值的自定义映射关系。此方法返回一个 Java 对象,其类型对应于使用
registerOutParameter
方法为此参数注册的 JDBC 类型。通过将目标 JDBC 类型注册为java.sql.Types.OTHER
,可以使用此方法来读取特定于数据库的抽象数据类型。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推map
- SQL 类型名称到 Java 类的映射关系- 返回:
- 保存 OUT 参数值的
java.lang.Object
- 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.2
- 另请参见:
- setObject(java.lang.String, java.lang.Object, int, int)
getRef
Ref getRef(int parameterIndex) throws SQLException
- 以 Java 编程语言中 Ref 对象的形式获取指定的 JDBC
REF(<structured-type>)
参数的值。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推- 返回:
- Java 编程语言中
Ref
对象形式的参数值。如果值为 SQLNULL
,则返回null
值。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.2
getBlob
Blob getBlob(int parameterIndex) throws SQLException
- 以 Java 编程语言中
java.sql.Clob
对象的形式获取指定的 JDBCCLOB
参数的值。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推- 返回:
- Java 编程语言中
Blob
对象形式的参数值。如果值为 SQLNULL
,则返回null
值。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.2
getClob
Clob getClob(int parameterIndex) throws SQLException
- 以 Java 编程语言中
java.sql.Clob
对象的形式获取指定的 JDBCCLOB
参数的值。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推- 返回:
- Java 编程语言中
Clob
对象形式的参数值。如果值为 SQLNULL
,则返回null
值。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.2
getArray
Array getArray(int parameterIndex) throws SQLException
- 以 Java 编程语言中 Array 对象的形式获取指定的 JDBC
ARRAY
参数的值。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推- 返回:
- Java 编程语言中
Array
对象形式的参数值。如果值为 SQLNULL
,则返回null
值。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.2
getDate
Date getDate(int parameterIndex, Calendar cal) throws SQLException
- 以
java.sql.Date
对象的形式获取指定 JDBCDATE
参数的值,使用给定Calendar
对象构造日期。利用Calendar
对象,驱动程序可以在考虑自定义时区和语言环境的情况下计算日期。如果没有指定任何Calendar
对象,那么驱动程序将使用默认时区和语言环境。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推cal
- 供驱动程序用来构造日期的Calendar
对象- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为null
。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法- 从以下版本开始:
- 1.2
- 另请参见:
- setDate(java.lang.String, java.sql.Date)
getTime
Time getTime(int parameterIndex, Calendar cal) throws SQLException
- 以
java.sql.Time
对象的形式获取指定 JDBCTIME
参数的值,使用给定Calendar
对象构造时间。利用Calendar
对象,驱动程序可以在考虑自定义时区和语言环境的情况下计算时间。如果没有指定任何Calendar
对象,那么驱动程序将使用默认时区和语言环境。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推cal
- 供驱动程序用来构造时间的Calendar
对象- 返回:
- 参数值;如果该值为 SQL
NULL
,则结果为null
。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法- 从以下版本开始:
- 1.2
- 另请参见:
- setTime(java.lang.String, java.sql.Time)
getTimestamp
Timestamp getTimestamp(int parameterIndex, Calendar cal) throws SQLException
- 以
java.sql.Timestamp
对象的形式获取指定 JDBCTIMESTAMP
参数的值,使用给定Calendar
对象构造Timestamp
对象。利用Calendar
对象,驱动程序可以在考虑自定义时区和语言环境的情况下计算时间戳。如果没有指定任何Calendar
对象,那么驱动程序将使用默认时区和语言环境。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推cal
- 供驱动程序用来构造时间戳的Calendar
对象- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为null
。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法- 从以下版本开始:
- 1.2
- 另请参见:
- setTimestamp(java.lang.String, java.sql.Timestamp)
registerOutParameter
void registerOutParameter(int parameterIndex, int sqlType, String typeName) throws SQLException
- 注册指定的输出参数。这种形式的
registerOutParameter
方法应该用于用户定义的输出参数或REF
输出参数。用户定义类型的示例有:STRUCT
、DISTINCT
、JAVA_OBJECT
和指定的数组类型。所有 OUT 参数都必须在执行存储过程前注册。
对于用户定义的参数,还应该提供该参数的完全限定 SQL 类型名称,而
REF
参数则要求提供引用类型的完全限定类型名称。不需要类型代码和类型名称信息的 JDBC 驱动程序可以忽略它。不过,为了便于移植,应用程序应该为用户定义的参数和REF
参数提供这些值。 尽管此方法是供用户定义的参数和REF
参数使用的,但也可以将其用于注册任何 JDBC 类型的参数。如果参数没有用户定义的类型或REF
类型,则忽略 typeName 参数。注:在读取 out 参数的值时,必须使用某个获取方法,该方法的 Java 类型对应于参数的已注册 SQL 类型。
- 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推sqlType
- 取自 Types 的一个值typeName
- SQL 结构类型的完全限定名称- 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果sqlType
是ARRAY
、BLOB
、CLOB
、DATALINK
、JAVA_OBJECT
、NCHAR
、NCLOB
、NVARCHAR
、LONGNVARCHAR
、REF
、ROWID
、SQLXML
或STRUCT
数据类型之一并且 JDBC 驱动程序不支持此数据类型- 从以下版本开始:
- 1.2
- 另请参见:
- Types
registerOutParameter
void registerOutParameter(String parameterName, int sqlType) throws SQLException
- 将名为
parameterName
的 OUT 参数注册为 JDBC 类型sqlType
。所有 OUT 参数都必须在执行存储过程前注册。sqlType
为 OUT 参数指定的 JDBC 类型确定必须用于get
方法,以读取该参数值的 Java 类型。如果预期返回给此输出参数的 JDBC 类型是特定于此特定数据库的,则
sqlType
应该是java.sql.Types.OTHER
。方法 getObject(int) 获取该值。 - 参数:
parameterName
- 参数名sqlType
- 由java.sql.Types
定义的 JDBC 类型代码。如果参数是 JDBC 类型NUMERIC
或DECIMAL
,则应使用接受标度值的那种registerOutParameter
。- 抛出:
SQLException
- 如果 parameterName 不对应指定的参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果sqlType
是ARRAY
、BLOB
、CLOB
、DATALINK
、JAVA_OBJECT
、NCHAR
、NCLOB
、NVARCHAR
、LONGNVARCHAR
、REF
、ROWID
、SQLXML
或STRUCT
数据类型之一并且 JDBC 驱动程序不支持此数据类型,或者 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- Types
registerOutParameter
void registerOutParameter(String parameterName, int sqlType, int scale) throws SQLException
- 将名为
parameterName
的参数注册为 JDBC 类型sqlType
。所有 OUT 参数都必须在执行存储过程前注册。sqlType
为 OUT 参数指定的 JDBC 类型确定必须用于get
方法,以读取该参数值的 Java 类型。这种形式的
registerOutParameter
应该在参数是 JDBC 类型NUMERIC
或DECIMAL
时使用。 - 参数:
parameterName
- 参数名sqlType
- 由java.sql.Types
定义的 SQL 类型代码。scale
- 小数点右边所需的位数。该参数必须大于等于 0。- 抛出:
SQLException
- 如果 parameterName 不对应指定的参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果sqlType
是ARRAY
、BLOB
、CLOB
、DATALINK
、JAVA_OBJECT
、NCHAR
、NCLOB
、NVARCHAR
、LONGNVARCHAR
、REF
、ROWID
、SQLXML
或STRUCT
数据类型之一并且 JDBC 驱动程序不支持此数据类型,或者 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- Types
registerOutParameter
void registerOutParameter(String parameterName, int sqlType, String typeName) throws SQLException
- 注册指定的输出参数。这种形式的
registerOutParameter
方法应该用于用户命名的输出参数或 REF 输出参数。用户命名类型的示例有:STRUCT、DISTINCT、JAVA_OBJECT 和指定的数组类型。所有 OUT 参数都必须在执行存储过程前注册。
对于用户命名的参数,还应该提供参数的完全限定 SQL 类型名称,而 REF 参数则要求提供所引用类型的完全限定类型名称。不需要类型代码和类型名称信息的 JDBC 驱动程序可以忽略它。不过,为了便于移植,应用程序应该为用户命名的参数和 REF 参数提供这些值。尽管此方法是供用户命名的参数和 REF 参数使用的,但也可以将其用于注册任何 JDBC 类型的参数。如果参数没有用户命名的类型或 REF 类型,则忽略 typeName 参数。
注:在读取 out 参数的值时,必须使用
getXXX
方法,其 Java 类型 XXX 对应于参数的已注册 SQL 类型。 - 参数:
parameterName
- 参数名sqlType
- 取自 Types 的一个值typeName
- SQL 结构类型的完全限定名称- 抛出:
SQLException
- 如果 parameterName 不对应指定的参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果sqlType
是ARRAY
、BLOB
、CLOB
、DATALINK
、JAVA_OBJECT
、NCHAR
、NCLOB
、NVARCHAR
、LONGNVARCHAR
、REF
、ROWID
、SQLXML
或STRUCT
数据类型之一并且 JDBC 驱动程序不支持此数据类型,或者 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- Types
getURL
URL getURL(int parameterIndex) throws SQLException
- 以
java.sql.URL
对象的形式获取指定 JDBCDATALINK
参数的值。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,……- 返回:
- 表示用作指定参数的 JDBC
DATALINK
值的java.net.URL
对象 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法,或者将返回的 URL 在 Java 平台上是一个无效 URLSQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- setURL(java.lang.String, java.net.URL)
setURL
void setURL(String parameterName, URL val) throws SQLException
- 将指定参数设置为给定
java.net.URL
对象。在将该值发送到数据库时,驱动程序将它转换成一个 SQLDATALINK
值。 - 参数:
parameterName
- 参数名val
- 参数值- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法,或者 URL 是错误的SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- getURL(int)
setNull
void setNull(String parameterName, int sqlType) throws SQLException
- 将指定参数设置为 SQL
NULL
。注:必须指定参数的 SQL 类型。
- 参数:
parameterName
- 参数名sqlType
-java.sql.Types
中定义的 SQL 类型代码- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
setBoolean
void setBoolean(String parameterName, boolean x) throws SQLException
- 将指定参数设置为给定 Java
boolean
值。在将该值发送到数据库时,驱动程序将它转换成一个 SQLBIT
或BOOLEAN
值。 - 参数:
parameterName
- 参数名x
- 参数值- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- getBoolean(int)
setByte
void setByte(String parameterName, byte x) throws SQLException
- 将指定参数设置为给定 Java
byte
值。在将该值发送到数据库时,驱动程序将它转换成一个 SQLTINYINT
值。 - 参数:
parameterName
- 参数名x
- 参数值- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- getByte(int)
setShort
void setShort(String parameterName, short x) throws SQLException
- 将指定参数设置为给定 Java
short
值。在将该值发送到数据库时,驱动程序将它转换成一个 SQLSMALLINT
值。 - 参数:
parameterName
- 参数名x
- 参数值- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- getShort(int)
setInt
void setInt(String parameterName, int x) throws SQLException
- 将指定参数设置为给定 Java
int
值。在将该值发送到数据库时,驱动程序将它转换成一个 SQLINTEGER
值。 - 参数:
parameterName
- 参数名x
- 参数值- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- getInt(int)
setLong
void setLong(String parameterName, long x) throws SQLException
- 将指定参数设置为给定 Java
long
值。在将该值发送到数据库时,驱动程序将它转换成一个 SQLBIGINT
值。 - 参数:
parameterName
- 参数名x
- 参数值- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- getLong(int)
setFloat
void setFloat(String parameterName, float x) throws SQLException
- 将指定参数设置为给定 Java
float
值。在将该值发送到数据库时,驱动程序将它转换成一个 SQLFLOAT
值。 - 参数:
parameterName
- 参数名x
- 参数值- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- getFloat(int)
setDouble
void setDouble(String parameterName, double x) throws SQLException
- 将指定参数设置为给定 Java
double
值。在将该值发送到数据库时,驱动程序将它转换成一个 SQLDOUBLE
值。 - 参数:
parameterName
- 参数名x
- 参数值- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- getDouble(int)
setBigDecimal
void setBigDecimal(String parameterName, BigDecimal x) throws SQLException
- 将指定参数设置为给定
java.math.BigDecimal
值。在将该值发送到数据库时,驱动程序将它转换成一个 SQLNUMERIC
值。 - 参数:
parameterName
- 参数名x
- 参数值- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- getBigDecimal(int, int)
setString
void setString(String parameterName, String x) throws SQLException
- 将指定参数设置为给定 Java
String
值。在将此值发送给数据库时,驱动程序将它转换成一个 SQLVARCHAR
或LONGVARCHAR
值(取决于该参数相对于驱动程序在VARCHAR
值上的限制的大小)。 - 参数:
parameterName
- 参数名x
- 参数值- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- getString(int)
setBytes
void setBytes(String parameterName, byte[] x) throws SQLException
- 将指定参数设置为给定 Java byte 数组。在将此值发送给数据库时,驱动程序将它转换成一个 SQL
VARBINARY
或LONGVARBINARY
值(取决于该参数相对于驱动程序在VARBINARY
值上的限制的大小)。 - 参数:
parameterName
- 参数名x
- 参数值- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- getBytes(int)
setDate
void setDate(String parameterName, Date x) throws SQLException
- 使用运行应用程序的虚拟机默认时区将指定参数设置为给定
java.sql.Date
值。在将该值发送到数据库时,驱动程序将它转换成一个 SQLDATE
值。 - 参数:
parameterName
- 参数名x
- 参数值- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- getDate(int)
setTime
void setTime(String parameterName, Time x) throws SQLException
- 将指定参数设置为给定
java.sql.Time
值。在将该值发送到数据库时,驱动程序将它转换成一个 SQLTIME
值。 - 参数:
parameterName
- 参数名x
- 参数值- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- getTime(int)
setTimestamp
void setTimestamp(String parameterName, Timestamp x) throws SQLException
- 将指定参数设置为给定
java.sql.Timestamp
值。在将该值发送到数据库时,驱动程序将它转换成一个 SQLTIMESTAMP
值。 - 参数:
parameterName
- 参数名x
- 参数值- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- getTimestamp(int)
setAsciiStream
void setAsciiStream(String parameterName, InputStream x, int length) throws SQLException
- 将指定参数设置为给定输入流,该输入流将拥有指定的字节数。在将一个非常大的 ASCII 值输入给
LONGVARCHAR
参数时,通过java.io.InputStream
发送它可能更为实际。将根据需要从流中读取数据,一直读取到文件末尾。JDBC 驱动程序将执行从 ASCII 到数据库 char 格式的任何必要转换。注:此流对象可以是一个标准 Java 流对象,也可以是实现标准接口的用户自己的子类。
- 参数:
parameterName
- 参数名x
- 包含 ASCII 参数值的 Java 输入流length
- 流中的字节数- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
setBinaryStream
void setBinaryStream(String parameterName, InputStream x, int length) throws SQLException
- 将指定参数设置为给定输入流,该输入流将拥有指定的字节数。在将一个非常大的二进制值输入给
LONGVARBINARY
参数时,通过java.io.InputStream
对象发送它可能更为实际。将根据需要从流中读取数据,一直读取到文件末尾。注:此流对象可以是一个标准 Java 流对象,也可以是实现标准接口的用户自己的子类。
- 参数:
parameterName
- 参数名x
- 包含二进制参数值的 java 输入流length
- 流中的字节数- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
setObject
void setObject(String parameterName, Object x, int targetSqlType, int scale) throws SQLException
- 使用给定对象设置指定参数的值。第二个参数必须是一个对象类型;对于整数值,应该使用
java.lang
的等效对象。在被发送到数据库之前,给定 Java 对象将被转换为给定 targetSqlType。 如果对象具有自定义映射关系(是实现
SQLData
接口的类),则 JDBC 驱动程序应该调用SQLData.writeSQL
方法将它写入 SQL 数据流中。另一方面,如果该对象是实现Ref
、Blob
、Clob
、NClob
、Struct
、java.net.URL
或Array
的类,则驱动程序应该将它作为相应 SQL 类型的值传递给数据库。注意,此方法可用于传递特定于数据库的抽象数据类型。
- 参数:
parameterName
- 参数名x
- 包含输入参数值的对象targetSqlType
- 将发送到数据库的 SQL 类型(在 java.sql.Types 中定义)。scale 参数可以进一步限定此类型。scale
- 对于 java.sql.Types.DECIMAL 或 java.sql.Types.NUMERIC 类型,该参数是小数点后的位数。对于其他所有类型,将忽略此值。- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果targetSqlType
是ARRAY
、BLOB
、CLOB
、DATALINK
、JAVA_OBJECT
、NCHAR
、NCLOB
、NVARCHAR
、LONGNVARCHAR
、REF
、ROWID
、SQLXML
或STRUCT
数据类型之一并且 JDBC 驱动程序不支持此数据类型- 从以下版本开始:
- 1.4
- 另请参见:
- Types, getObject(int)
setObject
void setObject(String parameterName, Object x, int targetSqlType) throws SQLException
- 使用给定对象设置指定参数的值。除了假定 scale 为 0 外,此方法类似于上面的
setObject
方法。 - 参数:
parameterName
- 参数名x
- 包含输入参数值的对象targetSqlType
- 要发送到数据库的 SQL 类型(在 java.sql.Types 中定义)- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果targetSqlType
是ARRAY
、BLOB
、CLOB
、DATALINK
、JAVA_OBJECT
、NCHAR
、NCLOB
、NVARCHAR
、LONGNVARCHAR
、REF
、ROWID
、SQLXML
或STRUCT
数据类型之一并且 JDBC 驱动程序不支持此数据类型- 从以下版本开始:
- 1.4
- 另请参见:
- getObject(int)
setObject
void setObject(String parameterName, Object x) throws SQLException
- 使用给定对象设置指定参数的值。第二个参数必须是类型
Object
;所以,应该对内置类型使用java.lang
的等效对象。JDBC 规范指定了一个从 Java
Object
类型到 SQL 类型的标准映射关系。在被发送到数据库之前,给定参数将被转换为相应 SQL 类型。注意,通过使用特定于驱动程序的 Java 类型,此方法可用于传递特定于数据库的抽象数据类型。 如果对象是实现
SQLData
接口的类,则 JDBC 驱动程序应该调用SQLData.writeSQL
方法将它写入 SQL 数据流中。另一方面,如果该对象是实现Ref
、Blob
、Clob
、NClob
、Struct
、java.net.URL
或Array
的类,则驱动程序应该将它作为相应 SQL 类型的值传递给数据库。如果出现混淆,例如,如果该对象是实现不止一个上述指定接口的类,则此方法抛出异常。
注: 并非所有允许非类型 Null 的数据库都被发送到后端。为了获得最大的可移植性,应该使用
setNull
或setObject(String parameterName, Object x, int sqlType)
方法替代setObject(String parameterName, Object x)
。 - 参数:
parameterName
- 参数名x
- 包含输入参数值的对象- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法,或者给定的Object
参数不明确SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- getObject(int)
setCharacterStream
void setCharacterStream(String parameterName, Reader reader, int length) throws SQLException
- 将指定参数设置为给定
Reader
对象,该对象是给定的字符长度数。在将一个非常大的 UNICODE 值输入给LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更为实际。将根据需要从流中读取数据,一直读取到文件末尾。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。注:此流对象可以是一个标准 Java 流对象,也可以是实现标准接口的用户自己的子类。
- 参数:
parameterName
- 参数名reader
- 包含用作指定参数的 UNICODE 数据的java.io.Reader
对象length
- 流中的字节数- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
setDate
void setDate(String parameterName, Date x, Calendar cal) throws SQLException
- 使用给定的
Calendar
对象将指定参数设置为给定java.sql.Date
值。驱动程序使用Calendar
对象构造一个 SQLDATE
值,该值随后被驱动程序发送给数据库。利用Calendar
对象,驱动程序可以在考虑自定义时区的情况下计算日期。如果没有指定任何Calendar
对象,那么驱动程序将使用默认时区,该时区是运行应用程序的虚拟机所在的时区。 - 参数:
parameterName
- 参数名x
- 参数值cal
- 供驱动程序用来构造日期的Calendar
对象- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- getDate(int)
setTime
void setTime(String parameterName, Time x, Calendar cal) throws SQLException
- 使用给定的
Calendar
对象将指定参数设置为给定java.sql.Time
值。驱动程序使用Calendar
对象构造一个 SQLTIME
值,该值随后被驱动程序发送给数据库。利用Calendar
对象,驱动程序可以在考虑自定义时区的情况下计算时间。如果没有指定任何Calendar
对象,那么驱动程序将使用默认时区,该时区是运行应用程序的虚拟机所在的时区。 - 参数:
parameterName
- 参数名x
- 参数值cal
- 供驱动程序用来构造时间的Calendar
对象- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- getTime(int)
setTimestamp
void setTimestamp(String parameterName, Timestamp x, Calendar cal) throws SQLException
- 使用给定的
Calendar
对象将指定参数设置为给定java.sql.Timestamp
值。驱动程序使用Calendar
对象构造一个 SQLTIMESTAMP
值,该值随后被驱动程序发送给数据库。利用Calendar
对象,驱动程序可以在考虑自定义时区的情况下计算时间戳。如果没有指定任何Calendar
对象,那么驱动程序将使用默认时区,该时区是运行应用程序的虚拟机所在的时区。 - 参数:
parameterName
- 参数名x
- 参数值cal
- 供驱动程序用来构造时间戳的Calendar
对象- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- getTimestamp(int)
setNull
void setNull(String parameterName, int sqlType, String typeName) throws SQLException
- 将指定参数设置为 SQL
NULL
。这种形式的setNull
方法应该用于用户定义类型的参数或 REF 类型的参数。用户定义类型的示例有:STRUCT、DISTINCT、JAVA_OBJECT 和指定的数组类型。注:为了便于移植,在指定 NULL 用户定义参数或 REF 参数时,应用程序必须提供 SQL 类型代码和完全限定的 SQL 类型名称。对于用户定义的类型,该名称是参数本身的类型名称。对于 REF 参数,该名称是所引用类型的类型名称。
尽管此方法是供用户定义的参数和 Ref 参数使用的,但也可以将其用于设置任何 JDBC 类型的 null 参数。如果参数没有用户定义的类型或 REF 类型,则忽略 typeName。
- 参数:
parameterName
- 参数名sqlType
- 取自java.sql.Types
的一个值typeName
- SQL 用户定义类型的完全限定名;如果该参数不是用户定义的类型或 SQLREF
值,则忽略它- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
getString
String getString(String parameterName) throws SQLException
- 以 Java 编程语言中
String
的形式获取 JDBCCHAR
、VARCHAR
或LONGVARCHAR
参数的值。对于固定长度类型 JDBC
CHAR
,返回的String
对象与数据库拥有的 SQLCHAR
值完全相同,包括数据库添加的任何填充数据。 - 参数:
parameterName
- 参数名- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为null
。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- setString(java.lang.String, java.lang.String)
getBoolean
boolean getBoolean(String parameterName) throws SQLException
- 以 Java 编程语言中
boolean
值的形式获取 JDBCBIT
或BOOLEAN
参数的值。 - 参数:
parameterName
- 参数名- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为false
。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- setBoolean(java.lang.String, boolean)
getByte
byte getByte(String parameterName) throws SQLException
- 以 Java 编程语言中
byte
值的形式获取 JDBCTINYINT
参数的值。 - 参数:
parameterName
- 参数名- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为0
。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- setByte(java.lang.String, byte)
getShort
short getShort(String parameterName) throws SQLException
- 以 Java 编程语言中
short
值的形式获取 JDBCSMALLINT
参数的值。 - 参数:
parameterName
- 参数名- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为0
。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- setShort(java.lang.String, short)
getInt
int getInt(String parameterName) throws SQLException
- 以 Java 编程语言中
int
值的形式获取 JDBCINTEGER
参数的值。 - 参数:
parameterName
- 参数名- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为0
。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- setInt(java.lang.String, int)
getLong
long getLong(String parameterName) throws SQLException
- 以 Java 编程语言中
long
值的形式获取 JDBCBIGINT
参数的值。 - 参数:
parameterName
- 参数名- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为0
。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- setLong(java.lang.String, long)
getFloat
float getFloat(String parameterName) throws SQLException
- 以 Java 编程语言中
float
值的形式获取 JDBCFLOAT
参数的值。 - 参数:
parameterName
- 参数名- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为0
。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- setFloat(java.lang.String, float)
getDouble
double getDouble(String parameterName) throws SQLException
- 以 Java 编程语言中
double
值的形式获取 JDBCDOUBLE
参数的值。 - 参数:
parameterName
- 参数名- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为0
。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- setDouble(java.lang.String, double)
getBytes
byte[] getBytes(String parameterName) throws SQLException
- 以 Java 编程语言中
byte
数组值的形式获取 JDBCBINARY
或VARBINARY
参数的值。 - 参数:
parameterName
- 参数名- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为null
。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- setBytes(java.lang.String, byte[])
getDate
Date getDate(String parameterName) throws SQLException
- 以
java.sql.Date
对象的形式获取 JDBCDATE
参数的值。 - 参数:
parameterName
- 参数名- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为null
。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- setDate(java.lang.String, java.sql.Date)
getTime
Time getTime(String parameterName) throws SQLException
- 以
java.sql.Time
对象的形式获取 JDBCTIME
参数的值。 - 参数:
parameterName
- 参数名- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为null
。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- setTime(java.lang.String, java.sql.Time)
getTimestamp
Timestamp getTimestamp(String parameterName) throws SQLException
- 以
java.sql.Timestamp
对象的形式获取 JDBCTIMESTAMP
参数的值。 - 参数:
parameterName
- 参数名- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为null
。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- setTimestamp(java.lang.String, java.sql.Timestamp)
getObject
Object getObject(String parameterName) throws SQLException
- 以 Java 编程语言中
Object
的形式获取参数的值。如果值为 SQLNULL
,则驱动程序返回一个 Javanull
。此方法返回一个 Java 对象,其类型对应于使用
registerOutParameter
方法为此参数注册的 JDBC 类型。通过将目标 JDBC 类型注册为java.sql.Types.OTHER
,可以使用此方法来读取特定于数据库的抽象数据类型。 - 参数:
parameterName
- 参数名- 返回:
- 保存 OUT 参数值的
java.lang.Object
。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- Types, setObject(java.lang.String, java.lang.Object, int, int)
getBigDecimal
BigDecimal getBigDecimal(String parameterName) throws SQLException
- 以
java.math.BigDecimal
对象的形式获取 JDBCNUMERIC
参数的值,小数点右边的位数与该参数值所包含的位数相同。 - 参数:
parameterName
- 参数名- 返回:
- 全精度参数值。如果值为 SQL
NULL
,则结果为null
。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- setBigDecimal(java.lang.String, java.math.BigDecimal)
getObject
Object getObject(String parameterName, Map<String,Class<?>> map) throws SQLException
- 返回一个表示 OUT 参数
parameterName
值的对象,并将map
用于该参数值的自定义映射关系。此方法返回一个 Java 对象,其类型对应于使用
registerOutParameter
方法为此参数注册的 JDBC 类型。通过将目标 JDBC 类型注册为java.sql.Types.OTHER
,可以使用此方法来读取特定于数据库的抽象数据类型。 - 参数:
parameterName
- 参数名map
- SQL 类型名称到 Java 类的映射关系- 返回:
- 保存 OUT 参数值的
java.lang.Object
- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- setObject(java.lang.String, java.lang.Object, int, int)
getRef
Ref getRef(String parameterName) throws SQLException
- 以 Java 编程语言中 Ref 对象的形式获取 JDBC
REF(<structured-type>)
参数的值。 - 参数:
parameterName
- 参数名- 返回:
- Java 编程语言中
Ref
对象形式的参数值。如果值为 SQLNULL
,则返回null
值。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
getBlob
Blob getBlob(String parameterName) throws SQLException
- 以 Java 编程语言中 Blob 对象的形式获取 JDBC
BLOB
参数的值。 - 参数:
parameterName
- 参数名- 返回:
- Java 编程语言中
Blob
对象形式的参数值。如果值为 SQLNULL
,则返回null
值。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
getClob
Clob getClob(String parameterName) throws SQLException
- 以 Java 编程语言中
java.sql.CLOB
对象的形式获取 JDBCCLOB
参数的值。 - 参数:
parameterName
- 参数名- 返回:
- Java 编程语言中
Clob
对象形式的参数值。如果值为 SQLNULL
,则返回null
值。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
getArray
Array getArray(String parameterName) throws SQLException
- 以 Java 编程语言中
java.sql.ARRAY
对象的形式获取 JDBCARRAY
参数的值。 - 参数:
parameterName
- 参数名- 返回:
- Java 编程语言中
ARRAY
对象形式的参数值。如果值为 SQLNULL
,则返回null
值。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
getDate
Date getDate(String parameterName, Calendar cal) throws SQLException
- 以
java.sql.Date
对象的形式获取 JDBCDATE
参数的值,使用给定Calendar
对象构造日期。利用Calendar
对象,驱动程序可以在考虑自定义时区和语言环境的情况下计算日期。如果没有指定任何Calendar
对象,那么驱动程序将使用默认时区和语言环境。 - 参数:
parameterName
- 参数名cal
- 供驱动程序用来构造日期的Calendar
对象- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为null
。 - 抛出:
SQLException
- 如果 parameterName 并不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- setDate(java.lang.String, java.sql.Date)
getTime
Time getTime(String parameterName, Calendar cal) throws SQLException
- 以
java.sql.Time
对象的形式获取 JDBCTIME
参数的值,使用给定Calendar
对象构造时间。利用Calendar
对象,驱动程序可以在考虑自定义时区和语言环境的情况下计算时间。如果没有指定任何Calendar
对象,那么驱动程序将使用默认时区和语言环境。 - 参数:
parameterName
- 参数名cal
- 供驱动程序用来构造时间的Calendar
对象- 返回:
- 参数值;如果该值为 SQL
NULL
,则结果为null
。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- setTime(java.lang.String, java.sql.Time)
getTimestamp
Timestamp getTimestamp(String parameterName, Calendar cal) throws SQLException
- 以
java.sql.Timestamp
对象的形式获取 JDBCTIMESTAMP
参数的值,使用给定Calendar
对象构造Timestamp
对象。利用Calendar
对象,驱动程序可以在考虑自定义时区和语言环境的情况下计算时间戳。如果没有指定任何Calendar
对象,那么驱动程序将使用默认时区和语言环境。 - 参数:
parameterName
- 参数名cal
- 供驱动程序用来构造时间戳的Calendar
对象- 返回:
- 参数值。如果值为 SQL
NULL
,则结果为null
。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- setTimestamp(java.lang.String, java.sql.Timestamp)
getURL
URL getURL(String parameterName) throws SQLException
- 以
java.net.URL
对象的形式获取 JDBCDATALINK
参数的值。 - 参数:
parameterName
- 参数名- 返回:
- Java 编程语言中
java.net.URL
对象形式的参数值。如果值为 SQLNULL
,则返回null
值。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法,或者 URL 有问题SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.4
- 另请参见:
- setURL(java.lang.String, java.net.URL)
getRowId
RowId getRowId(int parameterIndex) throws SQLException
- 以
java.sql.RowId
对象的形式获取指定 JDBCROWID
参数的值。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,……- 返回:
- 表示被用作指定参数的 JDBC
ROWID
值的RowId
对象。如果该参数包含一个 SQLNULL
,则返回null
值。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
getRowId
RowId getRowId(String parameterName) throws SQLException
- 以
java.sql.RowId
对象的形式获取指定 JDBCROWID
参数的值。 - 参数:
parameterName
- 参数名- 返回:
- 表示被用作指定参数的 JDBC
ROWID
值的RowId
对象。如果该参数包含一个 SQLNULL
,则返回null
值。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
setRowId
void setRowId(String parameterName, RowId x) throws SQLException
- 将指定参数设置为给定
java.sql.RowId
对象。在将该对象发送到数据库时,驱动程序将它转换成一个 SQLROWID
。 - 参数:
parameterName
- 参数名x
- 参数值- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
setNString
void setNString(String parameterName, String value) throws SQLException
- 将指定参数设置为给定
String
对象。驱动程序将此对象转换成一个 SQLNCHAR
、NVARCHAR
或LONGNVARCHAR
。 - 参数:
parameterName
- 要设置的参数的名称value
- 参数值- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果驱动程序不支持国家字符 (national character) 集;如果驱动程序检测到可能发生数据转换错误;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
setNCharacterStream
void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException
- 将指定参数设置为
Reader
对象。Reader
将读取数据,直到到达文件末尾。驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。 - 参数:
parameterName
- 要设置的参数名参数值
-length
- 该参数数据中的字符数。- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
setNClob
void setNClob(String parameterName, NClob value) throws SQLException
- 将指定参数设置为
java.sql.NClob
对象。该对象实现java.sql.NClob
接口。此NClob
对象映射到 SQLNCLOB
。 - 参数:
parameterName
- 要设置的参数名value
- 参数值- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
setClob
void setClob(String parameterName, Reader reader, long length) throws SQLException
- 将指定参数设置为
Reader
对象。reader
必须包含 length 指定的字符数,否则在执行CallableStatement
时将生成一个SQLException
。此方法不同于setCharacterStream (int, Reader, int)
方法,因为它会通知驱动程序应该将参数值作为CLOB
发送给服务器。在使用setCharacterStream
方法时,驱动程序可能必须做一些额外的工作,以确定应该将参数数据作为LONGVARCHAR
还是CLOB
发送给服务器 - 参数:
parameterName
- 要设置的参数名reader
- 包含用来设置参数值的数据的对象。length
- 参数数据中的字符数。- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果指定的 length 小于 0;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
setBlob
void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException
- 将指定参数设置为
InputStream
对象。inputstream
必须包含 length 指定的字符数,否则在执行CallableStatement
时将生成一个SQLException
。此方法不同于setBinaryStream (int, InputStream, int)
方法,因为它会通知驱动程序应该将参数值作为BLOB
发送给服务器。在使用setBinaryStream
方法时,驱动程序可能必须做一些额外的工作,以确定应该将参数数据作为LONGVARBINARY
还是BLOB
发送给服务器 - 参数:
parameterName
- 要设置的参数名inputStream
- 包含用来设置参数值的数据的对象。length
- 参数数据中的字节数。- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果指定的 length 小于 0;如果输入流中的字节数与指定 length 不匹配;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
setNClob
void setNClob(String parameterName, Reader reader, long length) throws SQLException
- 将指定参数设置为
Reader
对象。reader
必须包含 length 指定的字符数,否则在执行CallableStatement
时将生成一个SQLException
。此方法不同于setCharacterStream (int, Reader, int)
方法,因为它会通知驱动程序应该将参数值作为NCLOB
发送给服务器。在使用setCharacterStream
方法时,驱动程序可能必须做一些额外的工作,以确定应该将参数数据作为LONGNVARCHAR
还是NCLOB
发送给服务器 - 参数:
parameterName
- 要设置的参数名reader
- 包含用于设置参数值的数据的对象。length
- 参数数据中的字符数。- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果指定 length 小于 0;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
getNClob
NClob getNClob(int parameterIndex) throws SQLException
- 以 Java 编程语言中
java.sql.NClob
对象的形式获取指定的 JDBCNCLOB
参数的值。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,依此类推- 返回:
- Java 编程语言中
NClob
对象形式的参数值。如果值为 SQLNULL
,则返回null
值。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
getNClob
NClob getNClob(String parameterName) throws SQLException
- 以 Java 编程语言中
java.sql.NClob
对象的形式获取 JDBCNCLOB
参数的值。 - 参数:
parameterName
- 参数名- 返回:
- Java 编程语言中
NClob
对象形式的参数值。如果值为 SQLNULL
,则返回null
值。 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
setSQLXML
void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException
- 将指定参数设置为给定
java.sql.SQLXML
对象。在将该对象发送到数据库时,驱动程序将它转换成一个SQL XML
值。 - 参数:
parameterName
- 参数名xmlObject
- 映射SQL XML
值的SQLXML
对象- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误;在关闭的CallableStatement
上调用此方法,或者java.xml.transform.Result
、Writer
或OutputStream
没有关闭(对于SQLXML
对象而言)SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
getSQLXML
SQLXML getSQLXML(int parameterIndex) throws SQLException
- 以 Java 编程语言中
java.sql.SQLXML
对象的形式获取指定的SQL XML
参数的值。 - 参数:
parameterIndex
- 第一个参数的索引是 1,第二个参数的索引是 2,……- 返回:
- 映射
SQL XML
值的SQLXML
对象 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
getSQLXML
SQLXML getSQLXML(String parameterName) throws SQLException
- 以 Java 编程语言中
java.sql.SQLXML
对象的形式获取指定的SQL XML
参数的值。 - 参数:
parameterName
- 参数名- 返回:
- 映射
SQL XML
值的SQLXML
对象 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
getNString
String getNString(int parameterIndex) throws SQLException
- 以 Java 编程语言中
String
的形式获取指定的NCHAR
、NVARCHAR
或LONGNVARCHAR
参数的值。对于固定长度类型 JDBC
NCHAR
,返回的String
对象与数据库拥有的 SQLNCHAR
值完全相同,包括数据库添加的任何填充数据。 - 参数:
parameterIndex
- 第一个参数的索引是 1,第二个参数的索引是 2,……- 返回:
- 映射
NCHAR
、NVARCHAR
或LONGNVARCHAR
值的String
对象 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
- 另请参见:
- setNString(java.lang.String, java.lang.String)
getNString
String getNString(String parameterName) throws SQLException
- 以 Java 编程语言中
String
的形式获取指定的NCHAR
、NVARCHAR
或LONGNVARCHAR
参数的值。对于固定长度类型 JDBC
NCHAR
,返回的String
对象与数据库中所拥有的 SQLNCHAR
值完全相同,包括数据库添加的任何填充数据。 - 参数:
parameterName
- 参数名- 返回:
- 映射
NCHAR
、NVARCHAR
或LONGNVARCHAR
值的String
对象 - 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
- 另请参见:
- setNString(java.lang.String, java.lang.String)
getNCharacterStream
Reader getNCharacterStream(int parameterIndex) throws SQLException
- 以 Java 编程语言中
java.io.Reader
对象的形式获取指定参数的值。此方法用于访问NCHAR
、NVARCHAR
和LONGNVARCHAR
参数时。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,……- 返回:
- 包含参数值的
java.io.Reader
对象;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
getNCharacterStream
Reader getNCharacterStream(String parameterName) throws SQLException
- 以 Java 编程语言中
java.io.Reader
对象的形式获取指定参数的值。此方法用于访问NCHAR
、NVARCHAR
和LONGNVARCHAR
参数时。 - 参数:
parameterName
- 参数名- 返回:
- 包含参数值的
java.io.Reader
对象;如果该值为 SQLNULL
,则返回值是 Java 编程语言中的null
- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
getCharacterStream
Reader getCharacterStream(int parameterIndex) throws SQLException
- 以 Java 编程语言中
java.io.Reader
对象的形式获取指定参数的值。 - 参数:
parameterIndex
- 第一个参数是 1,第二个参数是 2,……- 返回:
- 包含参数值的
java.io.Reader
对象;如果值为 SQLNULL
,则返回值为 Java 编程语言中的null
。 - 抛出:
SQLException
- 如果 parameterIndex 无效;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法- 从以下版本开始:
- 1.6
getCharacterStream
Reader getCharacterStream(String parameterName) throws SQLException
- 以 Java 编程语言中
java.io.Reader
对象的形式获取指定参数的值。 - 参数:
parameterName
- 参数名- 返回:
- 包含参数值的
java.io.Reader
对象;如果该值为 SQLNULL
,则返回值是 Java 编程语言中的null
- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
setBlob
void setBlob(String parameterName, Blob x) throws SQLException
- 将指定参数设置为给定的
java.sql.Blob
对象。在将该对象发送到数据库时,驱动程序将它转换成一个 SQLBLOB
值。 - 参数:
parameterName
- 参数名x
- 映射 SQLBLOB
值的Blob
对象- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
setClob
void setClob(String parameterName, Clob x) throws SQLException
- 将指定参数设置为给定的
java.sql.Clob
对象。在将该对象发送到数据库时,驱动程序将它转换成一个 SQLCLOB
值。 - 参数:
parameterName
- 参数名x
- 映射 SQLCLOB
值的Clob
对象- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
setAsciiStream
void setAsciiStream(String parameterName, InputStream x, long length) throws SQLException
- 将指定参数设置为给定输入流,该输入流将拥有指定的字节数。在将一个非常大的 ASCII 值输入到
LONGVARCHAR
参数时,通过java.io.InputStream
发送它可能更为实际。将根据需要从流中读取数据,一直读取到文件末尾。驱动程序将执行从 ASCII 到数据库 char 格式的任何必要转换。注:此流对象既可以是一个标准 Java 流对象,也可以是实现标准接口的用户自己的子类。
- 参数:
parameterName
- 参数名x
- 包含 ASCII 参数值的 Java 输入流length
- 流中的字节数- 抛出:
SQLException
- 如果 parameterName 不对应于给定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
setBinaryStream
void setBinaryStream(String parameterName, InputStream x, long length) throws SQLException
- 将指定参数设置为给定输入流,该输入流将拥有指定字节数。在将一个非常大的二进制值输入到
LONGVARBINARY
参数时,通过java.io.InputStream
对象发送它可能更为实际。将根据需要从流中读取数据,一直读取到文件末尾。注:此流对象既可以是一个标准 Java 流对象,也可以是实现标准接口的用户自己的子类。
- 参数:
parameterName
- 参数名x
- 包含二进制参数值的 java 输入流length
- 流中的字节数- 抛出:
SQLException
- 如果 parameterName 不对应于给定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
setCharacterStream
void setCharacterStream(String parameterName, Reader reader, long length) throws SQLException
- 将指定参数设置为给定
Reader
对象,该对象具有给定字符数长度。在将一个非常大的 UNICODE 值输入给LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更为实际。将根据需要从流中读取数据,一直读取到文件末尾。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。注:此流对象既可以是一个标准 Java 流对象,也可以是实现标准接口的用户自己的子类。
- 参数:
parameterName
- 参数名reader
- 包含用作指定参数的 UNICODE 数据的java.io.Reader
对象length
- 流中的字节数- 抛出:
SQLException
- 如果 parameterName 不对应于给定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
setAsciiStream
void setAsciiStream(String parameterName, InputStream x) throws SQLException
- 将指定参数设置为给定输入流。在将一个非常大的 ASCII 值输入到
LONGVARCHAR
参数时,通过java.io.InputStream
发送它可能更为实际。将根据需要从流中读取数据,一直读取到文件末尾。JDBC 驱动程序将执行从 ASCII 到数据库 char 格式的任何必要转换。注:此流对象既可以是一个标准 Java 流对象,也可以是实现标准接口的用户自己的子类。
注:查询 JDBC 驱动程序文档,以确定使用带 length 参数的
setAsciiStream
是否更有效。 - 参数:
parameterName
- 参数名x
- 包含 ASCII 参数值的 Java 输入流x
- 参数值- 抛出:
SQLException
- 如果 parameterName 不对应于给定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
setBinaryStream
void setBinaryStream(String parameterName, InputStream x) throws SQLException
- 将指定参数设置为给定输入流。在将一个非常大的二进制值输入到
LONGVARBINARY
参数时,通过java.io.InputStream
对象发送它可能更为实际。将根据需要从流中读取数据,一直读取到文件末尾。注:此流对象既可以是一个标准 Java 流对象,也可以是实现标准接口的用户自己的子类。
注:查询 JDBC 驱动程序文档,以确定使用带 length 参数的
setBinaryStream
是否更有效。 - 参数:
parameterName
- 参数名x
- 包含二进制参数值的 java 输入流- 抛出:
SQLException
- 如果 parameterName 不对应于给定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
setCharacterStream
void setCharacterStream(String parameterName, Reader reader) throws SQLException
- 将指定参数设置为给定
Reader
对象。在将一个非常大的 UNICODE 值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更为实际。将根据需要从流中读取数据,一直读取到文件末尾。JDBC 驱动程序将执行从 UNICODE 到数据库 char 格式的任何必要转换。注:此流对象既可以是一个标准 Java 流对象,也可以是实现标准接口的用户自己的子类。
注:查询 JDBC 驱动程序文档,以确定使用带 length 参数的
setCharacterStream
是否更有效。 - 参数:
parameterName
- 参数名reader
- 包含 Unicode 数据的java.io.Reader
对象- 抛出:
SQLException
- 如果 parameterName 不对应于给定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
setNCharacterStream
void setNCharacterStream(String parameterName, Reader value) throws SQLException
- 将指定参数设置为
Reader
对象。Reader
将读取数据,直到到达文件末尾。驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。注:此流对象既可以是一个标准 Java 流对象,也可以是实现标准接口的用户自己的子类。
注:查询 JDBC 驱动程序文档,以确定使用带 length 参数的
setNCharacterStream
是否更有效。 - 参数:
parameterName
- 要设置的参数名value
- 参数值- 抛出:
SQLException
- 如果 parameterName 不对应于给定参数;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
setClob
void setClob(String parameterName, Reader reader) throws SQLException
- 将指定参数设置为
Reader
对象。此方法不同于setCharacterStream (int, Reader)
方法,因为它会通知驱动程序应该将参数值作为CLOB
发送给服务器。在使用setCharacterStream
方法时,驱动程序可能必须做一些额外的工作,以确定应该将参数数据作为LONGVARCHAR
还是CLOB
发送给服务器。注:查询 JDBC 驱动程序文档,以确定使用带 length 参数的
setClob
是否更有效。 - 参数:
parameterName
- 参数名reader
- 包含用来设置参数值的数据的对象。- 抛出:
SQLException
- 如果 parameterName 不对应于指定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
setBlob
void setBlob(String parameterName, InputStream inputStream) throws SQLException
- 将指定参数设置为
InputStream
对象。此方法不同于setBinaryStream (int, InputStream)
方法,因为它会通知驱动程序应该将参数值作为BLOB
发送给服务器。在使用setBinaryStream
方法时,驱动程序可能必须做一些额外的工作,以确定应该将参数数据作为LONGVARBINARY
还是BLOB
发送给服务器。注:查询 JDBC 驱动程序文档,以确定使用带 length 参数的
setBlob
是否更有效。 - 参数:
parameterName
- 参数名inputStream
- 包含用来设置参数值的数据的对象。- 抛出:
SQLException
- 如果 parameterName 不对应于给定参数;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
setNClob
void setNClob(String parameterName, Reader reader) throws SQLException
- 将指定参数设置为
Reader
对象。此方法不同于setCharacterStream (int, Reader)
方法,因为它会通知驱动程序应该将参数值作为NCLOB
发送给服务器。在使用setCharacterStream
方法时,驱动程序可能必须做一些额外的工作,以确定应该将参数数据作为LONGNVARCHAR
还是NCLOB
发送给服务器。注:查询 JDBC 驱动程序文档,以确定使用带 length 参数的
setNClob
是否更有效。 - 参数:
parameterName
- 参数名reader
- 包含用来设置参数值的数据的对象。- 抛出:
SQLException
- 如果 parameterName 不对应于给定参数;如果驱动程序不支持国家字符集;如果驱动程序检测到可能发生数据转换错误;如果发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法- 从以下版本开始:
- 1.6
- 32、浅谈CallableStatement可调用语句!
- JDBC系列教程(六)---可调用语句
- sql学用语句
- sql中常用语句
- SCREEN中常用语句
- Oracle 便用语句
- 工作中常用语句
- js中常用语句
- Oracle中常用语句
- mysql不常用语句
- JavaScript中常用语句
- 31、CallableStatement.execute()浅谈
- 英语日常用语100句
- 英语日常用语百句
- 日语常用语3000句
- 商务午餐中常用语句
- 存储过程中常用语句
- 日语日常用语100句
- java中怎么才能替换Map集合中的健和值,只能有一个健和值
- 单例模式
- 写一个程序接收从键盘输入学生的信息,输入格式为:name,30,30,30(姓名,三门课成绩)
- c#将datagridview信息导入excel
- 蓝牙相关
- 32、浅谈CallableStatement可调用语句!
- top命令
- 图片模糊处理
- 《Hadoop基础教程》之初识Hadoop
- 微信开发准备(二)——springmvc+mybatis项目结构的搭建
- 欢迎使用CSDN-markdown编辑器
- leetcode 224. Basic Calculator
- tomcat7 参数优化
- 一些细节错误