Java 呼叫 Oracle 函數完整指南：CallableStatement 兩大場景實戰

前言

JDBC 中透過 CallableStatement 呼叫 Oracle 預存函數是企業級應用常見需求。本文針對「無參數函數」與「含輸入/輸出參數函數」兩大典型場景，提供完整程式碼範例與關鍵細節說明。

場景一：呼叫無參數函數

Oracle 函數定義

CREATE OR REPLACE FUNCTION f_getstring
RETURN VARCHAR2 IS
BEGIN
  RETURN 'String value';
END f_getstring;
/

Java 程式碼

Connection con = dataSource.getConnection();
CallableStatement cstmt = null;
try {
  // 語法：{? = call function_name}
  cstmt = con.prepareCall("{? = call f_getstring}");

  // 註冊第 1 個參數為 OUT，型別 VARCHAR
  cstmt.registerOutParameter(1, Types.VARCHAR);

  cstmt.execute();

  String strValue = cstmt.getString(1);
  System.out.println("The return value is: " + strValue);
} finally {
  if (cstmt != null) cstmt.close();
  if (con != null) con.close();
}

場景二：呼叫含輸入參數、輸出參數與回傳值的函數

Oracle 函數定義

CREATE OR REPLACE FUNCTION f_getinfo(p_id IN INTEGER, p_age OUT INTEGER)
RETURN VARCHAR2 IS
BEGIN
  p_age := 10;
  RETURN 'The age is: ' || p_id;
END f_getinfo;
/

Java 程式碼

Connection con = dataSource.getConnection();
CallableStatement cstmt = null;
try {
  // 語法：{? = call function_name(?, ?)}
  // 參數索引：1=回傳值, 2=IN 參數, 3=OUT 參數
  cstmt = con.prepareCall("{? = call f_getinfo(?, ?)}");

  cstmt.registerOutParameter(1, Types.VARCHAR);   // 回傳值
  cstmt.setInt(2, 11);                            // IN 參數
  cstmt.registerOutParameter(3, Types.INTEGER);   // OUT 參數

  cstmt.execute();

  String strValue = cstmt.getString(1);
  int age = cstmt.getInt(3);

  System.out.println("Return: " + strValue + ", Age: " + age);
} finally {
  if (cstmt != null) cstmt.close();
  if (con != null) con.close();
}

關鍵細節總結

進階提示

• 使用連線池時，確保 CallableStatement 用完即關，避免游標洩漏。
• Oracle 12c+ 支援 RESULT_SET 類型回傳，可用 getObject(index) 轉 ResultSet 處理大量資料。
• 若函數回傳集合/物件型別，需註冊 OracleTypes.STRUCT 或 ARRAY 並轉換。