-
- 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参数值使用继承自
PreparedStatement
的set
方法设置。 所有OUT参数的类型必须在执行存储过程之前进行注册; 它们的值通过这里提供的get
方法在执行后被检索。A
CallableStatement
可以返回一个ResultSet
对象或多个ResultSet
对象。 多个ResultSet
对象使用继承自Statement
的操作来处理。为了最大的可移植性,调用的
ResultSet
对象和更新计数应该在获得输出参数的值进行处理。- 从以下版本开始:
- 1.1
- 另请参见:
-
Connection.prepareCall(java.lang.String)
,ResultSet
-
-
Field Summary
-
Fields inherited from 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 弃用的方法 Modifier and Type 方法 描述 Array
getArray(int parameterIndex)
以Java编程语言的形式获取指定的JDBCARRAY
参数的值作为Array
对象。Array
getArray(String parameterName)
BigDecimal
getBigDecimal(int parameterIndex)
将指定的JDBCNUMERIC
参数的值作为java.math.BigDecimal
对象检索,该对象的值包含小数点右侧的数字。BigDecimal
getBigDecimal(int parameterIndex, int scale)
已过时。使用getBigDecimal(int parameterIndex)
或getBigDecimal(String parameterName)
BigDecimal
getBigDecimal(String parameterName)
以java.math.BigDecimal
对象的形式java.math.BigDecimal
JDBCNUMERIC
参数的值,该对象的值包含小数点右侧的数字。Blob
getBlob(int parameterIndex)
以Java编程语言的形式获取指定的JDBCBLOB
参数的值作为Blob
对象。Blob
getBlob(String parameterName)
boolean
getBoolean(int parameterIndex)
获取指定的JDBC的价值BIT
或者BOOLEAN
作为参数boolean
Java编程语言。boolean
getBoolean(String parameterName)
以Java编程语言中的boolean
JDBCBIT
或BOOLEAN
参数的值。byte
getByte(int parameterIndex)
以Java编程语言中的byte
指定的JDBCTINYINT
参数的值。byte
getByte(String parameterName)
以Java编程语言中的byte
JDBCTINYINT
参数的值。byte[]
getBytes(int parameterIndex)
将指定的JDBCBINARY
或VARBINARY
参数的值作为Java编程语言中的byte
值的数组byte
。byte[]
getBytes(String parameterName)
检索JDBCBINARY
或VARBINARY
参数的值,作为Java编程语言中的byte
值。Reader
getCharacterStream(int parameterIndex)
以Java编程语言的形式获取指定参数的值作为java.io.Reader
对象。Reader
getCharacterStream(String parameterName)
以Java编程语言的形式获取指定参数的值作为java.io.Reader
对象。Clob
getClob(int parameterIndex)
以Java编程语言的形式获取指定的JDBCCLOB
参数的值作为java.sql.Clob
对象。Clob
getClob(String parameterName)
以Java编程语言中的java.sql.Clob
对象获取JDBCCLOB
参数的值。Date
getDate(int parameterIndex)
以java.sql.Date
对象的形式获取指定的JDBCDATE
参数的值。Date
getDate(int parameterIndex, Calendar cal)
检索指定的JDBCDATE
参数的值作为java.sql.Date
对象,使用给定的Calendar
对象构造日期。Date
getDate(String parameterName)
检索作为java.sql.Date
对象的JDBCDATE
参数的值。Date
getDate(String parameterName, Calendar cal)
检索JDBCDATE
参数的值作为java.sql.Date
对象,使用给定的Calendar
对象构造日期。double
getDouble(int parameterIndex)
以Java编程语言中的double
指定的JDBCDOUBLE
参数的值。double
getDouble(String parameterName)
以Java编程语言中的double
JDBCDOUBLE
参数的值。float
getFloat(int parameterIndex)
以Java编程语言中的float
指定的JDBCFLOAT
参数的值。float
getFloat(String parameterName)
以Java编程语言中的float
JDBCFLOAT
参数的值。int
getInt(int parameterIndex)
以Java编程语言中的int
指定的JDBCINTEGER
参数的值。int
getInt(String parameterName)
以Java编程语言中的int
JDBCINTEGER
参数的值。long
getLong(int parameterIndex)
以Java编程语言中的long
指定的JDBCBIGINT
参数的值。long
getLong(String parameterName)
以Java编程语言中的long
JDBCBIGINT
参数的值。Reader
getNCharacterStream(int parameterIndex)
以Java编程语言中的java.io.Reader
对象获取指定参数的值。Reader
getNCharacterStream(String parameterName)
以Java编程语言的形式获取指定参数的值作为java.io.Reader
对象。NClob
getNClob(int parameterIndex)
以Java编程语言的形式获取指定的JDBCNCLOB
参数的值作为java.sql.NClob
对象。NClob
getNClob(String parameterName)
以Java编程语言作为java.sql.NClob
对象检索JDBCNCLOB
参数的值。String
getNString(int parameterIndex)
检索指定的值NCHAR
,NVARCHAR
或者LONGNVARCHAR
参数为String
的Java编程语言。String
getNString(String parameterName)
检索指定的值NCHAR
,NVARCHAR
或者LONGNVARCHAR
参数为String
的Java编程语言。Object
getObject(int parameterIndex)
以Java编程语言中的Object
指定参数的值。<T> T
getObject(int parameterIndex, Class<T> type)
返回表示OUT参数parameterIndex
的值的对象,并将转换为参数的SQL类型到所请求的Java数据类型,如果支持转换。Object
getObject(int parameterIndex, Map<String,Class<?>> map)
返回表示OUT参数parameterIndex
的值的对象,并使用map
作为参数值的自定义映射。Object
getObject(String parameterName)
以Java编程语言中的Object
参数的值。<T> T
getObject(String parameterName, Class<T> type)
返回表示OUT参数值parameterName
的值的对象,如果支持转换,则将从参数的SQL类型转换为请求的Java数据类型。Object
getObject(String parameterName, Map<String,Class<?>> map)
返回表示OUT参数parameterName
的值的对象,并使用map
作为参数值的自定义映射。Ref
getRef(int parameterIndex)
以Java编程语言的形式获取指定的JDBCREF(<structured-type>)
参数的值作为Ref
对象。Ref
getRef(String parameterName)
RowId
getRowId(int parameterIndex)
以java.sql.RowId
对象的形式获取指定的JDBCROWID
参数的值。RowId
getRowId(String parameterName)
以java.sql.RowId
对象的形式获取指定的JDBCROWID
参数的值。short
getShort(int parameterIndex)
以Java编程语言中的short
指定的JDBCSMALLINT
参数的值。short
getShort(String parameterName)
以Java编程语言short
JDBCSMALLINT
参数的值作为short
。SQLXML
getSQLXML(int parameterIndex)
以Java编程语言中的java.sql.SQLXML
对象获取指定的SQL XML
参数的值。SQLXML
getSQLXML(String parameterName)
以Java编程语言作为java.sql.SQLXML
对象检索指定的SQL XML
参数的值。String
getString(int parameterIndex)
以Java编程语言中的CHAR
VARCHAR
指定的JDBCCHAR
或LONGVARCHAR
参数的String
。String
getString(String parameterName)
检索JDBC的价值CHAR
,VARCHAR
,或LONGVARCHAR
参数为String
的Java编程语言。Time
getTime(int parameterIndex)
以java.sql.Time
对象的形式获取指定的JDBCTIME
参数的值。Time
getTime(int parameterIndex, Calendar cal)
检索指定的JDBC的TIME
参数为java.sql.Time
对象,使用给定的Calendar
对象构建时间。Time
getTime(String parameterName)
检索作为java.sql.Time
对象的JDBCTIME
参数的值。Time
getTime(String parameterName, Calendar cal)
检索JDBCTIME
参数的值作为java.sql.Time
对象,使用给定的Calendar
对象构造时间。Timestamp
getTimestamp(int parameterIndex)
以java.sql.Timestamp
对象的形式获取指定的JDBCTIMESTAMP
参数的值。Timestamp
getTimestamp(int parameterIndex, Calendar cal)
将指定的JDBCTIMESTAMP
参数的值作为java.sql.Timestamp
对象java.sql.Timestamp
,使用给定的Calendar
对象构造Timestamp
对象。Timestamp
getTimestamp(String parameterName)
检索作为java.sql.Timestamp
对象的JDBCTIMESTAMP
参数的值。Timestamp
getTimestamp(String parameterName, Calendar cal)
检索JDBCTIMESTAMP
参数的值作为java.sql.Timestamp
对象,使用给定的Calendar
对象来构造Timestamp
对象。URL
getURL(int parameterIndex)
将指定的JDBCDATALINK
参数的值检索为java.net.URL
对象。URL
getURL(String parameterName)
检索作为java.net.URL
对象的JDBCDATALINK
参数的值。void
registerOutParameter(int parameterIndex, int sqlType)
将序号parameterIndex
的OUT参数注册到JDBC类型sqlType
。void
registerOutParameter(int parameterIndex, int sqlType, int scale)
将序号parameterIndex
的参数注册为JDBC类型sqlType
。void
registerOutParameter(int parameterIndex, int sqlType, String typeName)
注册指定的输出参数。default void
registerOutParameter(int parameterIndex, SQLType sqlType)
将序号parameterIndex
的OUT参数注册到JDBC类型sqlType
。default void
registerOutParameter(int parameterIndex, SQLType sqlType, int scale)
将序号parameterIndex
的参数注册为JDBC类型sqlType
。default void
registerOutParameter(int parameterIndex, SQLType sqlType, String typeName)
注册指定的输出参数。void
registerOutParameter(String parameterName, int sqlType)
将名为parameterName
的OUT参数注册到JDBC类型sqlType
。void
registerOutParameter(String parameterName, int sqlType, int scale)
将名为parameterName
的参数注册为JDBC类型sqlType
。void
registerOutParameter(String parameterName, int sqlType, String typeName)
注册指定的输出参数。default void
registerOutParameter(String parameterName, SQLType sqlType)
将名为parameterName
的OUT参数注册到JDBC类型sqlType
。default void
registerOutParameter(String parameterName, SQLType sqlType, int scale)
将名为parameterName
的参数注册为JDBC类型sqlType
。default void
registerOutParameter(String parameterName, SQLType sqlType, String typeName)
注册指定的输出参数。void
setAsciiStream(String parameterName, InputStream x)
将指定的参数设置为给定的输入流。void
setAsciiStream(String parameterName, InputStream x, int length)
将指定的参数设置为给定的输入流,它将具有指定的字节数。void
setAsciiStream(String parameterName, InputStream x, long length)
将指定的参数设置为给定的输入流,它将具有指定的字节数。void
setBigDecimal(String parameterName, BigDecimal x)
将指定的参数设置为给定的java.math.BigDecimal
值。void
setBinaryStream(String parameterName, InputStream x)
将指定的参数设置为给定的输入流。void
setBinaryStream(String parameterName, InputStream x, int length)
将指定的参数设置为给定的输入流,它将具有指定的字节数。void
setBinaryStream(String parameterName, InputStream x, long length)
将指定的参数设置为给定的输入流,它将具有指定的字节数。void
setBlob(String parameterName, InputStream inputStream)
将指定的参数设置为InputStream
对象。void
setBlob(String parameterName, InputStream inputStream, long length)
将指定的参数设置为InputStream
对象。void
setBlob(String parameterName, Blob x)
将指定的参数设置为给定的java.sql.Blob
对象。void
setBoolean(String parameterName, boolean x)
将指定的参数设置为给定的Javaboolean
值。void
setByte(String parameterName, byte x)
将指定的参数设置为给定的Javabyte
值。void
setBytes(String parameterName, byte[] x)
将指定的参数设置为给定的Java字节数组。void
setCharacterStream(String parameterName, Reader reader)
将指定的参数设置为给定的Reader
对象。void
setCharacterStream(String parameterName, Reader reader, int length)
将指定的参数设置为给定的Reader
对象,这是给定的长度的字符数。void
setCharacterStream(String parameterName, Reader reader, long length)
将指定的参数设置为给定的Reader
对象,这是给定的长度的字符数。void
setClob(String parameterName, Reader reader)
将指定的参数设置为Reader
对象。void
setClob(String parameterName, Reader reader, long length)
将指定的参数设置为Reader
对象。void
setClob(String parameterName, Clob x)
将指定的参数设置为给定的java.sql.Clob
对象。void
setDate(String parameterName, Date x)
使用运行应用程序的虚拟机的默认时区将指定的参数设置为给定的java.sql.Date
值。void
setDate(String parameterName, Date x, Calendar cal)
将指定的参数设置为给定的java.sql.Date
值,使用给定的Calendar
对象。void
setDouble(String parameterName, double x)
将指定的参数设置为给定的Javadouble
值。void
setFloat(String parameterName, float x)
将指定的参数设置为给定的Javafloat
值。void
setInt(String parameterName, int x)
将指定的参数设置为给定的Javaint
值。void
setLong(String parameterName, long x)
将指定的参数设置为给定的Javalong
值。void
setNCharacterStream(String parameterName, Reader value)
将指定的参数设置为Reader
对象。void
setNCharacterStream(String parameterName, Reader value, long length)
将指定的参数设置为Reader
对象。void
setNClob(String parameterName, Reader reader)
将指定的参数设置为Reader
对象。void
setNClob(String parameterName, Reader reader, long length)
将指定的参数设置为Reader
对象。void
setNClob(String parameterName, NClob value)
将指定的参数设置为java.sql.NClob
对象。void
setNString(String parameterName, String value)
将指定的参数设置为给定的String
对象。void
setNull(String parameterName, int sqlType)
将指定的参数设置为SQLNULL
。void
setNull(String parameterName, int sqlType, String typeName)
将指定的参数设置为SQLNULL
。void
setObject(String parameterName, Object x)
使用给定对象设置指定参数的值。void
setObject(String parameterName, Object x, int targetSqlType)
使用给定对象设置指定参数的值。void
setObject(String parameterName, Object x, int targetSqlType, int scale)
使用给定对象设置指定参数的值。default void
setObject(String parameterName, Object x, SQLType targetSqlType)
使用给定对象设置指定参数的值。default void
setObject(String parameterName, Object x, SQLType targetSqlType, int scaleOrLength)
使用给定对象设置指定参数的值。void
setRowId(String parameterName, RowId x)
将指定的参数设置为给定的java.sql.RowId
对象。void
setShort(String parameterName, short x)
将指定的参数设置为给定的Javashort
值。void
setSQLXML(String parameterName, SQLXML xmlObject)
将指定的参数设置为给定的java.sql.SQLXML
对象。void
setString(String parameterName, String x)
将指定的参数设置为给定的JavaString
值。void
setTime(String parameterName, Time x)
将指定的参数设置为给定的java.sql.Time
值。void
setTime(String parameterName, Time x, Calendar cal)
使用给定的Calendar
对象将指定的参数设置为给定的java.sql.Time
值。void
setTimestamp(String parameterName, Timestamp x)
将指定的参数设置为给定的java.sql.Timestamp
值。void
setTimestamp(String parameterName, Timestamp x, Calendar cal)
使用给定的Calendar
对象将指定的参数设置为给定的java.sql.Timestamp
值。void
setURL(String parameterName, URL val)
将指定的参数设置为给定的java.net.URL
对象。boolean
wasNull()
检索读取的最后一个OUT参数的值是否为SQLNULL
。-
Methods inherited from interface 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
-
Methods inherited from interface 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
-
Methods inherited from interface java.sql.Wrapper
isWrapperFor, unwrap
-
-
-
-
方法详细信息
-
registerOutParameter
void registerOutParameter(int parameterIndex, int sqlType) throws SQLException
将序号parameterIndex
的OUT参数注册到JDBC类型sqlType
。 所有OUT参数必须在执行存储过程之前进行注册。对于OUT参数,由
sqlType
指定的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参数必须在执行存储过程之前进行注册。对于OUT参数,由
sqlType
指定的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
没有null
。- 结果
-
true
如果最后一个参数读取为SQLNULL
; 否则为false
- 异常
-
SQLException
- 如果发生数据库访问错误或此方法在关闭的CallableStatement
调用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编程语言的形式获取指定的JDBCBIT
或BOOLEAN
参数的值作为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
已过时。 使用getBigDecimal(int parameterIndex)
或getBigDecimal(String parameterName)
将指定的JDBCNUMERIC
参数的值作为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
以Java编程语言中的byte
数组的形式byte
指定的JDBCBINARY
或VARBINARY
参数的值。- 参数
-
parameterIndex
- 第一个参数是1,第二个是2,依此类推 - 结果
-
参数值。
如果值为SQL
NULL
,则结果为null
。 - 异常
-
SQLException
- 如果parameterIndex无效; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 - 另请参见:
-
setBytes(java.lang.String, byte[])
-
getDate
Date getDate(int parameterIndex) throws SQLException
以java.sql.Date
对象的形式获取指定的JDBCDATE
参数的值。- 参数
-
parameterIndex
- 第一个参数是1,第二个是2,依此类推 - 结果
-
参数值。
如果值为SQL
NULL
,则结果为null
。 - 异常
-
SQLException
- 如果parameterIndex无效; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 - 另请参见:
-
setDate(java.lang.String, java.sql.Date)
-
getTime
Time getTime(int parameterIndex) throws SQLException
以java.sql.Time
对象的形式获取指定的JDBCTIME
参数的值。- 参数
-
parameterIndex
- 第一个参数是1,第二个是2,依此类推 - 结果
-
参数值。
如果值为SQL
NULL
,则结果为null
。 - 异常
-
SQLException
- 如果parameterIndex无效; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 - 另请参见:
-
setTime(java.lang.String, java.sql.Time)
-
getTimestamp
Timestamp getTimestamp(int parameterIndex) throws SQLException
以java.sql.Timestamp
对象的形式获取指定的JDBCTIMESTAMP
参数的值。- 参数
-
parameterIndex
- 第一个参数是1,第二个是2,依此类推 - 结果
-
参数值。
如果值为SQL
NULL
,则结果为null
。 - 异常
-
SQLException
- 如果parameterIndex无效; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 - 另请参见:
-
setTimestamp(java.lang.String, java.sql.Timestamp)
-
getObject
Object getObject(int parameterIndex) throws SQLException
以Java编程语言中的Object
指定参数的值。 如果值为SQLNULL
,则驱动程序返回一个Javanull
。此方法返回一个Java对象,其类型对应于使用方法
registerOutParameter
为此参数注册的JDBC类型。 通过将目标JDBC类型注册为java.sql.Types.OTHER
,此方法可用于读取特定于数据库的抽象数据类型。- 参数
-
parameterIndex
- 第一个参数是1,第二个是2,依此类推 - 结果
-
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
对象NUMERIC
,该对象的值包含小数点右侧的数字。- 参数
-
parameterIndex
- 第一个参数是1,第二个是2,依此类推 - 结果
-
参数值全精度。
如果值为SQL
NULL
,结果为null
。 - 异常
-
SQLException
- 如果parameterIndex无效; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 - 从以下版本开始:
- 1.2
- 另请参见:
-
setBigDecimal(java.lang.String, java.math.BigDecimal)
-
getObject
Object getObject(int parameterIndex, Map<String,Class<?>> map) throws SQLException
返回表示OUT参数值parameterIndex
的对象,并使用map
作为参数值的自定义映射。此方法返回一个Java对象,其类型对应于使用方法
registerOutParameter
为该参数注册的JDBC类型。 通过将目标JDBC类型注册为java.sql.Types.OTHER
,此方法可用于读取数据库特定的抽象数据类型。- 参数
-
parameterIndex
- 第一个参数是1,第二个是2,依此类推 -
map
- 从SQL类型名称到Java类的映射 - 结果
-
一个
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编程语言的形式获取指定的JDBCREF(<structured-type>)
参数的值作为Ref
对象。- 参数
-
parameterIndex
- 第一个参数是1,第二个是2,依此类推 - 结果
-
参数值为Java编程语言中的一个
Ref
对象。 如果值为SQLNULL
,则返回值null
。 - 异常
-
SQLException
- 如果parameterIndex无效; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getBlob
Blob getBlob(int parameterIndex) throws SQLException
以Java编程语言的形式获取指定的JDBCBLOB
参数的值作为Blob
对象。- 参数
-
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
参数的值作为java.sql.Clob
对象。- 参数
-
parameterIndex
- 第一个参数是1,第二个是2,依此类推 - 结果
-
Clob
如果值为SQLNULL
,则返回值null
。 - 异常
-
SQLException
- 如果parameterIndex无效; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
getArray
Array getArray(int parameterIndex) throws SQLException
以Java编程语言的形式获取指定的JDBCARRAY
参数的值作为2705898377907对象。- 参数
-
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
对象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
将指定的JDBCTIMESTAMP
参数的值作为java.sql.Timestamp
对象java.sql.Timestamp
,使用给定的Calendar
对象构造Timestamp
对象。 使用Calendar
对象,驱动程序可以计算考虑到自定义时区和区域设置的时间戳。 如果未指定Calendar
对象,则驱动程序将使用默认的时区和区域设置。- 参数
-
parameterIndex
- 第一个参数是1,第二个是2,依此类推 -
cal
- 驱动程序将用于构建时间戳的Calendar
对象 - 结果
-
参数值。
如果值为SQL
NULL
,则结果为null
。 - 异常
-
SQLException
- 如果parameterIndex无效; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 - 从以下版本开始:
- 1.2
- 另请参见:
-
setTimestamp(java.lang.String, java.sql.Timestamp)
-
registerOutParameter
void registerOutParameter(int parameterIndex, int sqlType, String typeName) throws SQLException
注册指定的输出参数。 此版本的方法registerOutParameter
应用于用户定义或REF
输出参数。 的用户定义类型的实例包括:STRUCT
,DISTINCT
,JAVA_OBJECT
,和指定数组类型。所有OUT参数必须在执行存储过程之前进行注册。
对于用户定义的参数,还应该给出参数的完全限定的SQL类型名称,而
REF
参数要求给出引用类型的完全限定类型名称。 不需要类型代码和类型名称信息的JDBC驱动程序可能会忽略它。 然而,为了便于携带,应用程序应始终为用户定义和REF
参数提供这些值。 虽然是为用户定义的和REF
参数,该方法可以被用于注册任何JDBC类型的参数。 如果该参数不具有用户定义或REF
类型,则typeName参数将被忽略。注意:读取out参数的值时,必须使用Java类型对应于参数的注册SQL类型的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参数必须在执行存储过程之前进行注册。对于OUT参数,由
sqlType
指定的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参数必须在执行存储过程之前进行注册。对于OUT参数,由
sqlType
指定的JDBC类型决定了在get
方法中必须使用的Java类型,以读取该参数的值。这个版本
registerOutParameter
当参数是JDBC类型应使用NUMERIC
或DECIMAL
。- 参数
-
parameterName
- 参数的名称 -
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驱动程序不支持此数据类型,或者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不对应于named参数; 如果发生数据库访问错误或在关闭的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,... - 结果
-
一个
java.net.URL
对象,表示用作指定参数的JDBCDATALINK
值 - 异常
-
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
或网址格式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不对应于named参数; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
setBoolean
void setBoolean(String parameterName, boolean x) throws SQLException
将指定的参数设置为给定的Javaboolean
值。 当驱动程序将其发送到数据库时将其转换为SQLBIT
或BOOLEAN
值。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果发生数据库访问错误或在关闭的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不对应于named参数; 如果发生数据库访问错误或在关闭的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不对应于named参数; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
getFloat(int)
-
setDouble
void setDouble(String parameterName, double x) throws SQLException
将指定的参数设置为给定的Javadouble
值。 当驱动程序将其发送到数据库时,将其转换为SQLDOUBLE
值。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
getDouble(int)
-
setBigDecimal
void setBigDecimal(String parameterName, BigDecimal x) throws SQLException
将指定的参数设置为给定的java.math.BigDecimal
值。 当驱动程序将其发送到数据库时,将其转换为SQLNUMERIC
值。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果发生数据库访问错误或在关闭的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不对应于named参数; 如果发生数据库访问错误或在关闭的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不对应于named参数; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
getDate(int)
-
setTime
void setTime(String parameterName, Time x) throws SQLException
将指定的参数设置为给定的java.sql.Time
值。 当驱动程序将其发送到数据库时,将其转换为SQLTIME
值。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果发生数据库访问错误或在关闭的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到数据库字符格式进行任何必要的转换。注意:此流对象可以是标准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不对应于named参数; 如果发生数据库访问错误或在关闭的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
- 对于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不对应于named参数; 如果发生数据库访问错误或在关闭的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到数据库字符格式进行任何必要的转换。注意:此流对象可以是标准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
值,然后驱动程序将其发送到数据库。 使用aaCalendar
对象,驱动程序可以计算考虑到自定义时区的日期。 如果未指定Calendar
对象,则驱动程序将使用默认时区,即运行应用程序的虚拟机的时区。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 -
cal
- 驱动程序将用于构建日期的Calendar
对象 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
getDate(int)
-
setTime
void setTime(String parameterName, Time x, Calendar cal) throws SQLException
使用给定的Calendar
对象将指定的参数设置为给定的java.sql.Time
值。 驱动程序使用Calendar
对象来构造一个SQLTIME
值,然后驱动程序将其发送到数据库。 使用aaCalendar
对象,驱动程序可以计算考虑到自定义时区的时间。 如果没有指定Calendar
对象,则驱动程序使用默认时区,即运行应用程序的虚拟机的时区。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 -
cal
- 驱动程序将用于构建时间的Calendar
对象 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
getTime(int)
-
setTimestamp
void setTimestamp(String parameterName, Timestamp x, Calendar cal) throws SQLException
使用给定的Calendar
对象将指定的参数设置为给定的java.sql.Timestamp
值。 驱动程序使用Calendar
对象来构造一个SQLTIMESTAMP
值,然后驱动程序将其发送到数据库。 使用aaCalendar
对象,驱动程序可以计算考虑到自定义时区的时间戳。 如果未指定Calendar
对象,则驱动程序使用默认时区,即运行应用程序的虚拟机的时区。- 参数
-
parameterName
- 参数的名称 -
x
- 参数值 -
cal
- 驱动程序将用于构建时间戳的Calendar
对象 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果发生数据库访问错误或在关闭的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参数,名称是引用类型的类型名称。
尽管它是用于用户定义的和参数的参数,但是该方法可以用于设置任何JDBC类型的空值参数。 如果参数没有用户定义或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不对应于named参数; 如果发生数据库访问错误或在关闭的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不对应于named参数; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
setBoolean(java.lang.String, boolean)
-
getByte
byte getByte(String parameterName) throws SQLException
以Java编程语言中的byte
JDBCTINYINT
参数的值。- 参数
-
parameterName
- 参数的名称 - 结果
-
参数值。
如果值为SQL
NULL
,则结果为0
。 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
setByte(java.lang.String, byte)
-
getShort
short getShort(String parameterName) throws SQLException
以Java编程语言中的short
JDBCSMALLINT
参数的值。- 参数
-
parameterName
- 参数的名称 - 结果
-
参数值。
如果值为SQL
NULL
,则结果为0
。 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果发生数据库访问错误或在关闭的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不对应于named参数; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
setInt(java.lang.String, int)
-
getLong
long getLong(String parameterName) throws SQLException
以Java编程语言中的long
JDBCBIGINT
参数的值。- 参数
-
parameterName
- 参数的名称 - 结果
-
参数值。
如果值为SQL
NULL
,则结果为0
。 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
setLong(java.lang.String, long)
-
getFloat
float getFloat(String parameterName) throws SQLException
以Java编程语言中的float
JDBCFLOAT
参数的值。- 参数
-
parameterName
- 参数的名称 - 结果
-
参数值。
如果值为SQL
NULL
,则结果为0
。 - 异常
-
SQLException
- 如果parameterName不对应于一个命名参数; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
setFloat(java.lang.String, float)
-
getDouble
double getDouble(String parameterName) throws SQLException
以Java编程语言中的double
JDBCDOUBLE
参数的值。- 参数
-
parameterName
- 参数的名称 - 结果
-
参数值。
如果值为SQL
NULL
,则结果为0
。 - 异常
-
SQLException
- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
setDouble(java.lang.String, double)
-
getBytes
byte[] getBytes(String parameterName) throws SQLException
以Java编程语言中的byte
数组的形式byte
JDBCBINARY
或VARBINARY
参数的值。- 参数
-
parameterName
- 参数的名称 - 结果
-
参数值。
如果值为SQL
NULL
,则结果为null
。 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果发生数据库访问错误或在关闭的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不对应于named参数; 如果发生数据库访问错误或在关闭的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
- 参数的名称 - 结果
-
A
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
检索JDBCNUMERIC
参数的值作为java.math.BigDecimal
对象,该值与小数点右边的数字一样多。- 参数
-
parameterName
- 参数的名称 - 结果
-
参数值全精度。
如果值为SQL
NULL
,则结果为null
。 - 异常
-
SQLException
- 如果parameterName不对应于命名参数; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
setBigDecimal(java.lang.String, java.math.BigDecimal)
-
getObject
Object getObject(String parameterName, Map<String,Class<?>> map) throws SQLException
返回表示OUT参数值parameterName
的对象,并使用map
作为参数值的自定义映射。此方法返回一个Java对象,其类型对应于使用方法
registerOutParameter
为该参数注册的JDBC类型。 通过将目标JDBC类型注册为java.sql.Types.OTHER
,此方法可用于读取数据库特定的抽象数据类型。- 参数
-
parameterName
- 参数的名称 -
map
- 从SQL类型名称到Java类的映射 - 结果
-
一个
java.lang.Object
持有OUT参数值 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果发生数据库访问错误或在关闭的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不对应于named参数; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
getBlob
Blob getBlob(String parameterName) throws SQLException
- 参数
-
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不对应于named参数; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
getArray
Array getArray(String parameterName) throws SQLException
以Java编程语言中的Array
对象获取JDBCARRAY
参数的值。- 参数
-
parameterName
- 参数的名称 - 结果
-
参数值为Java编程语言中的一个
Array
对象。 如果值为SQLNULL
,则返回值null
。 - 异常
-
SQLException
- 如果parameterName与命名参数不对应; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
getDate
Date getDate(String parameterName, Calendar cal) throws SQLException
检索JDBCDATE
参数的值作为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
检索JDBCTIMESTAMP
参数的值作为java.sql.Timestamp
对象,使用给定的Calendar
对象构造Timestamp
对象。 使用Calendar
对象,驱动程序可以计算考虑到自定义时区和区域设置的时间戳。 如果未指定Calendar
对象,则驱动程序将使用默认的时区和区域设置。- 参数
-
parameterName
- 参数的名称 -
cal
- 驱动程序将用于构建时间戳的Calendar
对象 - 结果
-
参数值。
如果值为SQL
NULL
,则结果为null
。 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
- 另请参见:
-
setTimestamp(java.lang.String, java.sql.Timestamp)
-
getURL
URL getURL(String parameterName) throws SQLException
以java.net.URL
对象的形式java.net.URL
JDBCDATALINK
参数的值。- 参数
-
parameterName
- 参数的名称 - 结果
-
参数值为Java编程语言中的一个
java.net.URL
对象。 如果值为SQLNULL
,则返回值null
。 - 异常
-
SQLException
- 如果parameterName与命名参数不对应; 如果发生数据库访问错误,此方法在关闭的CallableStatement
上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不对应于named参数; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
setNCharacterStream
void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException
将指定的参数设置为Reader
对象。Reader
读取数据,直到达到文件结尾。 驱动程序必须从Java字符格式转换为数据库中的国家字符集。- 参数
-
parameterName
- 要设置的参数的名称 -
value
- 参数值 -
length
- 参数数据中的字符数。 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误或在关闭的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不对应于named参数; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
setClob
void setClob(String parameterName, Reader reader, long length) throws SQLException
将指定的参数设置为Reader
对象。reader
必须包含由长度指定的字符数,否则在执行SQLException
将生成CallableStatement
。 该方法与setCharacterStream (int, Reader, int)
方法不同,因为它通知驱动程序参数值应该作为CLOB
发送到服务器。 当使用setCharacterStream
方法时,驱动程序可能需要额外的工作才能确定参数数据是否应作为LONGVARCHAR
或CLOB
发送到服务器- 参数
-
parameterName
- 要设置的参数的名称 -
reader
- 包含用于设置参数值的数据的对象。 -
length
- 参数数据中的字符数。 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果指定的长度小于零; 发生数据库访问错误,或者在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
setBlob
void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException
将指定的参数设置为InputStream
对象。Inputstream
必须包含由长度指定的字符数,否则当执行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
必须包含由长度指定的字符数,否则当执行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编程语言的形式获取指定的JDBCNCLOB
参数的值作为java.sql.NClob
对象。- 参数
-
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
参数的值作为java.sql.NClob
对象。- 参数
-
parameterName
- 参数的名称 - 结果
-
参数值为Java编程语言中的一个
NClob
对象。 如果值为SQLNULL
,则返回值null
。 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
setSQLXML
void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException
将指定的参数设置为给定的java.sql.SQLXML
对象。 当驱动程序将其发送到数据库时,将其转换为SQL XML
值。- 参数
-
parameterName
- 参数的名称 -
xmlObject
- 一个SQLXML
对象,绘制一个SQL XML
值 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果发生数据库访问错误; 这个方法被称为在关闭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不对应于named参数; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
getNString
String getNString(int parameterIndex) throws SQLException
检索指定的值NCHAR
,NVARCHAR
或者LONGNVARCHAR
参数为String
的Java编程语言。对于固定长度类型的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
参数为String
的Java编程语言。对于固定长度类型的JDBC
NCHAR
,返回的String
对象具有与数据库中具有的SQLNCHAR
值完全相同的值,包括数据库添加的任何填充。- 参数
-
parameterName
- 参数的名称 - 结果
-
一个
String
对象映射的NCHAR
,NVARCHAR
或LONGNVARCHAR
值 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果发生数据库访问错误或在关闭的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
,则返回的值为null
,在Java编程语言 - 异常
-
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
,则返回的值为null
(在Java编程语言中)。 - 异常
-
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不对应于named参数; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
setBlob
void setBlob(String parameterName, Blob x) throws SQLException
将指定的参数设置为给定的java.sql.Blob
对象。 当驱动程序将其发送到数据库时,将其转换为SQLBLOB
值。- 参数
-
parameterName
- 参数的名称 -
x
- 一个Blob
对象,映射SQLBLOB
值 - 异常
-
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到数据库字符格式进行任何必要的转换。注意:此流对象可以是标准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到数据库字符格式进行任何必要的转换。注意:此流对象可以是标准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到数据库字符格式进行任何必要的转换。注意:此流对象可以是标准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不对应于named参数; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
setCharacterStream
void setCharacterStream(String parameterName, Reader reader) throws SQLException
将指定的参数设置为给定的Reader
对象。 当将非常大的UNICODE值输入到LONGVARCHAR
参数时,通过java.io.Reader
对象发送它可能更实用。 数据将从流中读取,直到达到文件结尾。 JDBC驱动程序将从UNICODE到数据库字符格式进行任何必要的转换。注意:此流对象可以是标准Java流对象,也可以是实现标准接口的自己的子类。
注意:请参阅您的JDBC驱动程序文档,以确定使用需要长度参数的版本的
setCharacterStream
可能会更有效。- 参数
-
parameterName
- 参数的名称 -
reader
- 包含Unicode数据的java.io.Reader
对象 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
setNCharacterStream
void setNCharacterStream(String parameterName, Reader value) throws SQLException
将指定的参数设置为Reader
对象。Reader
读取数据,直到达到文件结尾。 驱动程序必须从Java字符格式转换为数据库中的国家字符集。注意:此流对象可以是标准Java流对象,也可以是实现标准接口的自己的子类。
注意:请参阅您的JDBC驱动程序文档,以确定使用需要长度参数的版本的
setNCharacterStream
可能会更有效。- 参数
-
parameterName
- 参数的名称 -
value
- 参数值 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果司机不支持国家字符集; 如果驱动程序可以检测到可能发生数据转换错误; 如果发生数据库访问错误; 或者这个方法在关闭的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不对应于named参数; 如果发生数据库访问错误或在关闭的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不对应于named参数; 如果发生数据库访问错误或在关闭的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, Class<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
- 如果不支持转换,type为null或发生另一个错误。 异常的getCause()方法可能会提供更详细的异常,例如,如果发生转换错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.7
-
getObject
<T> T getObject(String parameterName, Class<T> type) throws SQLException
返回表示OUT参数parameterName
的值的对象,并将转换为参数的SQL类型为所需的Java数据类型,如果支持转换。 如果转换不受支持或为该类型指定为空,则抛出SQLException
。至少,实现必须支持附录B表B-3中定义的转换,并将适当的用户定义的SQL类型转换为实现
SQLData
或Struct
的Java类型。 可以支持额外的转换,并定义供应商。- 参数类型
-
T
- 由此Class对象建模的类的类型 - 参数
-
parameterName
- 参数的名称 -
type
- 表示将指定参数转换为的Java数据类型的类。 - 结果
-
一个持有OUT参数值的
type
的实例 - 异常
-
SQLException
- 如果不支持转换,type为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
。在发送给数据库之前,给定的Java对象将被转换为给定的targetSqlType。 如果对象具有自定义映射(实现接口
SQLData
的类),则JDBC驱动程序应调用方法SQLData.writeSQL
将其写入SQL数据流。 如果,在另一方面,对象是实现一类Ref
,Blob
,Clob
,NClob
,Struct
,java.net.URL
,或Array
,驾驶员应把它传递给数据库作为相应SQL类型的值。请注意,此方法可能用于传递特定于数据库的抽象数据类型。
默认实现将抛出
SQLFeatureNotSupportedException
- 参数
-
parameterName
- 参数的名称 -
x
- 包含输入参数值的对象 -
targetSqlType
- 要发送到数据库的SQL类型。 比例参数可能进一步限定此类型。 -
scaleOrLength
- 对于java.sql.JDBCType.DECIMAL
或java.sql.JDBCType.NUMERIC types
,这是小数点后的位数。 对于Java对象类型InputStream
和Reader
,这是流或读取器中数据的长度。 对于所有其他类型,此值将被忽略。 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果发生数据库访问错误或在关闭的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不对应于named参数; 如果发生数据库访问错误或在关闭的CallableStatement
上调用此方法 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持指定的targetSqlType - 从以下版本开始:
- 1.8
- 另请参见:
-
JDBCType
,SQLType
-
registerOutParameter
default void registerOutParameter(int parameterIndex, SQLType sqlType) throws SQLException
将序号parameterIndex
的OUT参数注册到JDBC类型sqlType
。 所有OUT参数必须在执行存储过程之前进行注册。对于OUT参数,由
sqlType
指定的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参数必须在执行存储过程之前进行注册。对于OUT参数,由
sqlType
指定的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参数必须在执行存储过程之前进行注册。对于OUT参数,由
sqlType
指定的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不对应于named参数; 如果发生数据库访问错误或在关闭的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参数必须在执行存储过程之前进行注册。对于OUT参数,由
sqlType
指定的JDBC类型决定了在get
方法中必须使用的Java类型,以读取该参数的值。这个版本
registerOutParameter
当参数是JDBC类型应使用JDBCType.NUMERIC
或JDBCType.DECIMAL
。默认实现将抛出
SQLFeatureNotSupportedException
- 参数
-
parameterName
- 参数的名称 -
sqlType
- 由SQLType
定义的JDBC类型代码用于注册OUT参数。 -
scale
- 小数点右侧所需的数字位数。 它必须大于或等于零。 - 异常
-
SQLException
- 如果parameterName不对应于named参数; 如果发生数据库访问错误或在关闭的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
-
-