-
- All Superinterfaces:
-
AutoCloseable,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参数值是使用所设定的
set从继承的方法PreparedStatement。 必须在执行存储过程之前注册所有OUT参数的类型; 通过此处提供的get方法执行后检索它们的值。CallableStatement可以返回一个ResultSet对象或多个ResultSet对象。 使用从Statement继承的操作处理多个ResultSet对象。为了获得最大的可移植性,应在获取输出参数值之前处理调用的
ResultSet对象和更新计数。- 从以下版本开始:
- 1.1
- 另请参见:
-
Connection.prepareCall(java.lang.String),ResultSet
-
-
字段汇总
-
Fields declared in interface java.sql.Statement
CLOSE_ALL_RESULTS, CLOSE_CURRENT_RESULT, EXECUTE_FAILED, KEEP_CURRENT_RESULT, NO_GENERATED_KEYS, RETURN_GENERATED_KEYS, SUCCESS_NO_INFO
-
-
方法摘要
所有方法 实例方法 抽象方法 Default Methods 弃用的方法 变量和类型 方法 描述 ArraygetArray(int parameterIndex)以Java编程语言中Array对象的形式检索指定的JDBCARRAY参数的值。ArraygetArray(String parameterName)BigDecimalgetBigDecimal(int parameterIndex)检索指定的JDBCNUMERIC参数的值,作为java.math.BigDecimal对象,其值包含小数点右侧的位数。BigDecimalgetBigDecimal(int parameterIndex, int scale)已过时。使用getBigDecimal(int parameterIndex)或getBigDecimal(String parameterName)BigDecimalgetBigDecimal(String parameterName)以java.math.BigDecimal对象的形式检索JDBCNUMERIC参数的值,该值包含小数点右侧的位数。BlobgetBlob(int parameterIndex)以Java编程语言中Blob对象的形式检索指定的JDBCBLOB参数的值。BlobgetBlob(String parameterName)以Java编程语言中Blob对象的形式检索JDBCBLOB参数的值。booleangetBoolean(int parameterIndex)在Java编程语言中以boolean检索指定的JDBCBIT或BOOLEAN参数的值。booleangetBoolean(String parameterName)使用Java编程语言中的boolean检索JDBCBIT或BOOLEAN参数的值。bytegetByte(int parameterIndex)以Java编程语言中byte检索指定的JDBCTINYINT参数的值。bytegetByte(String parameterName)检索JDBC的价值TINYINT参数为byte的Java编程语言。byte[]getBytes(int parameterIndex)检索指定的JDBCBINARY或VARBINARY参数的值,作为Java编程语言中byte值的数组。byte[]getBytes(String parameterName)检索JDBCBINARY或VARBINARY参数的值,作为Java编程语言中byte值的数组。ReadergetCharacterStream(int parameterIndex)以Java编程语言中java.io.Reader对象的形式检索指定参数的值。ReadergetCharacterStream(String parameterName)以Java编程语言中java.io.Reader对象的形式检索指定参数的值。ClobgetClob(int parameterIndex)以Java编程语言中java.sql.Clob对象的形式检索指定的JDBCCLOB参数的值。ClobgetClob(String parameterName)以Java编程语言中java.sql.Clob对象的形式检索JDBCCLOB参数的值。DategetDate(int parameterIndex)以java.sql.Date对象的形式检索指定的JDBCDATE参数的值。DategetDate(int parameterIndex, Calendar cal)检索指定的JDBCDATE参数的值作为java.sql.Date对象,使用给定的Calendar对象构造日期。DategetDate(String parameterName)以java.sql.Date对象的形式检索JDBCDATE参数的值。DategetDate(String parameterName, Calendar cal)检索JDBC的值DATE参数作为java.sql.Date对象,使用给定Calendar对象构造日期。doublegetDouble(int parameterIndex)以Java编程语言中double检索指定的JDBCDOUBLE参数的值。doublegetDouble(String parameterName)检索JDBC的价值DOUBLE参数为double的Java编程语言。floatgetFloat(int parameterIndex)以Java编程语言中float检索指定的JDBCFLOAT参数的值。floatgetFloat(String parameterName)检索JDBC的价值FLOAT参数为float的Java编程语言。intgetInt(int parameterIndex)以Java编程语言中int检索指定的JDBCINTEGER参数的值。intgetInt(String parameterName)使用Java编程语言中的int检索JDBCINTEGER参数的值。longgetLong(int parameterIndex)以Java编程语言中long检索指定的JDBCBIGINT参数的值。longgetLong(String parameterName)检索JDBC的价值BIGINT参数为long的Java编程语言。ReadergetNCharacterStream(int parameterIndex)以Java编程语言中java.io.Reader对象的形式检索指定参数的值。ReadergetNCharacterStream(String parameterName)以Java编程语言中java.io.Reader对象的形式检索指定参数的值。NClobgetNClob(int parameterIndex)以Java编程语言中java.sql.NClob对象的形式检索指定的JDBCNCLOB参数的值。NClobgetNClob(String parameterName)以Java编程语言中java.sql.NClob对象的形式检索JDBCNCLOB参数的值。StringgetNString(int parameterIndex)检索指定的值NCHAR,NVARCHAR或LONGNVARCHAR作为参数StringJava编程语言。StringgetNString(String parameterName)检索指定的值NCHAR,NVARCHAR或LONGNVARCHAR作为参数StringJava编程语言。ObjectgetObject(int parameterIndex)以Java编程语言中Object检索指定参数的值。<T> TgetObject(int parameterIndex, 类<T> type)返回表示OUT参数parameterIndex的值的对象,如果支持转换,则将从参数的SQL类型转换为请求的Java数据类型。ObjectgetObject(int parameterIndex, Map<String,类<?>> map)返回表示OUT参数parameterIndex的值的对象,并使用map作为参数值的自定义映射。ObjectgetObject(String parameterName)在Java编程语言中以Object检索参数的值。<T> TgetObject(String parameterName, 类<T> type)返回表示OUT参数parameterName的值的对象,如果支持转换,则将从参数的SQL类型转换为请求的Java数据类型。ObjectgetObject(String parameterName, Map<String,类<?>> map)返回表示OUT参数parameterName的值的对象,并使用map作为参数值的自定义映射。RefgetRef(int parameterIndex)以Java编程语言中Ref对象的形式检索指定的JDBCREF(<structured-type>)参数的值。RefgetRef(String parameterName)以Java编程语言中Ref对象的形式检索JDBCREF(<structured-type>)参数的值。RowIdgetRowId(int parameterIndex)以java.sql.RowId对象的形式检索指定的JDBCROWID参数的值。RowIdgetRowId(String parameterName)检索指定的JDBCROWID参数的值作为java.sql.RowId对象。shortgetShort(int parameterIndex)以Java编程语言中short检索指定的JDBCSMALLINT参数的值。shortgetShort(String parameterName)检索JDBC的价值SMALLINT参数为short的Java编程语言。SQLXMLgetSQLXML(int parameterIndex)以Java编程语言中java.sql.SQLXML对象的形式检索指定的SQL XML参数的值。SQLXMLgetSQLXML(String parameterName)以Java编程语言检索指定的SQL XML参数的值作为java.sql.SQLXML对象。StringgetString(int parameterIndex)获取指定的JDBC的价值CHAR,VARCHAR,或LONGVARCHAR参数为String的Java编程语言。StringgetString(String parameterName)检索JDBC的价值CHAR,VARCHAR,或LONGVARCHAR参数为String的Java编程语言。TimegetTime(int parameterIndex)以java.sql.Time对象的形式检索指定的JDBCTIME参数的值。TimegetTime(int parameterIndex, Calendar cal)检索指定的JDBCTIME参数的值作为java.sql.Time对象,使用给定的Calendar对象构造时间。TimegetTime(String parameterName)以java.sql.Time对象的形式检索JDBCTIME参数的值。TimegetTime(String parameterName, Calendar cal)检索JDBC的值TIME参数作为java.sql.Time对象,使用给定Calendar对象构造时间。TimestampgetTimestamp(int parameterIndex)以java.sql.Timestamp对象的形式检索指定的JDBCTIMESTAMP参数的值。TimestampgetTimestamp(int parameterIndex, Calendar cal)使用给定的Calendar对象检索指定的JDBCTIMESTAMP参数的值作为java.sql.Timestamp对象,以构造Timestamp对象。TimestampgetTimestamp(String parameterName)以java.sql.Timestamp对象的形式检索JDBCTIMESTAMP参数的值。TimestampgetTimestamp(String parameterName, Calendar cal)使用给定的Calendar对象检索JDBCTIMESTAMP参数的值作为java.sql.Timestamp对象,以构造Timestamp对象。URLgetURL(int parameterIndex)以java.net.URL对象的形式检索指定的JDBCDATALINK参数的值。URLgetURL(String parameterName)以java.net.URL对象的形式检索JDBCDATALINK参数的值。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对象。voidsetBlob(String parameterName, Blob x)将指定参数设置为给定的java.sql.Blob对象。voidsetBoolean(String parameterName, boolean x)将指定参数设置为给定的Javaboolean值。voidsetByte(String parameterName, byte x)将指定参数设置为给定的Javabyte值。voidsetBytes(String parameterName, byte[] x)将指定参数设置为给定的Java字节数组。voidsetCharacterStream(String parameterName, Reader reader)将指定参数设置为给定的Reader对象。voidsetCharacterStream(String parameterName, Reader reader, int length)将指定参数设置为给定的Reader对象,该对象是给定的字符长度。voidsetCharacterStream(String parameterName, Reader reader, long length)将指定参数设置为给定的Reader对象,该对象是给定的字符长度。voidsetClob(String parameterName, Reader reader)将指定参数设置为Reader对象。voidsetClob(String parameterName, Reader reader, long length)将指定参数设置为Reader对象。voidsetClob(String parameterName, Clob x)将指定参数设置为给定的java.sql.Clob对象。voidsetDate(String parameterName, Date x)使用运行应用程序的虚拟机的默认时区将指定参数设置为给定的java.sql.Date值。voidsetDate(String parameterName, Date x, Calendar cal)使用给定的Calendar对象将指定参数设置为给定的java.sql.Date值。voidsetDouble(String parameterName, double x)将指定参数设置为给定的Javadouble值。voidsetFloat(String parameterName, float x)将指定参数设置为给定的Javafloat值。voidsetInt(String parameterName, int x)将指定参数设置为给定的Javaint值。voidsetLong(String parameterName, long x)将指定参数设置为给定的Javalong值。voidsetNCharacterStream(String parameterName, Reader value)将指定参数设置为Reader对象。voidsetNCharacterStream(String parameterName, Reader value, long length)将指定参数设置为Reader对象。voidsetNClob(String parameterName, Reader reader)将指定参数设置为Reader对象。voidsetNClob(String parameterName, Reader reader, long length)将指定参数设置为Reader对象。voidsetNClob(String parameterName, NClob value)将指定参数设置为java.sql.NClob对象。voidsetNString(String parameterName, String value)将指定参数设置为给定的String对象。voidsetNull(String parameterName, int sqlType)将指定参数设置为SQLNULL。voidsetNull(String parameterName, int sqlType, String typeName)将指定参数设置为SQLNULL。voidsetObject(String parameterName, Object x)使用给定对象设置指定参数的值。voidsetObject(String parameterName, Object x, int targetSqlType)使用给定对象设置指定参数的值。voidsetObject(String parameterName, Object x, int targetSqlType, int scale)使用给定对象设置指定参数的值。default voidsetObject(String parameterName, Object x, SQLType targetSqlType)使用给定对象设置指定参数的值。default voidsetObject(String parameterName, Object x, SQLType targetSqlType, int scaleOrLength)使用给定对象设置指定参数的值。voidsetRowId(String parameterName, RowId x)将指定参数设置为给定的java.sql.RowId对象。voidsetShort(String parameterName, short x)将指定参数设置为给定的Javashort值。voidsetSQLXML(String parameterName, SQLXML xmlObject)将指定参数设置为给定的java.sql.SQLXML对象。voidsetString(String parameterName, String x)将指定参数设置为给定的JavaString值。voidsetTime(String parameterName, Time x)将指定参数设置为给定的java.sql.Time值。voidsetTime(String parameterName, Time x, Calendar cal)使用给定的Calendar对象将指定参数设置为给定的java.sql.Time值。voidsetTimestamp(String parameterName, Timestamp x)将指定参数设置为给定的java.sql.Timestamp值。voidsetTimestamp(String parameterName, Timestamp x, Calendar cal)使用给定的Calendar对象将指定参数设置为给定的java.sql.Timestamp值。voidsetURL(String parameterName, URL val)将指定参数设置为给定的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
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- 小数点右侧的所需位数。 它必须大于或等于零。 - 异常
-
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参数是否具有SQLNULL的值。 请注意,只有在调用getter方法后才能调用此方法; 否则,没有价值可用于确定它是否为null。- 结果
-
true如果读取的最后一个参数是SQLNULL; 否则为false - 异常
-
SQLException- 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法
-
getString
String getString(int parameterIndex) throws SQLException
获取指定的JDBC的价值CHAR,VARCHAR,或LONGVARCHAR参数为String的Java编程语言。对于固定长度类型JDBC
CHAR,返回的String对象与SQLCHAR值在数据库中具有的值完全相同,包括数据库添加的任何填充。- 参数
-
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
@Deprecated(since="1.2") BigDecimal getBigDecimal(int parameterIndex, int scale) throws SQLException
Deprecated.usegetBigDecimal(int parameterIndex)orgetBigDecimal(String parameterName)检索指定JDBC的值NUMERIC参数作为java.math.BigDecimal带有 刻度数字在小数点右侧的对象。- 参数
-
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检索指定的JDBCBINARY或VARBINARY参数的值,作为Java编程语言中byte值的数组。- 参数
-
parameterIndex- 第一个参数是1,第二个参数是2,依此类推 - 结果
-
参数值。
如果值为SQL
NULL,则结果为null。 - 异常
-
SQLException- 如果parameterIndex无效; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 - 另请参见:
-
setBytes(java.lang.String, byte[])
-
getDate
Date getDate(int parameterIndex) throws SQLException
检索指定的JDBCDATE参数的值作为java.sql.Date对象。- 参数
-
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,依此类推 - 结果
-
A
java.lang.Object保持OUT参数值 - 异常
-
SQLException- 如果parameterIndex无效; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 - 另请参见:
-
Types,setObject(java.lang.String, java.lang.Object, int, int)
-
getBigDecimal
BigDecimal getBigDecimal(int parameterIndex) throws SQLException
检索指定的JDBCNUMERIC参数的值,作为java.math.BigDecimal对象,该值包含小数点右侧的位数。- 参数
-
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,类<?>> map) throws SQLException
返回表示OUT参数parameterIndex的值的对象,并使用map作为参数值的自定义映射。此方法返回一个Java对象,其类型对应于使用方法
registerOutParameter为此参数注册的JDBC类型。 通过将目标JDBC类型注册为java.sql.Types.OTHER,此方法可用于读取特定于数据库的抽象数据类型。- 参数
-
parameterIndex- 第一个参数是1,第二个参数是2,依此类推 -
map- 从SQL类型名称到Java类的映射 - 结果
-
a
java.lang.Object保存OUT参数值 - 异常
-
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对象的形式检索指定的JDBCREF(<structured-type>)参数的值。- 参数
-
parameterIndex- 第一个参数是1,第二个参数是2,依此类推 - 结果
-
参数值为Java编程语言中的
Ref对象。 如果值为SQLNULL,则返回值null。 - 异常
-
SQLException- 如果parameterIndex无效; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getBlob
Blob getBlob(int parameterIndex) throws SQLException
以Java编程语言中Blob对象的形式检索指定的JDBCBLOB参数的值。- 参数
-
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对象的形式检索指定的JDBCARRAY参数的值。- 参数
-
parameterIndex- 第一个参数是1,第二个参数是2,依此类推 - 结果
-
参数值为Java编程语言中的
Array对象。 如果值为SQLNULL,则返回值null。 - 异常
-
SQLException- 如果parameterIndex无效; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getDate
Date getDate(int parameterIndex, Calendar cal) throws SQLException
检索指定的JDBCDATE参数的值作为java.sql.Date对象,使用给定的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
检索指定的JDBCTIME参数的值作为java.sql.Time对象,使用给定的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
使用给定的Calendar对象检索指定的JDBCTIMESTAMP参数的值作为java.sql.Timestamp对象,以构造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类型的getter方法。
- 参数
-
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- 小数点右侧所需的位数。 它必须大于或等于零。 - 异常
-
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参数的值时,必须使用其Java类型XXX对应于参数的已注册SQL类型的
getXXX方法。- 参数
-
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.net.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格式CallableStatement则调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
getURL(int)
-
setNull
void setNull(String parameterName, int sqlType) throws SQLException
将指定的参数设置为SQLNULL。注意:您必须指定参数的SQL类型。
- 参数
-
parameterName- 参数的名称 -
sqlType-java.sql.Types定义的SQL类型代码 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
setBoolean
void setBoolean(String parameterName, boolean x) throws SQLException
将指定参数设置为给定的Javaboolean值。 驱动程序在将数据发送到数据库时将其转换为SQLBIT或BOOLEAN值。- 参数
-
parameterName- 参数的名称 -
x- 参数值 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
getBoolean(int)
-
setByte
void setByte(String parameterName, byte x) throws SQLException
将指定参数设置为给定的Javabyte值。 驱动程序在将其发送到数据库时将其转换为SQLTINYINT值。- 参数
-
parameterName- 参数的名称 -
x- 参数值 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
getByte(int)
-
setShort
void setShort(String parameterName, short x) throws SQLException
将指定参数设置为给定的Javashort值。 驱动程序在将其发送到数据库时将其转换为SQLSMALLINT值。- 参数
-
parameterName- 参数的名称 -
x- 参数值 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
getShort(int)
-
setInt
void setInt(String parameterName, int x) throws SQLException
将指定参数设置为给定的Javaint值。 驱动程序将其发送到数据库时将其转换为SQLINTEGER值。- 参数
-
parameterName- 参数的名称 -
x- 参数值 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
getInt(int)
-
setLong
void setLong(String parameterName, long x) throws SQLException
将指定参数设置为给定的Javalong值。 驱动程序将其发送到数据库时将其转换为SQLBIGINT值。- 参数
-
parameterName- 参数的名称 -
x- 参数值 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
getLong(int)
-
setFloat
void setFloat(String parameterName, float x) throws SQLException
将指定参数设置为给定的Javafloat值。 驱动程序在将其发送到数据库时将其转换为SQLFLOAT值。- 参数
-
parameterName- 参数的名称 -
x- 参数值 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
getFloat(int)
-
setDouble
void setDouble(String parameterName, double x) throws SQLException
将指定参数设置为给定的Javadouble值。 驱动程序在将其发送到数据库时将其转换为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
将指定参数设置为给定的JavaString值。 将驱动程序发送到数据库时,驱动程序将其转换为SQLVARCHAR或LONGVARCHAR值(取决于参数的大小相对于驱动程序对VARCHAR值的限制)。- 参数
-
parameterName- 参数的名称 -
x- 参数值 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
getString(int)
-
setBytes
void setBytes(String parameterName, byte[] x) throws SQLException
将指定参数设置为给定的Java字节数组。 将驱动程序发送到数据库时,驱动程序将其转换为SQLVARBINARY或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对象将转换为给定的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
- 另请参见:
-
Types,getObject(int)
-
setObject
void setObject(String parameterName, Object x, int targetSqlType) throws SQLException
使用给定对象设置指定参数的值。 此方法类似于setObject(String parameterName, Object x, int targetSqlType, int scaleOrLength),不同之处在于它假设为零。- 参数
-
parameterName- 参数的名称 -
x- 包含输入参数值的对象 -
targetSqlType- 要发送到数据库的SQL类型(在java.sql.Types中定义) - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持指定的targetSqlType - 从以下版本开始:
- 1.4
- 另请参见:
-
getObject(int)
-
setObject
void setObject(String parameterName, Object x) throws SQLException
使用给定对象设置指定参数的值。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
将指定参数设置为SQLNULL。 此版本的方法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
检索JDBC的价值CHAR,VARCHAR,或LONGVARCHAR参数为String的Java编程语言。对于固定长度类型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
检索JDBC的价值TINYINT参数为byte的Java编程语言。- 参数
-
parameterName- 参数的名称 - 结果
-
参数值。
如果值为SQL
NULL,则结果为0。 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
setByte(java.lang.String, byte)
-
getShort
short getShort(String parameterName) throws SQLException
检索JDBC的价值SMALLINT参数为short的Java编程语言。- 参数
-
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
检索JDBC的价值BIGINT参数为long的Java编程语言。- 参数
-
parameterName- 参数的名称 - 结果
-
参数值。
如果值为SQL
NULL,则结果为0。 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
setLong(java.lang.String, long)
-
getFloat
float getFloat(String parameterName) throws SQLException
检索JDBC的价值FLOAT参数为float的Java编程语言。- 参数
-
parameterName- 参数的名称 - 结果
-
参数值。
如果值为SQL
NULL,则结果为0。 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
setFloat(java.lang.String, float)
-
getDouble
double getDouble(String parameterName) throws SQLException
检索JDBC的价值DOUBLE参数为double的Java编程语言。- 参数
-
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值的数组的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- 参数的名称 - 结果
-
java.lang.Object保持OUT参数值。 - 异常
-
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,类<?>> map) throws SQLException
返回表示OUT参数parameterName的值的对象,并使用map作为参数值的自定义映射。此方法返回一个Java对象,其类型对应于使用方法
registerOutParameter为此参数注册的JDBC类型。 通过将目标JDBC类型注册为java.sql.Types.OTHER,此方法可用于读取特定于数据库的抽象数据类型。- 参数
-
parameterName- 参数的名称 -
map- 从SQL类型名称到Java类的映射 - 结果
-
a
java.lang.Object保持OUT参数值 - 异常
-
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对象的形式检索JDBCREF(<structured-type>)参数的值。- 参数
-
parameterName- 参数的名称 - 结果
-
参数值为Java编程语言中的
Ref对象。 如果值为SQLNULL,则返回值null。 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
getBlob
Blob getBlob(String parameterName) throws SQLException
以Java编程语言中Blob对象的形式检索JDBCBLOB参数的值。- 参数
-
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
- 参数
-
parameterName- 参数的名称 - 结果
-
参数值为Java编程语言中的
Array对象。 如果值为SQLNULL,则返回值null。 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
getDate
Date getDate(String parameterName, Calendar cal) throws SQLException
检索JDBC的值DATE参数作为java.sql.Date对象,使用给定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
检索JDBCTIME参数的值作为java.sql.Time对象,使用给定的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
使用给定的Calendar对象检索JDBCTIMESTAMP参数的值作为java.sql.Timestamp对象,以构造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与命名参数不对应; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
setNCharacterStream
void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException
将指定参数设置为Reader对象。Reader读取数据,直到达到文件结尾。 驱动程序执行从Java字符格式到数据库中的国家字符集的必要转换。- 参数
-
parameterName- 要设置的参数的名称 -
value- 参数值 -
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指定的字符数,否则在执行SQLException将生成CallableStatement。 此方法与setCharacterStream (int, Reader, int)方法不同,因为它通知驱动程序参数值应作为CLOB发送到服务器。 使用setCharacterStream方法时,驱动程序可能需要做额外的工作来确定参数数据是否应作为LONGVARCHAR或CLOB发送到服务器- 参数
-
parameterName- 要设置的参数的名称 -
reader- 包含要将参数值设置为的数据的对象。 -
length- 参数数据中的字符数。 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果指定的长度小于零; 发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
setBlob
void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException
将指定参数设置为InputStream对象。Inputstream必须包含由length指定的字符数,否则在执行SQLException将生成CallableStatement。 此方法与setBinaryStream (int, InputStream, int)方法不同,因为它通知驱动程序参数值应作为BLOB发送到服务器。 使用setBinaryStream方法时,驱动程序可能需要做额外的工作来确定参数数据是否应作为LONGVARBINARY或BLOB发送到服务器- 参数
-
parameterName- 要设置的参数名称第二个是2,... -
inputStream- 包含要将参数值设置为的数据的对象。 -
length- 参数数据中的字节数。 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果指定的长度小于零; 如果InputStream中的字节数与指定的长度不匹配; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
setNClob
void setNClob(String parameterName, Reader reader, long length) throws SQLException
将指定参数设置为Reader对象。reader必须包含由length指定的字符数,否则在执行SQLException将生成CallableStatement。 此方法与setCharacterStream (int, Reader, int)方法不同,因为它通知驱动程序参数值应作为NCLOB发送到服务器。 使用setCharacterStream方法时,驱动程序可能需要做额外的工作来确定参数数据是否应作为LONGNVARCHAR或NCLOB发送到服务器- 参数
-
parameterName- 要设置的参数的名称 -
reader- 包含要将参数值设置为的数据的对象。 -
length- 参数数据中的字符数。 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果指定的长度小于零; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误或在关闭的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
检索指定的值NCHAR,NVARCHAR或LONGNVARCHAR作为参数StringJava编程语言。对于固定长度类型JDBC
NCHAR,返回的String对象与SQLNCHAR值在数据库中具有完全相同的值,包括数据库添加的任何填充。- 参数
-
parameterIndex- 第一个参数的索引是1,第二个参数是2,... - 结果
-
一个
String对象映射的NCHAR,NVARCHAR或LONGNVARCHAR值 - 异常
-
SQLException- 如果parameterIndex无效; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
- 另请参见:
-
setNString(java.lang.String, java.lang.String)
-
getNString
String getNString(String parameterName) throws SQLException
检索指定的值NCHAR,NVARCHAR或LONGNVARCHAR作为参数StringJava编程语言。对于固定长度类型JDBC
NCHAR,返回的String对象与SQLNCHAR值在数据库中具有的值完全相同,包括数据库添加的任何填充。- 参数
-
parameterName- 参数的名称 - 结果
-
一个
String对象映射的NCHAR,NVARCHAR或LONGNVARCHAR值 - 异常
-
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发送它可能更实用。 将根据需要从流中读取数据,直到达到文件结尾。 JDBC驱动程序将执行从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驱动程序文档以确定使用带有长度参数的
setAsciiStream版本是否更有效。- 参数
-
parameterName- 参数的名称 -
x- 包含ASCII参数值的Java输入流 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
setBinaryStream
void setBinaryStream(String parameterName, InputStream x) throws SQLException
将指定参数设置为给定输入流。 当将非常大的二进制值输入到LONGVARBINARY参数时,通过java.io.InputStream对象发送它可能更实际。 将根据需要从流中读取数据,直到达到文件结尾。注意:此流对象可以是标准Java流对象,也可以是您自己的实现标准接口的子类。
注意:请参阅JDBC驱动程序文档,以确定使用带有长度参数的
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驱动程序文档,以确定使用带有长度参数的
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驱动程序文档,以确定使用带有长度参数的
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驱动程序文档,以确定使用带有长度参数的
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驱动程序文档,以确定使用带有长度参数的
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驱动程序文档,以确定使用带有长度参数的
setNClob版本是否更有效。- 参数
-
parameterName- 参数的名称 -
reader- 包含要将参数值设置为的数据的对象。 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
getObject
<T> T getObject(int parameterIndex, 类<T> type) throws SQLException返回表示OUT参数parameterIndex的值的对象,如果支持转换,则将从参数的SQL类型转换为请求的Java数据类型。 如果不支持转换或为类型指定null,则抛出SQLException。实现必须至少支持附录B,表B-3中定义的转换以及将适当的用户定义的SQL类型转换为实现
SQLData或Struct的Java类型。 可能支持其他转换,并且是供应商定义的。- 参数类型
-
T- 此Class对象建模的类的类型 - 参数
-
parameterIndex- 第一个参数是1,第二个参数是2,依此类推 -
type- 表示要将指定参数转换为的Java数据类型的类。 - 结果
-
保存OUT参数值的
type实例 - 异常
-
SQLException- 如果不支持转换,则键入null或发生其他错误。 异常的getCause()方法可能会提供更详细的异常,例如,如果发生转换错误 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.7
-
getObject
<T> T getObject(String parameterName, 类<T> type) throws SQLException
返回表示OUT参数parameterName的值的对象,如果支持转换,则将从参数的SQL类型转换为请求的Java数据类型。 如果不支持转换或为类型指定null,则抛出SQLException。实现必须至少支持附录B,表B-3中定义的转换以及将适当的用户定义的SQL类型转换为实现
SQLData或Struct的Java类型。 可能支持其他转换,并且是供应商定义的。- 参数类型
-
T- 此Class对象建模的类的类型 - 参数
-
parameterName- 参数的名称 -
type- 表示要将指定参数转换为的Java数据类型的类。 - 结果
-
保存OUT参数值的
type的实例 - 异常
-
SQLException- 如果不支持转换,则键入null或发生其他错误。 异常的getCause()方法可能会提供更详细的异常,例如,如果发生转换错误 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.7
-
setObject
default void setObject(String parameterName, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException
使用给定对象设置指定参数的值。 如果第二个参数是InputStream则流必须包含scaleOrLength指定的字节数。 如果第二个参数是Reader则阅读器必须包含scaleOrLength指定的字符数。 如果这些条件不成立,则在执行SQLException准备语句时,驱动程序将生成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
- 另请参见:
-
JDBCType,SQLType
-
setObject
default void setObject(String parameterName, Object x, SQLType targetSqlType) throws SQLException
使用给定对象设置指定参数的值。 此方法类似于setObject(String parameterName, Object x, SQLType targetSqlType, int scaleOrLength),不同之处在于它假设为零。默认实现将抛出
SQLFeatureNotSupportedException- 参数
-
parameterName- 参数的名称 -
x- 包含输入参数值的对象 -
targetSqlType- 要发送到数据库的SQL类型 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持指定的targetSqlType - 从以下版本开始:
- 1.8
- 另请参见:
-
JDBCType,SQLType
-
registerOutParameter
default void registerOutParameter(int parameterIndex, SQLType sqlType) throws SQLException将序号位置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- 如果parameterIndex无效; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持指定的sqlType - 从以下版本开始:
- 1.8
- 另请参见:
-
JDBCType,SQLType
-
registerOutParameter
default void registerOutParameter(int parameterIndex, SQLType sqlType, int scale) throws SQLException将序号位置parameterIndex的参数注册为JDBC类型sqlType。 必须在执行存储过程之前注册所有OUT参数。sqlType为OUT参数指定的JDBC类型确定必须在get方法中使用的Java类型,以读取该参数的值。这个版本
registerOutParameter当参数是JDBC类型应使用JDBCType.NUMERIC或JDBCType.DECIMAL。默认实现将抛出
SQLFeatureNotSupportedException- 参数
-
parameterIndex- 第一个参数是1,第二个参数是2,依此类推 -
sqlType- 由SQLType定义的JDBC类型代码,用于注册OUT参数。 -
scale- 小数点右侧所需的位数。 它必须大于或等于零。 - 异常
-
SQLException- 如果parameterIndex无效; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持指定的sqlType - 从以下版本开始:
- 1.8
- 另请参见:
-
JDBCType,SQLType
-
registerOutParameter
default void registerOutParameter(int parameterIndex, SQLType sqlType, String typeName) throws SQLException注册指定的输出参数。 此版本的方法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- 如果parameterIndex无效; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持指定的sqlType - 从以下版本开始:
- 1.8
- 另请参见:
-
JDBCType,SQLType
-
registerOutParameter
default void registerOutParameter(String parameterName, SQLType sqlType) throws SQLException
将名为parameterName的OUT参数注册到JDBC类型sqlType。 必须在执行存储过程之前注册所有OUT参数。sqlType为OUT参数指定的JDBC类型确定必须在get方法中使用的Java类型,以读取该参数的值。如果预期要返回给此输出参数的JDBC类型是特定于该特定的数据库,
sqlType应该是JDBCType.OTHER或SQLType由该JDBC驱动程序支持..方法getObject(int)检索值。默认实现将抛出
SQLFeatureNotSupportedException- 参数
-
parameterName- 参数的名称 -
sqlType- 由SQLType定义的JDBC类型代码,用于注册OUT参数。 如果参数是JDBC类型JDBCType.NUMERIC或JDBCType.DECIMAL,则应使用接受比例值的registerOutParameter版本。 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持指定的sqlType或JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.8
- 另请参见:
-
JDBCType,SQLType
-
registerOutParameter
default void registerOutParameter(String parameterName, SQLType sqlType, int scale) throws SQLException
将名为parameterName的参数注册为JDBC类型sqlType。 必须在执行存储过程之前注册所有OUT参数。sqlType为OUT参数指定的JDBC类型确定必须在get方法中用于读取该参数值的Java类型。这个版本
registerOutParameter当参数是JDBC类型应使用JDBCType.NUMERIC或JDBCType.DECIMAL。默认实现将抛出
SQLFeatureNotSupportedException- 参数
-
parameterName- 参数的名称 -
sqlType- 由SQLType定义的JDBC类型代码,用于注册OUT参数。 -
scale- 小数点右侧所需的位数。 它必须大于或等于零。 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持指定的sqlType或JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.8
- 另请参见:
-
JDBCType,SQLType
-
registerOutParameter
default void registerOutParameter(String parameterName, SQLType sqlType, String typeName) throws SQLException
注册指定的输出参数。 此版本的方法registerOutParameter应该用于用户命名或REF输出参数。 用户命名类型的示例包括:STRUCT,DISTINCT,JAVA_OBJECT和命名数组类型。必须在执行存储过程之前注册所有OUT参数。
对于用户命名的参数,还应该给出参数的完全限定SQL类型名称,而REF参数要求给出引用类型的完全限定类型名称。 不需要类型代码和类型名称信息的JDBC驱动程序可能会忽略它。 但是,为了便携,应用程序应始终为用户命名和REF参数提供这些值。 虽然它适用于用户命名和REF参数,但此方法可用于注册任何JDBC类型的参数。 如果参数没有用户命名或REF类型,则忽略typeName参数。注意:读取out参数的值时,必须使用其Java类型XXX对应于参数的已注册SQL类型的
getXXX方法。默认实现将抛出
SQLFeatureNotSupportedException- 参数
-
parameterName- 参数的名称 -
sqlType- 由SQLType定义的JDBC类型代码,用于注册OUT参数。 -
typeName- SQL结构类型的完全限定名称 - 异常
-
SQLException- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement上调用此方法 -
SQLFeatureNotSupportedException- 如果JDBC驱动程序不支持指定的sqlType或JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.8
- 另请参见:
-
JDBCType,SQLType
-
-