萬盛學電腦網

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

Oracle Forms 遷移與 PL/SQL 除錯利器:建立可重用訊息輸出套件

從 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 即可靜默除錯資訊。

整合到既有 Forms 遷移專案

  1. 全域搜尋 SHOW_ALERT、MESSAGE 呼叫。
  2. 以正則取出訊息文字與參數。
  3. 批次替換為 msg_pkg.put_txt(...) 或 msg_pkg.put_num(...)。
  4. 統一編譯套件,單點維護格式、前綴、語系。

最佳實踐

  • 所有輸出統一經由套件,方便日後切換至 UTL_FILE、DBMS_PIPE、外部 Log Server (ELK/Splunk)。
  • 加入 $$PLSQL_UNIT、$$PLSQL_LINE 自動記錄來源位置。
  • 嚴禁在生產環境開啟 SERVEROUTPUT ON 的長時間 Session,改用非同步 Log 寫入表或檔案。

一套設計良好的訊息輸出套件,不僅能平滑解決 Forms 遷移的大量修改,更能成為 PL/SQL 開發全生命週期的除錯、審計、監控基石。

copyright © 萬盛學電腦網 all rights reserved