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
字段摘要 |
---|
从接口 java.sql.Statement 继承的字段 |
---|
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 。 |
从接口 java.sql.PreparedStatement 继承的方法 |
---|
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 |
从接口 java.sql.Statement 继承的方法 |
---|
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 |
从接口 java.sql.Wrapper 继承的方法 |
---|
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
上调用此方法
-
如果最后一个读取的参数为 SQL
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 平台上是一个无效 URL -
SQLFeatureNotSupportedException
- 如果 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
-