從 Oracle Forms 6i 遷移至 9i/10g/11g 時,內建的 SHOW_ALERT 參數傳遞機制被移除,數千個警示訊息若逐一修改極其痛苦。同樣,PL/SQL 開發者頻繁撰寫 DBMS_OUTPUT.PUT_LINE 既冗長又易誤拼。本文示範如何建立一套輕量、可擴充的訊息輸出套件,一次解決遷移與日常除錯痛點。
CREATE OR REPLACE PACKAGE msg_pkg AS
-- 數值型訊息:自動加上前綴
PROCEDURE put_num(p_label VARCHAR2, p_val NUMBER);
-- 字串型訊息
PROCEDURE put_txt(p_msg VARCHAR2);
-- 關鍵點標記:追蹤程式流程
PROCEDURE mark(p_location VARCHAR2);
-- 變數監看:顯示變數名稱與值
PROCEDURE watch(p_var_name VARCHAR2, p_val VARCHAR2);
PROCEDURE watch(p_var_name VARCHAR2, p_val NUMBER);
PROCEDURE watch(p_var_name VARCHAR2, p_val DATE);
END msg_pkg;
/
CREATE OR REPLACE PACKAGE BODY msg_pkg AS
PROCEDURE put_num(p_label VARCHAR2, p_val NUMBER) IS
BEGIN
DBMS_OUTPUT.PUT_LINE('[NUM] ' || p_label || ': ' || p_val);
END;
PROCEDURE put_txt(p_msg VARCHAR2) IS
BEGIN
DBMS_OUTPUT.PUT_LINE('[TXT] ' || p_msg);
END;
PROCEDURE mark(p_location VARCHAR2) IS
BEGIN
DBMS_OUTPUT.PUT_LINE('>>> ' || p_location || ' <<<');
END;
PROCEDURE watch(p_var_name VARCHAR2, p_val VARCHAR2) IS
BEGIN
DBMS_OUTPUT.PUT_LINE('[WATCH] ' || p_var_name || ' = ' || NVL(p_val, '[NULL]'));
END;
PROCEDURE watch(p_var_name VARCHAR2, p_val NUMBER) IS
BEGIN
DBMS_OUTPUT.PUT_LINE('[WATCH] ' || p_var_name || ' = ' || p_val);
END;
PROCEDURE watch(p_var_name VARCHAR2, p_val DATE) IS
BEGIN
DBMS_OUTPUT.PUT_LINE('[WATCH] ' || p_var_name || ' = ' || TO_CHAR(p_val, 'YYYY-MM-DD HH24:MI:SS'));
END;
END msg_pkg;
/
BEGIN
msg_pkg.mark('START process_order');
msg_pkg.watch('p_order_id', 1001);
msg_pkg.put_num('Rows updated', SQL%ROWCOUNT);
msg_pkg.put_txt('Calling calculate_discount...');
-- 業務邏輯...
msg_pkg.mark('END process_order');
END;
/
-- 輸出
-- >>> START process_order <<<
-- [WATCH] p_order_id = 1001
-- [NUM] Rows updated: 46
-- [TXT] Calling calculate_discount...
-- >>> END process_order <<<
-- 套件規格新增 TYPE log_level IS (DEBUG, INFO, WARN, ERROR); g_level log_level := INFO; -- 可由參數表動態調整 PROCEDURE log(p_level log_level, p_msg VARCHAR2);
呼叫端:msg_pkg.log(msg_pkg.DEBUG, 'Enter loop'); —— 只有當 g_level <= DEBUG 才輸出,生產環境設為 WARN 即可靜默除錯資訊。
SHOW_ALERT、MESSAGE 呼叫。msg_pkg.put_txt(...) 或 msg_pkg.put_num(...)。UTL_FILE、DBMS_PIPE、外部 Log Server (ELK/Splunk)。$$PLSQL_UNIT、$$PLSQL_LINE 自動記錄來源位置。SERVEROUTPUT ON 的長時間 Session,改用非同步 Log 寫入表或檔案。一套設計良好的訊息輸出套件,不僅能平滑解決 Forms 遷移的大量修改,更能成為 PL/SQL 開發全生命週期的除錯、審計、監控基石。