鷹翔宇空

　　在本文中，我想演示如何從Oracle9i數(shù)據(jù)庫直接發(fā)送電子郵件，作為一種實(shí)時通信解決方案。這樣我們要監(jiān)視存儲過程就不再需要等待它們完成了，這樣的方法還為開發(fā)者提供了其他的一些好處:

　　. 可以在幾分鐘內(nèi)調(diào)試一些很長的批處理過程，而不需要等幾個小時;

　　. 計(jì)算用于指定代碼塊所需的執(zhí)行時間;

　　這就需要解決一個問題，我們?nèi)绾螐倪\(yùn)行的存儲過程中輸出消息以便我們可以即時檢查它們，即使我們不在辦公場所?我們的做法是把所有必需的過程與函數(shù)包裝在自定義的包中，然后使用Oracle9i UTL_SMTP包直接地從Oracle數(shù)據(jù)庫中發(fā)送電子郵件。下面我將詳細(xì)講解一些這個過程。

　　Oracle的UTL_SMTP包

　　在Oracle9i中引入了UTL_SMTP包(SMTP代表Simple Mail Transfer Protocol簡單郵件傳送協(xié)議，使用TCP端口25在客戶機(jī)和服務(wù)器之間建立通信聯(lián)絡(luò))，使開發(fā)者能夠從數(shù)據(jù)庫發(fā)送電子郵件。

　　只有安裝帶有Java虛擬機(jī)(JVM)的8i或更高的版本才能使用UTL_SMTP。 此外還必須把plsql.jar載入數(shù)據(jù)庫中。否則，當(dāng)調(diào)用UTL_SMTP API來發(fā)送電子郵件的時候我們將得到下面的異常:ORA - 29540 : class oracle/plsql/net/TCPConnection does not exist。

　　默認(rèn)的$ORACLE_HOME/javavm/install/initjvm.sql腳本(安裝了JVM)不運(yùn)行把plsql.jar載入數(shù)據(jù)庫的initplsj.sql腳本。系統(tǒng)用戶或者內(nèi)部用戶可以手工運(yùn)行$ORACLE_HOME/RDBMS/ADMIN/initplsj.sql腳本以解決這個問題。 如果你沒有可用的腳本，你要么可以從Oracle支持那里得到它，要么可以簡單地直接使用loadjava載入實(shí)用程序plsql.jar:

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

　　UTL_SMTP API:

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

　　OPEN_CONNECTION():打開到簡單郵件傳送協(xié)議服務(wù)器的連接。

　　HELO():執(zhí)行連接之后建立與簡單郵件傳送協(xié)議服務(wù)器初始的收發(fā)關(guān)系功能，它能識別發(fā)送到服務(wù)器的“信使”。

　　MAIL():初始化與服務(wù)器的郵件交換，但是事實(shí)上不發(fā)送消息。

　　RCPT():識別消息的接受者。為了把一條消息發(fā)送到多個接受者，你必須多次調(diào)用這個過程。

　　DATA():指定電子郵件的內(nèi)容。

　　QUIT():終止一個SMTP會話并且斷開與服務(wù)器的連接。

　　為了利用應(yīng)用程序編程接口，把下面的調(diào)用按照給定的順序放入程序中:

　　調(diào)用 OPEN_CONNECTION

　　調(diào)用 HELO

　　調(diào)用 MAIL

　　調(diào)用 RCPT for each recipient

　　格式化電子郵件的內(nèi)容然后調(diào)用MAIL

　　調(diào)用 QUIT

　　EmailUtils包規(guī)范

　　EmailUtils包包括下列API:

　　SetSender/GetSender-設(shè)置/取得發(fā)送者

　　SetRecipient/GetRecipient -設(shè)置/取得接受者

　　SetCcrecipient/GetCcrecipient -設(shè)置/取得抄件接受者

　　SetMailHost/GetMailHost -設(shè)置/取得郵件主機(jī)

　　SetSubject/GetSubject -設(shè)置/取得主題

　　Send-發(fā)送郵件

　　代碼1說明了EmailUtils包的規(guī)范:

　　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過程是重載過程:包規(guī)范中包括這個過程的兩個版本。 一個版本當(dāng)至少三個強(qiáng)制性參數(shù)要規(guī)定的時候引用，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);
?

　　另一個版本只有當(dāng)提供pMessage參數(shù)值時執(zhí)行:

　　procedure Send(pMessage in varchar2);

