一、JavaMail API簡介 JavaMail API是讀取、撰寫、發送電子信息的可選包。我們可用它來建立如Eudora、Foxmail、MS Outlook Express一般的郵件用戶代理程序(Mail User Agent,簡稱MUA)。而不是像sendmail或者其它的郵件傳輸代理(Mail Transfer Agent,簡稱MTA)程序那樣可以傳送、遞送、轉發郵件。從另外一個角度來看,我們這些電子郵件用戶日常用MUA程序來讀寫郵件,而MUA依賴着MTA處理郵件的遞送。 在清楚了到MUA與MTA之間的關係後,讓我們看看JavaMail API是如何提供信息訪問功能的吧!JavaMail API被設計用於以不依賴協議的方式去發送和接收電子信息,這個API被分爲兩大部分:
基本功能:如何以不依賴於協議的方式發送接收電子信息,這也是本文所要描述的,不過在下文中,大家將看到這只是一廂情願而已。 第二個部分則是依賴特定協議的,比如SMTP、POP、IMAP、NNTP協議。在這部分的JavaMail API是爲了和服務器通訊,並不在本文的內容中。
二、相關協議一覽 在我們步入JavaMail API之前,先看一下API所涉及的協議。以下便是大家日常所知、所樂於使用的4大信息傳輸協議: SMTP POP IMAP MIME 當然,上面的4個協議,並不是全部,還有NNTP和其它一些協議可用於傳輸信息,但是由於不常用到,所以本文便不提及了。理解這4個基本的協議有助於我們更好的使用JavaMail API。然而JavaMail API是被設計爲與協議無關的,目前我們並不能克服這些協議的束縛。確切的說,如果我們使用的功能並不被我們選擇的協議支持,那麼JavaMail API並不可能如魔術師一樣神奇的賦予我們這種能力。
1.SMTP 簡單郵件傳輸協議定義了遞送郵件的機制。在下文中,我們將使用基於Java-Mail的程序與公司或者ISP的SMTP服務器進行通訊。這個SMTP服務器將郵件轉發到接收者的SMTP服務器,直至最後被接收者通過POP或者IMAP協議獲取。這並不需要SMTP服務器使用支持授權的郵件轉發,但是卻的確要注意SMTP服務器的正確設置(SMTP服務器的設置與JavaMail API無關)。
2.POP POP是一種郵局協議,目前爲第3個版本,即衆所周知的POP3。POP定義了一種用戶如何獲得郵件的機制。它規定了每個用戶使用一個單獨的郵箱。大多數人在使用POP時所熟悉的功能並非都被支持,例如查看郵箱中的新郵件數量。而這個功能是微軟的Outlook內建的,那麼就說明微軟Outlook之類的郵件客戶端軟件是通過查詢最近收到的郵件來計算新郵件的數量來實現前面所說的功能。因此在我們使用JavaMail API時需要注意,當需要獲得如前面所講的新郵件數量之類的信息時,我們不得不自己進行計算。
3.IMAP IMAP使用在接收信息的高級協議,目前版本爲第4版,所以也被稱爲IMAP4。需要注意的是在使用IMAP時,郵件服務器必須支持該協議。從這個方面講,我們並不能完全使用IMAP來替代POP,不能期待IMAP在任何地方都被支持。假如郵件服務器支持IMAP,那麼我們的郵件程序將能夠具有以下被IMAP所支持的特性:每個用戶在服務器上可具有多個目錄,這些目錄能在多個用戶之間共享。 其與POP相比高級之處顯而易見,但是在嘗試採取IMAP時,我們認識到它並不是十分完美的:由於IMAP需要從其它服務器上接收新信息,將這些信息遞送給用戶,維護每個用戶的多個目錄,這都爲郵件服務器帶來了高負載。並且IMAP與POP的一個不同之處是POP用戶在接收郵件時將從郵件服務器上下載郵件,而IMAP允許用戶直接訪問郵件目錄,所以在郵件服務器進行備份作業時,由於每個長期使用此郵件系統的用戶所用的郵件目錄會佔有很大的空間,這將直接導致郵件服務器上磁盤空間暴漲。
4.MIME MIME並不是用於傳送郵件的協議,它作爲多用途郵件的擴展定義了郵件內容的格式:信息格式、附件格式等等。一些RFC標準都涉及了MIME:RFC 822, RFC 2045, RFC 2046, RFC 2047,有興趣的Matrixer可以閱讀一下。而作爲JavaMail API的開發者,我們並不需關心這些格式定義,但是這些格式被用在了程序中。
5.NNTP和其它的第三方協議 正因爲JavaMail API在設計時考慮到與第三方協議實現提供商之間的分離,故我們可以很容易的添加一些第三方協議。SUN維護着一個第三方協議實現提供商的列表:http://java.sun.com/products/javamail/Third_Party.html,通過此列表我們可以找到所需要的而又不被SUN提供支持的第三方協議:比如NNTP這個新聞組協議和S/MIME這個安全的MIME協議。
三、安裝 1.安裝JavaMail 爲了使用JavaMail API,需要從http://java.sun.com/products/javamail/downloads/index.html下載文件名格式爲javamail-[version].zip的文件(這個文件中包括了JavaMail實現),並將其中的mail.jar文件添加到CLASSPATH中。這個實現提供了對SMTP、IMAP4、POP3的支持。 注意:在安裝JavaMail實現之後,我們將在demo目錄中發現許多有趣的簡單實例程序。 在安裝了JavaMail之後,我們還需要安裝JavaBeans Activation Framework,因爲這個框架是JavaMail API所需要的。如果我們使用J2EE的話,那麼我們並無需單獨下載JavaMail,因爲它存在於J2EE.jar中,只需將J2EE.jar加入到CLASSPATH即可。
2.安裝JavaBeans Activation Framework 從http://java.sun.com/products/javabeans/glasgow/jaf.html下載JavaBeans Activation Framework,並將其添加到CLASSPATH中。此框架增加了對任何數據塊的分類、以及對它們的處理的特性。這些特性是JavaMail API需要的。雖然聽起來這些特性非常模糊,但是它對於我們的JavaMail API來說只是提供了基本的MIME類型支持。 到此爲止,我們應當把mail.jar和activation.jar都添加到了CLASSPATH中。 當然如果從方便的角度講,直接把這兩個Jar文件複製到JRE目錄的lib/ext目錄中也可以。
四、初次認識JavaMail API 1.瞭解我們的JavaMail環境 A.縱覽JavaMail核心類結構 打開JavaMail.jar文件,我們將發現在javax.mail的包下面存在着一些核心類:Session、Message、Address、Authenticator、Transport、Store、Folder。而且在javax.mail.internet包中還有一些常用的子類。 B.Session Session類定義了基本的郵件會話。就像Http會話那樣,我們進行收發郵件的工作都是基於這個會話的。Session對象利用了java.util.Properties對象獲得了郵件服務器、用戶名、密碼信息和整個應用程序都要使用到的共享信息。 Session類的構造方法是私有的,所以我們可以使用Session類提供的getDefaultInstance()這個靜態工廠方法獲得一個默認的Session對象: Properties props = new Properties();// fill props with any informationSession session = Session.getDefaultInstance(props, null); 或者使用getInstance()這個靜態工廠方法獲得自定義的Session: Properties props = new Properties();// fill props with any informationSession session = Session.getInstance(props, null); 從上面的兩個例子中不難發現,getDefaultInstance()和getInstance()方法的第二個參數都是null,這是因爲在上面的例子中並沒有使用到郵件授權,下文中將對授權進行詳細介紹。 從很多的實例看,在對mail server進行訪問的過程中使用共享的Session是足夠的,即使是工作在多個用戶郵箱的模式下也不例外。
C.Message 當我們建立了Session對象後,便可以被髮送的構造信息體了。在這裏SUN提供了Message類型來幫助開發者完成這項工作。由於Message是一個抽象類,大多數情況下,我們使用javax.mail.internet.MimeMessage這個子類,該類是使用MIME類型、MIME信息頭的郵箱信息。信息頭只能使用US-ASCII字符,而非ASCII字符將通過編碼轉換爲ASCII的方式使用。 爲了建立一個MimeMessage對象,我們必須將Session對象作爲MimeMessage構造方法的參數傳入: MimeMessage message = new MimeMessage(session); 注意:對於MimeMessage類來講存在着多種構造方法,比如使用輸入流作爲參數的構造方法。
在建立了MimeMessage對象後,我們需要設置它的各個part,對於MimeMessage類來說,這些part就是MimePart接口。最基本的設置信息內容的方法就是通過表示信息內容和米麼類型的參數調用setContent()方法: message.setContent("Hello", "text/plain"); 然而,如果我們所使用的MimeMessage中信息內容是文本的話,我們便可以直接使用setText()方法來方便的設置文本內容。 message.setText("Hello"); 前面所講的兩種方法,對於文本信息,後者更爲合適。而對於其它的一些信息類型,比如HTML信息,則要使用前者。 別忘記了,使用setSubject()方法對郵件設置郵件主題: message.setSubject("First");
D.Address 到這裏,我們已經建立了Session和Message,下面將介紹如何使用郵件地址類:Address。像Message一樣,Address類也是一個抽象類,所以我們將使用javax.mail.internet.InternetAddress這個子類。 通過傳入代表郵件地址的字符串,我們可以建立一個郵件地址類: Address address = new InternetAddress("[email protected]"); 如果要在郵件地址後面增加名字的話,可以通過傳遞兩個參數:代表郵件地址和名字的字符串來建立一個具有郵件地址和名字的郵件地址類: Address address = new InternetAddress("[email protected]", "George Bush"); 本文在這裏所講的郵件地址類是爲了設置郵件信息的發信人和收信人而準備的,在建立了郵件地址類後,我們通過message的setFrom()和setReplyTo()兩種方法設置郵件的發信人: message.setFrom(address);message.setReplyTo(address); 若在郵件中存在多個發信人地址,我們可用addForm()方法增加發信人: Address address[] = ...;message.addFrom(address); 爲了設置收信人,我們使用addRecipient()方法增加收信人,此方法需要使用Message.RecipientType的常量來區分收信人的類型: message.addRecipient(type, address) 下面是Message.RecipientType的三個常量: Message.RecipientType.TO Message.RecipientType.CC Message.RecipientType.BCC 因此,如果我們要發送郵件給總統,併發用一個副本給第一夫人的話,下面的方法將被用到: Address toAddress = new InternetAddress("[email protected]");Address ccAddress = new InternetAddress("[email protected]");message.addRecipient(Message.RecipientType.TO, toAddress);message.addRecipient(Message.RecipientType.CC, ccAddress); JavaMail API並沒有提供檢查郵件地址有效性的機制。當然我們可以自己完成這個功能:驗證郵件地址的字符是否按照RFC822規定的格式書寫或者通過DNS服務器上的MX記錄驗證等。
E.Authenticator 像java.net類那樣,JavaMail API通過使用授權者類(Authenticator)以用戶名、密碼的方式訪問那些受到保護的資源,在這裏“資源”就是指郵件服務器。在javax.mail包中可以找到這個JavaMail的授權者類(Authenticator)。 在使用Authenticator這個抽象類時,我們必須採用繼承該抽象類的方式,並且該繼承類必須具有返回PasswordAuthentication對象(用於存儲認證時要用到的用戶名、密碼)getPasswordAuthentication()方法。並且要在Session中進行註冊,使Session能夠了解在認證時該使用哪個類。 下面代碼片斷中的MyAuthenticator就是一個Authenticator的子類。 Properties props = new Properties();// fill props with any informationAuthenticator auth = new MyAuthenticator();Session session = Session.getDefaultInstance(props, auth);
|