java.sql
介面 CallableStatement

所有父級介面：

PreparedStatement, Statement, Wrapper

public interface CallableStatement
extends PreparedStatement

用於執行 SQL 預儲程序的介面。JDBC API 提供了一個預儲程序 SQL 轉義語法，該語法允許對所有 RDBMS 使用標準方式調用預儲程序。此轉義語法有一個套件含結果參數的形式和一個不包含結果參數的形式。如果使用結果參數，則必須將其註冊為 OUT 參數。其他參數可用於輸入、輸出或同時用於二者。參數是根據編號按順序參考的，第一個參數的編號是 1。

   {?= call <procedure-name>[(<arg1>,<arg2>, ...)]}
   {call <procedure-name>[(<arg1>,<arg2>, ...)]}
 

IN 參數值是使用繼承自 PreparedStatement 的 set 方法設置的。在執行預儲程序之前，必須註冊所有 OUT 參數的型別；它們的值是在執行後通過此類別提供的 get 方法獲取的。

CallableStatement 可以返回一個 ResultSet 物件或多個 ResultSet 物件。多個 ResultSet 物件是使用繼承自 Statement 的操作處理的。

為了獲得最大的可移植性，某一調用的 ResultSet 物件和更新計數應該在獲得輸出參數的值之前處理。

另請參見：

Connection.prepareCall(java.lang.String), ResultSet

欄位摘要

從介面 java.sql.Statement 繼承的欄位

CLOSE_ALL_RESULTS, CLOSE_CURRENT_RESULT, EXECUTE_FAILED, KEEP_CURRENT_RESULT, NO_GENERATED_KEYS, RETURN_GENERATED_KEYS, SUCCESS_NO_INFO

方法摘要

