萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> Oracle 教學

從 PL/SQL 呼叫 Web Services 完整實作指南:UTL_DBWS 與 JPublisher 整合

Oracle 9i 起透過擴充套件支援 PL/SQL 呼叫 Web Services,10g 引入 UTL_DBWS 封裝 JPublisher,讓開發者僅需幾行 API 即可完成 SOAP 呼叫。本文以實作步驟說明完整流程。

環境準備

  1. Oracle Database Enterprise/Standard/Personal Edition(不可用 Express Edition,缺少 SQLJ 元件)。
  2. 從 OTN 下載對應版本 UTL_DBWS:
    • Pre-10g: dbws-callout-utility.zip
    • 10g R2: dbws-callout-utility-10R2.zip
  3. 解壓至 $ORACLE_HOME/sqlj/lib。
  4. 使用 loadjava 載入 JAR 至 SYS schema:
    $ORACLE_HOME/bin/loadjava -u sys/password -r -v -f -s -grant public -noverify -genmissing $ORACLE_HOME/sqlj/lib/dbwsclient.jar

建立 Web Service Proxy 物件

假設已部署一個 HelloWS 服務(WSDL: https://host:port/hellows?wsdl),提供 sayHello(name) 方法。

DECLARE
  l_service  UTL_DBWS.SERVICE;
  l_call     UTL_DBWS.CALL;
  l_result   VARCHAR2(4000);
BEGIN
  -- 1. 建立 Service 物件
  l_service := UTL_DBWS.CREATE_SERVICE(
    wsdl_url => 'https://host:port/hellows?wsdl',
    service_name => 'HelloService',
    namespace => 'https://example.com/hello');

  -- 2. 建立 Call 物件
  l_call := UTL_DBWS.CREATE_CALL(
    service_handle => l_service,
    port_name => 'HelloPort',
    operation_name => 'sayHello');

  -- 3. 設定參數與呼叫
  UTL_DBWS.SET_PROPERTY(l_call, 'USERNAME', 'ws_user');
  UTL_DBWS.SET_PROPERTY(l_call, 'PASSWORD', 'ws_pwd');
  l_result := UTL_DBWS.INVOKE(l_call, 'World');

  DBMS_OUTPUT.PUT_LINE('Web Service 回傳: ' || l_result);

  -- 4. 釋放資源
  UTL_DBWS.RELEASE_CALL(l_call);
  UTL_DBWS.RELEASE_SERVICE(l_service);
END;

進階:複雜型別對應

若 Web Service 使用複雜型別(如 Customer 物件),需先用 JPublisher 產生對應的 SQL 物件型別:

jpub -user=scott/tiger -url=https://host:port/hellows?wsdl
     -methods=all -package=ws_types -dir=./gen

產生的型別可直接在 PL/SQL 中傳遞,UTL_DBWS 會自動處理 XML 序列化/反序列化。

錯誤處理與除錯

  • 捕捉 UTL_DBWS.EXCEPTION 並檢查 SQLERRM。
  • 啟用 UTL_DBWS.SET_PROPERTY(call, 'DEBUG', TRUE) 印出 SOAP 請求/回應 XML。
  • 網路逾時設定:UTL_DBWS.SET_PROPERTY(call, 'TIMEOUT', 30000)(毫秒)。

替代方案:APEX_WEB_SERVICE / UTL_HTTP

12c+ 內建 APEX_WEB_SERVICE(無需額外安裝),支援 REST/JSON,較輕量。若僅需簡單 HTTP GET/POST,UTL_HTTP 更直接。

掌握 UTL_DBWS 完整流程,讓 PL/SQL 能無縫整合企業級 SOA 服務,拓展資料庫應用邊界。

copyright © 萬盛學電腦網 all rights reserved