- 所有父级接口:
AutoCloseable,PreparedStatement,Statement,Wrapper
{?= call <procedure-name>[(<arg1>,<arg2>, ...)]}
{call <procedure-name>[(<arg1>,<arg2>, ...)]}
使用从 PreparedStatement 继承的 set 方法设置 IN 参数值。所有 OUT 参数的类型必须在执行存储过程之前注册;它们的值在执行后通过此处提供的 get 方法检索。
CallableStatement 可以返回一个 ResultSet 对象或多个 ResultSet 对象。使用从 Statement 继承的操作处理多个 ResultSet 对象。
为了获得最大的可移植性,应在获取输出参数值之前处理调用的ResultSet 对象和更新计数。
- 自从:
- 1.1
- 参见:
-
字段摘要
-
方法总结
修饰符和类型方法描述getArray(int parameterIndex) 检索指定 JDBCARRAY参数的值作为 Java 编程语言中的Array对象。检索 JDBCARRAY参数的值作为 Java 编程语言中的Array对象。getBigDecimal(int parameterIndex) 检索指定 JDBCNUMERIC参数的值作为java.math.BigDecimal对象,小数点右侧的位数与该值包含的位数一样多。getBigDecimal(int parameterIndex, int scale) 已弃用。getBigDecimal(String parameterName) 检索 JDBCNUMERIC参数的值作为java.math.BigDecimal对象,小数点右侧的位数与该值包含的位数一样多。getBlob(int parameterIndex) 检索指定 JDBCBLOB参数的值作为 Java 编程语言中的Blob对象。检索 JDBCBLOB参数的值作为 Java 编程语言中的Blob对象。booleangetBoolean(int parameterIndex) 检索指定 JDBCBIT或BOOLEAN参数的值作为 Java 编程语言中的boolean。booleangetBoolean(String parameterName) 检索 JDBCBIT或BOOLEAN参数的值作为 Java 编程语言中的boolean。bytegetByte(int parameterIndex) 检索指定 JDBCTINYINT参数的值作为 Java 编程语言中的byte。byte检索 JDBCTINYINT参数的值作为 Java 编程语言中的byte。byte[]getBytes(int parameterIndex) 检索指定 JDBCBINARY或VARBINARY参数的值作为 Java 编程语言中byte值的数组。byte[]检索 JDBCBINARY或VARBINARY参数的值作为 Java 编程语言中byte值的数组。getCharacterStream(int parameterIndex) 检索指定参数的值作为 Java 编程语言中的java.io.Reader对象。getCharacterStream(String parameterName) 检索指定参数的值作为 Java 编程语言中的java.io.Reader对象。getClob(int parameterIndex) 检索指定 JDBCCLOB参数的值作为 Java 编程语言中的java.sql.Clob对象。检索 JDBCCLOB参数的值作为 Java 编程语言中的java.sql.Clob对象。getDate(int parameterIndex) 检索指定 JDBCDATE参数的值作为java.sql.Date对象。检索指定 JDBCDATE参数的值作为java.sql.Date对象,使用给定的Calendar对象构造日期。检索 JDBCDATE参数的值作为java.sql.Date对象。检索 JDBCDATE参数的值作为java.sql.Date对象,使用给定的Calendar对象构造日期。doublegetDouble(int parameterIndex) 检索指定 JDBCDOUBLE参数的值作为 Java 编程语言中的double。double检索 JDBCDOUBLE参数的值作为 Java 编程语言中的double。floatgetFloat(int parameterIndex) 检索指定 JDBCFLOAT参数的值作为 Java 编程语言中的float。float检索 JDBCFLOAT参数的值作为 Java 编程语言中的float。intgetInt(int parameterIndex) 检索指定 JDBCINTEGER参数的值作为 Java 编程语言中的int。int检索 JDBCINTEGER参数的值作为 Java 编程语言中的int。longgetLong(int parameterIndex) 检索指定 JDBCBIGINT参数的值作为 Java 编程语言中的long。long检索 JDBCBIGINT参数的值作为 Java 编程语言中的long。getNCharacterStream(int parameterIndex) 检索指定参数的值作为 Java 编程语言中的java.io.Reader对象。getNCharacterStream(String parameterName) 检索指定参数的值作为 Java 编程语言中的java.io.Reader对象。getNClob(int parameterIndex) 检索指定 JDBCNCLOB参数的值作为 Java 编程语言中的java.sql.NClob对象。检索 JDBCNCLOB参数的值作为 Java 编程语言中的java.sql.NClob对象。getNString(int parameterIndex) 检索指定NCHAR、NVARCHAR或LONGNVARCHAR参数的值作为 Java 编程语言中的String。getNString(String parameterName) 检索指定NCHAR、NVARCHAR或LONGNVARCHAR参数的值作为 Java 编程语言中的String。getObject(int parameterIndex) 检索指定参数的值作为 Java 编程语言中的Object。<T> T返回表示 OUT 参数parameterIndex值的对象,如果支持转换,将从参数的 SQL 类型转换为请求的 Java 数据类型。返回表示 OUT 参数parameterIndex值的对象,并将map用于参数值的自定义映射。检索参数值作为 Java 编程语言中的Object。<T> T返回表示 OUT 参数parameterName值的对象,并将从参数的 SQL 类型转换为请求的 Java 数据类型(如果支持转换)。返回表示 OUT 参数值的对象parameterName并使用map进行参数值的自定义映射。getRef(int parameterIndex) 检索指定 JDBCREF(<structured-type>)参数的值作为 Java 编程语言中的Ref对象。检索 JDBCREF(<structured-type>)参数的值作为 Java 编程语言中的Ref对象。getRowId(int parameterIndex) 检索指定 JDBCROWID参数的值作为java.sql.RowId对象。检索指定 JDBCROWID参数的值作为java.sql.RowId对象。shortgetShort(int parameterIndex) 检索指定 JDBCSMALLINT参数的值作为 Java 编程语言中的short。short检索 JDBCSMALLINT参数的值作为 Java 编程语言中的short。getSQLXML(int parameterIndex) 检索指定SQL XML参数的值作为 Java 编程语言中的java.sql.SQLXML对象。检索指定SQL XML参数的值作为 Java 编程语言中的java.sql.SQLXML对象。getString(int parameterIndex) 检索指定 JDBCCHAR、VARCHAR或LONGVARCHAR参数的值作为 Java 编程语言中的String。检索 JDBCCHAR、VARCHAR或LONGVARCHAR参数的值作为 Java 编程语言中的String。getTime(int parameterIndex) 检索指定 JDBCTIME参数的值作为java.sql.Time对象。检索指定 JDBCTIME参数的值作为java.sql.Time对象,使用给定的Calendar对象构造时间。检索 JDBCTIME参数的值作为java.sql.Time对象。检索 JDBCTIME参数的值作为java.sql.Time对象,使用给定的Calendar对象构造时间。getTimestamp(int parameterIndex) 检索指定 JDBCTIMESTAMP参数的值作为java.sql.Timestamp对象。getTimestamp(int parameterIndex, Calendar cal) 检索指定 JDBCTIMESTAMP参数的值作为java.sql.Timestamp对象,使用给定的Calendar对象构造Timestamp对象。getTimestamp(String parameterName) 检索 JDBCTIMESTAMP参数的值作为java.sql.Timestamp对象。getTimestamp(String parameterName, Calendar cal) 检索 JDBCTIMESTAMP参数的值作为java.sql.Timestamp对象,使用给定的Calendar对象构造Timestamp对象。getURL(int parameterIndex) 检索指定 JDBCDATALINK参数的值作为java.net.URL对象。检索 JDBCDATALINK参数的值作为java.net.URL对象。voidregisterOutParameter(int parameterIndex, int sqlType) 将序号位置parameterIndex中的 OUT 参数注册到 JDBC 类型sqlType。voidregisterOutParameter(int parameterIndex, int sqlType, int scale) 将序号位置parameterIndex的参数注册为 JDBC 类型sqlType。voidregisterOutParameter(int parameterIndex, int sqlType, String typeName) 注册指定的输出参数。default voidregisterOutParameter(int parameterIndex, SQLType sqlType) 将序号位置parameterIndex中的 OUT 参数注册到 JDBC 类型sqlType。default voidregisterOutParameter(int parameterIndex, SQLType sqlType, int scale) 将序号位置parameterIndex的参数注册为 JDBC 类型sqlType。default voidregisterOutParameter(int parameterIndex, SQLType sqlType, String typeName) 注册指定的输出参数。voidregisterOutParameter(String parameterName, int sqlType) 将名为parameterName的 OUT 参数注册到 JDBC 类型sqlType。voidregisterOutParameter(String parameterName, int sqlType, int scale) 将名为parameterName的参数注册为 JDBC 类型sqlType。voidregisterOutParameter(String parameterName, int sqlType, String typeName) 注册指定的输出参数。default voidregisterOutParameter(String parameterName, SQLType sqlType) 将名为parameterName的 OUT 参数注册到 JDBC 类型sqlType。default voidregisterOutParameter(String parameterName, SQLType sqlType, int scale) 将名为parameterName的参数注册为 JDBC 类型sqlType。default voidregisterOutParameter(String parameterName, SQLType sqlType, String typeName) 注册指定的输出参数。voidsetAsciiStream(String parameterName, InputStream x) 将指定参数设置为给定的输入流。voidsetAsciiStream(String parameterName, InputStream x, int length) 将指定参数设置为给定的输入流,它将具有指定的字节数。voidsetAsciiStream(String parameterName, InputStream x, long length) 将指定参数设置为给定的输入流,它将具有指定的字节数。voidsetBigDecimal(String parameterName, BigDecimal x) 将指定参数设置为给定的java.math.BigDecimal值。voidsetBinaryStream(String parameterName, InputStream x) 将指定参数设置为给定的输入流。voidsetBinaryStream(String parameterName, InputStream x, int length) 将指定参数设置为给定的输入流,它将具有指定的字节数。voidsetBinaryStream(String parameterName, InputStream x, long length) 将指定参数设置为给定的输入流,它将具有指定的字节数。voidsetBlob(String parameterName, InputStream inputStream) 将指定参数设置为InputStream对象。voidsetBlob(String parameterName, InputStream inputStream, long length) 将指定参数设置为InputStream对象。void将指定参数设置为给定的java.sql.Blob对象。voidsetBoolean(String parameterName, boolean x) 将指定参数设置为给定的 Javaboolean值。void将指定参数设置为给定的 Javabyte值。void将指定参数设置为给定的 Java 字节数组。voidsetCharacterStream(String parameterName, Reader reader) 将指定参数设置为给定的Reader对象。voidsetCharacterStream(String parameterName, Reader reader, int length) 将指定参数设置为给定的Reader对象,它是给定的字符长度。voidsetCharacterStream(String parameterName, Reader reader, long length) 将指定参数设置为给定的Reader对象,它是给定的字符长度。void将指定参数设置为Reader对象。void将指定参数设置为Reader对象。void将指定参数设置为给定的java.sql.Clob对象。void使用运行应用程序的虚拟机的默认时区将指定参数设置为给定的java.sql.Date值。void使用给定的Calendar对象将指定参数设置为给定的java.sql.Date值。void将指定参数设置为给定的 Javadouble值。void将指定参数设置为给定的 Javafloat值。void将指定参数设置为给定的 Javaint值。void将指定参数设置为给定的 Javalong值。voidsetNCharacterStream(String parameterName, Reader value) 将指定参数设置为Reader对象。voidsetNCharacterStream(String parameterName, Reader value, long length) 将指定参数设置为Reader对象。void将指定参数设置为Reader对象。void将指定参数设置为Reader对象。void将指定参数设置为java.sql.NClob对象。voidsetNString(String parameterName, String value) 将指定参数设置为给定的String对象。void将指定参数设置为 SQLNULL。void将指定参数设置为 SQLNULL。void使用给定对象设置指定参数的值。void使用给定对象设置指定参数的值。void使用给定对象设置指定参数的值。default void使用给定对象设置指定参数的值。default void使用给定对象设置指定参数的值。void将指定参数设置为给定的java.sql.RowId对象。void将指定参数设置为给定的 Javashort值。void将指定参数设置为给定的java.sql.SQLXML对象。void将指定参数设置为给定的 JavaString值。void将指定参数设置为给定的java.sql.Time值。void使用给定的Calendar对象将指定参数设置为给定的java.sql.Time值。voidsetTimestamp(String parameterName, Timestamp x) 将指定参数设置为给定的java.sql.Timestamp值。voidsetTimestamp(String parameterName, Timestamp x, Calendar cal) 使用给定的Calendar对象将指定参数设置为给定的java.sql.Timestamp值。void将指定参数设置为给定的java.net.URL对象。booleanwasNull()检索读取的最后一个 OUT 参数是否具有 SQLNULL的值。在接口 java.sql.PreparedStatement 中声明的方法
addBatch, clearParameters, execute, executeLargeUpdate, 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, setObject, setObject, setRef, setRowId, setShort, setSQLXML, setString, setTime, setTime, setTimestamp, setTimestamp, setUnicodeStream, setURL在接口 java.sql.Statement 中声明的方法
addBatch, cancel, clearBatch, clearWarnings, close, closeOnCompletion, enquoteIdentifier, enquoteLiteral, enquoteNCharLiteral, execute, execute, execute, execute, executeBatch, executeLargeBatch, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeQuery, executeUpdate, executeUpdate, executeUpdate, executeUpdate, getConnection, getFetchDirection, getFetchSize, getGeneratedKeys, getLargeMaxRows, getLargeUpdateCount, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSet, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getUpdateCount, getWarnings, isClosed, isCloseOnCompletion, isPoolable, isSimpleIdentifier, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setLargeMaxRows, setMaxFieldSize, setMaxRows, setPoolable, setQueryTimeout在接口 java.sql.Wrapper 中声明的方法
isWrapperFor, unwrap
-
方法详情
-
registerOutParameter
将序号位置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- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果sqlType是ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR,REF,ROWID,SQLXML或STRUCT数据类型并且 JDBC 驱动程序不支持此数据类型- 参见:
-
registerOutParameter
将序号位置parameterIndex的参数注册为 JDBC 类型sqlType。在执行存储过程之前,必须注册所有 OUT 参数。sqlType为 OUT 参数指定的 JDBC 类型决定了get方法中必须使用的 Java 类型来读取该参数的值。当参数为 JDBC 类型
NUMERIC或DECIMAL时,应使用此版本的registerOutParameter。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推sqlType-java.sql.Types定义的 SQL 类型代码。scale- 小数点右侧所需的位数。它必须大于或等于零。- 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果sqlType是ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR,REF,ROWID,SQLXML或STRUCT数据类型并且 JDBC 驱动程序不支持此数据类型- 参见:
-
wasNull
检索读取的最后一个 OUT 参数是否具有 SQLNULL的值。请注意,此方法应仅在调用 getter 方法后调用;否则,在确定它是否为null时没有任何值。- 返回:
true如果最后读取的参数是 SQLNULL;false否则- 抛出:
SQLException- 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法
-
getString
检索指定 JDBCCHAR、VARCHAR或LONGVARCHAR参数的值作为 Java 编程语言中的String。对于固定长度类型的 JDBC
CHAR,返回的String对象与数据库中的 SQLCHAR值具有完全相同的值,包括数据库添加的任何填充。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推- 返回:
-
参数值。如果值为 SQL
NULL,则结果为null。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法- 参见:
-
getBoolean
检索指定 JDBCBIT或BOOLEAN参数的值作为 Java 编程语言中的boolean。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推- 返回:
-
参数值。如果值为 SQL
NULL,则结果为false。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法- 参见:
-
getByte
检索指定 JDBCTINYINT参数的值作为 Java 编程语言中的byte。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推- 返回:
-
参数值。如果值为 SQL
NULL,则结果为0。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法- 参见:
-
getShort
检索指定 JDBCSMALLINT参数的值作为 Java 编程语言中的short。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推- 返回:
-
参数值。如果值为 SQL
NULL,则结果为0。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法- 参见:
-
getInt
检索指定 JDBCINTEGER参数的值作为 Java 编程语言中的int。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推- 返回:
-
参数值。如果值为 SQL
NULL,则结果为0。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法- 参见:
-
getLong
检索指定 JDBCBIGINT参数的值作为 Java 编程语言中的long。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推- 返回:
-
参数值。如果值为 SQL
NULL,则结果为0。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法- 参见:
-
getFloat
检索指定 JDBCFLOAT参数的值作为 Java 编程语言中的float。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推- 返回:
-
参数值。如果值为 SQL
NULL,则结果为0。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法- 参见:
-
getDouble
检索指定 JDBCDOUBLE参数的值作为 Java 编程语言中的double。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推- 返回:
-
参数值。如果值为 SQL
NULL,则结果为0。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法- 参见:
-
getBigDecimal
已弃用。使用getBigDecimal(int parameterIndex)或getBigDecimal(String parameterName)检索指定 JDBCNUMERIC参数的值作为java.math.BigDecimal对象scale小数点右边的数字。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推scale- 小数点右边的位数- 返回:
-
参数值。如果值为 SQL
NULL,则结果为null。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 参见:
-
getBytes
检索指定 JDBCBINARY或VARBINARY参数的值作为 Java 编程语言中byte值的数组。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推- 返回:
-
参数值。如果值为 SQL
NULL,则结果为null。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法- 参见:
-
getDate
检索指定 JDBCDATE参数的值作为java.sql.Date对象。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推- 返回:
-
参数值。如果值为 SQL
NULL,则结果为null。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法- 参见:
-
getTime
检索指定 JDBCTIME参数的值作为java.sql.Time对象。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推- 返回:
-
参数值。如果值为 SQL
NULL,则结果为null。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法- 参见:
-
getTimestamp
检索指定 JDBCTIMESTAMP参数的值作为java.sql.Timestamp对象。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推- 返回:
-
参数值。如果值为 SQL
NULL,则结果为null。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法- 参见:
-
getObject
检索指定参数的值作为 Java 编程语言中的Object。如果该值为 SQLNULL,则驱动程序返回 Javanull。此方法返回一个 Java 对象,其类型对应于使用方法
registerOutParameter为该参数注册的 JDBC 类型。通过将目标 JDBC 类型注册为java.sql.Types.OTHER,此方法可用于读取特定于数据库的抽象数据类型。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推- 返回:
-
A
java.lang.Object保存 OUT 参数值 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法- 参见:
-
getBigDecimal
检索指定 JDBCNUMERIC参数的值作为java.math.BigDecimal对象,小数点右侧的位数与该值包含的位数一样多。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推- 返回:
-
全精度的参数值。如果值为 SQL
NULL,则结果为null。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法- 自从:
- 1.2
- 参见:
-
getObject
返回表示 OUT 参数parameterIndex值的对象,并将map用于参数值的自定义映射。此方法返回一个 Java 对象,其类型对应于使用方法
registerOutParameter为该参数注册的 JDBC 类型。通过将目标 JDBC 类型注册为java.sql.Types.OTHER,此方法可用于读取特定于数据库的抽象数据类型。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推map- 从 SQL 类型名称到 Java 类的映射- 返回:
java.lang.Object保存 OUT 参数值- 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
- 参见:
-
getRef
检索指定 JDBCREF(<structured-type>)参数的值作为 Java 编程语言中的Ref对象。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推- 返回:
-
参数值作为 Java 编程语言中的
Ref对象。如果值为 SQLNULL,则返回值null。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
getBlob
检索指定 JDBCBLOB参数的值作为 Java 编程语言中的Blob对象。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推- 返回:
-
参数值作为 Java 编程语言中的
Blob对象。如果值为 SQLNULL,则返回值null。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
getClob
检索指定 JDBCCLOB参数的值作为 Java 编程语言中的java.sql.Clob对象。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推- 返回:
-
参数值作为 Java 编程语言中的
Clob对象。如果值为 SQLNULL,则返回值null。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
getArray
检索指定 JDBCARRAY参数的值作为 Java 编程语言中的Array对象。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推- 返回:
-
参数值作为 Java 编程语言中的
Array对象。如果值为 SQLNULL,则返回值null。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.2
-
getDate
检索指定 JDBCDATE参数的值作为java.sql.Date对象,使用给定的Calendar对象构造日期。使用Calendar对象,驱动程序可以在考虑自定义时区和区域设置的情况下计算日期。如果未指定Calendar对象,则驱动程序使用默认时区和区域设置。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推cal- 驱动程序将用于构建日期的Calendar对象- 返回:
-
参数值。如果值为 SQL
NULL,则结果为null。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法- 自从:
- 1.2
- 参见:
-
getTime
检索指定 JDBCTIME参数的值作为java.sql.Time对象,使用给定的Calendar对象构造时间。使用Calendar对象,驱动程序可以在考虑自定义时区和区域设置的情况下计算时间。如果未指定Calendar对象,则驱动程序使用默认时区和区域设置。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推cal- 驱动程序将用于构建时间的Calendar对象- 返回:
-
参数值;如果值为 SQL
NULL,则结果为null。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法- 自从:
- 1.2
- 参见:
-
getTimestamp
检索指定 JDBCTIMESTAMP参数的值作为java.sql.Timestamp对象,使用给定的Calendar对象构造Timestamp对象。使用Calendar对象,驱动程序可以在考虑自定义时区和区域设置的情况下计算时间戳。如果未指定Calendar对象,则驱动程序使用默认时区和区域设置。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推cal- 驱动程序将用于构建时间戳的Calendar对象- 返回:
-
参数值。如果值为 SQL
NULL,则结果为null。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法- 自从:
- 1.2
- 参见:
-
registerOutParameter
注册指定的输出参数。此版本的方法registerOutParameter应用于用户定义或REF输出参数。用户定义类型的示例包括:STRUCT、DISTINCT、JAVA_OBJECT和命名数组类型。在执行存储过程之前,必须注册所有 OUT 参数。
对于用户定义的参数,还应给出参数的完全限定 SQL 类型名称,而
REF参数则要求给出引用类型的完全限定类型名称。不需要类型代码和类型名称信息的 JDBC 驱动程序可能会忽略它。但是,为了便于移植,应用程序应始终为用户定义的参数和REF参数提供这些值。尽管它适用于用户定义的参数和REF参数,但此方法可用于注册任何 JDBC 类型的参数。如果参数没有用户定义或REF类型,则typeName参数被忽略。笔记:读取 out 参数的值时,必须使用其 Java 类型对应于参数的已注册 SQL 类型的 getter 方法。
- 参数:
parameterIndex- 第一个参数是 1,第二个是 2,...sqlType- 来自Types的值typeName- SQL 结构类型的完全限定名称- 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果sqlType是ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR,REF,ROWID,SQLXML或STRUCT数据类型并且 JDBC 驱动程序不支持此数据类型- 自从:
- 1.2
- 参见:
-
registerOutParameter
将名为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
- 参见:
-
registerOutParameter
将名为parameterName的参数注册为 JDBC 类型sqlType。在执行存储过程之前,必须注册所有 OUT 参数。sqlType为 OUT 参数指定的 JDBC 类型决定了get方法中必须使用的 Java 类型来读取该参数的值。当参数为 JDBC 类型
NUMERIC或DECIMAL时,应使用此版本的registerOutParameter。- 参数:
parameterName- 参数名称sqlType- SQL 类型代码由java.sql.Types定义。scale- 小数点右侧所需的位数。它必须大于或等于零。- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果sqlType是ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML或STRUCT数据类型并且 JDBC 驱动程序不支持此数据类型,或者如果 JDBC 驱动程序不支持支持这个方法- 自从:
- 1.4
- 参见:
-
registerOutParameter
注册指定的输出参数。此版本的方法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
- 参见:
-
getURL
检索指定 JDBCDATALINK参数的值作为java.net.URL对象。- 参数:
parameterIndex- 第一个参数是 1,第二个是 2,...- 返回:
-
代表用作指定参数的 JDBC
DATALINK值的java.net.URL对象 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误,则在关闭的CallableStatement上调用此方法,或者如果返回的 URL 不是 Java 平台上的有效 URLSQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
setURL
将指定参数设置为给定的java.net.URL对象。驱动程序将它发送到数据库时将其转换为 SQLDATALINK值。- 参数:
parameterName- 参数名称val- 参数值- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误;此方法在关闭的CallableStatement或 URL 格式错误时调用SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
setNull
将指定参数设置为 SQLNULL。笔记:您必须指定参数的 SQL 类型。
- 参数:
parameterName- 参数名称sqlType-java.sql.Types中定义的 SQL 类型代码- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
-
setBoolean
将指定参数设置为给定的 Javaboolean值。驱动程序将它发送到数据库时将其转换为 SQLBIT或BOOLEAN值。- 参数:
parameterName- 参数名称x- 参数值- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
setByte
将指定参数设置为给定的 Javabyte值。驱动程序将其发送到数据库时将其转换为 SQLTINYINT值。- 参数:
parameterName- 参数名称x- 参数值- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
setShort
将指定参数设置为给定的 Javashort值。驱动程序将它发送到数据库时将其转换为 SQLSMALLINT值。- 参数:
parameterName- 参数名称x- 参数值- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
setInt
将指定参数设置为给定的 Javaint值。驱动程序将它发送到数据库时将其转换为 SQLINTEGER值。- 参数:
parameterName- 参数名称x- 参数值- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
setLong
将指定参数设置为给定的 Javalong值。驱动程序将它发送到数据库时将其转换为 SQLBIGINT值。- 参数:
parameterName- 参数名称x- 参数值- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
setFloat
将指定参数设置为给定的 Javafloat值。驱动程序将它发送到数据库时将其转换为 SQLFLOAT值。- 参数:
parameterName- 参数名称x- 参数值- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
setDouble
将指定参数设置为给定的 Javadouble值。驱动程序将它发送到数据库时将其转换为 SQLDOUBLE值。- 参数:
parameterName- 参数名称x- 参数值- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
setBigDecimal
将指定参数设置为给定的java.math.BigDecimal值。驱动程序将它发送到数据库时将其转换为 SQLNUMERIC值。- 参数:
parameterName- 参数名称x- 参数值- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
setString
将指定参数设置为给定的 JavaString值。驱动程序将它发送到数据库时将其转换为 SQLVARCHAR或LONGVARCHAR值(取决于参数的大小相对于驱动程序对VARCHAR值的限制)。- 参数:
parameterName- 参数名称x- 参数值- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
setBytes
将指定参数设置为给定的 Java 字节数组。驱动程序将它发送到数据库时将其转换为 SQLVARBINARY或LONGVARBINARY(取决于参数的大小相对于驱动程序对VARBINARY值的限制)。- 参数:
parameterName- 参数名称x- 参数值- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
setDate
使用运行应用程序的虚拟机的默认时区将指定参数设置为给定的java.sql.Date值。驱动程序将它发送到数据库时将其转换为 SQLDATE值。- 参数:
parameterName- 参数名称x- 参数值- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
setTime
将指定参数设置为给定的java.sql.Time值。驱动程序将它发送到数据库时将其转换为 SQLTIME值。- 参数:
parameterName- 参数名称x- 参数值- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
setTimestamp
将指定参数设置为给定的java.sql.Timestamp值。驱动程序将它发送到数据库时将其转换为 SQLTIMESTAMP值。- 参数:
parameterName- 参数名称x- 参数值- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
setAsciiStream
将指定参数设置为给定的输入流,它将具有指定的字节数。当一个非常大的 ASCII 值输入到LONGVARCHAR参数时,通过java.io.InputStream发送它可能更实用。数据将根据需要从流中读取,直到到达文件末尾。 JDBC 驱动程序将执行从 ASCII 到数据库字符格式的任何必要转换。笔记:此流对象可以是标准 Java 流对象,也可以是您自己实现标准接口的子类。
- 参数:
parameterName- 参数名称x- 包含 ASCII 参数值的 Java 输入流length- 流中的字节数- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
-
setBinaryStream
将指定参数设置为给定的输入流,它将具有指定的字节数。当一个非常大的二进制值被输入到LONGVARBINARY参数时,通过java.io.InputStream对象发送它可能更实用。数据将根据需要从流中读取,直到到达文件末尾。笔记:此流对象可以是标准 Java 流对象,也可以是您自己实现标准接口的子类。
- 参数:
parameterName- 参数名称x- 包含二进制参数值的 java 输入流length- 流中的字节数- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
-
setObject
使用给定对象设置指定参数的值。在发送到数据库之前,给定的 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- 如果 JDBC 驱动程序不支持指定的 targetSqlType- 自从:
- 1.4
- 参见:
-
setObject
使用给定对象设置指定参数的值。此方法类似于setObject(String parameterName, Object x, int targetSqlType, int scaleOrLength),不同之处在于它假定比例为零。- 参数:
parameterName- 参数名称x- 包含输入参数值的对象targetSqlType- 要发送到数据库的 SQL 类型(在 java.sql.Types 中定义)- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持指定的 targetSqlType- 自从:
- 1.4
- 参见:
-
setObject
使用给定对象设置指定参数的值。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
- 参见:
-
setCharacterStream
将指定参数设置为给定的Reader对象,它是给定的字符长度。当一个非常大的 UNICODE 值输入到LONGVARCHAR参数时,通过java.io.Reader对象发送它可能更实用。数据将根据需要从流中读取,直到到达文件末尾。 JDBC 驱动程序将执行从 UNICODE 到数据库字符格式的任何必要转换。笔记:此流对象可以是标准 Java 流对象,也可以是您自己实现标准接口的子类。
- 参数:
parameterName- 参数名称reader- 包含用作指定参数的 UNICODE 数据的java.io.Reader对象length- 流中的字符数- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
-
setDate
使用给定的Calendar对象将指定参数设置为给定的java.sql.Date值。驱动程序使用Calendar对象构造 SQLDATE值,然后驱动程序将其发送到数据库。使用Calendar对象,驱动程序可以在考虑自定义时区的情况下计算日期。如果未指定Calendar对象,则驱动程序使用默认时区,即运行应用程序的虚拟机的时区。- 参数:
parameterName- 参数名称x- 参数值cal- 驱动程序将用于构建日期的Calendar对象- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
setTime
使用给定的Calendar对象将指定参数设置为给定的java.sql.Time值。驱动程序使用Calendar对象构造 SQLTIME值,然后驱动程序将其发送到数据库。使用Calendar对象,驱动程序可以在考虑自定义时区的情况下计算时间。如果未指定Calendar对象,则驱动程序使用默认时区,即运行应用程序的虚拟机的时区。- 参数:
parameterName- 参数名称x- 参数值cal- 驱动程序将用于构建时间的Calendar对象- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
setTimestamp
使用给定的Calendar对象将指定参数设置为给定的java.sql.Timestamp值。驱动程序使用Calendar对象构造 SQLTIMESTAMP值,然后驱动程序将其发送到数据库。使用 aaCalendar对象,驱动程序可以在考虑自定义时区的情况下计算时间戳。如果未指定Calendar对象,则驱动程序使用默认时区,即运行应用程序的虚拟机的时区。- 参数:
parameterName- 参数名称x- 参数值cal- 驱动程序将用于构建时间戳的Calendar对象- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
setNull
将指定参数设置为 SQLNULL。此版本的方法setNull应该用于用户定义类型和 REF 类型参数。用户定义类型的示例包括:STRUCT、DISTINCT、JAVA_OBJECT 和命名数组类型。笔记:为了便于移植,应用程序在指定 NULL 用户定义参数或 REF 参数时必须提供 SQL 类型代码和完全限定的 SQL 类型名称。在用户定义类型的情况下,名称是参数本身的类型名称。对于 REF 参数,名称是引用类型的类型名称。
尽管它适用于用户定义参数和 Ref 参数,但此方法可用于设置任何 JDBC 类型的空参数。如果参数没有用户定义或 REF 类型,则忽略给定的 typeName。
- 参数:
parameterName- 参数名称sqlType- 来自java.sql.Types的值typeName- SQL 用户定义类型的完全限定名称;如果参数不是用户定义的类型或 SQLREF值,则忽略- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
-
getString
检索 JDBCCHAR、VARCHAR或LONGVARCHAR参数的值作为 Java 编程语言中的String。对于固定长度类型的 JDBC
CHAR,返回的String对象与数据库中的 SQLCHAR值具有完全相同的值,包括数据库添加的任何填充。- 参数:
parameterName- 参数名称- 返回:
-
参数值。如果值为 SQL
NULL,则结果为null。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
getBoolean
检索 JDBCBIT或BOOLEAN参数的值作为 Java 编程语言中的boolean。- 参数:
parameterName- 参数名称- 返回:
-
参数值。如果值为 SQL
NULL,则结果为false。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
getByte
检索 JDBCTINYINT参数的值作为 Java 编程语言中的byte。- 参数:
parameterName- 参数名称- 返回:
-
参数值。如果值为 SQL
NULL,则结果为0。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
getShort
检索 JDBCSMALLINT参数的值作为 Java 编程语言中的short。- 参数:
parameterName- 参数名称- 返回:
-
参数值。如果值为 SQL
NULL,则结果为0。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
getInt
检索 JDBCINTEGER参数的值作为 Java 编程语言中的int。- 参数:
parameterName- 参数名称- 返回:
-
参数值。如果值为 SQL
NULL,则结果为0。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
getLong
检索 JDBCBIGINT参数的值作为 Java 编程语言中的long。- 参数:
parameterName- 参数名称- 返回:
-
参数值。如果值为 SQL
NULL,则结果为0。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
getFloat
检索 JDBCFLOAT参数的值作为 Java 编程语言中的float。- 参数:
parameterName- 参数名称- 返回:
-
参数值。如果值为 SQL
NULL,则结果为0。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
getDouble
检索 JDBCDOUBLE参数的值作为 Java 编程语言中的double。- 参数:
parameterName- 参数名称- 返回:
-
参数值。如果值为 SQL
NULL,则结果为0。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
getBytes
检索 JDBCBINARY或VARBINARY参数的值作为 Java 编程语言中byte值的数组。- 参数:
parameterName- 参数名称- 返回:
-
参数值。如果值为 SQL
NULL,则结果为null。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
getDate
检索 JDBCDATE参数的值作为java.sql.Date对象。- 参数:
parameterName- 参数名称- 返回:
-
参数值。如果值为 SQL
NULL,则结果为null。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
getTime
检索 JDBCTIME参数的值作为java.sql.Time对象。- 参数:
parameterName- 参数名称- 返回:
-
参数值。如果值为 SQL
NULL,则结果为null。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
getTimestamp
检索 JDBCTIMESTAMP参数的值作为java.sql.Timestamp对象。- 参数:
parameterName- 参数名称- 返回:
-
参数值。如果值为 SQL
NULL,则结果为null。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
getObject
检索参数值作为 Java 编程语言中的Object。如果该值为 SQLNULL,则驱动程序返回 Javanull。此方法返回一个 Java 对象,其类型对应于使用方法
registerOutParameter为该参数注册的 JDBC 类型。通过将目标 JDBC 类型注册为java.sql.Types.OTHER,此方法可用于读取特定于数据库的抽象数据类型。- 参数:
parameterName- 参数名称- 返回:
-
保存 OUT 参数值的
java.lang.Object。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
getBigDecimal
检索 JDBCNUMERIC参数的值作为java.math.BigDecimal对象,小数点右侧的位数与该值包含的位数一样多。- 参数:
parameterName- 参数名称- 返回:
-
全精度的参数值。如果值为 SQL
NULL,则结果为null。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
getObject
返回表示 OUT 参数值的对象parameterName并使用map进行参数值的自定义映射。此方法返回一个 Java 对象,其类型对应于使用方法
registerOutParameter为该参数注册的 JDBC 类型。通过将目标 JDBC 类型注册为java.sql.Types.OTHER,此方法可用于读取特定于数据库的抽象数据类型。- 参数:
parameterName- 参数名称map- 从 SQL 类型名称到 Java 类的映射- 返回:
java.lang.Object保存 OUT 参数值- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
getRef
检索 JDBCREF(<structured-type>)参数的值作为 Java 编程语言中的Ref对象。- 参数:
parameterName- 参数名称- 返回:
-
参数值作为 Java 编程语言中的
Ref对象。如果值为 SQLNULL,则返回值null。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
-
getBlob
检索 JDBCBLOB参数的值作为 Java 编程语言中的Blob对象。- 参数:
parameterName- 参数名称- 返回:
-
参数值作为 Java 编程语言中的
Blob对象。如果值为 SQLNULL,则返回值null。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
-
getClob
检索 JDBCCLOB参数的值作为 Java 编程语言中的java.sql.Clob对象。- 参数:
parameterName- 参数名称- 返回:
-
参数值作为 Java 编程语言中的
Clob对象。如果值为 SQLNULL,则返回值null。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
-
getArray
检索 JDBCARRAY参数的值作为 Java 编程语言中的Array对象。- 参数:
parameterName- 参数名称- 返回:
-
参数值作为 Java 编程语言中的
Array对象。如果值为 SQLNULL,则返回值null。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
-
getDate
检索 JDBCDATE参数的值作为java.sql.Date对象,使用给定的Calendar对象构造日期。使用Calendar对象,驱动程序可以在考虑自定义时区和区域设置的情况下计算日期。如果未指定Calendar对象,则驱动程序使用默认时区和区域设置。- 参数:
parameterName- 参数名称cal- 驱动程序将用于构建日期的Calendar对象- 返回:
-
参数值。如果值为 SQL
NULL,则结果为null。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
getTime
检索 JDBCTIME参数的值作为java.sql.Time对象,使用给定的Calendar对象构造时间。使用Calendar对象,驱动程序可以在考虑自定义时区和区域设置的情况下计算时间。如果未指定Calendar对象,则驱动程序使用默认时区和区域设置。- 参数:
parameterName- 参数名称cal- 驱动程序将用于构建时间的Calendar对象- 返回:
-
参数值;如果值为 SQL
NULL,则结果为null。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
getTimestamp
检索 JDBCTIMESTAMP参数的值作为java.sql.Timestamp对象,使用给定的Calendar对象构造Timestamp对象。使用Calendar对象,驱动程序可以在考虑自定义时区和区域设置的情况下计算时间戳。如果未指定Calendar对象,则驱动程序使用默认时区和区域设置。- 参数:
parameterName- 参数名称cal- 驱动程序将用于构建时间戳的Calendar对象- 返回:
-
参数值。如果值为 SQL
NULL,则结果为null。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
getURL
检索 JDBCDATALINK参数的值作为java.net.URL对象。- 参数:
parameterName- 参数名称- 返回:
-
参数值作为 Java 编程语言中的
java.net.URL对象。如果值为 SQLNULL,则返回值null。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误,则在关闭的CallableStatement上调用此方法,或者 URL 有问题SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.4
- 参见:
-
getRowId
检索指定 JDBCROWID参数的值作为java.sql.RowId对象。- 参数:
parameterIndex- 第一个参数是 1,第二个是 2,...- 返回:
-
表示 JDBC
ROWID值的RowId对象用作指定参数。如果参数包含 SQLNULL,则返回null值。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
getRowId
检索指定 JDBCROWID参数的值作为java.sql.RowId对象。- 参数:
parameterName- 参数名称- 返回:
-
表示 JDBC
ROWID值的RowId对象用作指定参数。如果参数包含 SQLNULL,则返回null值。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
setRowId
将指定参数设置为给定的java.sql.RowId对象。驱动程序将它发送到数据库时将其转换为 SQLROWID。- 参数:
parameterName- 参数名称x- 参数值- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
setNString
将指定参数设置为给定的String对象。驱动程序将其转换为 SQLNCHAR或NVARCHAR或LONGNVARCHAR- 参数:
parameterName- 要设置的参数名称value- 参数值- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
setNCharacterStream
将指定参数设置为Reader对象。Reader读取数据直到到达文件末尾。驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。- 参数:
parameterName- 要设置的参数名称value- 参数值length- 参数数据中的字符数。- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
setNClob
将指定参数设置为java.sql.NClob对象。该对象实现了java.sql.NClob接口。此NClob对象映射到 SQLNCLOB。- 参数:
parameterName- 要设置的参数名称value- 参数值- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
setClob
将指定参数设置为Reader对象。reader必须包含长度指定的字符数,否则在执行CallableStatement时将生成SQLException。此方法不同于setCharacterStream (int, Reader, int)方法,因为它通知驱动程序参数值应作为CLOB发送到服务。当使用setCharacterStream方法时,驱动程序可能必须做额外的工作来确定参数数据是否应该作为LONGVARCHAR或CLOB发送到服务- 参数:
parameterName- 要设置的参数名称reader- 包含要将参数值设置到的数据的对象。length- 参数数据中的字符数。- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果指定的长度小于零;发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
setBlob
将指定参数设置为InputStream对象。Inputstream必须包含长度指定的字符数,否则执行CallableStatement时将生成SQLException。此方法不同于setBinaryStream (int, InputStream, int)方法,因为它通知驱动程序参数值应作为BLOB发送到服务。当使用setBinaryStream方法时,驱动程序可能必须做额外的工作来确定参数数据是否应该作为LONGVARBINARY或BLOB发送到服务- 参数:
parameterName- 第二个要设置的参数名称是 2,...inputStream- 包含要将参数值设置到的数据的对象。length- 参数数据中的字节数。- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果指定的长度小于零;如果InputStream中的字节数与指定长度不匹配;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
setNClob
将指定参数设置为Reader对象。reader必须包含长度指定的字符数,否则在执行CallableStatement时将生成SQLException。此方法不同于setCharacterStream (int, Reader, int)方法,因为它通知驱动程序参数值应作为NCLOB发送到服务。当使用setCharacterStream方法时,驱动程序可能必须做额外的工作来确定参数数据是否应该作为LONGNVARCHAR或NCLOB发送到服务- 参数:
parameterName- 要设置的参数名称reader- 包含要将参数值设置到的数据的对象。length- 参数数据中的字符数。- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果指定的长度小于零;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
getNClob
检索指定 JDBCNCLOB参数的值作为 Java 编程语言中的java.sql.NClob对象。- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推- 返回:
-
参数值作为 Java 编程语言中的
NClob对象。如果值为 SQLNULL,则返回值null。 - 抛出:
SQLException- 如果参数索引无效;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
getNClob
检索 JDBCNCLOB参数的值作为 Java 编程语言中的java.sql.NClob对象。- 参数:
parameterName- 参数名称- 返回:
-
参数值作为 Java 编程语言中的
NClob对象。如果值为 SQLNULL,则返回值null。 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
setSQLXML
将指定参数设置为给定的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
检索指定SQL XML参数的值作为 Java 编程语言中的java.sql.SQLXML对象。- 参数:
parameterIndex- 第一个参数的索引是 1,第二个是 2,...- 返回:
-
映射
SQL XML值的SQLXML对象 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
getSQLXML
检索指定SQL XML参数的值作为 Java 编程语言中的java.sql.SQLXML对象。- 参数:
parameterName- 参数名称- 返回:
-
映射
SQL XML值的SQLXML对象 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
getNString
检索指定NCHAR、NVARCHAR或LONGNVARCHAR参数的值作为 Java 编程语言中的String。对于固定长度类型的 JDBC
NCHAR,返回的String对象与数据库中的 SQLNCHAR值具有完全相同的值,包括数据库添加的任何填充。- 参数:
parameterIndex- 第一个参数的索引是 1,第二个是 2,...- 返回:
-
映射
NCHAR、NVARCHAR或LONGNVARCHAR值的String对象 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
- 参见:
-
getNString
检索指定NCHAR、NVARCHAR或LONGNVARCHAR参数的值作为 Java 编程语言中的String。对于固定长度类型的 JDBC
NCHAR,返回的String对象与数据库中的 SQLNCHAR值具有完全相同的值,包括数据库添加的任何填充。- 参数:
parameterName- 参数名称- 返回:
-
映射
NCHAR、NVARCHAR或LONGNVARCHAR值的String对象 - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
- 参见:
-
getNCharacterStream
检索指定参数的值作为 Java 编程语言中的java.io.Reader对象。它旨在在访问NCHAR、NVARCHAR和LONGNVARCHAR参数时使用。- 参数:
parameterIndex- 第一个参数是 1,第二个是 2,...- 返回:
-
包含参数值的
java.io.Reader对象;如果值为 SQLNULL,则返回值为 Java 编程语言中的null。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
getNCharacterStream
检索指定参数的值作为 Java 编程语言中的java.io.Reader对象。它旨在在访问NCHAR、NVARCHAR和LONGNVARCHAR参数时使用。- 参数:
parameterName- 参数名称- 返回:
-
包含参数值的
java.io.Reader对象;如果值为 SQLNULL,则返回值为 Java 编程语言中的null - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
getCharacterStream
检索指定参数的值作为 Java 编程语言中的java.io.Reader对象。- 参数:
parameterIndex- 第一个参数是 1,第二个是 2,...- 返回:
-
包含参数值的
java.io.Reader对象;如果值为 SQLNULL,则返回值为 Java 编程语言中的null。 - 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法- 自从:
- 1.6
-
getCharacterStream
检索指定参数的值作为 Java 编程语言中的java.io.Reader对象。- 参数:
parameterName- 参数名称- 返回:
-
包含参数值的
java.io.Reader对象;如果值为 SQLNULL,则返回值为 Java 编程语言中的null - 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
setBlob
将指定参数设置为给定的java.sql.Blob对象。驱动程序将它发送到数据库时将其转换为 SQLBLOB值。- 参数:
parameterName- 参数名称x- 映射 SQLBLOB值的Blob对象- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
setClob
将指定参数设置为给定的java.sql.Clob对象。驱动程序将它发送到数据库时将其转换为 SQLCLOB值。- 参数:
parameterName- 参数名称x- 映射 SQLCLOB值的Clob对象- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
setAsciiStream
将指定参数设置为给定的输入流,它将具有指定的字节数。当一个非常大的 ASCII 值输入到LONGVARCHAR参数时,通过java.io.InputStream发送它可能更实用。数据将根据需要从流中读取,直到到达文件末尾。 JDBC 驱动程序将执行从 ASCII 到数据库字符格式的任何必要转换。笔记:此流对象可以是标准 Java 流对象,也可以是您自己实现标准接口的子类。
- 参数:
parameterName- 参数名称x- 包含 ASCII 参数值的 Java 输入流length- 流中的字节数- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
setBinaryStream
将指定参数设置为给定的输入流,它将具有指定的字节数。当一个非常大的二进制值被输入到LONGVARBINARY参数时,通过java.io.InputStream对象发送它可能更实用。数据将根据需要从流中读取,直到到达文件末尾。笔记:此流对象可以是标准 Java 流对象,也可以是您自己实现标准接口的子类。
- 参数:
parameterName- 参数名称x- 包含二进制参数值的 java 输入流length- 流中的字节数- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
setCharacterStream
将指定参数设置为给定的Reader对象,它是给定的字符长度。当一个非常大的 UNICODE 值输入到LONGVARCHAR参数时,通过java.io.Reader对象发送它可能更实用。数据将根据需要从流中读取,直到到达文件末尾。 JDBC 驱动程序将执行从 UNICODE 到数据库字符格式的任何必要转换。笔记:此流对象可以是标准 Java 流对象,也可以是您自己实现标准接口的子类。
- 参数:
parameterName- 参数名称reader- 包含用作指定参数的 UNICODE 数据的java.io.Reader对象length- 流中的字符数- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
setAsciiStream
将指定参数设置为给定的输入流。当一个非常大的 ASCII 值输入到LONGVARCHAR参数时,通过java.io.InputStream发送它可能更实用。数据将根据需要从流中读取,直到到达文件末尾。 JDBC 驱动程序将执行从 ASCII 到数据库字符格式的任何必要转换。笔记:此流对象可以是标准 Java 流对象,也可以是您自己实现标准接口的子类。
笔记:请查阅您的 JDBC 驱动程序文档以确定使用带长度参数的
setAsciiStream版本是否更有效。- 参数:
parameterName- 参数名称x- 包含 ASCII 参数值的 Java 输入流- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
setBinaryStream
将指定参数设置为给定的输入流。当一个非常大的二进制值被输入到LONGVARBINARY参数时,通过java.io.InputStream对象发送它可能更实用。数据将根据需要从流中读取,直到到达文件末尾。笔记:此流对象可以是标准 Java 流对象,也可以是您自己实现标准接口的子类。
笔记:请查阅您的 JDBC 驱动程序文档以确定使用带长度参数的
setBinaryStream版本是否更有效。- 参数:
parameterName- 参数名称x- 包含二进制参数值的 java 输入流- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
setCharacterStream
将指定参数设置为给定的Reader对象。当一个非常大的 UNICODE 值输入到LONGVARCHAR参数时,通过java.io.Reader对象发送它可能更实用。数据将根据需要从流中读取,直到到达文件末尾。 JDBC 驱动程序将执行从 UNICODE 到数据库字符格式的任何必要转换。笔记:此流对象可以是标准 Java 流对象,也可以是您自己实现标准接口的子类。
笔记:请查阅您的 JDBC 驱动程序文档以确定使用带有长度参数的
setCharacterStream版本是否更有效。- 参数:
parameterName- 参数名称reader- 包含 Unicode 数据的java.io.Reader对象- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
setNCharacterStream
将指定参数设置为Reader对象。Reader读取数据直到到达文件末尾。驱动程序执行从 Java 字符格式到数据库中国家字符集的必要转换。笔记:此流对象可以是标准 Java 流对象,也可以是您自己实现标准接口的子类。
笔记:请查阅您的 JDBC 驱动程序文档以确定使用带长度参数的
setNCharacterStream版本是否更有效。- 参数:
parameterName- 参数名称value- 参数值- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;如果发生数据库访问错误;或者在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
setClob
将指定参数设置为Reader对象。此方法不同于setCharacterStream (int, Reader)方法,因为它通知驱动程序参数值应作为CLOB发送到服务。当使用setCharacterStream方法时,驱动程序可能必须做额外的工作来确定参数数据是否应该作为LONGVARCHAR或CLOB发送到服务笔记:请查阅您的 JDBC 驱动程序文档以确定使用带长度参数的
setClob版本是否更有效。- 参数:
parameterName- 参数名称reader- 包含要将参数值设置到的数据的对象。- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
setBlob
将指定参数设置为InputStream对象。此方法不同于setBinaryStream (int, InputStream)方法,因为它通知驱动程序参数值应作为BLOB发送到服务。当使用setBinaryStream方法时,驱动程序可能必须做额外的工作来确定参数数据是否应该作为LONGVARBINARY或BLOB发送到服务笔记:请查阅您的 JDBC 驱动程序文档以确定使用带长度参数的
setBlob版本是否更有效。- 参数:
parameterName- 参数名称inputStream- 包含要将参数值设置到的数据的对象。- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
setNClob
将指定参数设置为Reader对象。此方法不同于setCharacterStream (int, Reader)方法,因为它通知驱动程序参数值应作为NCLOB发送到服务。当使用setCharacterStream方法时,驱动程序可能必须做额外的工作来确定参数数据是否应该作为LONGNVARCHAR或NCLOB发送到服务笔记:请查阅您的 JDBC 驱动程序文档以确定使用带长度参数的
setNClob版本是否更有效。- 参数:
parameterName- 参数名称reader- 包含要将参数值设置到的数据的对象。- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果驱动程序不支持国家字符集;如果驱动程序可以检测到可能发生数据转换错误;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.6
-
getObject
返回表示 OUT 参数parameterIndex值的对象,如果支持转换,将从参数的 SQL 类型转换为请求的 Java 数据类型。如果不支持转换或为类型指定 null,则抛出SQLException。至少,实现必须支持附录 B、表 B-3 中定义的转换,以及将适当的用户定义的 SQL 类型转换为实现
SQLData或Struct的 Java 类型。可能支持其他转换,并且由供应商定义。- 类型参数:
T- 此 Class 对象建模的类的类型- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推type- 表示要将指定参数转换为的 Java 数据类型的类。- 返回:
type的实例保存 OUT 参数值- 抛出:
SQLException- 如果不支持转换,则类型为空或发生其他错误。异常的 getCause() 方法可能会提供更详细的异常,例如,如果发生转换错误SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.7
-
getObject
返回表示 OUT 参数parameterName值的对象,并将从参数的 SQL 类型转换为请求的 Java 数据类型(如果支持转换)。如果不支持转换或为类型指定 null,则抛出SQLException。至少,实现必须支持附录 B、表 B-3 中定义的转换,以及将适当的用户定义的 SQL 类型转换为实现
SQLData或Struct的 Java 类型。可能支持其他转换,并且由供应商定义。- 类型参数:
T- 此 Class 对象建模的类的类型- 参数:
parameterName- 参数名称type- 表示要将指定参数转换为的 Java 数据类型的类。- 返回:
type的实例保存 OUT 参数值- 抛出:
SQLException- 如果不支持转换,则类型为空或发生其他错误。异常的 getCause() 方法可能会提供更详细的异常,例如,如果发生转换错误SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持此方法- 自从:
- 1.7
-
setObject
default void setObject(String parameterName, Object x, SQLType targetSqlType, int scaleOrLength) throws SQL异常 使用给定对象设置指定参数的值。如果第二个参数是InputStream,则流必须包含由 scaleOrLength 指定的字节数。如果第二个参数是Reader,那么读取器必须包含由 scaleOrLength 指定的字符数。如果这些条件不成立,驱动程序将在执行准备好的语句时生成SQLException。在发送到数据库之前,给定的 Java 对象将转换为给定的 targetSqlType。如果对象具有自定义映射(属于实现接口
SQLData的类),JDBC 驱动程序应调用方法SQLData.writeSQL将其写入 SQL 数据流。另一方面,如果对象属于实现Ref、Blob、Clob、NClob、Struct、java.net.URL或Array的类,则驱动程序应将其作为相应 SQL 类型的值传递给数据库。请注意,此方法可用于传递特定于数据库的抽象数据类型。
默认实现会抛出
SQLFeatureNotSupportedException- 参数:
parameterName- 参数名称x- 包含输入参数值的对象targetSqlType- 要发送到数据库的 SQL 类型。 scale 参数可以进一步限定这种类型。scaleOrLength- 对于java.sql.JDBCType.DECIMAL或java.sql.JDBCType.NUMERIC types,这是小数点后的位数。对于 Java 对象类型InputStream和Reader,这是流或读取器中数据的长度。对于所有其他类型,此值将被忽略。- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法,或者如果 x 指定的 Java 对象是 InputStream 或 Reader 对象并且 scale 参数的值小于零SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持指定的 targetSqlType- 自从:
- 1.8
- 参见:
-
setObject
使用给定对象设置指定参数的值。此方法类似于setObject(String parameterName, Object x, SQLType targetSqlType, int scaleOrLength),不同之处在于它假定比例为零。默认实现会抛出
SQLFeatureNotSupportedException- 参数:
parameterName- 参数名称x- 包含输入参数值的对象targetSqlType- 要发送到数据库的 SQL 类型- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持指定的 targetSqlType- 自从:
- 1.8
- 参见:
-
registerOutParameter
将序号位置parameterIndex中的 OUT 参数注册到 JDBC 类型sqlType。在执行存储过程之前,必须注册所有 OUT 参数。sqlType为 OUT 参数指定的 JDBC 类型决定了get方法中必须使用的 Java 类型来读取该参数的值。如果预期返回到此输出参数的 JDBC 类型特定于此特定数据库,则
sqlType可能是JDBCType.OTHER或 JDBC 驱动程序支持的SQLType。getObject(int)方法检索该值。默认实现会抛出
SQLFeatureNotSupportedException- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推sqlType-SQLType定义的 JDBC 类型代码,用于注册 OUT 参数。如果参数是 JDBC 类型JDBCType.NUMERIC或JDBCType.DECIMAL,则应使用接受比例值的registerOutParameter版本。- 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持指定的 sqlType- 自从:
- 1.8
- 参见:
-
registerOutParameter
将序号位置parameterIndex的参数注册为 JDBC 类型sqlType。在执行存储过程之前,必须注册所有 OUT 参数。sqlType为 OUT 参数指定的 JDBC 类型决定了get方法中必须使用的 Java 类型来读取该参数的值。当参数是 JDBC 类型
JDBCType.NUMERIC或JDBCType.DECIMAL时,应使用此版本的registerOutParameter。默认实现会抛出
SQLFeatureNotSupportedException- 参数:
parameterIndex- 第一个参数为1,第二个为2,依此类推sqlType-SQLType定义的 JDBC 类型代码,用于注册 OUT 参数。scale- 小数点右侧所需的位数。它必须大于或等于零。- 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持指定的 sqlType- 自从:
- 1.8
- 参见:
-
registerOutParameter
default void registerOutParameter(int parameterIndex, SQLType sqlType, String typeName) throws SQL异常 注册指定的输出参数。此版本的方法registerOutParameter应用于用户定义或REF输出参数。用户定义类型的示例包括:STRUCT、DISTINCT、JAVA_OBJECT和命名数组类型。在执行存储过程之前,必须注册所有 OUT 参数。
对于用户定义的参数,还应给出参数的完全限定 SQL 类型名称,而
REF参数则要求给出引用类型的完全限定类型名称。不需要类型代码和类型名称信息的 JDBC 驱动程序可能会忽略它。但是,为了便于移植,应用程序应始终为用户定义的参数和REF参数提供这些值。尽管它适用于用户定义的参数和REF参数,但此方法可用于注册任何 JDBC 类型的参数。如果参数没有用户定义或REF类型,则typeName参数被忽略。笔记:读取 out 参数的值时,必须使用其 Java 类型对应于参数的已注册 SQL 类型的 getter 方法。
默认实现会抛出
SQLFeatureNotSupportedException- 参数:
parameterIndex- 第一个参数是 1,第二个是 2,...sqlType-SQLType定义的 JDBC 类型代码,用于注册 OUT 参数。typeName- SQL 结构类型的完全限定名称- 抛出:
SQLException- 如果参数索引无效;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持指定的 sqlType- 自从:
- 1.8
- 参见:
-
registerOutParameter
将名为parameterName的 OUT 参数注册到 JDBC 类型sqlType。在执行存储过程之前,必须注册所有 OUT 参数。sqlType为 OUT 参数指定的 JDBC 类型决定了get方法中必须使用的 Java 类型来读取该参数的值。如果预期返回到此输出参数的 JDBC 类型特定于此特定数据库,
sqlType应该是JDBCType.OTHER或 JDBC 驱动程序支持的SQLType。方法getObject(int)检索值。默认实现会抛出
SQLFeatureNotSupportedException- 参数:
parameterName- 参数名称sqlType-SQLType定义的 JDBC 类型代码,用于注册 OUT 参数。如果参数是 JDBC 类型JDBCType.NUMERIC或JDBCType.DECIMAL,则应使用接受比例值的registerOutParameter版本。- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持指定的 sqlType 或者 JDBC 驱动程序不支持此方法- 自从:
- 1.8
- 参见:
-
registerOutParameter
将名为parameterName的参数注册为 JDBC 类型sqlType。在执行存储过程之前,必须注册所有 OUT 参数。sqlType为 OUT 参数指定的 JDBC 类型决定了get方法中必须使用的 Java 类型来读取该参数的值。当参数是 JDBC 类型
JDBCType.NUMERIC或JDBCType.DECIMAL时,应使用此版本的registerOutParameter。默认实现会抛出
SQLFeatureNotSupportedException- 参数:
parameterName- 参数名称sqlType-SQLType定义的 JDBC 类型代码,用于注册 OUT 参数。scale- 小数点右侧所需的位数。它必须大于或等于零。- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持指定的 sqlType 或者 JDBC 驱动程序不支持此方法- 自从:
- 1.8
- 参见:
-
registerOutParameter
default void registerOutParameter(String parameterName, SQLType sqlType, String typeName) throws SQL异常 注册指定的输出参数。此版本的方法registerOutParameter应用于用户命名或 REF 输出参数。用户命名类型的示例包括:STRUCT、DISTINCT、JAVA_OBJECT 和命名数组类型。在执行存储过程之前,必须注册所有 OUT 参数。
对于用户命名的参数,还应给出参数的完全限定 SQL 类型名称,而 REF 参数要求给出引用类型的完全限定类型名称。不需要类型代码和类型名称信息的 JDBC 驱动程序可能会忽略它。然而,为了便于移植,应用程序应始终为用户命名参数和 REF 参数提供这些值。尽管它适用于用户命名参数和 REF 参数,但此方法可用于注册任何 JDBC 类型的参数。如果参数没有用户命名或 REF 类型,则忽略 typeName 参数。笔记:读取 out 参数的值时,必须使用
getXXX方法,其 Java 类型 XXX 对应于参数的注册 SQL 类型。默认实现会抛出
SQLFeatureNotSupportedException- 参数:
parameterName- 参数名称sqlType-SQLType定义的 JDBC 类型代码,用于注册 OUT 参数。typeName- SQL 结构类型的完全限定名称- 抛出:
SQLException- 如果 parameterName 不对应于命名参数;如果发生数据库访问错误或在关闭的CallableStatement上调用此方法SQLFeatureNotSupportedException- 如果 JDBC 驱动程序不支持指定的 sqlType 或者 JDBC 驱动程序不支持此方法- 自从:
- 1.8
- 参见:
-
getBigDecimal(int parameterIndex)或getBigDecimal(String parameterName)