Array	getArray(int parameterIndex) 以 Java 程式語言中 Array 物件的形式獲取指定的 JDBC ARRAY 參數的值。
Array	getArray(String parameterName) 以 Java 程式語言中 java.sql.ARRAY 物件的形式獲取 JDBC ARRAY 參數的值。
BigDecimal	getBigDecimal(int parameterIndex) 以 java.math.BigDecimal 物件的形式獲取指定 JDBC NUMERIC 參數的值，小數點右邊的位數與該參數值所包含的位數相同。
BigDecimal	getBigDecimal(int parameterIndex, int scale) 已過時。 使用 getBigDecimal(int parameterIndex) 或 getBigDecimal(String parameterName)
BigDecimal	getBigDecimal(String parameterName) 以 java.math.BigDecimal 物件的形式獲取 JDBC NUMERIC 參數的值，小數點右邊的位數與該參數值所包含的位數相同。
Blob	getBlob(int parameterIndex) 以 Java 程式語言中 java.sql.Clob 物件的形式獲取指定的 JDBC CLOB 參數的值。
Blob	getBlob(String parameterName) 以 Java 程式語言中 Blob 物件的形式獲取 JDBC BLOB 參數的值。
boolean	getBoolean(int parameterIndex) 以 Java 程式語言中 boolean 值的形式獲取指定的 JDBC BIT 或 BOOLEAN 參數的值。
boolean	getBoolean(String parameterName) 以 Java 程式語言中 boolean 值的形式獲取 JDBC BIT 或 BOOLEAN 參數的值。
byte	getByte(int parameterIndex) 以 Java 程式語言中 byte 的形式獲取指定的 JDBC TINYINT 參數的值。
byte	getByte(String parameterName) 以 Java 程式語言中 byte 值的形式獲取 JDBC TINYINT 參數的值。
byte[]	getBytes(int parameterIndex) 以 Java 程式語言中 byte 陣列值的形式獲取指定的 JDBC BINARY 或 VARBINARY 參數的值。
byte[]	getBytes(String parameterName) 以 Java 程式語言中 byte 陣列值的形式獲取 JDBC BINARY 或 VARBINARY 參數的值。
Reader	getCharacterStream(int parameterIndex) 以 Java 程式語言中 java.io.Reader 物件的形式獲取指定參數的值。
Reader	getCharacterStream(String parameterName) 以 Java 程式語言中 java.io.Reader 物件的形式獲取指定參數的值。
Clob	getClob(int parameterIndex) 以 Java 程式語言中 java.sql.Clob 物件的形式獲取指定的 JDBC CLOB 參數的值。
Clob	getClob(String parameterName) 以 Java 程式語言中 java.sql.CLOB 物件的形式獲取 JDBC CLOB 參數的值。
Date	getDate(int parameterIndex) 以 java.sql.Date 物件的形式獲取指定 JDBC DATE 參數的值。
Date	getDate(int parameterIndex, Calendar cal) 以 java.sql.Date 物件的形式獲取指定 JDBC DATE 參數的值，使用給定 Calendar 物件建構日期。
Date	getDate(String parameterName) 以 java.sql.Date 物件的形式獲取 JDBC DATE 參數的值。
Date	getDate(String parameterName, Calendar cal) 以 java.sql.Date 物件的形式獲取 JDBC DATE 參數的值，使用給定 Calendar 物件建構日期。
double	getDouble(int parameterIndex) 以 Java 程式語言中 double 值的形式獲取指定的 JDBC DOUBLE 參數的值。
double	getDouble(String parameterName) 以 Java 程式語言中 double 值的形式獲取 JDBC DOUBLE 參數的值。
float	getFloat(int parameterIndex) 以 Java 程式語言中 float 值的形式獲取指定的 JDBC FLOAT 參數的值。
float	getFloat(String parameterName) 以 Java 程式語言中 float 值的形式獲取 JDBC FLOAT 參數的值。
int	getInt(int parameterIndex) 以 Java 程式語言中 int 值的形式獲取指定的 JDBC INTEGER 參數的值。
int	getInt(String parameterName) 以 Java 程式語言中 int 值的形式獲取 JDBC INTEGER 參數的值。
long	getLong(int parameterIndex) 以 Java 程式語言中 long 值的形式獲取指定的 JDBC BIGINT 參數的值。
long	getLong(String parameterName) 以 Java 程式語言中 long 值的形式獲取 JDBC BIGINT 參數的值。
Reader	getNCharacterStream(int parameterIndex) 以 Java 程式語言中 java.io.Reader 物件的形式獲取指定參數的值。
Reader	getNCharacterStream(String parameterName) 以 Java 程式語言中 java.io.Reader 物件的形式獲取指定參數的值。
NClob	getNClob(int parameterIndex) 以 Java 程式語言中 java.sql.NClob 物件的形式獲取指定的 JDBC NCLOB 參數的值。
NClob	getNClob(String parameterName) 以 Java 程式語言中 java.sql.NClob 物件的形式獲取 JDBC NCLOB 參數的值。
String	getNString(int parameterIndex) 以 Java 程式語言中 String 的形式獲取指定的 NCHAR、NVARCHAR 或 LONGNVARCHAR 參數的值。
String	getNString(String parameterName) 以 Java 程式語言中 String 的形式獲取指定的 NCHAR、NVARCHAR 或 LONGNVARCHAR 參數的值。
Object	getObject(int parameterIndex) 以 Java 程式語言中 Object 的形式獲取指定參數的值。
Object	getObject(int parameterIndex, Map<String,Class<?>> map) 返回一個表示 OUT 參數 parameterIndex 值的物件，並將 map 用於該參數值的自定義映射關係。
Object	getObject(String parameterName) 以 Java 程式語言中 Object 的形式獲取參數的值。
Object	getObject(String parameterName, Map<String,Class<?>> map) 返回一個表示 OUT 參數 parameterName 值的物件，並將 map 用於該參數值的自定義映射關係。
Ref	getRef(int parameterIndex) 以 Java 程式語言中 Ref 物件的形式獲取指定的 JDBC REF(<structured-type>) 參數的值。
Ref	getRef(String parameterName) 以 Java 程式語言中 Ref 物件的形式獲取 JDBC REF(<structured-type>) 參數的值。
RowId	getRowId(int parameterIndex) 以 java.sql.RowId 物件的形式獲取指定 JDBC ROWID 參數的值。
RowId	getRowId(String parameterName) 以 java.sql.RowId 物件的形式獲取指定 JDBC ROWID 參數的值。
short	getShort(int parameterIndex) 以 Java 程式語言中 short 值的形式獲取指定的 JDBC SMALLINT 參數的值。
short	getShort(String parameterName) 以 Java 程式語言中 short 值的形式獲取 JDBC SMALLINT 參數的值。
SQLXML	getSQLXML(int parameterIndex) 以 Java 程式語言中 java.sql.SQLXML 物件的形式獲取指定的 SQL XML 參數的值。
SQLXML	getSQLXML(String parameterName) 以 Java 程式語言中 java.sql.SQLXML 物件的形式獲取指定的 SQL XML 參數的值。
String	getString(int parameterIndex) 以 Java 程式語言中 String 的形式獲取指定的 JDBC CHAR、VARCHAR 或 LONGVARCHAR 參數的值。
String	getString(String parameterName) 以 Java 程式語言中 String 的形式獲取 JDBC CHAR、VARCHAR 或 LONGVARCHAR 參數的值。
Time	getTime(int parameterIndex) 以 java.sql.Time 物件的形式獲取指定 JDBC TIME 參數的值。
Time	getTime(int parameterIndex, Calendar cal) 以 java.sql.Time 物件的形式獲取指定 JDBC TIME 參數的值，使用給定 Calendar 物件建構時間。
Time	getTime(String parameterName) 以 java.sql.Time 物件的形式獲取 JDBC TIME 參數的值。
Time	getTime(String parameterName, Calendar cal) 以 java.sql.Time 物件的形式獲取 JDBC TIME 參數的值，使用給定 Calendar 物件建構時間。
Timestamp	getTimestamp(int parameterIndex) 以 java.sql.Timestamp 物件的形式獲取指定 JDBC TIMESTAMP 參數的值。
Timestamp	getTimestamp(int parameterIndex, Calendar cal) 以 java.sql.Timestamp 物件的形式獲取指定 JDBC TIMESTAMP 參數的值，使用給定 Calendar 物件建構 Timestamp 物件。
Timestamp	getTimestamp(String parameterName) 以 java.sql.Timestamp 物件的形式獲取 JDBC TIMESTAMP 參數的值。
Timestamp	getTimestamp(String parameterName, Calendar cal) 以 java.sql.Timestamp 物件的形式獲取 JDBC TIMESTAMP 參數的值，使用給定 Calendar 物件建構 Timestamp 物件。
URL	getURL(int parameterIndex) 以 java.sql.URL 物件的形式獲取指定 JDBC DATALINK 參數的值。
URL	getURL(String parameterName) 以 java.net.URL 物件的形式獲取 JDBC DATALINK 參數的值。
void	registerOutParameter(int parameterIndex, int sqlType) 按順序位置 parameterIndex 將 OUT 參數註冊為 JDBC 型別 sqlType。
void	registerOutParameter(int parameterIndex, int sqlType, int scale) 按順序位置 parameterIndex 將參數註冊為 JDBC 型別 sqlType。
void	registerOutParameter(int parameterIndex, int sqlType, String typeName) 註冊指定的輸出參數。
void	registerOutParameter(String parameterName, int sqlType) 將名為 parameterName 的 OUT 參數註冊為 JDBC 型別 sqlType。
void	registerOutParameter(String parameterName, int sqlType, int scale) 將名為 parameterName 的參數註冊為 JDBC 型別 sqlType。
void	registerOutParameter(String parameterName, int sqlType, String typeName) 註冊指定的輸出參數。
void	setAsciiStream(String parameterName, InputStream x) 將指定參數設置為給定輸入串流。
void	setAsciiStream(String parameterName, InputStream x, int length) 將指定參數設置為給定輸入串流，該輸入串流將擁有指定的位元組數。
void	setAsciiStream(String parameterName, InputStream x, long length) 將指定參數設置為給定輸入串流，該輸入串流將擁有指定的位元組數。
void	setBigDecimal(String parameterName, BigDecimal x) 將指定參數設置為給定 java.math.BigDecimal 值。
void	setBinaryStream(String parameterName, InputStream x) 將指定參數設置為給定輸入串流。
void	setBinaryStream(String parameterName, InputStream x, int length) 將指定參數設置為給定輸入串流，該輸入串流將擁有指定的位元組數。
void	setBinaryStream(String parameterName, InputStream x, long length) 將指定參數設置為給定輸入串流，該輸入串流將擁有指定位元組數。
void	setBlob(String parameterName, Blob x) 將指定參數設置為給定的 java.sql.Blob 物件。
void	setBlob(String parameterName, InputStream inputStream) 將指定參數設置為 InputStream 物件。
void	setBlob(String parameterName, InputStream inputStream, long length) 將指定參數設置為 InputStream 物件。
void	setBoolean(String parameterName, boolean x) 將指定參數設置為給定 Java boolean 值。
void	setByte(String parameterName, byte x) 將指定參數設置為給定 Java byte 值。
void	setBytes(String parameterName, byte[] x) 將指定參數設置為給定 Java byte 陣列。
void	setCharacterStream(String parameterName, Reader reader) 將指定參數設置為給定 Reader 物件。
void	setCharacterStream(String parameterName, Reader reader, int length) 將指定參數設置為給定 Reader 物件，該物件是給定的字元長度數。
void	setCharacterStream(String parameterName, Reader reader, long length) 將指定參數設置為給定 Reader 物件，該物件具有給定字元數長度。
void	setClob(String parameterName, Clob x) 將指定參數設置為給定的 java.sql.Clob 物件。
void	setClob(String parameterName, Reader reader) 將指定參數設置為 Reader 物件。
void	setClob(String parameterName, Reader reader, long length) 將指定參數設置為 Reader 物件。
void	setDate(String parameterName, Date x) 使用運行應用程序的虛擬機器預設時區將指定參數設置為給定 java.sql.Date 值。
void	setDate(String parameterName, Date x, Calendar cal) 使用給定的 Calendar 物件將指定參數設置為給定 java.sql.Date 值。
void	setDouble(String parameterName, double x) 將指定參數設置為給定 Java double 值。
void	setFloat(String parameterName, float x) 將指定參數設置為給定 Java float 值。
void	setInt(String parameterName, int x) 將指定參數設置為給定 Java int 值。
void	setLong(String parameterName, long x) 將指定參數設置為給定 Java long 值。
void	setNCharacterStream(String parameterName, Reader value) 將指定參數設置為 Reader 物件。
void	setNCharacterStream(String parameterName, Reader value, long length) 將指定參數設置為 Reader 物件。
void	setNClob(String parameterName, NClob value) 將指定參數設置為 java.sql.NClob 物件。
void	setNClob(String parameterName, Reader reader) 將指定參數設置為 Reader 物件。
void	setNClob(String parameterName, Reader reader, long length) 將指定參數設置為 Reader 物件。
void	setNString(String parameterName, String value) 將指定參數設置為給定 String 物件。
void	setNull(String parameterName, int sqlType) 將指定參數設置為 SQL NULL。
void	setNull(String parameterName, int sqlType, String typeName) 將指定參數設置為 SQL NULL。
void	setObject(String parameterName, Object x) 使用給定物件設置指定參數的值。
void	setObject(String parameterName, Object x, int targetSqlType) 使用給定物件設置指定參數的值。
void	setObject(String parameterName, Object x, int targetSqlType, int scale) 使用給定物件設置指定參數的值。
void	setRowId(String parameterName, RowId x) 將指定參數設置為給定 java.sql.RowId 物件。
void	setShort(String parameterName, short x) 將指定參數設置為給定 Java short 值。
void	setSQLXML(String parameterName, SQLXML xmlObject) 將指定參數設置為給定 java.sql.SQLXML 物件。
void	setString(String parameterName, String x) 將指定參數設置為給定 Java String 值。
void	setTime(String parameterName, Time x) 將指定參數設置為給定 java.sql.Time 值。
void	setTime(String parameterName, Time x, Calendar cal) 使用給定的 Calendar 物件將指定參數設置為給定 java.sql.Time 值。
void	setTimestamp(String parameterName, Timestamp x) 將指定參數設置為給定 java.sql.Timestamp 值。
void	setTimestamp(String parameterName, Timestamp x, Calendar cal) 使用給定的 Calendar 物件將指定參數設置為給定 java.sql.Timestamp 值。
void	setURL(String parameterName, URL val) 將指定參數設置為給定 java.net.URL 物件。
boolean	wasNull() 查詢最後一個讀取的 OUT 參數是否為 SQL NULL。

