Oracle 9i 起透過擴充套件支援 PL/SQL 呼叫 Web Services,10g 引入 UTL_DBWS 封裝 JPublisher,讓開發者僅需幾行 API 即可完成 SOAP 呼叫。本文以實作步驟說明完整流程。
UTL_DBWS:
dbws-callout-utility.zipdbws-callout-utility-10R2.zip$ORACLE_HOME/sqlj/lib。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
假設已部署一個 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)(毫秒)。12c+ 內建 APEX_WEB_SERVICE(無需額外安裝),支援 REST/JSON,較輕量。若僅需簡單 HTTP GET/POST,UTL_HTTP 更直接。
掌握 UTL_DBWS 完整流程,讓 PL/SQL 能無縫整合企業級 SOA 服務,拓展資料庫應用邊界。