一、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("president@whitehouse.gov");?
如果要在郵件地址后面增加名字的話,可以通過傳遞兩個參數:代表郵件地址和名字的字符串來建立一個具有郵件地址和名字的郵件地址類:
Address?address?=?new?InternetAddress("president@whitehouse.gov",?"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("vice.president@whitehouse.gov");Address?ccAddress?=?new?InternetAddress("first.lady@whitehouse.gov");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)
近來一直都在研究javamail.歡迎大家交流.qq:57118637