從介面 java.sql.PreparedStatement 繼承的方法

addBatch, clearParameters, execute, executeQuery, executeUpdate, getMetaData, getParameterMetaData, setArray, setAsciiStream, setAsciiStream, setAsciiStream, setBigDecimal, setBinaryStream, setBinaryStream, setBinaryStream, setBlob, setBlob, setBlob, setBoolean, setByte, setBytes, setCharacterStream, setCharacterStream, setCharacterStream, setClob, setClob, setClob, setDate, setDate, setDouble, setFloat, setInt, setLong, setNCharacterStream, setNCharacterStream, setNClob, setNClob, setNClob, setNString, setNull, setNull, setObject, setObject, setObject, setRef, setRowId, setShort, setSQLXML, setString, setTime, setTime, setTimestamp, setTimestamp, setUnicodeStream, setURL

從介面 java.sql.Statement 繼承的方法

addBatch, cancel, clearBatch, clearWarnings, close, execute, execute, execute, execute, executeBatch, executeQuery, executeUpdate, executeUpdate, executeUpdate, executeUpdate, getConnection, getFetchDirection, getFetchSize, getGeneratedKeys, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSet, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getUpdateCount, getWarnings, isClosed, isPoolable, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setMaxFieldSize, setMaxRows, setPoolable, setQueryTimeout

從介面 java.sql.Wrapper 繼承的方法

isWrapperFor, unwrap

方法詳細資訊

registerOutParameter

void registerOutParameter(int parameterIndex,
                          int sqlType)
                          throws SQLException

按順序位置 parameterIndex 將 OUT 參數註冊為 JDBC 型別 sqlType。所有 OUT 參數都必須在執行預儲程序前註冊。

sqlType 為 OUT 參數指定的 JDBC 型別確定必須用於 get 方法，以讀取該參數值的 Java 型別。

如果預期返回給此輸出參數的 JDBC 型別是取決於此特定資料庫的，則 sqlType 應該是 java.sql.Types.OTHER。方法 getObject(int) 獲取該值。

參數：

parameterIndex - 第一個參數是 1，第二個參數是 2，依此類別推

sqlType - java.sql.Types 定義的 JDBC 型別程式碼。如果參數是 JDBC 型別 NUMERIC 或 DECIMAL，則應使用接受標度值的那種 registerOutParameter。

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 sqlType 是 ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML 或 STRUCT 資料型別之一並且 JDBC 驅動程序不支持此資料型別

另請參見：

Types

registerOutParameter

void registerOutParameter(int parameterIndex,
                          int sqlType,
                          int scale)
                          throws SQLException

按順序位置 parameterIndex 將參數註冊為 JDBC 型別 sqlType。所有 OUT 參數都必須在執行預儲程序前註冊。

sqlType 為 OUT 參數指定的 JDBC 型別確定必須用於 get 方法，以讀取該參數值的 Java 型別。

這種形式的 registerOutParameter 應該在參數是 JDBC 型別 NUMERIC 或 DECIMAL 時使用。

參數：

parameterIndex - 第一個參數是 1，第二個參數是 2，依此類別推

sqlType - 由 java.sql.Types 定義的 SQL 型別程式碼。

scale - 小數點右邊所需的位數。該參數必須大於等於 0。

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 sqlType 是 ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML 或 STRUCT 資料型別之一並且 JDBC 驅動程序不支持此資料型別

另請參見：

Types

wasNull

boolean wasNull()
                throws SQLException

查詢最後一個讀取的 OUT 參數是否為 SQL NULL。注意，此方法只應該在調用獲取方法之後調用；否則沒有用來確定它是否為 null 的值。

返回：

如果最後一個讀取的參數為 SQL NULL，則返回 true；否則返回 false

拋出：

SQLException - 如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

getString

String getString(int parameterIndex)
                 throws SQLException

以 Java 程式語言中 String 的形式獲取指定的 JDBC CHAR、VARCHAR 或 LONGVARCHAR 參數的值。

對於固定長度型別 SQL CHAR，返回的 String 物件與資料庫中的 JDBC CHAR 值完全相同，包括資料庫添加的任何填充資料。

參數：

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 值的形式獲取指定的 JDBC BIT 或 BOOLEAN 參數的值。

參數：

parameterIndex - 第一個參數是 1，第二個參數是 2，依此類別推

返回：

參數值。如果值為 SQL NULL，則結果為 false。

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

另請參見：

setBoolean(java.lang.String, boolean)

getByte

byte getByte(int parameterIndex)
             throws SQLException

以 Java 程式語言中 byte 的形式獲取指定的 JDBC TINYINT 參數的值。

參數：

parameterIndex - 第一個參數是 1，第二個參數是 2，依此類別推

返回：

參數值。如果值為 SQL NULL，則結果為 0。

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

另請參見：

setByte(java.lang.String, byte)

getShort

short getShort(int parameterIndex)
               throws SQLException

以 Java 程式語言中 short 值的形式獲取指定的 JDBC SMALLINT 參數的值。

參數：

parameterIndex - 第一個參數是 1，第二個參數是 2，依此類別推

返回：

參數值。如果值為 SQL NULL，則結果為 0。

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

另請參見：

setShort(java.lang.String, short)

getInt

int getInt(int parameterIndex)
           throws SQLException

以 Java 程式語言中 int 值的形式獲取指定的 JDBC INTEGER 參數的值。

參數：

parameterIndex - 第一個參數是 1，第二個參數是 2，依此類別推

返回：

參數值。如果值為 SQL NULL，則結果為 0。

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

另請參見：

setInt(java.lang.String, int)

getLong

long getLong(int parameterIndex)
             throws SQLException

以 Java 程式語言中 long 值的形式獲取指定的 JDBC BIGINT 參數的值。

參數：

parameterIndex - 第一個參數是 1，第二個參數是 2，依此類別推

返回：

參數值。如果值為 SQL NULL，則結果為 0。

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

另請參見：

setLong(java.lang.String, long)

getFloat

float getFloat(int parameterIndex)
               throws SQLException

以 Java 程式語言中 float 值的形式獲取指定的 JDBC FLOAT 參數的值。

參數：

parameterIndex - 第一個參數是 1，第二個參數是 2，依此類別推

返回：

參數值。如果值為 SQL NULL，則結果為 0。

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

另請參見：

setFloat(java.lang.String, float)

getDouble

double getDouble(int parameterIndex)
                 throws SQLException

以 Java 程式語言中 double 值的形式獲取指定的 JDBC DOUBLE 參數的值。

參數：

parameterIndex - 第一個參數是 1，第二個參數是 2，依此類別推

返回：

參數值。如果值為 SQL NULL，則結果為 0。

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

另請參見：

setDouble(java.lang.String, double)

getBigDecimal

BigDecimal getBigDecimal(int parameterIndex,
                         int scale)
                         throws SQLException

已過時。 使用 getBigDecimal(int parameterIndex) 或 getBigDecimal(String parameterName)

以 java.math.BigDecimal 物件的形式獲取指定 JDBC NUMERIC 參數的值，小數點右邊有 scale 個位數。

參數：

parameterIndex - 第一個參數是 1，第二個參數是 2，依此類別推

scale - 小數點右邊的位數

返回：

參數值。如果值為 SQL NULL，則結果為 null。

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

另請參見：

setBigDecimal(java.lang.String, java.math.BigDecimal)

getBytes

byte[] getBytes(int parameterIndex)
                throws SQLException

以 Java 程式語言中 byte 陣列值的形式獲取指定的 JDBC BINARY 或 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 物件的形式獲取指定 JDBC 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 物件的形式獲取指定 JDBC TIME 參數的值。

參數：

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 物件的形式獲取指定 JDBC TIMESTAMP 參數的值。

參數：

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 的形式獲取指定參數的值。如果值為 SQL NULL，則驅動程序返回一個 Java null。

此方法返回一個 Java 物件，其型別對應於使用 registerOutParameter 方法為此參數註冊的 JDBC 型別。通過將目標 JDBC 型別註冊為 java.sql.Types.OTHER，可以使用此方法來讀取特定於資料庫的抽象資料型別。

