使用Oracle實現即時通訊

    由於Oracle不提供用於即時輸出訊息的工具, Oracle資料庫開發人員總是要面臨即時監視他們的儲備過程執行的挑戰。他們必須使用dbms_output.put_line調用，這個調用直到過程完成才返回結果。

　　在本文中，我想示範如何從Oracle8i資料庫直接寄送電子郵件，作為一種即時通訊解決方案。這樣我們要監視預存程序就不再需要等待它們完成了，這樣的方法還為開發人員提供了其他的一些好處：

      . 可以在幾分鐘內調試一些很長的批處理過程，而不需要等幾個小時；

　　　. 計算用於指定代碼塊所需的執行時間；

　　這就需要解決一個問題，我們如何從啟動並執行預存程序中輸出訊息以便我們可以即時檢查它們，即使我們不在辦公場所？我們的做法是把所有必需的過程與函數封裝在自訂的包中，然後使用Oracle8i UTL_SMTP包直接地從Oracle資料庫中寄送電子郵件。下面我將詳細講解一些這個過程。

　　Oracle的UTL_SMTP包

　　在Oracle8i中引入了UTL_SMTP包（SMTP代表Simple Mail Transfer Protocol簡單郵件傳送協議，使用TCP連接埠25在客戶機和伺服器之間建立通訊聯絡)，使開發人員能夠從資料庫寄送電子郵件。

　　只有安裝帶有Java虛擬機器(JVM)的8i或更高的版本才能使用UTL_SMTP。 此外還必須把plsql.jar載入資料庫中。否則，當調用UTL_SMTP API來寄送電子郵件的時候我們將得到下面的異常：ORA - 29540 : class oracle/plsql/net/TCPConnection does not exist。

　　預設的$ORACLE_HOME/javavm/install/initjvm.sql指令碼（安裝了JVM）不運行把plsql.jar載入資料庫的initplsj.sql指令碼。系統使用者或者內部使用者可以手工運行$ORACLE_HOME/RDBMS/ADMIN/initplsj.sql指令碼以解決這個問題。 如果你沒有可用的指令碼，你要麼可以從Oracle支援那裡得到它，要麼可以簡單地直接使用loadjava載入公用程式plsql.jar：

　　loadjava -user sys/password@database -resolve plsql/jlib/plsql.jar

　　UTL_SMTP API:

　　本文的代碼中使用了下列UTL_SMTP包中的API：

　　　OPEN_CONNECTION()：開啟到簡單郵件傳送協議伺服器的串連。

　　　HELO()：執行串連之後建立與簡單郵件傳送協議伺服器初始的收發關係功能，它能識別發送到伺服器的“信使”。

　　　MAIL()：初始化與伺服器的郵件交換，但是事實上不發送訊息。

　　　RCPT()：識別訊息的接受者。為了把一條訊息發送到多個接受者，你必須多次調用這個過程。

　　　DATA()：指定電子郵件的內容。

　　　QUIT()：終止一個SMTP會話並且斷開與伺服器的串連。

　　為了利用API，把下面的調用按照給定的順序放入程式中：

　　　調用 OPEN_CONNECTION

　　　調用 HELO

　　　調用 MAIL

　　　調用 RCPT for each recipient

　　　格式化電子郵件的內容然後調用MAIL

　　　調用 QUIT

　　EmailUtils包規範

　　 EmailUtils包包括下列API：

　　　SetSender/GetSender-設定/取得寄件者

　　　SetRecipient/GetRecipient -設定/取得接受者

　　　SetCcrecipient/GetCcrecipient -設定/取得抄件接受者

　　　SetMailHost/GetMailHost -設定/取得郵件主機

　　　SetSubject/GetSubject -設定/取得主題

　　　Send-發送郵件

　　代碼1說明了EmailUtils包的規範：

create or replace package EmailUtils as

procedure SetSender(pSender in varchar2);
function GetSender
return varchar2;

procedure SetRecipient(pRecipient in varchar2);
function GetRecipient
return varchar2;

procedure SetCcRecipient(pCcRecipient in varchar2);
function GetCcRecipient
return varchar2;

procedure SetMailHost(pMailHost in varchar2);
function GetMailHost
return varchar2;

procedure SetSubject(pSubject in varchar2);
function GetSubject
return varchar2;

procedure Send(pMessage in varchar2);

procedure Send(pSender in varchar2,
pRecipient in varchar2,
pMailHost in varchar2,
pCcRecipient in varchar2 := null,
pSubject in varchar2 := null,
pMessage in varchar2 := null);

end EmailUtils;
/
        可以看出，Send過程是重載過程：包規範中包括這個過程的兩個版本。 一個版本當至少三個強制性參數要規定的時候引用，pSender，pRecipient和pMailHost：

procedure Send(pSender in varchar2,
pRecipient in varchar2,
pMailHost in varchar2,
pCcRecipient in varchar2 := null,
pSubject in varchar2 := null,
pMessage in varchar2 := null);

　    另一個版本只有當提供pMessage參數值時執行：

            procedure Send(pMessage in varchar2);

