1.8 api詳細介紹Interface CallableStatement
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方法在執行get 。
A CallableStatement可以返回一個ResultSet對象或多個ResultSet對象。 多個ResultSet對象使用從Statement ResultSet操作來處理。
爲獲得最大的便攜性，應在處理輸出參數值之前處理一個電話ResultSet對象和更新計數。
方法詳細信息介紹：
registerOutParameter
void registerOutParameter(int parameterIndex,
int sqlType)
throws SQLException
將序號parameterIndex中的OUT參數parameterIndex到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參數必須在執行存儲過程之前進行註冊。
用於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參數的值是否爲NULL 。 請注意，此方法只能在調用getter方法後調用; 否則，在確定是否爲null時沒有使用價值。
結果
true如果最後一個參數讀取爲SQL NULL ; false否則
異常
SQLException - 如果發生數據庫訪問錯誤或此方法在關閉的 CallableStatement
getString
String getString(int parameterIndex)
throws SQLException
獲取指定的JDBC值CHAR ， VARCHAR ，或LONGVARCHAR參數爲String的Java編程語言。
對於固定長度類型的JDBC CHAR ，返回的String對象與SQL CHAR值在數據庫中具有完全相同的值，包括數據庫添加的任何填充。
參數
parameterIndex - 第一個參數是1，第二個是2，依此類推
結果
參數值。 如果值爲SQL NULL ，則結果爲null 。
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
另請參見：
setString(java.lang.String, java.lang.String)
getBoolean
boolean getBoolean(int parameterIndex)
throws SQLException
獲取指定的JDBC的值 BIT或 BOOLEAN作爲參數 boolean Java編程語言。
參數
parameterIndex - 第一個參數是1，第二個是2，依此類推
結果
參數值。 如果值爲SQL NULL ，則結果爲false 。
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
另請參見：
setBoolean(java.lang.String, boolean)
getByte
byte getByte(int parameterIndex)
throws SQLException
獲取指定的JDBC的價值 TINYINT參數爲 byte的Java編程語言。
參數
parameterIndex - 第一個參數是1，第二個是2，依此類推
結果
參數值。 如果值爲SQL NULL ，則結果爲0 。
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
另請參見：
setByte(java.lang.String, byte)
getShort
short getShort(int parameterIndex)
throws SQLException
獲取指定的JDBC的價值 SMALLINT參數爲 short的Java編程語言。
參數
parameterIndex - 第一個參數是1，第二個是2，依此類推
結果
參數值。 如果值爲SQL NULL ，則結果爲0 。
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
另請參見：
setShort(java.lang.String, short)
getInt
int getInt(int parameterIndex)
throws SQLException
獲取指定的JDBC的價值 INTEGER作爲參數 int Java編程語言。
參數
parameterIndex - 第一個參數是1，第二個是2，依此類推
結果
參數值。 如果值爲SQL NULL ，則結果爲0 。
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
另請參見：
setInt(java.lang.String, int)
getLong
long getLong(int parameterIndex)
throws SQLException
獲取指定的JDBC的價值 BIGINT參數爲 long的Java編程語言。
參數
parameterIndex - 第一個參數是1，第二個是2，依此類推
結果
參數值。 如果值爲SQL NULL ，則結果爲0 。
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
另請參見：
setLong(java.lang.String, long)
getFloat
float getFloat(int parameterIndex)
throws SQLException
獲取指定的JDBC的價值 FLOAT參數爲 float的Java編程語言。
參數
parameterIndex - 第一個參數是1，第二個是2，依此類推
結果
參數值。 如果值爲SQL NULL ，則結果爲0 。
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
另請參見：
setFloat(java.lang.String, float)
getDouble
double getDouble(int parameterIndex)
throws SQLException
獲取指定的JDBC的價值 DOUBLE參數爲 double的Java編程語言。
參數
parameterIndex - 第一個參數是1，第二個是2，依此類推
結果
參數值。 如果值爲SQL NULL ，則結果爲0 。
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
另請參見：
setDouble(java.lang.String, double)
getBigDecimal
@Deprecated
BigDecimal getBigDecimal(int parameterIndex,
int scale)
throws SQLException
已棄用 使用getBigDecimal(int parameterIndex)或getBigDecimal(String parameterName)
將指定的JDBC NUMERIC參數的值檢索爲 java.math.BigDecimal對象，其小數點右側的 比例數字。
參數
parameterIndex - 第一個參數是1，第二個是2，依此類推
scale - 小數點右側的位數
結果
參數值。 如果值爲SQL NULL ，則結果爲null 。
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
另請參見：
setBigDecimal(java.lang.String, java.math.BigDecimal)
getBytes
byte[] getBytes(int parameterIndex)
throws SQLException
將指定的JDBC BINARY或 VARBINARY參數的值作爲Java編程語言中的 byte值的數組檢索。
參數
parameterIndex - 第一個參數是1，第二個是2，依此類推
結果
參數值。 如果值爲SQL NULL ，則結果爲null 。
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
另請參見：
setBytes(java.lang.String, byte[])
getDate
Date getDate(int parameterIndex)
throws SQLException
將指定的JDBC DATE參數的值檢索爲 java.sql.Date對象。
參數
parameterIndex - 第一個參數是1，第二個是2，依此類推
結果
參數值。 如果值爲SQL NULL ，則結果爲null 。
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
另請參見：
setDate(java.lang.String, java.sql.Date)
getTime
Time getTime(int parameterIndex)
throws SQLException
將指定的JDBC TIME參數的值檢索爲 java.sql.Time對象。
參數
parameterIndex - 第一個參數是1，第二個是2，依此類推
結果
參數值。 如果值爲SQL NULL ，則結果爲null 。
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
另請參見：
setTime(java.lang.String, java.sql.Time)
getTimestamp
Timestamp getTimestamp(int parameterIndex)
throws SQLException
將指定的JDBC TIMESTAMP參數的值檢索爲 java.sql.Timestamp對象。
參數
parameterIndex - 第一個參數是1，第二個是2，依此類推
結果
參數值。 如果值爲SQL NULL ，則結果爲null 。
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
另請參見：
setTimestamp(java.lang.String, java.sql.Timestamp)
getObject
Object getObject(int parameterIndex)
throws SQLException
檢索作爲指定參數的值Object Java編程語言。 如果該值爲SQL NULL ，則驅動程序返回Java null 。
此方法返回一個Java對象，該對象的類型與使用方法registerOutParameter爲該參數註冊的JDBC類型registerOutParameter 。 通過將目標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
將指定的JDBC NUMERIC參數的值檢索爲 java.math.BigDecimal對象，其值包含小數點右側的數字。
參數
parameterIndex - 第一個參數是1，第二個是2，依此類推
結果
參數值全精度。 如果值爲SQL NULL ，則結果爲null 。
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
從以下版本開始：
1.2
另請參見：
setBigDecimal(java.lang.String, java.math.BigDecimal)
getObject
Object getObject(int parameterIndex,
Map<String,類<?>> map)
throws SQLException
返回一個表示OUT參數的值的對象， parameterIndex和使用map用於該參數值的自定義映射。
此方法返回一個Java對象，該對象的類型與使用方法registerOutParameter爲此參數註冊的JDBC類型registerOutParameter 。 通過將目標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
將指定的JDBC REF(<structured-type>)參數的值作爲Java編程語言中的Ref對象檢索。
參數
parameterIndex - 第一個參數是1，第二個是2，依此類推
結果
該參數值作爲Java編程語言中的一個Ref對象。 如果值爲SQL NULL ，則返回值null 。
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.2
getBlob
Blob getBlob(int parameterIndex)
throws SQLException
以Java編程語言的形式獲取指定的JDBC BLOB參數的值作爲Blob對象。
參數
parameterIndex - 第一個參數是1，第二個是2，依此類推
結果
參數值爲Java編程語言中的Blob對象。 如果值爲SQL NULL ，則返回值null 。
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.2
getClob
Clob getClob(int parameterIndex)
throws SQLException
以Java編程語言的形式獲取指定的JDBC CLOB參數的值作爲 java.sql.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
將指定的JDBC 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
將指定的JDBC TIME參數的值檢索爲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
將指定的JDBC 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參數parameterName到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使用接受比例值的registerOutParameter版本。
異常
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
registerOutParameter
void registerOutParameter(String parameterName,
int sqlType,
int scale)
throws SQLException
註冊命名的參數parameterName JDBC類型的sqlType 。 所有OUT參數必須在執行存儲過程之前進行註冊。
通過指定JDBC類型sqlType爲OUT參數確定必須在所使用的Java類型get方法來讀取該參數的值。
這個版本registerOutParameter當參數是JDBC類型應使用NUMERIC或DECIMAL 。
參數
parameterName - 參數的名稱
sqlType - 由 java.sql.Types定義的SQL類型代碼。
scale - 小數點右側所需的數字位數。 它必須大於或等於零。
異常
SQLException - 如果parameterName與命名參數不對應; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException -如果 sqlType是 ARRAY ， BLOB ， CLOB ， DATALINK ， JAVA_OBJECT ， NCHAR ， NCLOB ， NVARCHAR ， LONGNVARCHAR ， REF ， ROWID ， SQLXML或 STRUCT數據類型和JDBC驅動程序不支持此數據類型，或者JDBC驅動程序不支持這種方法
從以下版本開始：
1.4
另請參見：
Types
registerOutParameter
void registerOutParameter(String parameterName,
int sqlType,
String typeName)
throws SQLException
註冊指定的輸出參數。 此版本的方法registerOutParameter應用於用戶名或REF輸出參數。 用戶命名類型的示例包括：STRUCT，DISTINCT，JAVA_OBJECT和命名的數組類型。
所有OUT參數必須在執行存儲過程之前進行註冊。
對於用戶命名的參數，還應該給出參數的完全限定的SQL類型名稱，而REF參數要求給定引用類型的完全限定類型名稱。 不需要類型代碼和類型名稱信息的JDBC驅動程序可能會忽略它。 然而，爲了便於攜帶，應用程序應始終爲用戶命名和REF參數提供這些值。 儘管它是用於用戶命名的和REF參數的，但是該方法可以用於註冊任何JDBC類型的參數。 如果該參數不具有用戶名或REF類型，則將忽略typeName參數。
注意：讀取out參數的值時，必須使用Java類型XXX對應於參數的註冊SQL類型的getXXX方法。
參數
parameterName - 參數的名稱
sqlType - 一個值來自Types
typeName - SQL結構化類型的全限定名稱
異常
SQLException - 如果parameterName不對應於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
將指定的JDBC DATALINK參數的值檢索爲 java.net.URL對象。
參數
parameterIndex - 第一個參數是1，第二個是2，...
結果
一個 java.net.URL對象，表示用作指定參數的JDBC DATALINK值
異常
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不對應於named參數; 如果發生數據庫訪問錯誤; 該方法在封閉的CallableStatement上調用，或者網址格式錯誤
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不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的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不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
getFloat(int)
setDouble
void setDouble(String parameterName,
double x)
throws SQLException
將指定的參數設置爲給定的Java double值。 當驅動程序將其發送到數據庫時，將其轉換爲SQL DOUBLE值。
參數
parameterName - 參數的名稱
x - 參數值
異常
SQLException - 如果parameterName不對應於named參數; 如果發生數據庫訪問錯誤或在關閉的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不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的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字節數組。 當驅動程序將其發送到數據庫時，驅動程序將其轉換爲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設置爲給定的java.sql.Date值。 當驅動程序將其發送到數據庫時，將其轉換爲SQL DATE值。
參數
parameterName - 參數的名稱
x - 參數值
異常
SQLException - 如果parameterName不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的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不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的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發送它可能更java.io.InputStream 。 將根據需要從流中讀取數據，直到達到文件結尾。 JDBC驅動程序將從ASCII到數據庫字符格式進行任何必要的轉換。
注意：此流對象可以是標準Java流對象，也可以是實現標準接口的自己的子類。
參數
parameterName - 參數的名稱
x - 包含ASCII參數值的Java輸入流
length - 流中的字節數
異常
SQLException - 如果parameterName不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的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不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的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不對應於named參數; 如果發生數據庫訪問錯誤，則該方法在關閉的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 -所述 java.io.Reader包含用作指定參數的UNICODE數據對象
length - 流中的字符數
異常
SQLException - 如果parameterName不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.4
setDate
void setDate(String parameterName,
Date x,
Calendar cal)
throws SQLException
使用給定的Calendar對象將指定的Calendar設置爲給定的java.sql.Date值。 驅動程序使用Calendar對象來構造一個SQL DATE值，然後驅動程序將其發送到數據庫。 使用aa Calendar對象，驅動程序可以計算考慮到自定義時區的日期。 如果沒有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對象將指定的Calendar設置爲給定的java.sql.Time值。 驅動程序使用Calendar對象來構造一個SQL TIME值，然後驅動程序將其發送到數據庫。 使用aa Calendar對象，驅動程序可以計算考慮到自定義時區的時間。 如果沒有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對象將指定的Calendar設置爲給定的java.sql.Timestamp值。 驅動程序使用Calendar對象來構造一個SQL TIMESTAMP值，然後驅動程序將其發送到數據庫。 使用aa Calendar對象，驅動程序可以計算考慮到自定義時區的時間戳。 如果沒有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
將指定的參數設置爲SQL NULL 。 此版本的方法setNull應用於用戶定義的類型和REF類型參數。 用戶定義類型的示例包括：STRUCT，DISTINCT，JAVA_OBJECT和命名的數組類型。
注意：爲了便於攜帶，當指定NULL用戶定義或REF參數時，應用程序必須給出SQL類型代碼和完全限定的SQL類型名稱。 在用戶定義類型的情況下，名稱是參數本身的類型名稱。 對於REF參數，名稱是引用類型的類型名稱。
儘管它是用於用戶定義的和參數的參數，但是該方法可以用於設置任何JDBC類型的空值參數。 如果參數沒有用戶定義或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
檢索JDBC的值CHAR ， VARCHAR ，或LONGVARCHAR作爲參數String Java編程語言。
對於固定長度類型的JDBC CHAR ，返回的String對象與SQL CHAR值在數據庫中具有完全相同的值，包括數據庫添加的任何填充。
參數
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
檢索JDBC的值 BIT或 BOOLEAN作爲參數 boolean Java編程語言。
參數
parameterName - 參數的名稱
結果
參數值。 如果值爲SQL NULL ，則結果爲false 。
異常
SQLException - 如果parameterName與命名參數不對應; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
setBoolean(java.lang.String, boolean)
getByte
byte getByte(String parameterName)
throws SQLException
檢索JDBC的價值 TINYINT參數爲 byte的Java編程語言。
參數
parameterName - 參數的名稱
結果
參數值。 如果值爲SQL NULL ，則結果爲0 。
異常
SQLException - 如果parameterName與命名參數不對應; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
setByte(java.lang.String, byte)
getShort
short getShort(String parameterName)
throws SQLException
檢索JDBC的價值 SMALLINT參數爲 short的Java編程語言。
參數
parameterName - 參數的名稱
結果
參數值。 如果值爲SQL NULL ，則結果爲0 。
異常
SQLException - 如果parameterName與命名參數不對應; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
setShort(java.lang.String, short)
getInt
int getInt(String parameterName)
throws SQLException
檢索JDBC的價值 INTEGER作爲參數 int Java編程語言。
參數
parameterName - 參數的名稱
結果
參數值。 如果值爲SQL NULL ，則結果爲0 。
異常
SQLException - 如果parameterName不對應於命名參數; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
setInt(java.lang.String, int)
getLong
long getLong(String parameterName)
throws SQLException
檢索JDBC的價值 BIGINT參數爲 long的Java編程語言。
參數
parameterName - 參數的名稱
結果
參數值。 如果值爲SQL NULL ，則結果爲0 。
異常
SQLException - 如果parameterName不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
setLong(java.lang.String, long)
getFloat
float getFloat(String parameterName)
throws SQLException
檢索JDBC的價值 FLOAT參數爲 float的Java編程語言。
參數
parameterName - 參數的名稱
結果
參數值。 如果值爲SQL NULL ，則結果爲0 。
異常
SQLException - 如果parameterName與命名參數不對應; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
setFloat(java.lang.String, float)
getDouble
double getDouble(String parameterName)
throws SQLException
檢索JDBC的價值 DOUBLE參數爲 double的Java編程語言。
參數
parameterName - 參數的名稱
結果
參數值。 如果值爲SQL NULL ，則結果爲0 。
異常
SQLException - 如果parameterName不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
setDouble(java.lang.String, double)
getBytes
byte[] getBytes(String parameterName)
throws SQLException
以Java編程語言中的byte數組的 byte JDBC BINARY或 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對象的JDBC DATE參數的值。
參數
parameterName - 參數的名稱
結果
參數值。 如果值爲SQL NULL ，則結果爲null 。
異常
SQLException - 如果parameterName不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的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對象的 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
檢索作爲一個參數的值Object Java編程語言。 如果該值爲SQL NULL ，則驅動程序返回Java null 。
此方法返回一個Java對象，其類型對應於使用方法registerOutParameter爲此參數註冊的JDBC類型。 通過將目標JDBC類型註冊爲java.sql.Types.OTHER ，此方法可用於讀取數據庫特定的抽象數據類型。
參數
parameterName - 參數的名稱
結果
A java.lang.Object保存OUT參數值。
異常
SQLException - 如果parameterName不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
Types ， setObject(java.lang.String, java.lang.Object, int, int)
getBigDecimal
BigDecimal getBigDecimal(String parameterName)
throws SQLException
將JDBC NUMERIC參數的值作爲 java.math.BigDecimal對象檢索，該對象的值包含小數點右側的數字。
參數
parameterName - 參數的名稱
結果
參數值全精度。 如果值爲SQL NULL ，則結果爲null 。
異常
SQLException - 如果parameterName不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
setBigDecimal(java.lang.String, java.math.BigDecimal)
getObject
Object getObject(String parameterName,
Map<String,類<?>> map)
throws SQLException
返回一個表示OUT參數的值的對象， parameterName和使用map用於該參數值的自定義映射。
此方法返回一個Java對象，其類型對應於使用方法registerOutParameter爲該參數註冊的JDBC類型。 通過將目標JDBC類型註冊爲java.sql.Types.OTHER ，此方法可用於讀取特定於數據庫的抽象數據類型。
參數
parameterName - 參數的名稱
map - 從SQL類型名稱到Java類的映射
結果
一個 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
檢索JDBC的價值REF(<structured-type>)參數爲Ref的Java編程語言對象。
參數
parameterName - 參數的名稱
結果
該參數值作爲Java編程語言中的一個Ref對象。 如果值爲SQL NULL ，則返回值null 。
異常
SQLException - 如果parameterName不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.4
getBlob
Blob getBlob(String parameterName)
throws SQLException
以Java編程語言的Blob對象的BLOB獲取JDBC BLOB參數的值。
參數
parameterName - 參數的名稱
結果
該參數值作爲Java編程語言中的一個Blob對象。 如果值爲SQL NULL ，則返回值null 。
異常
SQLException - 如果parameterName不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.4
getClob
Clob getClob(String parameterName)
throws SQLException
檢索JDBC的價值 CLOB參數爲 java.sql.Clob的Java編程語言對象。
參數
parameterName - 參數的名稱
結果
參數值爲Clob對象的Java編程語言。 如果該值爲SQL NULL ，則返回值null 。
異常
SQLException - 如果parameterName不對應於命名參數; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.4
getArray
Array getArray(String parameterName)
throws SQLException
以Java編程語言中的Array對象的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對象的DATE獲取JDBC DATE參數的值，使用給定的Calendar對象來構造日期。 使用Calendar對象，驅動程序可以計算考慮到自定義時區和區域設置的日期。 如果沒有Calendar對象，則驅動程序將使用默認的時區和區域設置。
參數
parameterName - 參數的名稱
cal - 驅動程序將用於構建日期的 Calendar對象
結果
參數值。 如果值爲SQL NULL ，則結果爲null 。
異常
SQLException - 如果parameterName不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
setDate(java.lang.String, java.sql.Date)
getTime
Time getTime(String parameterName,
Calendar cal)
throws SQLException
以java.sql.Time對象的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
檢索JDBC TIMESTAMP參數的值作爲java.sql.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不對應於named參數; 如果發生數據庫訪問錯誤，此方法在封閉的CallableStatement ，或者如果URL有問題
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
setURL(java.lang.String, java.net.URL)
getRowId
RowId getRowId(int parameterIndex)
throws SQLException
將指定的JDBC ROWID參數的值檢索爲 java.sql.RowId對象。
參數
parameterIndex - 第一個參數是1，第二個是2，...
結果
將RowId表示JDBC ROWID值的RowId對象作爲指定參數。 如果參數包含SQL NULL ，則返回一個null值。
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.6
getRowId
RowId getRowId(String parameterName)
throws SQLException
將指定的JDBC ROWID參數的值檢索爲 java.sql.RowId對象。
參數
parameterName - 參數的名稱
結果
使用RowId JDBC ROWID值的RowId對象作爲指定參數。 如果參數包含SQL NULL ，則返回一個null值。
異常
SQLException - 如果parameterName不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.6
setRowId
void setRowId(String parameterName,
RowId x)
throws SQLException
將指定的參數設置爲給定的java.sql.RowId對象。 當驅動程序將其發送到數據庫時，將其轉換爲SQL ROWID 。
參數
parameterName - 參數的名稱
x - 參數值
異常
SQLException - 如果parameterName不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.6
setNString
void setNString(String parameterName,
String value)
throws SQLException
將指定的參數設置爲給定的String對象。 驅動程序將其轉換爲SQL NCHAR或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與命名參數不對應; 如果司機不支持國家字符集; 如果驅動程序可以檢測到可能發生數據轉換錯誤; 如果發生數據庫訪問錯誤或在封閉的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必須包含由長度指定的SQLException數，否則將在執行CallableStatement時生成CallableStatement 。 該方法與setCharacterStream (int, Reader, int)方法不同，因爲它通知驅動程序參數值應作爲CLOB發送到服務器。 當使用setCharacterStream方法時，驅動程序可能需要額外的工作才能確定參數數據是否應以LONGVARCHAR或CLOB發送到服務器
參數
parameterName - 要設置的參數的名稱
reader - 包含用於設置參數值的數據的對象。
length - 參數數據中的字符數。
異常
SQLException - 如果parameterName與命名參數不對應; 如果指定的長度小於零; 發生數據庫訪問錯誤，或者在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.6
setBlob
void setBlob(String parameterName,
InputStream inputStream,
long length)
throws SQLException
將指定的參數設置爲InputStream對象。 inputstream必須包含由長度指定的字符數， SQLException將在執行CallableStatement時生成CallableStatement 。 該方法與setBinaryStream (int, InputStream, int)方法不同，因爲它通知驅動程序參數值應作爲BLOB發送到服務器。 當使用setBinaryStream方法時，驅動程序可能需要進行額外的工作才能確定是否將參數數據作爲LONGVARBINARY或BLOB發送到服務器
參數
parameterName - 要設置的第二個參數的名稱是2，...
inputStream - 包含將參數值設置爲的數據的對象。
length - 參數數據中的字節數。
異常
SQLException - 如果parameterName與命名參數不對應; 如果指定的長度小於零; 如果輸入流中的字節數與指定長度不匹配; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.6
setNClob
void setNClob(String parameterName,
Reader reader,
long length)
throws SQLException
將指定的參數設置爲Reader對象。 reader必須包含由長度指定的SQLException數，否則將在執行CallableStatement時生成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
將指定的JDBC NCLOB參數的值作爲Java編程語言中的 java.sql.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對象的 NCLOB獲取JDBC NCLOB參數的值。
參數
parameterName - 參數的名稱
結果
該參數值作爲Java編程語言中的一個NClob對象。 如果值爲SQL NULL ，則返回值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不對應於命名參數; 如果發生數據庫訪問錯誤; 這個方法被稱爲在關閉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 SQL XML參數的值。
參數
parameterIndex - 第一個參數的索引爲1，第二個爲2，...
結果
一個 SQLXML對象映射一個 SQL XML值
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.6
getSQLXML
SQLXML getSQLXML(String parameterName)
throws SQLException
檢索指定的值 SQL XML參數爲 java.sql.SQLXML的Java編程語言對象。
參數
parameterName - 參數的名稱
結果
一個 SQLXML對象映射一個 SQL XML值
異常
SQLException - 如果parameterName不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.6
getNString
String getNString(int parameterIndex)
throws SQLException
檢索指定的值NCHAR ， NVARCHAR或LONGNVARCHAR作爲參數String Java編程語言。
對於固定長度類型的JDBC NCHAR ，返回的String對象具有與數據庫中SQL NCHAR值相同的值，包括數據庫添加的任何填充。
參數
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對象與數據庫中SQL NCHAR值完全相同，包括數據庫添加的任何填充。
參數
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對象; 如果值是SQL NULL ，返回的值是null Java編程語言。
異常
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 ，返回的值爲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對象; 如果值是SQL NULL ，返回的值是null Java編程語言。
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
從以下版本開始：
1.6
getCharacterStream
Reader getCharacterStream(String parameterName)
throws SQLException
以Java編程語言中的 java.io.Reader對象獲取指定參數的值。
參數
parameterName - 參數的名稱
結果
一個包含參數值的java.io.Reader對象; 如果值爲SQL NULL ，則返回的值爲null ，在Java編程語言
異常
SQLException - 如果parameterName不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的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不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.6
setAsciiStream
void setAsciiStream(String parameterName,
InputStream x,
long length)
throws SQLException
將指定的參數設置爲給定的輸入流，它將具有指定的字節數。 當一個非常大的ASCII值輸入到LONGVARCHAR參數時，通過java.io.InputStream發送它可能更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 -所述 java.io.Reader包含用作指定參數的UNICODE數據對象
length - 流中的字符數
異常
SQLException - 如果parameterName與命名參數不對應; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.6
setAsciiStream
void setAsciiStream(String parameterName,
InputStream x)
throws SQLException
將指定的參數設置爲給定的輸入流。 當一個非常大的ASCII值輸入到LONGVARCHAR參數時，通過java.io.InputStream發送它可能會更加java.io.InputStream 。 將根據需要從流中讀取數據，直到達到文件結尾。 JDBC驅動程序將從ASCII到數據庫字符格式進行任何必要的轉換。
注意：此流對象可以是標準Java流對象，也可以是實現標準接口的自己的子類。
注意：請參閱您的JDBC驅動程序文檔，以確定使用需要長度參數的版本setAsciiStream可能會更有效。
參數
parameterName - 參數的名稱
x - 包含ASCII參數值的Java輸入流
異常
SQLException - 如果parameterName不對應於named參數; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.6
setBinaryStream
void setBinaryStream(String parameterName,
InputStream x)
throws SQLException
將指定的參數設置爲給定的輸入流。 當一個非常大的二進制值輸入到一個LONGVARBINARY參數時，通過一個java.io.InputStream對象發送它可能會比較實用。 數據將根據需要從流中讀取，直到達到文件結尾。
注意：此流對象可以是標準Java流對象，也可以是實現標準接口的自己的子類。
注意：請參閱您的JDBC驅動程序文檔，以確定使用一個長度參數的版本setBinaryStream可能會更有效。
參數
parameterName - 參數的名稱
x - 包含二進制參數值的java輸入流
異常
SQLException - 如果parameterName與命名參數不對應; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.6
setCharacterStream
void setCharacterStream(String parameterName,
Reader reader)
throws SQLException
將指定的參數設置爲給定的Reader對象。 當一個非常大的UNICODE值輸入到LONGVARCHAR參數時，通過java.io.Reader對象發送它可能更實用。 數據將根據需要從流中讀取，直到達到文件結尾。 JDBC驅動程序將從UNICODE到數據庫字符格式進行任何必要的轉換。
注意：此流對象可以是標準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不對應於named參數; 如果司機不支持國家字符集; 如果驅動程序可以檢測到可能發生數據轉換錯誤; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.6
getObject
<T> T getObject(int parameterIndex,
類<T> type)
throws SQLException
返回一個對象，表示OUT參數的值parameterIndex並將從SQL類型的參數轉換爲所請求的Java數據類型，如果支持的轉換。 如果不支持轉換或爲該類型指定了SQLException則拋出SQLException 。
至少，實現必須支持附錄B表B-3中定義的轉換，並將適當的用戶定義的SQL類型轉換爲實現SQLData或Struct的Java類型。 可以支持額外的轉換，並定義供應商。
參數類型
T - 由此Class對象建模的類的類型
參數
parameterIndex - 第一個參數是1，第二個是2，依此類推
type - 表示將數據類型轉換爲指定參數的類。
結果
一個保留OUT參數值的 type的實例
異常
SQLException - 如果不支持轉換，則type爲null或發生其他錯誤。 異常的getCause（）方法可能會提供更詳細的異常，例如，如果發生轉換錯誤
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持此方法
從以下版本開始：
1.7
getObject
<T> T getObject(String parameterName,
類<T> type)
throws SQLException
返回一個對象，表示OUT參數的值parameterName並將從SQL類型的參數轉換爲所請求的Java數據類型，如果支持的轉換。 如果不支持轉換或爲該類型指定了SQLException則拋出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與命名參數不對應; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法，或者如果x指定的Java對象是InputStream或Reader對象，並且scale參數的值小於零
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持指定的targetSqlType
從以下版本開始：
1.8
另請參見：
JDBCType ， SQLType
setObject
default void setObject(String parameterName,
Object x,
SQLType targetSqlType)
throws SQLException
使用給定對象設置指定參數的值。 該方法類似於setObject(String parameterName, Object x, SQLType targetSqlType, int scaleOrLength) ，除了它假定爲零。
默認實現將拋出SQLFeatureNotSupportedException
參數
parameterName - 參數的名稱
x - 包含輸入參數值的對象
targetSqlType - 要發送到數據庫的SQL類型
異常
SQLException - 如果parameterName與命名參數不對應; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持指定的targetSqlType
從以下版本開始：
1.8
另請參見：
JDBCType ， SQLType
registerOutParameter
default void registerOutParameter(int parameterIndex,
SQLType sqlType)
throws SQLException
將序號parameterIndex中的OUT參數parameterIndex到JDBC類型sqlType 。 所有OUT參數必須在執行存儲過程之前進行註冊。
sqlType爲OUT參數指定的JDBC類型決定了在get方法中必須使用的Java類型，以讀取該參數的值。
如果預期要返回給此輸出參數的JDBC類型是特定於該特定的數據庫， sqlType可以是JDBCType.OTHER或SQLType由該JDBC驅動程序支持。 方法getObject(int)檢索該值。
默認實現將拋出SQLFeatureNotSupportedException
參數
parameterIndex - 第一個參數是1，第二個是2，依此類推
sqlType - 由SQLType定義的JDBC類型代碼用於註冊OUT參數。 如果參數是JDBC類型JDBCType.NUMERIC或JDBCType.DECIMAL ， registerOutParameter使用接受比例值的registerOutParameter版本。
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持指定的sqlType
從以下版本開始：
1.8
另請參見：
JDBCType ， SQLType
registerOutParameter
default void registerOutParameter(int parameterIndex,
SQLType sqlType,
int scale)
throws SQLException
將序號parameterIndex爲JDBC類型sqlType 。 所有OUT參數必須在執行存儲過程之前進行註冊。
由sqlType爲OUT參數指定的JDBC類型決定了在get方法中必須使用的Java類型，以讀取該參數的值。
這個版本registerOutParameter當參數是JDBC類型應使用JDBCType.NUMERIC或JDBCType.DECIMAL 。
默認實現將拋出SQLFeatureNotSupportedException
參數
parameterIndex - 第一個參數是1，第二個是2，依此類推
sqlType - 由 SQLType定義的JDBC類型代碼用於註冊OUT參數。
scale - 小數點右側所需的數字位數。 它必須大於或等於零。
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持指定的sqlType
從以下版本開始：
1.8
另請參見：
JDBCType ， SQLType
registerOutParameter
default void registerOutParameter(int parameterIndex,
SQLType sqlType,
String typeName)
throws SQLException
註冊指定的輸出參數。 此版本的方法registerOutParameter應用於用戶定義或REF輸出參數。 的用戶定義類型的實例包括： STRUCT ， DISTINCT ， JAVA_OBJECT ，和指定數組類型。
所有OUT參數必須在執行存儲過程之前進行註冊。
對於用戶定義的參數，還應該給出參數的完全限定的SQL類型名稱，而REF參數需要給出引用類型的完全限定類型名稱。 不需要類型代碼和類型名稱信息的JDBC驅動程序可能會忽略它。 然而，爲了便於攜帶，應用程序應始終爲用戶定義和REF參數提供這些值。 雖然它是用於用戶定義和REF參數，但是該方法可以用於註冊任何JDBC類型的參數。 如果該參數不具有用戶定義或REF類型，則typeName參數將被忽略。
注意：讀取out參數的值時，必須使用Java類型對應於參數的註冊SQL類型的getter方法。
默認實現將拋出SQLFeatureNotSupportedException
參數
parameterIndex - 第一個參數是1，第二個是2，...
sqlType - 由 SQLType定義的JDBC類型代碼用於註冊OUT參數。
typeName - SQL結構化類型的全限定名稱
異常
SQLException - 如果parameterIndex無效; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持指定的sqlType
從以下版本開始：
1.8
另請參見：
JDBCType ， SQLType
registerOutParameter
default void registerOutParameter(String parameterName,
SQLType sqlType)
throws SQLException
將名爲parameterName的OUT參數parameterName到JDBC類型sqlType 。 所有OUT參數必須在執行存儲過程之前進行註冊。
通過指定JDBC類型sqlType爲OUT參數確定必須在所使用的Java類型get方法來讀取該參數的值。
如果預期要返回給此輸出參數的JDBC類型是特定於該特定的數據庫， sqlType應該是JDBCType.OTHER或SQLType由該JDBC驅動程序支持..方法getObject(int)檢索值。
默認實現將拋出SQLFeatureNotSupportedException
參數
parameterName - 參數的名稱
sqlType - 由SQLType定義的JDBC類型代碼用於註冊OUT參數。 如果參數是JDBC類型JDBCType.NUMERIC或JDBCType.DECIMAL ， registerOutParameter使用接受比例值的registerOutParameter版本。
異常
SQLException - 如果parameterName與命名參數不對應; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持指定的sqlType或JDBC驅動程序不支持此方法
從以下版本開始：
1.8
另請參見：
JDBCType ， SQLType
registerOutParameter
default void registerOutParameter(String parameterName,
SQLType sqlType,
int scale)
throws SQLException
註冊命名的參數parameterName JDBC類型的sqlType 。 所有OUT參數必須在執行存儲過程之前進行註冊。
sqlType爲OUT參數指定的JDBC類型決定了在get方法中必須使用的Java類型，以讀取該參數的值。
這個版本registerOutParameter當參數是JDBC類型應使用JDBCType.NUMERIC或JDBCType.DECIMAL 。
默認實現將拋出SQLFeatureNotSupportedException
參數
parameterName - 參數的名稱
sqlType - 由 SQLType定義的JDBC類型代碼用於註冊OUT參數。
scale - 小數點右側所需的數字位數。 它必須大於或等於零。
異常
SQLException - 如果parameterName不對應於一個命名參數; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持指定的sqlType或JDBC驅動程序不支持此方法
從以下版本開始：
1.8
另請參見：
JDBCType ， SQLType
registerOutParameter
default void registerOutParameter(String parameterName,
SQLType sqlType,
String typeName)
throws SQLException
註冊指定的輸出參數。 該版本的方法registerOutParameter應該用於用戶名或REF輸出參數。 用戶命名類型的示例包括：STRUCT，DISTINCT，JAVA_OBJECT和命名的數組類型。
所有OUT參數必須在執行存儲過程之前進行註冊。
對於用戶命名的參數，還應該給出參數的完全限定的SQL類型名稱，而REF參數要求給定引用類型的完全限定類型名稱。 不需要類型代碼和類型名稱信息的JDBC驅動程序可能會忽略它。 然而，爲了便於攜帶，應用程序應始終爲用戶命名和REF參數提供這些值。 儘管它是用於用戶命名的和REF參數的，但是該方法可以用於註冊任何JDBC類型的參數。 如果該參數不具有用戶名或REF類型，則將忽略typeName參數。
注意：讀取out參數的值時，必須使用Java類型XXX對應於參數的註冊SQL類型的getXXX方法。
默認實現將拋出SQLFeatureNotSupportedException
參數
parameterName - 參數的名稱
sqlType - 由 SQLType定義的JDBC類型代碼用於註冊OUT參數。
typeName - SQL結構化類型的全限定名稱
異常
SQLException - 如果parameterName與命名參數不對應; 如果發生數據庫訪問錯誤或在封閉的CallableStatement上調用此方法
SQLFeatureNotSupportedException - 如果JDBC驅動程序不支持指定的sqlType或JDBC驅動程序不支持此方法
從以下版本開始：
1.8