參數：

parameterIndex - 第一個參數是 1，第二個參數是 2，依此類別推

返回：

保存 OUT 參數值的 java.lang.Object

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

另請參見：

Types, setObject(java.lang.String, java.lang.Object, int, int)

getBigDecimal

BigDecimal getBigDecimal(int parameterIndex)
                         throws SQLException

以 java.math.BigDecimal 物件的形式獲取指定 JDBC 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 類別的映射關係

返回：

保存 OUT 參數值的 java.lang.Object

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

另請參見：

setObject(java.lang.String, java.lang.Object, int, int)

getRef

Ref getRef(int parameterIndex)
           throws SQLException

以 Java 程式語言中 Ref 物件的形式獲取指定的 JDBC REF(<structured-type>) 參數的值。

參數：

parameterIndex - 第一個參數是 1，第二個參數是 2，依此類別推

返回：

Java 程式語言中 Ref 物件形式的參數值。如果值為 SQL NULL，則返回 null 值。

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

getBlob

Blob getBlob(int parameterIndex)
             throws SQLException

以 Java 程式語言中 java.sql.Clob 物件的形式獲取指定的 JDBC CLOB 參數的值。

參數：

parameterIndex - 第一個參數是 1，第二個參數是 2，依此類別推

返回：

Java 程式語言中 Blob 物件形式的參數值。如果值為 SQL NULL，則返回 null 值。

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

getClob

Clob getClob(int parameterIndex)
             throws SQLException

以 Java 程式語言中 java.sql.Clob 物件的形式獲取指定的 JDBC CLOB 參數的值。

參數：

parameterIndex - 第一個參數是 1，第二個參數是 2，依此類別推

返回：

Java 程式語言中 Clob 物件形式的參數值。如果值為 SQL NULL，則返回 null 值。

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

getArray

Array getArray(int parameterIndex)
               throws SQLException

以 Java 程式語言中 Array 物件的形式獲取指定的 JDBC ARRAY 參數的值。

參數：

parameterIndex - 第一個參數是 1，第二個參數是 2，依此類別推

返回：

Java 程式語言中 Array 物件形式的參數值。如果值為 SQL NULL，則返回 null 值。

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

getDate

Date getDate(int parameterIndex,
             Calendar cal)
             throws SQLException

以 java.sql.Date 物件的形式獲取指定 JDBC 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

以 java.sql.Time 物件的形式獲取指定 JDBC 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

以 java.sql.Timestamp 物件的形式獲取指定 JDBC 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 型別。

參數：

parameterIndex - 第一個參數是 1，第二個參數是 2，依此類別推

sqlType - 取自 Types 的一個值

typeName - SQL 結構型別的完全限定名稱

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 sqlType 是 ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML 或 STRUCT 資料型別之一並且 JDBC 驅動程序不支持此資料型別

從以下版本開始：

1.2

另請參見：

Types

registerOutParameter

void registerOutParameter(String parameterName,
                          int sqlType)
                          throws SQLException

將名為 parameterName 的 OUT 參數註冊為 JDBC 型別 sqlType。所有 OUT 參數都必須在執行預儲程序前註冊。

sqlType 為 OUT 參數指定的 JDBC 型別確定必須用於 get 方法，以讀取該參數值的 Java 型別。

如果預期返回給此輸出參數的 JDBC 型別是特定於此特定資料庫的，則 sqlType 應該是 java.sql.Types.OTHER。方法 getObject(int) 獲取該值。

參數：

parameterName - 參數名

sqlType - 由 java.sql.Types 定義的 JDBC 型別程式碼。如果參數是 JDBC 型別 NUMERIC 或 DECIMAL，則應使用接受標度值的那種 registerOutParameter。

拋出：

SQLException - 如果 parameterName 不對應指定的參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 sqlType 是 ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML 或 STRUCT 資料型別之一並且 JDBC 驅動程序不支持此資料型別，或者 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

Types

registerOutParameter

void registerOutParameter(String parameterName,
                          int sqlType,
                          int scale)
                          throws SQLException

將名為 parameterName 的參數註冊為 JDBC 型別 sqlType。所有 OUT 參數都必須在執行預儲程序前註冊。

sqlType 為 OUT 參數指定的 JDBC 型別確定必須用於 get 方法，以讀取該參數值的 Java 型別。

這種形式的 registerOutParameter 應該在參數是 JDBC 型別 NUMERIC 或 DECIMAL 時使用。

參數：

parameterName - 參數名

sqlType - 由 java.sql.Types 定義的 SQL 型別程式碼。

scale - 小數點右邊所需的位數。該參數必須大於等於 0。

拋出：

SQLException - 如果 parameterName 不對應指定的參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 sqlType 是 ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML 或 STRUCT 資料型別之一並且 JDBC 驅動程序不支持此資料型別，或者 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

Types

registerOutParameter

void registerOutParameter(String parameterName,
                          int sqlType,
                          String typeName)
                          throws SQLException

註冊指定的輸出參數。這種形式的 registerOutParameter 方法應該用於使用者命名的輸出參數或 REF 輸出參數。使用者命名型別的範例有：STRUCT、DISTINCT、JAVA_OBJECT 和指定的陣列型別。

所有 OUT 參數都必須在執行預儲程序前註冊。

對於使用者命名的參數，還應該提供參數的完全限定 SQL 型別名稱，而 REF 參數則要求提供所參考型別的完全限定型別名稱。不需要型別程式碼和型別名稱資訊的 JDBC 驅動程序可以忽略它。不過，為了便於移植，應用程序應該為使用者命名的參數和 REF 參數提供這些值。儘管此方法是供使用者命名的參數和 REF 參數使用的，但也可以將其用於註冊任何 JDBC 型別的參數。如果參數沒有使用者命名的型別或 REF 型別，則忽略 typeName 參數。

註：在讀取 out 參數的值時，必須使用 getXXX 方法，其 Java 型別 XXX 對應於參數的已註冊 SQL 型別。

參數：

parameterName - 參數名

sqlType - 取自 Types 的一個值

typeName - SQL 結構型別的完全限定名稱

拋出：

SQLException - 如果 parameterName 不對應指定的參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 sqlType 是 ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML 或 STRUCT 資料型別之一並且 JDBC 驅動程序不支持此資料型別，或者 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

Types

getURL

URL getURL(int parameterIndex)
           throws SQLException

以 java.sql.URL 物件的形式獲取指定 JDBC DATALINK 參數的值。

參數：

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 物件。在將該值發送到資料庫時，驅動程序將它轉換成一個 SQL DATALINK 值。

參數：

parameterName - 參數名

val - 參數值

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法，或者 URL 是錯誤的

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

getURL(int)

setNull

void setNull(String parameterName,
             int sqlType)
             throws SQLException

將指定參數設置為 SQL NULL。

註：必須指定參數的 SQL 型別。

參數：

parameterName - 參數名

sqlType - java.sql.Types 中定義的 SQL 型別程式碼

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

setBoolean

void setBoolean(String parameterName,
                boolean x)
                throws SQLException

將指定參數設置為給定 Java boolean 值。在將該值發送到資料庫時，驅動程序將它轉換成一個 SQL BIT 或 BOOLEAN 值。

參數：

parameterName - 參數名

x - 參數值

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

getBoolean(int)

setByte

void setByte(String parameterName,
             byte x)
             throws SQLException

將指定參數設置為給定 Java byte 值。在將該值發送到資料庫時，驅動程序將它轉換成一個 SQL TINYINT 值。

參數：

parameterName - 參數名

x - 參數值

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

getByte(int)

setShort

void setShort(String parameterName,
              short x)
              throws SQLException

將指定參數設置為給定 Java short 值。在將該值發送到資料庫時，驅動程序將它轉換成一個 SQL SMALLINT 值。

參數：

parameterName - 參數名

x - 參數值

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

getShort(int)

setInt

void setInt(String parameterName,
            int x)
            throws SQLException

將指定參數設置為給定 Java int 值。在將該值發送到資料庫時，驅動程序將它轉換成一個 SQL INTEGER 值。

參數：

parameterName - 參數名

x - 參數值

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

getInt(int)

setLong

void setLong(String parameterName,
             long x)
             throws SQLException

