概述
CallableStatement 對象爲所有的 DBMS 提供了一種以標準形式調用已儲存過程的方法。已儲存過程儲存在數據庫中。對已儲存過程的調用是 CallableStatement 對象所含的內容。這種調用是用一種換碼語法來寫的，有兩種形式：一種形式帶結果參數，另一種形式不帶結果參數（有關換碼語法的信息，參見第 4 節“語句”）。結果參數是一種輸出 (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 類型（從 JDBC 類型到 Java 類型的標準映射見 8.6.1 節中的表）。換言之， 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 來檢索輸出值 （第 8 節“JDBC 和 Java 類型之間的映射”將給出詳細信息和類型映射表）。
下例假設有一個已儲存過程 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 進行調用，直到不再有結果爲止。
檢索完所有的結果後(cs.getResultSet(); cs.getUpdateCount(); cs.getMoreResults(); )，就可用 CallableStatement.getXXX 方法來檢索 OUT 參數中的值。
5 檢索作爲 OUT 參數的 NULL 值
返回到 OUT 參數中的值可能會是 JDBC NULL。當出現這種情形時，將對 JDBC NULL 值進行轉換以使 getXXX 方法所返回的值爲 null、0 或 false，這取決於 getXXX 方法類型。對於 ResultSet 對象，要知道 0 或 false 是否源於 JDBC NULL 的唯一方法，是用方法 wasNull 進行檢測。如果 getXXX 方法讀取的最後一個值是 JDBC NULL，則該方法返回 true，否則返回 flase。第 5 節“ResultSet”將給出詳細信息。
本文闡述了怎麼使用DBMS存儲過程。我闡述了使用存儲過程的基本的和高級特性，比如返回ResultSet。本文假設你對DBMS和JDBC已經 非常熟 悉，也假設你能夠毫無障礙地閱讀其它語言寫成的代碼（即不是Java的語言），但是，並不要求你有任何存儲過程的編程經歷。
存儲過程是指保存在數據庫並在數據庫端執行的程序。你可以使用特殊的語法在Java類中調用存儲過程。在調用時，存儲過程的名稱及指定的參數通過JDBC連接發送給DBMS，執行存儲過程並通過連接（如果有）返回結果。
使用存儲過程擁有和使用基於EJB或CORBA這樣的應用服務器一樣的好處。區別是存儲過程可以從很多流行的DBMS中免費使用，而應用服務器大都非常昂 貴。這並不只是許可證費用的問題。使用應用服務器所需要花費的管理、編寫代碼的費用，以及客戶程序所增加的複雜性，都可以通過DBMS中的存儲過程所整個 地替代。
你可以使用Java，Python，Perl或C編寫存儲過程，但是通常使用你的DBMS所指定的特定語言。Oracle使用 PL/SQL，PostgreSQL使用pl/pgsql，DB2使用Procedural SQL。這些語言都非常相似。在它們之間移植存儲過程並不比在Sun的EJB規範不同實現版本之間移植Session Bean困難。並且，存儲過程是爲嵌入SQL所設計，這使得它們比Java或C等語言更加友好地方式表達數據庫的機制。
因爲存儲過程運行在DBMS自身，這可以幫助減少應用程序中的等待時間。不是在Java代碼中執行4個或5個SQL語句，而只需要在服務器端執行1個存儲過程。網絡上的數據往返次數的減少可以戲劇性地優化性能。
使用存儲過程
簡單的老的JDBC通過CallableStatement類支持存儲過程的調用。該類實際上是PreparedStatement的一個子類。假 設我們 有一個poets數據庫。數據庫中有一個設置詩人逝世年齡的存儲過程。下面是對老酒鬼Dylan Thomas（old soak Dylan Thomas，不指定是否有關典故、文化，請批評指正。譯註）進行調用的詳細代碼：
try
{
int age = 39;
String poetName = "dylan thomas";
CallableStatement proc =
connection.prepareCall("{ call set_death_age(?, ?) }");
proc.setString(1, poetName);
proc.setInt(2, age);
cs.execute();
}
catch (SQLException e)
{
// ....
}
傳給prepareCall方法的字串是存儲過程調用的書寫規範。它指定了存儲過程的名稱，？代表了你需要指定的參數。
和JDBC集成是存儲過程的一個很大的便利：爲了從應用中調用存儲過程，不需要存根（stub）類或者配置文件，除了你的DBMS的JDBC驅動程序外什麼也不需要。
當 這段代碼執行時，數據庫的存儲過程就被調用。我們沒有去獲取結果，因爲該存儲過程並不返回結果。執行成功或失敗將通過例外得知。失敗可能意味着調用存儲過 程時的失敗（比如提供的一個參數的類型不正確），或者一個應用程序的失敗（比如拋出一個例外指示在poets數據庫中並不存在“Dylan Thomas”）
結合SQL操作與存儲過程
映射Java對象到SQL表中的行相當簡單，但是通常需要執行幾個 SQL語句；可能是一個SELECT查找ID，然後一個INSERT插入指定ID的數據。在高度規格化（符合更高的範式，譯註）的數據庫模式中，可能需要 多個表的更新，因此需要更多的語句。Java代碼會很快地膨脹，每一個語句的網絡開銷也迅速增加。
將這些SQL語句轉移到一個存儲過程中將大 大簡化代碼，僅涉及一次網絡調用。所有關聯的SQL操作都可以在數據庫內部發生。並且，存儲過程語言，例如PL/SQL，允許使用SQL語法，這比 Java代碼更加自然。下面是我們早期的存儲過程，使用Oracle的PL/SQL語言編寫：
create procedure set_death_age(poet VARCHAR2, poet_age NUMBER)
poet_id NUMBER;
begin
SELECT id INTO poet_id FROM poets WHERE name = poet;
INSERT INTO deaths (mort_id, age) VALUES (poet_id, poet_age);
end set_death_age;
很獨特？不。我打賭你一定期待看到一個poets表上的UPDATE。這也暗示了使用存儲過程實現是多麼容易的一件事情。 set_death_age幾乎 可以肯定是一個很爛的實現。我們應該在poets表中添加一列來存儲逝世年齡。Java代碼中並不關心數據庫模式是怎麼實現的，因爲它僅調用存儲過程。我 們以後可以改變數據庫模式以提高性能，但是我們不必修改我們代碼。
下面是調用上面存儲過程的Java代碼：
public static void setDeathAge(Poet dyingBard, int age)
throws SQLException
{
Connection con = null;
CallableStatement proc = null;
try
{
con = connectionPool.getConnection();
proc = con.prepareCall("{ call set_death_age(?, ?) }");
proc.setString(1, dyingBard.getName());
proc.setInt(2, age);
proc.execute();
}
finally
{
try
{
proc.close();
}
catch (SQLException e) {}
con.close();
}
}
爲了確保可維護性，建議使用像這兒這樣的static方法。這也使得調用存儲過程的代碼集中在一個簡單的模版代碼中。如果你用到許多存儲過程，就會發現僅需要拷貝、粘貼就可以創建新的方法。因爲代碼的模版化，甚至也可以通過腳本自動生產調用存儲過程的代碼。
Functions
存儲過程可以有返回值，所以CallableStatement類有類似getResultSet這樣的方法來獲取返回值。當存儲過程返回一個值 時，你必 須使用registerOutParameter方法告訴JDBC驅動器該值的SQL類型是什麼。你也必須調整存儲過程調用來指示該過程返回一個值。
下面接着上面的例子。這次我們查詢Dylan Thomas逝世時的年齡。這次的存儲過程使用PostgreSQL的pl/pgsql：
create function snuffed_it_when (VARCHAR) returns integer '
declare
poet_id NUMBER;
poet_age NUMBER;
begin
-- first get the id associated with the poet.
SELECT id INTO poet_id FROM poets WHERE name = $1;
-- get and return the age.
SELECT age INTO poet_age FROM deaths WHERE mort_id = poet_id;
return age;
end;
' language 'pl/pgsql';
另外，注意pl/pgsql參數名通過Unix和DOS腳本的$n語法引用。同時，也注意嵌入的註釋，這是和Java代碼相比的另一個優越性。在Java中寫這樣的註釋當然是可以的，但是看起來很凌亂，並且和SQL語句脫節，必須嵌入到Java String中。
下面是調用這個存儲過程的Java代碼：
connection.setAutoCommit(false);
CallableStatement proc =
connection.prepareCall("{ ? = call snuffed_it_when(?) }");
proc.registerOutParameter(1, Types.INTEGER);
proc.setString(2, poetName);
cs.execute();
int age = proc.getInt(2);
如果指定了錯誤的返回值類型會怎樣？那麼，當調用存儲過程時將拋出一個RuntimeException，正如你在ResultSet操作中使用了一個錯誤的類型所碰到的一樣。
複雜的返回值
關於存儲過程的知識，很多人好像就熟悉我們所討論的這些。如果這是存儲過程的全部功能，那麼存儲過程就不是其它遠程執行機制的替換方案了。存儲過程的功能比這強大得多。
當你執行一個SQL查詢時，DBMS創建一個叫做cursor（遊標）的數據庫對象，用於在返回結果中迭代每一行。ResultSet是當前時間點的遊標的一個表示。這就是爲什麼沒有緩存或者特定數據庫的支持，你只能在ResultSet中向前移動。
某些DBMS允許從存儲過程中返回遊標的一個引用。JDBC並不支持這個功能，但是Oracle、PostgreSQL和DB2的JDBC驅動器都支持在ResultSet上打開到遊標的指針（pointer）。
設想列出所有沒有活到退休年齡的詩人，下面是完成這個功能的存儲過程，返回一個打開的遊標，同樣也使用PostgreSQL的pl/pgsql語言：
create procedure list_early_deaths () return refcursor as '
declare
toesup refcursor;
begin
open toesup for
SELECT poets.name, deaths.age
FROM poets, deaths
-- all entries in deaths are for poets.
-- but the table might become generic.
WHERE poets.id = deaths.mort_id
AND deaths.age < 60;
return toesup;
end;
' language 'plpgsql';
下面是調用該存儲過程的Java方法，將結果輸出到PrintWriter：
PrintWriter:
static void sendEarlyDeaths(PrintWriter out)
{
Connection con = null;
CallableStatement toesUp = null;
try
{
con = ConnectionPool.getConnection();
// PostgreSQL needs a transaction to do this...
con.setAutoCommit(false);
// Setup the call.
CallableStatement toesUp
= connection.prepareCall("{ ? = call list_early_deaths () }");
toesUp.registerOutParameter(1, Types.OTHER);
getResults.execute();
ResultSet rs = (ResultSet) getResults.getObject(1);
while (rs.next())
{
String name = rs.getString(1);
int age = rs.getInt(2);
out.println(name + " was " + age + " years old.");
}
rs.close();
}
catch (SQLException e)
{
// We should protect these calls.
toesUp.close();
con.close();
}
}
因爲JDBC並不直接支持從存儲過程中返回遊標，我們使用Types.OTHER來指示存儲過程的返回類型，然後調用getObject()方法並對返回值進行強制類型轉換。
這個調用存儲過程的Java方法是mapping的一個好例子。Mapping是對一個集上的操作進行抽象的方法。不是在這個過程上返回一個集，我們可以 把操作傳送進去執行。本例中，操作就是把ResultSet打印到一個輸出流。這是一個值得舉例的很常用的例子，下面是調用同一個存儲過程的另外一個方法 實現：
public class ProcessPoetDeaths
{
public abstract void sendDeath(String name, int age);
}
static void mapEarlyDeaths(ProcessPoetDeaths mapper)
{
Connection con = null;
CallableStatement toesUp = null;
try
{
con = ConnectionPool.getConnection();
con.setAutoCommit(false);
CallableStatement toesUp
= connection.prepareCall("{ ? = call list_early_deaths () }");
toesUp.registerOutParameter(1, Types.OTHER);
getResults.execute();
ResultSet rs = (ResultSet) getResults.getObject(1);
while (rs.next())
{
String name = rs.getString(1);
int age = rs.getInt(2);
mapper.sendDeath(name, age);
}
rs.close();
}
catch (SQLException e)
{
// We should protect these calls.
toesUp.close();
con.close();
}
}
這允許在ResultSet數據上執行任意的處理，而不需要改變或者複製獲取ResultSet的方法：
static void sendEarlyDeaths(final PrintWriter out)
{
ProcessPoetDeaths myMapper = new ProcessPoetDeaths()
{
public void sendDeath(String name, int age)
{
out.println(name + " was " + age + " years old.");
}
};
mapEarlyDeaths(myMapper);
}