CallableStatement 在符合所有的 DBMS 它提供了一個存儲過程調用方法的標準形式。存儲在數據庫中的存儲過程。調用存儲過程 CallableStatement內容。

這樣的調用是用一種換碼語法來寫的，有兩種形式：一種形式帶結果參，還有一種形式不帶結果參數。

結果參數是一種輸出 (OUT) 參數。是已儲存過程的返回值。

兩種形式都可帶有數量可變的輸入（IN 參數）、輸出（OUT 參數）或輸入和輸出（INOUT 參數）的參數。問號將用作參數的占位符。

　在 JDBC 中調用已儲存過程的語法例如以下所看到的。注意，方括號表示其間的內容是可選項。方括號本身并不是語法的組成部份。
{call 過程名[(?, ?

, ...)]}
　　返回結果參數的過程的語法為：
{? = call 過程名[(?, ?, ...)]}
　　不帶參數的已儲存過程的語法相似：
{call 過程名}

　　通常。創建 CallableStatement 對象的人應當知道所用的 DBMS 是支持已儲存過程的。而且知道這些過程都是些什么。

然而，假設須要檢查，多種DatabaseMetaData 方法都能夠提供這樣的信息。

比如。假設 DBMS 支持已儲存過程的調用，則supportsStoredProcedures 方法將返回 true，而getProcedures 方法將返回對已儲存過程的描寫敘述。CallableStatement 繼承 Statement 的方法（它們用于處理一般的 SQL 語句）。還繼承了 PreparedStatement 的方法（它們用于處理 IN 參）。

　　CallableStatement 中定義的全部方法都用于處理 OUT 參數或 INOUT 參數的輸出部分：注冊 OUT 參數的 JDBC 類型（一般 SQL 類型）、從這些參數中檢索結果。或者檢查所返回的值是否為 JDBC NULL。

1、創建 CallableStatement 對象

　　CallableStatement 對象是用 Connection 方法 prepareCall 創建的。下例創建 CallableStatement 的實例，當中含有對已儲存過程 getTestData 調用。

該過程有兩個變量，但不含結果參數：

CallableStatement cstmt = con.prepareCall("{call getTestData(?, ?)}");

　　當中?占位符為IN、OUT還是INOUT參數，取決于已儲存過程getTestData。

2、IN和OUT參數

　　將IN參數傳給 CallableStatement 對象是通過 setXXX 方法完畢的。該方法繼承自 PreparedStatement。所傳入參數的類型決定了所用的setXXX方法（比如。用 setFloat 來傳入 float 值等）。

　　假設已儲存過程返回 OUT 參數，則在運行 CallableStatement 對象曾經必須先注冊每一個 OUT 參數的 JDBC 類型（這是必需的，由于某些 DBMS 要求 JDBC 類型）。

注冊 JDBC 類型是用 registerOutParameter 方法來完畢的。

語句運行完后，CallableStatement 的 getXXX 方法將取回參數值。正確的 getXXX 方法是為各參數所注冊的 JDBC 類型所相應的 Java 類型。換言之， registerOutParameter 使用的是 JDBC 類型（因此它與數據庫返回的 JDBC 類型匹配），而 getXXX 將之轉換為 Java 類型。

　　作為演示樣例，下述代碼先注冊 OUT 參數。運行由 cstmt 所調用的已儲存過程。然后檢索在 OUT 參數中返回的值。

方法 getByte 從第一個 OUT 參數中取出一個 Java 字節。而 getBigDecimal 從第二個 OUT 參數中取出一個 BigDecimal 對象（小數點后面帶三位數）：

CallableStatement cstmt = con.prepareCall("{call getTestData(?, ?

)}");

cstmt.registerOutParameter(1, java.sql.Types.TINYINT);

cstmt.registerOutParameter(2, java.sql.Types.DECIMAL, 3);

cstmt.executeQuery();

byte x = cstmt.getByte(1);

java.math.BigDecimal n = cstmt.getBigDecimal(2, 3);

　　CallableStatement 與 ResultSet 不同，它不提供用增量方式檢索大 OUT 值的特殊機制。



3、INOUT參數

　　既支持輸入又接受輸出的參數（INOUT 參數）除了調用 registerOutParameter 方法外。還要求調用適當的 setXXX 方法（該方法是從 PreparedStatement 繼承來的）。setXXX 方法將參數值設置為輸入參數，而 registerOutParameter 方法將它的 JDBC 類型注冊為輸出參數。setXXX 方法提供一個 Java 值，而驅動程序先把這個值轉換為 JDBC 值。然后將它送到數據庫中。這樣的 IN 值的 JDBC 類型和提供給 registerOutParameter 方法的 JDBC 類型應該同樣。然后，要檢索輸出值，就要用相應的 getXXX 方法。

比如，Java 類型為byte 的參數應該用法 setByte 來賦輸入值。

應該給registerOutParameter 提供類型為 TINYINT 的 JDBC 類型，同一時候應使用 getByte 來檢索輸出值。

　　下例假設有一個已儲存過程 reviseTotal，其唯一參數是 INOUT 參數。

方法setByte 把此參數設為 25，驅動程序將把它作為 JDBC TINYINT 類型送到數據庫中。

接著，registerOutParameter 將該參數注冊為 JDBC TINYINT。

運行完該已儲存過程后，將返回一個新的 JDBC TINYINT 值。

方法 getByte 將把這個新值作為 Java byte 類型檢索。

CallableStatement cstmt = con.prepareCall("{call reviseTotal(?

)}");

cstmt.setByte(1, 25);

cstmt.registerOutParameter(1, java.sql.Types.TINYINT);

cstmt.executeUpdate();

byte x = cstmt.getByte(1);



4、先檢索結果，再檢索 OUT 參數

　　由于某些 DBMS 的限制，為了實現最大的可移植性，建議先檢索由運行CallableStatement 對象所產生的結果，然后再用 CallableStatement.getXXX 方法來檢索 OUT 參數。假設 CallableStatement 對象返回多個 ResultSet 對象（通過調用 execute 方法），在檢索 OUT 參數前應先檢索全部的結果。

這樣的情況下，為確保對全部的結果都進行了訪問，必須對 Statement 方法 getResultSet、getUpdateCount 和getMoreResults 進行調用，直到不再有結果為止。

　　檢索全然部的結果后。就可用 CallableStatement.getXXX 方法來檢索 OUT 參數中的值。


5、檢索作為OUT參數的NULL值

返回到 OUT 參數中的值可能會是JDBC NULL。

當出現這樣的情形時，將對 JDBC NULL 值進行轉換以使 getXXX 方法所返回的值為 null、0 或 false。這取決于getXXX 方法類型。對于 ResultSet 對象，要知道0或false是否源于JDBCNULL的唯一方法，是用方法wasNull進行檢測。假設 getXXX 方法讀取的最后一個值是 JDBC NULL，則該方法返回 true，否則返回 flase。

?

注：對于多行的返回，則必須通過強制轉型為ResultSet進行返回，此時將返回指向多行游標的指針。

如

例

Conncetion con = getConnection();

CallableStatement cs = null;

ResultSet rs = null;

?

try{

??? cs = con.prepareCall("{?=call getCallfuc(?

,?

)}");

??? cs.registerOutParameter(1,Types.OTHER);

??? cs.setInt(2,0);

??? cs.setInt(3,0);

??

??? cs.execute();

??? rs = (ResultSet)cs.getObject(1);

??? while(rs.next()) {

?????? .......?

?? }

}catch(Exception ex){}