將指定參數設置為給定 Java long 值。在將該值發送到資料庫時，驅動程序將它轉換成一個 SQL BIGINT 值。

參數：

parameterName - 參數名

x - 參數值

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

getLong(int)

setFloat

void setFloat(String parameterName,
              float x)
              throws SQLException

將指定參數設置為給定 Java float 值。在將該值發送到資料庫時，驅動程序將它轉換成一個 SQL FLOAT 值。

參數：

parameterName - 參數名

x - 參數值

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

getFloat(int)

setDouble

void setDouble(String parameterName,
               double x)
               throws SQLException

將指定參數設置為給定 Java double 值。在將該值發送到資料庫時，驅動程序將它轉換成一個 SQL DOUBLE 值。

參數：

parameterName - 參數名

x - 參數值

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

getDouble(int)

setBigDecimal

void setBigDecimal(String parameterName,
                   BigDecimal x)
                   throws SQLException

將指定參數設置為給定 java.math.BigDecimal 值。在將該值發送到資料庫時，驅動程序將它轉換成一個 SQL NUMERIC 值。

參數：

parameterName - 參數名

x - 參數值

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

getBigDecimal(int, int)

setString

void setString(String parameterName,
               String x)
               throws SQLException

將指定參數設置為給定 Java String 值。在將此值發送給資料庫時，驅動程序將它轉換成一個 SQL VARCHAR 或 LONGVARCHAR 值（取決於該參數相對於驅動程序在 VARCHAR 值上的限制的大小）。

參數：

parameterName - 參數名

x - 參數值

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

getString(int)

setBytes

void setBytes(String parameterName,
              byte[] x)
              throws SQLException

將指定參數設置為給定 Java byte 陣列。在將此值發送給資料庫時，驅動程序將它轉換成一個 SQL VARBINARY 或 LONGVARBINARY 值（取決於該參數相對於驅動程序在 VARBINARY 值上的限制的大小）。

參數：

parameterName - 參數名

x - 參數值

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

getBytes(int)

setDate

void setDate(String parameterName,
             Date x)
             throws SQLException

使用運行應用程序的虛擬機器預設時區將指定參數設置為給定 java.sql.Date 值。在將該值發送到資料庫時，驅動程序將它轉換成一個 SQL DATE 值。

參數：

parameterName - 參數名

x - 參數值

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

getDate(int)

setTime

void setTime(String parameterName,
             Time x)
             throws SQLException

將指定參數設置為給定 java.sql.Time 值。在將該值發送到資料庫時，驅動程序將它轉換成一個 SQL TIME 值。

參數：

parameterName - 參數名

x - 參數值

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

getTime(int)

setTimestamp

void setTimestamp(String parameterName,
                  Timestamp x)
                  throws SQLException

將指定參數設置為給定 java.sql.Timestamp 值。在將該值發送到資料庫時，驅動程序將它轉換成一個 SQL TIMESTAMP 值。

參數：

parameterName - 參數名

x - 參數值

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

getTimestamp(int)

setAsciiStream

void setAsciiStream(String parameterName,
                    InputStream x,
                    int length)
                    throws SQLException

將指定參數設置為給定輸入串流，該輸入串流將擁有指定的位元組數。在將一個非常大的 ASCII 值輸入給 LONGVARCHAR 參數時，通過 java.io.InputStream 發送它可能更為實際。將根據需要從串流中讀取資料，一直讀取到檔案末尾。JDBC 驅動程序將執行從 ASCII 到資料庫 char 格式的任何必要轉換。

註：此串流對象可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

參數：

parameterName - 參數名

x - 套件含 ASCII 參數值的 Java 輸入串流

length - 串流中的位元組數

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

setBinaryStream

void setBinaryStream(String parameterName,
                     InputStream x,
                     int length)
                     throws SQLException

將指定參數設置為給定輸入串流，該輸入串流將擁有指定的位元組數。在將一個非常大的二進制值輸入給 LONGVARBINARY 參數時，通過 java.io.InputStream 物件發送它可能更為實際。將根據需要從串流中讀取資料，一直讀取到檔案末尾。

註：此串流對象可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

參數：

parameterName - 參數名

x - 套件含二進制參數值的 java 輸入串流

length - 串流中的位元組數

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

setObject

void setObject(String parameterName,
               Object x,
               int targetSqlType,
               int scale)
               throws SQLException

使用給定物件設置指定參數的值。第二個參數必須是一個物件型別；對於整數值，應該使用 java.lang 的等效物件。

在被發送到資料庫之前，給定 Java 物件將被轉換為給定 targetSqlType。 如果物件具有自定義映射關係（是實作 SQLData 介面的類別），則 JDBC 驅動程序應該調用 SQLData.writeSQL 方法將它寫入 SQL 資料串流中。另一方面，如果該物件是實作 Ref、Blob、Clob、NClob、Struct、java.net.URL 或 Array 的類別，則驅動程序應該將它作為相應 SQL 型別的值傳遞給資料庫。

注意，此方法可用於傳遞特定於資料庫的抽象資料型別。

參數：

parameterName - 參數名

x - 套件含輸入參數值的物件

targetSqlType - 將發送到資料庫的 SQL 型別（在 java.sql.Types 中定義）。scale 參數可以進一步限定此型別。

scale - 對於 java.sql.Types.DECIMAL 或 java.sql.Types.NUMERIC 型別，該參數是小數點後的位數。對於其他全部類別型，將忽略此值。

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 targetSqlType 是 ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML 或 STRUCT 資料型別之一並且 JDBC 驅動程序不支持此資料型別

從以下版本開始：

1.4

另請參見：

Types, getObject(int)

setObject

void setObject(String parameterName,
               Object x,
               int targetSqlType)
               throws SQLException

使用給定物件設置指定參數的值。除了假定 scale 為 0 外，此方法類似於上面的 setObject 方法。

參數：

parameterName - 參數名

x - 套件含輸入參數值的物件

targetSqlType - 要發送到資料庫的 SQL 型別（在 java.sql.Types 中定義）

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 targetSqlType 是 ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML 或 STRUCT 資料型別之一並且 JDBC 驅動程序不支持此資料型別

從以下版本開始：

1.4

另請參見：

getObject(int)

setObject

void setObject(String parameterName,
               Object x)
               throws SQLException

使用給定物件設置指定參數的值。第二個參數必須是型別 Object；所以，應該對內置型別使用 java.lang 的等效物件。

JDBC 規範指定了一個從 Java Object 型別到 SQL 型別的標準映射關係。在被發送到資料庫之前，給定參數將被轉換為相應 SQL 型別。

注意，通過使用特定於驅動程序的 Java 型別，此方法可用於傳遞特定於資料庫的抽象資料型別。 如果物件是實作 SQLData 介面的類別，則 JDBC 驅動程序應該調用 SQLData.writeSQL 方法將它寫入 SQL 資料串流中。另一方面，如果該物件是實作 Ref、Blob、Clob、NClob、Struct、java.net.URL 或 Array 的類別，則驅動程序應該將它作為相應 SQL 型別的值傳遞給資料庫。

如果出現混淆，例如，如果該物件是實作不止一個上述指定介面的類別，則此方法拋出異常。

註： 並非所有允許非型別 Null 的資料庫都被發送到後端。為了獲得最大的可移植性，應該使用 setNull 或 setObject(String parameterName, Object x, int sqlType) 方法替代 setObject(String parameterName, Object x)。

參數：

parameterName - 參數名

x - 套件含輸入參數值的物件

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法，或者給定的 Object 參數不明確

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

getObject(int)

setCharacterStream

void setCharacterStream(String parameterName,
                        Reader reader,
                        int length)
                        throws SQLException

將指定參數設置為給定 Reader 物件，該物件是給定的字元長度數。在將一個非常大的 UNICODE 值輸入給 LONGVARCHAR 參數時，通過 java.io.Reader 物件發送它可能更為實際。將根據需要從串流中讀取資料，一直讀取到檔案末尾。JDBC 驅動程序將執行從 UNICODE 到資料庫 char 格式的任何必要轉換。

註：此串流對象可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

參數：

parameterName - 參數名

reader - 套件含用作指定參數的 UNICODE 資料的 java.io.Reader 物件