　　第二個版本是用作調(diào)試的版本。 所有的電子郵件消息共用同樣的發(fā)送者、接受者、郵件主機(jī)、抄送接受者和主題信息，這些都是我在會話的開始的時候設(shè)置好的。 下面是一個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;

　　/

　　一個實(shí)際的電子郵件消息將在每個Send過程調(diào)用中被指定。 我們可以把所用的EmailUtils.Send()調(diào)用插入到我們調(diào)試的代碼中，我們以前為了得到同樣的調(diào)試結(jié)果使用的是DBMS_OUTPUT.PUT_LINE()調(diào)用。:

　　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規(guī)格。 我們可以看到，Send過程的代碼相當(dāng)簡單。 UTL_SMTP包不提供用于格式化消息內(nèi)容的應(yīng)用編程接口。 而是由用戶負(fù)責(zé)格式化消息。 這就是為什么下列程序塊要被包含到每個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)。 所以為了避免出現(xiàn)這個錯誤，我們使用下面的程序塊,不允許消息超過2000個字符:

　　if length(vMessage) > 2000

　　then

　　vMessage := substr(vMessage, 1, 2000);

　　end if;

　　如果需要發(fā)送帶有超過2000字的電子郵件，那么可以使用另三個UTL_SMTP應(yīng)用程序編程接口，提供比DATA()過程更加精細(xì)的控制。 首先, OPEN_DATA()發(fā)送數(shù)據(jù)命令。 然后WRITE_DATA()添加數(shù)據(jù)到你要發(fā)送的字符串中。 你可以調(diào)用WRITE_DATA()任意多次，這樣你就可以一次寫2000個字符以克服字?jǐn)?shù)的限制。 最后, CLOSE_DATA()通過發(fā)送一個封裝在CRLF中的終止周期結(jié)束電子郵件消息。

　　實(shí)時消息使你的生活更加舒適

　　從數(shù)據(jù)庫發(fā)送電子郵件就是那么容易。 一旦你試用這個簡單的操作，我相信你會發(fā)現(xiàn)它很有用，便于你的數(shù)據(jù)庫操作,例如調(diào)試、遠(yuǎn)程的數(shù)據(jù)庫監(jiān)控和輸出數(shù)據(jù)庫數(shù)據(jù)。

　　每個數(shù)據(jù)庫開發(fā)者都有在代碼中使用大量的DBMS_OUTPUT調(diào)用的調(diào)試經(jīng)歷。 在開始一個SQL * Plus會話之后,輸入SET SERVEROUTPUT ON然后運(yùn)行這個過程。 放進(jìn)DBMS_OUTPUT.PUT_LINE調(diào)用的消息顯示在屏幕上--但是只有在過程完成以后才能顯示出來。 這個過程極端地麻煩，尤其在調(diào)試長的批處理時通常是要運(yùn)行整晚。 你可以等待10到12小時僅僅是為了查出錯誤的代碼，然后修改，再去等待下一個10到12個小時? 然而，如果你有訪問消息的實(shí)時的辦法，那么你可以在頭5到10分鐘內(nèi)捕捉到問題。

　　DBMS_OUTPUT包也有其他的缺點(diǎn)。 例如,它不接受可變的布爾類型以及它有255字符每行的限制(如果你想輸出一個長的消息的話，那么你會得到這個異常:ORA - 20000 : ORU - 10028 : line length overflow, limit of 255 bytes per line)。 把它的缺點(diǎn)全部列出這已經(jīng)超出本文的范圍了，但是重要結(jié)論就是DBMS_OUTPUT包不許數(shù)據(jù)庫開發(fā)者實(shí)時的看到消息。

　　談到服務(wù)器上的OS文件，你會不會喜歡把選定的數(shù)據(jù)從服務(wù)器中輸出到一個Excel電子表格呢? 一個辦法就是使用Oracle的UTL_FILE包,它提供了一個標(biāo)準(zhǔn)OS流文檔輸入/輸出的限制級版本。 然而, PL/SQL程序只能訪問在初始化文件INIT.ORA的UTL_FILE_DIR參數(shù)規(guī)定的目錄。 這個參數(shù)大多數(shù)情況下是空的。為了使這個目錄可用來進(jìn)行文件訪問，必須請數(shù)據(jù)庫管理者修改初始化文件。 這有些麻煩。使用EmailUtils包,你可以簡簡單單的把數(shù)據(jù)寫入一個電子郵件中，發(fā)送給自己，然后收到它的副本粘貼到自己喜歡的文檔編輯器中。