　　第二個版本是用作調試的版本。 所有的電子郵件訊息共用同樣的寄件者、接受者、郵件主機、抄送接受者和主題資訊，這些都是我在會話的開始的時候設定好的。 下面是一個PL/SQL程式塊的例子：

begin

EmailUtils.SetSender('WayneZ@MyCompany.com');
EmailUtils.SetRecipient('waynezheng@vip.sina.com');
EmailUtils.SetCcRecipient('WayneZ@MyCompany.com');
EmailUtils.SetMailHost('MyServer.MyCompany.com');
EmailUtils.SetSubject('DeleteClassifications procedure: Run 1');

end;
/
 
    一個實際的電子郵件訊息將在每個Send程序呼叫中被指定。 我們可以把所用的EmailUtils.Send()調用插入到我們調試的代碼中，我們以前為了得到同樣的調試結果使用的是DBMS_OUTPUT.PUT_LINE()調用。:

vMessage := 'Point 1.' || utl_tcp.crlf ||
'Rows processed: ' || to_char(vRows) || utl_tcp.crlf ||
'Elapsed time: ' || vTime;

EmailUtils.Send(vMessage);

vMessage := 'Point 3.' || utl_tcp.crlf ||
'Rows processed: ' || to_char(vRows) || utl_tcp.crlf ||
'Elapsed time: ' || vTime;

EmailUtils.Send(vMessage);
     代碼2顯示帶有重載Send過程的EmailUtils規格。 我們可以看到，Send過程的代碼相當簡單。 UTL_SMTP包不提供用于格式化訊息內容的應用編程介面。 而是由使用者負責格式化訊息。 這就是為什麼下列程式塊要被包含到每個Send過程中以便格式化電子郵件的頭部。

vMessage := 'Date: ' ||
to_char(sysdate, 'fmDy, DD Mon YYYY fxHH24:MI:SS') ||
utl_tcp.crlf ||
'From: ' || pSender || utl_tcp.crlf ||
'Subject: ' || pSubject || utl_tcp.crlf ||
'To: ' || pRecipient || utl_tcp.crlf;

　　同時,如果訊息長度超過2000字元的話，你可能得到一個錯誤( ORA - 06502 : PL/SQL : numeric or value error)。 所以為了避免出現這個錯誤，我們使用下面的程式塊,不允許訊息超過2000個字元：

if length(vMessage) > 2000
then
vMessage := substr(vMessage, 1, 2000);
end if;

　　如果需要發送帶有超過2000字的電子郵件，那麼可以使用另三個UTL_SMTPAPI，提供比DATA()過程更加精細的控制。 首先, OPEN_DATA()發送資料命令。 然後WRITE_DATA()添加資料到你要發送的字串中。 你可以調用WRITE_DATA()任意多次，這樣你就可以一次寫2000個字元以克服字數的限制。 最後, CLOSE_DATA()通過發送一個封裝在CRLF中的終止周期結束電子郵件訊息。

　　即時訊息使你的生活更加舒適

　　從資料庫寄送電子郵件就是那麼容易。 一旦你試用這個簡單的操作，我相信你會發現它很有用，便於你的資料庫操作,例如調試、遠端資料庫監控和輸出資料庫資料。

　　每個資料庫開發人員都有在代碼中使用大量的DBMS_OUTPUT調用的調試經曆。 在開始一個SQL * Plus會話之後,輸入SET SERVEROUTPUT ON然後運行這個過程。 放進DBMS_OUTPUT.PUT_LINE調用的訊息顯示在螢幕上--但是只有在過程完成以後才能顯示出來。 這個過程極端地麻煩，尤其在調試長的批處理時通常是要運行整晚。 你可以等待10到12小時僅僅是為了查出錯誤的代碼，然後修改，再去等待下一個10到12個小時？ 然而，如果你有訪問訊息的即時的辦法，那麼你可以在頭5到10分鐘內捕捉到問題。

　　DBMS_OUTPUT包也有其他的缺點。 例如,它不接受可變的布爾類型以及它有255字元每行的限制（如果你想輸出一個長的訊息的話，那麼你會得到這個異常：ORA - 20000 : ORU - 10028 : line length overflow, limit of 255 bytes per line）。 把它的缺點全部列出這已經超出本文的範圍了，但是重要結論就是DBMS_OUTPUT包不許資料庫開發人員即時的看到訊息。

　　談到伺服器上的OS檔案，你會不會喜歡把選定的資料從伺服器中輸出到一個Excel試算表呢？ 一個辦法就是使用Oracle的UTL_FILE包,它提供了一個標準OS流文檔輸入/輸出的限制級版本。 然而, PL/SQL程式只能訪問在初始設定檔案INIT.ORA的UTL_FILE_DIR參數規定的目錄。 這個參數大多數情況下是空的。為了使這個目錄可用來進行檔案訪問，必須請資料庫管理者修改初始設定檔案。 這有些麻煩。使用EmailUtils包,你可以簡簡單單的把資料寫入一個電子郵件中，發送給自己，然後收到它的副本粘貼到自己喜歡的文檔編輯器中。