length - 串流中的位元組數

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

setDate

void setDate(String parameterName,
             Date x,
             Calendar cal)
             throws SQLException

使用給定的 Calendar 物件將指定參數設置為給定 java.sql.Date 值。驅動程序使用 Calendar 物件建構一個 SQL DATE 值，該值隨後被驅動程序發送給資料庫。利用 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 物件建構一個 SQL TIME 值，該值隨後被驅動程序發送給資料庫。利用 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 物件建構一個 SQL TIMESTAMP 值，該值隨後被驅動程序發送給資料庫。利用 Calendar 物件，驅動程序可以在考慮自定義時區的情況下計算時間戳。如果沒有指定任何 Calendar 物件，那麼驅動程序將使用預設時區，該時區是運行應用程序的虛擬機器所在的時區。

參數：

parameterName - 參數名

x - 參數值

cal - 供驅動程序用來建構時間戳的 Calendar 物件

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

getTimestamp(int)

setNull

void setNull(String parameterName,
             int sqlType,
             String typeName)
             throws SQLException

將指定參數設置為 SQL NULL。這種形式的 setNull 方法應該用於使用者定義型別的參數或 REF 型別的參數。使用者定義型別的範例有：STRUCT、DISTINCT、JAVA_OBJECT 和指定的陣列型別。

註：為了便於移植，在指定 NULL 使用者定義參數或 REF 參數時，應用程序必須提供 SQL 型別程式碼和完全限定的 SQL 型別名稱。對於使用者定義的型別，該名稱是參數本身的型別名稱。對於 REF 參數，該名稱是所參考型別的型別名稱。

儘管此方法是供使用者定義的參數和 Ref 參數使用的，但也可以將其用於設置任何 JDBC 型別的 null 參數。如果參數沒有使用者定義的型別或 REF 型別，則忽略 typeName。

參數：

parameterName - 參數名

sqlType - 取自 java.sql.Types 的一個值

typeName - SQL 使用者定義型別的完全限定名；如果該參數不是使用者定義的型別或 SQL REF 值，則忽略它

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

getString

String getString(String parameterName)
                 throws SQLException

以 Java 程式語言中 String 的形式獲取 JDBC CHAR、VARCHAR 或 LONGVARCHAR 參數的值。

對於固定長度型別 JDBC CHAR，返回的 String 物件與資料庫擁有的 SQL CHAR 值完全相同，包括資料庫添加的任何填充資料。

參數：

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 值的形式獲取 JDBC BIT 或 BOOLEAN 參數的值。

參數：

parameterName - 參數名

返回：

參數值。如果值為 SQL NULL，則結果為 false。

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

setBoolean(java.lang.String, boolean)

getByte

byte getByte(String parameterName)
             throws SQLException

以 Java 程式語言中 byte 值的形式獲取 JDBC TINYINT 參數的值。

參數：

parameterName - 參數名

返回：

參數值。如果值為 SQL NULL，則結果為 0。

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

setByte(java.lang.String, byte)

getShort

short getShort(String parameterName)
               throws SQLException

以 Java 程式語言中 short 值的形式獲取 JDBC SMALLINT 參數的值。

參數：

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 值的形式獲取 JDBC INTEGER 參數的值。

參數：

parameterName - 參數名

返回：

參數值。如果值為 SQL NULL，則結果為 0。

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

setInt(java.lang.String, int)

getLong

long getLong(String parameterName)
             throws SQLException

以 Java 程式語言中 long 值的形式獲取 JDBC BIGINT 參數的值。

參數：

parameterName - 參數名

返回：

參數值。如果值為 SQL NULL，則結果為 0。

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

setLong(java.lang.String, long)

getFloat

float getFloat(String parameterName)
               throws SQLException

以 Java 程式語言中 float 值的形式獲取 JDBC FLOAT 參數的值。

參數：

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 值的形式獲取 JDBC DOUBLE 參數的值。

參數：

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 陣列值的形式獲取 JDBC BINARY 或 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 物件的形式獲取 JDBC DATE 參數的值。

參數：

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 物件的形式獲取 JDBC TIME 參數的值。

參數：

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 物件的形式獲取 JDBC TIMESTAMP 參數的值。

參數：

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 的形式獲取參數的值。如果值為 SQL NULL，則驅動程序返回一個 Java null。

此方法返回一個 Java 物件，其型別對應於使用 registerOutParameter 方法為此參數註冊的 JDBC 型別。通過將目標 JDBC 型別註冊為 java.sql.Types.OTHER，可以使用此方法來讀取特定於資料庫的抽象資料型別。

參數：

parameterName - 參數名

返回：

保存 OUT 參數值的 java.lang.Object。

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

Types, setObject(java.lang.String, java.lang.Object, int, int)

getBigDecimal

BigDecimal getBigDecimal(String parameterName)
                         throws SQLException

以 java.math.BigDecimal 物件的形式獲取 JDBC NUMERIC 參數的值，小數點右邊的位數與該參數值所包含的位數相同。

參數：

parameterName - 參數名

返回：

全精度參數值。如果值為 SQL NULL，則結果為 null。

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

setBigDecimal(java.lang.String, java.math.BigDecimal)

getObject

Object getObject(String parameterName,
                 Map<String,Class<?>> map)
                 throws SQLException

返回一個表示 OUT 參數 parameterName 值的物件，並將 map 用於該參數值的自定義映射關係。

此方法返回一個 Java 物件，其型別對應於使用 registerOutParameter 方法為此參數註冊的 JDBC 型別。通過將目標 JDBC 型別註冊為 java.sql.Types.OTHER，可以使用此方法來讀取特定於資料庫的抽象資料型別。

參數：

parameterName - 參數名

map - SQL 型別名稱到 Java 類別的映射關係

返回：

保存 OUT 參數值的 java.lang.Object

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

setObject(java.lang.String, java.lang.Object, int, int)

getRef

Ref getRef(String parameterName)
           throws SQLException

以 Java 程式語言中 Ref 物件的形式獲取 JDBC REF(<structured-type>) 參數的值。

參數：

parameterName - 參數名

返回：

Java 程式語言中 Ref 物件形式的參數值。如果值為 SQL NULL，則返回 null 值。

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

getBlob

Blob getBlob(String parameterName)
             throws SQLException

以 Java 程式語言中 Blob 物件的形式獲取 JDBC BLOB 參數的值。

參數：

parameterName - 參數名

返回：

Java 程式語言中 Blob 物件形式的參數值。如果值為 SQL NULL，則返回 null 值。

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

getClob

Clob getClob(String parameterName)
             throws SQLException

以 Java 程式語言中 java.sql.CLOB 物件的形式獲取 JDBC CLOB 參數的值。

參數：

parameterName - 參數名

返回：

Java 程式語言中 Clob 物件形式的參數值。如果值為 SQL NULL，則返回 null 值。

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

getArray

Array getArray(String parameterName)
               throws SQLException

以 Java 程式語言中 java.sql.ARRAY 物件的形式獲取 JDBC ARRAY 參數的值。

參數：

parameterName - 參數名

返回：

Java 程式語言中 ARRAY 物件形式的參數值。如果值為 SQL NULL，則返回 null 值。

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

getDate

Date getDate(String parameterName,
             Calendar cal)
             throws SQLException

以 java.sql.Date 物件的形式獲取 JDBC 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

以 java.sql.Time 物件的形式獲取 JDBC 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

以 java.sql.Timestamp 物件的形式獲取 JDBC TIMESTAMP 參數的值，使用給定 Calendar 物件建構 Timestamp 物件。利用 Calendar 物件，驅動程序可以在考慮自定義時區和語言環境的情況下計算時間戳。如果沒有指定任何 Calendar 物件，那麼驅動程序將使用預設時區和語言環境。

參數：

parameterName - 參數名

cal - 供驅動程序用來建構時間戳的 Calendar 物件

返回：

參數值。如果值為 SQL NULL，則結果為 null。

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

setTimestamp(java.lang.String, java.sql.Timestamp)

getURL

URL getURL(String parameterName)
           throws SQLException

以 java.net.URL 物件的形式獲取 JDBC DATALINK 參數的值。

參數：

parameterName - 參數名

返回：

Java 程式語言中 java.net.URL 物件形式的參數值。如果值為 SQL NULL，則返回 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 物件的形式獲取指定 JDBC ROWID 參數的值。

參數：

parameterIndex - 第一個參數是 1，第二個參數是 2，……

返回：

表示被用作指定參數的 JDBC ROWID 值的 RowId 物件。如果該參數包含一個 SQL NULL，則返回 null 值。

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

getRowId

RowId getRowId(String parameterName)
               throws SQLException

以 java.sql.RowId 物件的形式獲取指定 JDBC ROWID 參數的值。

參數：

parameterName - 參數名

返回：

表示被用作指定參數的 JDBC ROWID 值的 RowId 物件。如果該參數包含一個 SQL NULL，則返回 null 值。

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

setRowId

void setRowId(String parameterName,
              RowId x)
              throws SQLException

將指定參數設置為給定 java.sql.RowId 物件。在將該物件發送到資料庫時，驅動程序將它轉換成一個 SQL ROWID。

參數：

parameterName - 參數名

x - 參數值

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

setNString

void setNString(String parameterName,
                String value)
                throws SQLException

將指定參數設置為給定 String 物件。驅動程序將此物件轉換成一個 SQL NCHAR、NVARCHAR 或 LONGNVARCHAR。

參數：

parameterName - 要設置的參數的名稱

value - 參數值

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果驅動程序不支持國家字元 (national character) 集；如果驅動程序檢測到可能發生資料轉換錯誤；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

setNCharacterStream

void setNCharacterStream(String parameterName,
                         Reader value,
                         long length)
                         throws SQLException

將指定參數設置為 Reader 物件。Reader 將讀取資料，直到到達檔案末尾。驅動程序執行從 Java 字元格式到資料庫中國家字元集的必要轉換。

參數：

parameterName - 要設置的參數名

參數值 -

length - 該參數資料中的字元數。

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

setNClob

void setNClob(String parameterName,
              NClob value)
              throws SQLException

將指定參數設置為 java.sql.NClob 物件。該物件實作 java.sql.NClob 介面。此 NClob 物件映射到 SQL NCLOB。

參數：

parameterName - 要設置的參數名

value - 參數值

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

setClob

void setClob(String parameterName,
             Reader reader,
             long length)
             throws SQLException

將指定參數設置為 Reader 物件。reader 必須包含 length 指定的字元數，否則在執行 CallableStatement 時將產生一個 SQLException。此方法不同於 setCharacterStream (int, Reader, int) 方法，因為它會通知驅動程序應該將參數值作為 CLOB 發送給伺服器。在使用 setCharacterStream 方法時，驅動程序可能必須做一些額外的工作，以確定應該將參數資料作為 LONGVARCHAR 還是 CLOB 發送給伺服器

參數：

parameterName - 要設置的參數名

reader - 套件含用來設置參數值的資料的物件。

length - 參數資料中的字元數。

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果指定的 length 小於 0；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

setBlob

void setBlob(String parameterName,
             InputStream inputStream,
             long length)
             throws SQLException

將指定參數設置為 InputStream 物件。inputstream 必須包含 length 指定的字元數，否則在執行 CallableStatement 時將產生一個 SQLException。此方法不同於 setBinaryStream (int, InputStream, int) 方法，因為它會通知驅動程序應該將參數值作為 BLOB 發送給伺服器。在使用 setBinaryStream 方法時，驅動程序可能必須做一些額外的工作，以確定應該將參數資料作為 LONGVARBINARY 還是 BLOB 發送給伺服器

參數：

parameterName - 要設置的參數名

inputStream - 套件含用來設置參數值的資料的物件。

length - 參數資料中的位元組數。

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果指定的 length 小於 0；如果輸入串流中的位元組數與指定 length 不比對；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

setNClob

void setNClob(String parameterName,
              Reader reader,
              long length)
              throws SQLException

將指定參數設置為 Reader 物件。reader 必須包含 length 指定的字元數，否則在執行 CallableStatement 時將產生一個 SQLException。此方法不同於 setCharacterStream (int, Reader, int) 方法，因為它會通知驅動程序應該將參數值作為 NCLOB 發送給伺服器。在使用 setCharacterStream 方法時，驅動程序可能必須做一些額外的工作，以確定應該將參數資料作為 LONGNVARCHAR 還是 NCLOB 發送給伺服器

參數：

parameterName - 要設置的參數名

reader - 套件含用於設置參數值的資料的物件。

length - 參數資料中的字元數。

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果指定 length 小於 0；如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

getNClob

NClob getNClob(int parameterIndex)
               throws SQLException

以 Java 程式語言中 java.sql.NClob 物件的形式獲取指定的 JDBC NCLOB 參數的值。

參數：

parameterIndex - 第一個參數是 1，第二個參數是 2，依此類別推

返回：

Java 程式語言中 NClob 物件形式的參數值。如果值為 SQL NULL，則返回 null 值。

拋出：

SQLException - 如果 parameterIndex 無效；如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

getNClob

NClob getNClob(String parameterName)
               throws SQLException

以 Java 程式語言中 java.sql.NClob 物件的形式獲取 JDBC NCLOB 參數的值。

參數：

parameterName - 參數名

返回：

Java 程式語言中 NClob 物件形式的參數值。如果值為 SQL NULL，則返回 null 值。

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

setSQLXML

void setSQLXML(String parameterName,
               SQLXML xmlObject)
               throws SQLException

將指定參數設置為給定 java.sql.SQLXML 物件。在將該物件發送到資料庫時，驅動程序將它轉換成一個 SQL XML 值。

參數：

parameterName - 參數名

xmlObject - 映射 SQL XML 值的 SQLXML 物件

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤；在關閉的 CallableStatement 上調用此方法，或者 java.xml.transform.Result、Writer 或 OutputStream 沒有關閉（對於 SQLXML 物件而言）

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

getSQLXML

SQLXML getSQLXML(int parameterIndex)
                 throws SQLException

以 Java 程式語言中 java.sql.SQLXML 物件的形式獲取指定的 SQL XML 參數的值。

參數：

parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2，……

返回：

映射 SQL XML 值的 SQLXML 物件

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

getSQLXML

SQLXML getSQLXML(String parameterName)
                 throws SQLException

以 Java 程式語言中 java.sql.SQLXML 物件的形式獲取指定的 SQL XML 參數的值。

參數：

parameterName - 參數名

返回：

映射 SQL XML 值的 SQLXML 物件

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

getNString

String getNString(int parameterIndex)
                  throws SQLException

以 Java 程式語言中 String 的形式獲取指定的 NCHAR、NVARCHAR 或 LONGNVARCHAR 參數的值。

對於固定長度型別 JDBC NCHAR，返回的 String 物件與資料庫擁有的 SQL NCHAR 值完全相同，包括資料庫添加的任何填充資料。

參數：

parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2，……

返回：

映射 NCHAR、NVARCHAR 或 LONGNVARCHAR 值的 String 物件

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

另請參見：

setNString(java.lang.String, java.lang.String)

getNString

String getNString(String parameterName)
                  throws SQLException

以 Java 程式語言中 String 的形式獲取指定的 NCHAR、NVARCHAR 或 LONGNVARCHAR 參數的值。

對於固定長度型別 JDBC NCHAR，返回的 String 物件與資料庫中所擁有的 SQL NCHAR 值完全相同，包括資料庫添加的任何填充資料。

參數：

parameterName - 參數名

返回：

映射 NCHAR、NVARCHAR 或 LONGNVARCHAR 值的 String 物件

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

另請參見：

setNString(java.lang.String, java.lang.String)

getNCharacterStream

Reader getNCharacterStream(int parameterIndex)
                           throws SQLException

以 Java 程式語言中 java.io.Reader 物件的形式獲取指定參數的值。此方法用於存取 NCHAR、NVARCHAR 和 LONGNVARCHAR 參數時。

參數：

parameterIndex - 第一個參數是 1，第二個參數是 2，……

返回：

包含參數值的 java.io.Reader 物件；如果值為 SQL NULL，則返回值為 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 物件；如果該值為 SQL NULL，則返回值是 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 物件；如果值為 SQL NULL，則返回值為 Java 程式語言中的 null。

拋出：

SQLException - 如果 parameterIndex 無效；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

從以下版本開始：

1.6

getCharacterStream

Reader getCharacterStream(String parameterName)
                          throws SQLException

以 Java 程式語言中 java.io.Reader 物件的形式獲取指定參數的值。

參數：

parameterName - 參數名

返回：

包含參數值的 java.io.Reader 物件；如果該值為 SQL NULL，則返回值是 Java 程式語言中的 null

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

setBlob

void setBlob(String parameterName,
             Blob x)
             throws SQLException

將指定參數設置為給定的 java.sql.Blob 物件。在將該物件發送到資料庫時，驅動程序將它轉換成一個 SQL BLOB 值。

參數：

parameterName - 參數名

x - 映射 SQL BLOB 值的 Blob 物件

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

setClob

void setClob(String parameterName,
             Clob x)
             throws SQLException

將指定參數設置為給定的 java.sql.Clob 物件。在將該物件發送到資料庫時，驅動程序將它轉換成一個 SQL CLOB 值。

參數：

parameterName - 參數名

x - 映射 SQL CLOB 值的 Clob 物件

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

setAsciiStream

void setAsciiStream(String parameterName,
                    InputStream x,
                    long length)
                    throws SQLException

將指定參數設置為給定輸入串流，該輸入串流將擁有指定的位元組數。在將一個非常大的 ASCII 值輸入到 LONGVARCHAR 參數時，通過 java.io.InputStream 發送它可能更為實際。將根據需要從串流中讀取資料，一直讀取到檔案末尾。驅動程序將執行從 ASCII 到資料庫 char 格式的任何必要轉換。

註：此串流物件既可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

參數：

parameterName - 參數名

x - 套件含 ASCII 參數值的 Java 輸入串流

length - 串流中的位元組數

拋出：

SQLException - 如果 parameterName 不對應於給定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

setBinaryStream

void setBinaryStream(String parameterName,
                     InputStream x,
                     long length)
                     throws SQLException

將指定參數設置為給定輸入串流，該輸入串流將擁有指定位元組數。在將一個非常大的二進制值輸入到 LONGVARBINARY 參數時，通過 java.io.InputStream 物件發送它可能更為實際。將根據需要從串流中讀取資料，一直讀取到檔案末尾。

註：此串流物件既可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

參數：

parameterName - 參數名

x - 套件含二進制參數值的 java 輸入串流

length - 串流中的位元組數

拋出：

SQLException - 如果 parameterName 不對應於給定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

setCharacterStream

void setCharacterStream(String parameterName,
                        Reader reader,
                        long length)
                        throws SQLException

將指定參數設置為給定 Reader 物件，該物件具有給定字元數長度。在將一個非常大的 UNICODE 值輸入給 LONGVARCHAR 參數時，通過 java.io.Reader 物件發送它可能更為實際。將根據需要從串流中讀取資料，一直讀取到檔案末尾。JDBC 驅動程序將執行從 UNICODE 到資料庫 char 格式的任何必要轉換。

註：此串流物件既可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

參數：

parameterName - 參數名

reader - 套件含用作指定參數的 UNICODE 資料的 java.io.Reader 物件

length - 串流中的位元組數

拋出：

SQLException - 如果 parameterName 不對應於給定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

setAsciiStream

void setAsciiStream(String parameterName,
                    InputStream x)
                    throws SQLException

將指定參數設置為給定輸入串流。在將一個非常大的 ASCII 值輸入到 LONGVARCHAR 參數時，通過 java.io.InputStream 發送它可能更為實際。將根據需要從串流中讀取資料，一直讀取到檔案末尾。JDBC 驅動程序將執行從 ASCII 到資料庫 char 格式的任何必要轉換。

註：此串流物件既可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

註：查詢 JDBC 驅動程序文檔，以確定使用帶 length 參數的 setAsciiStream 是否更有效。

參數：

parameterName - 參數名

x - 套件含 ASCII 參數值的 Java 輸入串流

x - 參數值

拋出：

SQLException - 如果 parameterName 不對應於給定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

setBinaryStream

void setBinaryStream(String parameterName,
                     InputStream x)
                     throws SQLException

將指定參數設置為給定輸入串流。在將一個非常大的二進制值輸入到 LONGVARBINARY 參數時，通過 java.io.InputStream 物件發送它可能更為實際。將根據需要從串流中讀取資料，一直讀取到檔案末尾。

註：此串流物件既可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

註：查詢 JDBC 驅動程序文檔，以確定使用帶 length 參數的 setBinaryStream 是否更有效。

參數：

parameterName - 參數名

x - 套件含二進制參數值的 java 輸入串流

拋出：

SQLException - 如果 parameterName 不對應於給定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

setCharacterStream

void setCharacterStream(String parameterName,
                        Reader reader)
                        throws SQLException

將指定參數設置為給定 Reader 物件。在將一個非常大的 UNICODE 值輸入到 LONGVARCHAR 參數時，通過 java.io.Reader 物件發送它可能更為實際。將根據需要從串流中讀取資料，一直讀取到檔案末尾。JDBC 驅動程序將執行從 UNICODE 到資料庫 char 格式的任何必要轉換。

註：此串流物件既可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

註：查詢 JDBC 驅動程序文檔，以確定使用帶 length 參數的 setCharacterStream 是否更有效。

參數：

parameterName - 參數名

reader - 套件含 Unicode 資料的 java.io.Reader 物件

拋出：

SQLException - 如果 parameterName 不對應於給定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

setNCharacterStream

void setNCharacterStream(String parameterName,
                         Reader value)
                         throws SQLException

將指定參數設置為 Reader 物件。Reader 將讀取資料，直到到達檔案末尾。驅動程序執行從 Java 字元格式到資料庫中國家字元集的必要轉換。

註：此串流物件既可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

註：查詢 JDBC 驅動程序文檔，以確定使用帶 length 參數的 setNCharacterStream 是否更有效。

參數：

parameterName - 要設置的參數名

value - 參數值

拋出：

SQLException - 如果 parameterName 不對應於給定參數；如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

setClob

void setClob(String parameterName,
             Reader reader)
             throws SQLException

將指定參數設置為 Reader 物件。此方法不同於 setCharacterStream (int, Reader) 方法，因為它會通知驅動程序應該將參數值作為 CLOB 發送給伺服器。在使用 setCharacterStream 方法時，驅動程序可能必須做一些額外的工作，以確定應該將參數資料作為 LONGVARCHAR 還是 CLOB 發送給伺服器。

註：查詢 JDBC 驅動程序文檔，以確定使用帶 length 參數的 setClob 是否更有效。

參數：

parameterName - 參數名

reader - 套件含用來設置參數值的資料的物件。

拋出：

SQLException - 如果 parameterName 不對應於指定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

setBlob

void setBlob(String parameterName,
             InputStream inputStream)
             throws SQLException

將指定參數設置為 InputStream 物件。此方法不同於 setBinaryStream (int, InputStream) 方法，因為它會通知驅動程序應該將參數值作為 BLOB 發送給伺服器。在使用 setBinaryStream 方法時，驅動程序可能必須做一些額外的工作，以確定應該將參數資料作為 LONGVARBINARY 還是 BLOB 發送給伺服器。

註：查詢 JDBC 驅動程序文檔，以確定使用帶 length 參數的 setBlob 是否更有效。

參數：

parameterName - 參數名

inputStream - 套件含用來設置參數值的資料的物件。

拋出：

SQLException - 如果 parameterName 不對應於給定參數；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

setNClob

void setNClob(String parameterName,
              Reader reader)
              throws SQLException

將指定參數設置為 Reader 物件。此方法不同於 setCharacterStream (int, Reader) 方法，因為它會通知驅動程序應該將參數值作為 NCLOB 發送給伺服器。在使用 setCharacterStream 方法時，驅動程序可能必須做一些額外的工作，以確定應該將參數資料作為 LONGNVARCHAR 還是 NCLOB 發送給伺服器。

註：查詢 JDBC 驅動程序文檔，以確定使用帶 length 參數的 setNClob 是否更有效。

參數：

parameterName - 參數名

reader - 套件含用來設置參數值的資料的物件。

拋出：

SQLException - 如果 parameterName 不對應於給定參數；如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；如果發生資料庫存取錯誤，或者在關閉的 CallableStatement 上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6