JavaMail API詳解（上）
一、JavaMail API簡(jiǎn)介
JavaMail API是讀取、撰寫(xiě)、發(fā)送電子信息的可選包。我們可用它來(lái)建立如Eudora、Foxmail、MS Outlook Express一般的郵件用戶代理程序（Mail User Agent,簡(jiǎn)稱(chēng)MUA）。而不是像sendmail或者其它的郵件傳輸代理（Mail Transfer Agent，簡(jiǎn)稱(chēng)MTA）程序那樣可以傳送、遞送、轉(zhuǎn)發(fā)郵件。從另外一個(gè)角度來(lái)看，我們這些電子郵件用戶日常用MUA程序來(lái)讀寫(xiě)郵件，而MUA依賴(lài)著MTA處理郵件的遞送。
在清楚了到MUA與MTA之間的關(guān)系后，讓我們看看JavaMail API是如何提供信息訪問(wèn)功能的吧！JavaMail API被設(shè)計(jì)用于以不依賴(lài)協(xié)議的方式去發(fā)送和接收電子信息，這個(gè)API被分為兩大部分：
基本功能：如何以不依賴(lài)于協(xié)議的方式發(fā)送接收電子信息，這也是本文所要描述的，不過(guò)在下文中，大家將看到這只是一廂情愿而已。
第二個(gè)部分則是依賴(lài)特定協(xié)議的，比如SMTP、POP、IMAP、NNTP協(xié)議。在這部分的JavaMail API是為了和服務(wù)器通訊，并不在本文的內(nèi)容中。
二、相關(guān)協(xié)議一覽
在我們步入JavaMail API之前，先看一下API所涉及的協(xié)議。以下便是大家日常所知、所樂(lè)于使用的4大信息傳輸協(xié)議：
SMTP
POP
IMAP
MIME
當(dāng)然，上面的4個(gè)協(xié)議，并不是全部，還有NNTP和其它一些協(xié)議可用于傳輸信息，但是由于不常用到，所以本文便不提及了。理解這4個(gè)基本的協(xié)議有助于我們更好的使用JavaMail API。然而JavaMail API是被設(shè)計(jì)為與協(xié)議無(wú)關(guān)的，目前我們并不能克服這些協(xié)議的束縛。確切的說(shuō)，如果我們使用的功能并不被我們選擇的協(xié)議支持，那么JavaMail API并不可能如魔術(shù)師一樣神奇的賦予我們這種能力。
1．SMTP
簡(jiǎn)單郵件傳輸協(xié)議定義了遞送郵件的機(jī)制。在下文中，我們將使用基于Java-Mail的程序與公司或者ISP的SMTP服務(wù)器進(jìn)行通訊。這個(gè)SMTP服務(wù)器將郵件轉(zhuǎn)發(fā)到接收者的SMTP服務(wù)器，直至***被接收者通過(guò)POP或者IMAP協(xié)議獲取。這并不需要SMTP服務(wù)器使用支持授權(quán)的郵件轉(zhuǎn)發(fā)，但是卻的確要注意SMTP服務(wù)器的正確設(shè)置（SMTP服務(wù)器的設(shè)置與JavaMail API無(wú)關(guān)）。
2．POP
POP是一種郵局協(xié)議，目前為第3個(gè)版本，即眾所周知的POP3。POP定義了一種用戶如何獲得郵件的機(jī)制。它規(guī)定了每個(gè)用戶使用一個(gè)單獨(dú)的郵箱。大多數(shù)人在使用POP時(shí)所熟悉的功能并非都被支持，例如查看郵箱中的新郵件數(shù)量。而這個(gè)功能是微軟的Outlook內(nèi)建的，那么就說(shuō)明微軟Outlook之類(lèi)的郵件客戶端軟件是通過(guò)查詢最近收到的郵件來(lái)計(jì)算新郵件的數(shù)量來(lái)實(shí)現(xiàn)前面所說(shuō)的功能。因此在我們使用JavaMail API時(shí)需要注意，當(dāng)需要獲得如前面所講的新郵件數(shù)量之類(lèi)的信息時(shí)，我們不得不自己進(jìn)行計(jì)算。
3．IMAP
IMAP使用在接收信息的高級(jí)協(xié)議，目前版本為第4版，所以也被稱(chēng)為IMAP4。需要注意的是在使用IMAP時(shí)，郵件服務(wù)器必須支持該協(xié)議。從這個(gè)方面講，我們并不能完全使用IMAP來(lái)替代POP，不能期待IMAP在任何地方都被支持。假如郵件服務(wù)器支持IMAP，那么我們的郵件程序?qū)⒛軌蚓哂幸韵卤籌MAP所支持的特性：每個(gè)用戶在服務(wù)器上可具有多個(gè)目錄，這些目錄能在多個(gè)用戶之間共享。
其與POP相比高級(jí)之處顯而易見(jiàn)，但是在嘗試采取IMAP時(shí)，我們認(rèn)識(shí)到它并不是十分***的：由于IMAP需要從其它服務(wù)器上接收新信息，將這些信息遞送給用戶，維護(hù)每個(gè)用戶的多個(gè)目錄，這都為郵件服務(wù)器帶來(lái)了高負(fù)載。并且IMAP與POP的一個(gè)不同之處是POP用戶在接收郵件時(shí)將從郵件服務(wù)器上下載郵件，而IMAP允許用戶直接訪問(wèn)郵件目錄，所以在郵件服務(wù)器進(jìn)行備份作業(yè)時(shí)，由于每個(gè)長(zhǎng)期使用此郵件系統(tǒng)的用戶所用的郵件目錄會(huì)占有很大的空間，這將直接導(dǎo)致郵件服務(wù)器上磁盤(pán)空間暴漲。
4．MIME
MIME并不是用于傳送郵件的協(xié)議，它作為多用途郵件的擴(kuò)展定義了郵件內(nèi)容的格式：信息格式、附件格式等等。一些RFC標(biāo)準(zhǔn)都涉及了MIME：RFC 822, RFC 2045, RFC 2046, RFC 2047，有興趣的Matrixer可以閱讀一下。而作為JavaMail API的開(kāi)發(fā)者，我們并不需關(guān)心這些格式定義，但是這些格式被用在了程序中。
5．NNTP和其它的第三方協(xié)議
正因?yàn)镴avaMail API在設(shè)計(jì)時(shí)考慮到與第三方協(xié)議實(shí)現(xiàn)提供商之間的分離，故我們可以很容易的添加一些第三方協(xié)議。SUN維護(hù)著一個(gè)第三方協(xié)議實(shí)現(xiàn)提供商的列表：http：//java.sun.com/products/javamail/Third_Party.html，通過(guò)此列表我們可以找到所需要的而又不被SUN提供支持的第三方協(xié)議：比如NNTP這個(gè)新聞組協(xié)議和S/MIME這個(gè)安全的MIME協(xié)議。
三、安裝JavaMail及其相關(guān)
1．安裝JavaMail
為了使用JavaMail API，需要從http：//java.sun.com/products/javamail/downloads/index.html下載文件名格式為javamail-[version].zip的文件（這個(gè)文件中包括了JavaMail實(shí)現(xiàn)），并將其中的mail.jar文件添加到CLASSPATH中。這個(gè)實(shí)現(xiàn)提供了對(duì)SMTP、IMAP4、POP3的支持。
注意：在安裝JavaMail實(shí)現(xiàn)之后，我們將在demo目錄中發(fā)現(xiàn)許多有趣的簡(jiǎn)單實(shí)例程序。
在安裝了JavaMail之后,我們還需要安裝JavaBeans Activation Framework，因?yàn)檫@個(gè)框架是JavaMail API所需要的。如果我們使用J2EE的話，那么我們并無(wú)需單獨(dú)下載JavaMail，因?yàn)樗嬖谟贘2EE.jar中，只需將J2EE.jar加入到CLASSPATH即可。
2．安裝JavaBeans Activation Framework
從http：//java.sun.com/products/javabeans/glasgow/jaf.html下載JavaBeans Activation Framework，并將其添加到CLASSPATH中。此框架增加了對(duì)任何數(shù)據(jù)塊的分類(lèi)、以及對(duì)它們的處理的特性。這些特性是JavaMail API需要的。雖然聽(tīng)起來(lái)這些特性非常模糊，但是它對(duì)于我們的JavaMail API來(lái)說(shuō)只是提供了基本的MIME類(lèi)型支持。
到此為止，我們應(yīng)當(dāng)把mail.jar和activation.jar都添加到了CLASSPATH中。
當(dāng)然如果從方便的角度講，直接把這兩個(gè)Jar文件復(fù)制到JRE目錄的lib/ext目錄中也可以。
四、初步認(rèn)識(shí)JavaMail API
1．了解我們的JavaMail環(huán)境
A．縱覽JavaMail核心類(lèi)結(jié)構(gòu)
打開(kāi)JavaMail.jar文件，我們將發(fā)現(xiàn)在javax.mail的包下面存在著一些核心類(lèi)：Session、Message、Address、Authenticator、Transport、Store、Folder。而且在javax.mail.internet包中還有一些常用的子類(lèi)。
B．Session
Session類(lèi)定義了基本的郵件會(huì)話。就像Http會(huì)話那樣，我們進(jìn)行收發(fā)郵件的工作都是基于這個(gè)會(huì)話的。Session對(duì)象利用了java.util.Properties對(duì)象獲得了郵件服務(wù)器、用戶名、密碼信息和整個(gè)應(yīng)用程序都要使用到的共享信息。
Session類(lèi)的構(gòu)造方法是私有的，所以我們可以使用Session類(lèi)提供的getDefaultInstance()這個(gè)靜態(tài)工廠方法獲得一個(gè)默認(rèn)的Session對(duì)象：
- Properties props = new Properties();
- // fill props with any informationSession session
- = Session.getDefaultInstance(props, null);
或者使用getInstance()這個(gè)靜態(tài)工廠方法獲得自定義的Session：
- Properties props = new Properties();
- // fill props with any informationSession session = Session.getInstance(props, null);
從上面的兩個(gè)例子中不難發(fā)現(xiàn)，getDefaultInstance()和getInstance()方法的第二個(gè)參數(shù)都是null，這是因?yàn)樵谏厦娴睦又胁](méi)有使用到郵件授權(quán)，下文中將對(duì)授權(quán)進(jìn)行詳細(xì)介紹。
從很多的實(shí)例看，在對(duì)mail server進(jìn)行訪問(wèn)的過(guò)程中使用共享的Session是足夠的，即使是工作在多個(gè)用戶郵箱的模式下也不例外。
C．Message
當(dāng)我們建立了Session對(duì)象后，便可以被發(fā)送的構(gòu)造信息體了。在這里SUN提供了Message類(lèi)型來(lái)幫助開(kāi)發(fā)者完成這項(xiàng)工作。由于Message是一個(gè)抽象類(lèi)，大多數(shù)情況下，我們使用javax.mail.internet.MimeMessage這個(gè)子類(lèi)，該類(lèi)是使用MIME類(lèi)型、MIME信息頭的郵箱信息。信息頭只能使用US-ASCII字符，而非ASCII字符將通過(guò)編碼轉(zhuǎn)換為ASCII的方式使用。
為了建立一個(gè)MimeMessage對(duì)象，我們必須將Session對(duì)象作為MimeMessage構(gòu)造方法的參數(shù)傳入：
MimeMessage message = new MimeMessage(session);
注意：對(duì)于MimeMessage類(lèi)來(lái)講存在著多種構(gòu)造方法，比如使用輸入流作為參數(shù)的構(gòu)造方法。
在建立了MimeMessage對(duì)象后，我們需要設(shè)置它的各個(gè)part，對(duì)于MimeMessage類(lèi)來(lái)說(shuō)，這些part就是MimePart接口。最基本的設(shè)置信息內(nèi)容的方法就是通過(guò)表示信息內(nèi)容和米么類(lèi)型的參數(shù)調(diào)用setContent()方法：
message.setContent("Hello", "text/plain");
然而，如果我們所使用的MimeMessage中信息內(nèi)容是文本的話，我們便可以直接使用setText()方法來(lái)方便的設(shè)置文本內(nèi)容。
message.setText("Hello");
前面所講的兩種方法，對(duì)于文本信息，后者更為合適。而對(duì)于其它的一些信息類(lèi)型，比如HTML信息，則要使用前者。
別忘記了，使用setSubject()方法對(duì)郵件設(shè)置郵件主題：
message.setSubject("First");
D．Address
到這里，我們已經(jīng)建立了Session和Message，下面將介紹如何使用郵件地址類(lèi)：Address。像Message一樣，Address類(lèi)也是一個(gè)抽象類(lèi)，所以我們將使用javax.mail.internet.InternetAddress這個(gè)子類(lèi)。
通過(guò)傳入代表郵件地址的字符串，我們可以建立一個(gè)郵件地址類(lèi)：
Address address = new InternetAddress("president@whitehouse.gov");
如果要在郵件地址后面增加名字的話，可以通過(guò)傳遞兩個(gè)參數(shù)：代表郵件地址和名字的字符串來(lái)建立一個(gè)具有郵件地址和名字的郵件地址類(lèi)：
Address address = new InternetAddress("president@whitehouse.gov", "George Bush");
本文在這里所講的郵件地址類(lèi)是為了設(shè)置郵件信息的發(fā)信人和收信人而準(zhǔn)備的，在建立了郵件地址類(lèi)后，我們通過(guò)message的setFrom()和setReplyTo()兩種方法設(shè)置郵件的發(fā)信人：
message.setFrom(address);message.setReplyTo(address);
若在郵件中存在多個(gè)發(fā)信人地址，我們可用addForm()方法增加發(fā)信人：
Address address[] = ...;message.addFrom(address);
為了設(shè)置收信人，我們使用addRecipient()方法增加收信人，此方法需要使用Message.RecipientType的常量來(lái)區(qū)分收信人的類(lèi)型：
message.addRecipient(type, address)
下面是Message.RecipientType的三個(gè)常量：
- Message.RecipientType.TO
- Message.RecipientType.CC
- Message.RecipientType.BCC
因此，如果我們要發(fā)送郵件給總統(tǒng)，并發(fā)用一個(gè)副本給***夫人的話，下面的方法將被用到：
- 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并沒(méi)有提供檢查郵件地址有效性的機(jī)制。當(dāng)然我們可以自己完成這個(gè)功能：驗(yàn)證郵件地址的字符是否按照RFC822規(guī)定的格式書(shū)寫(xiě)或者通過(guò)DNS服務(wù)器上的MX記錄驗(yàn)證等。
E．Authenticator
像java.net類(lèi)那樣，JavaMail API通過(guò)使用授權(quán)者類(lèi)（Authenticator）以用戶名、密碼的方式訪問(wèn)那些受到保護(hù)的資源，在這里“資源”就是指郵件服務(wù)器。在javax.mail包中可以找到這個(gè)JavaMail的授權(quán)者類(lèi)（Authenticator）。
在使用Authenticator這個(gè)抽象類(lèi)時(shí)，我們必須采用繼承該抽象類(lèi)的方式，并且該繼承類(lèi)必須具有返回PasswordAuthentication對(duì)象（用于存儲(chǔ)認(rèn)證時(shí)要用到的用戶名、密碼）getPasswordAuthentication()方法。并且要在Session中進(jìn)行注冊(cè)，使Session能夠了解在認(rèn)證時(shí)該使用哪個(gè)類(lèi)。
下面代碼片斷中的MyAuthenticator就是一個(gè)Authenticator的子類(lèi)。
- Properties props = new Properties();
- // fill props with any informationAuthenticator auth = new MyAuthenticator();
- Session session = Session.getDefaultInstance(props, auth);
F．Transport
在發(fā)送信息時(shí)，Transport類(lèi)將被用到。這個(gè)類(lèi)實(shí)現(xiàn)了發(fā)送信息的協(xié)議（通稱(chēng)為SMTP），此類(lèi)是一個(gè)抽象類(lèi)，我們可以使用這個(gè)類(lèi)的靜態(tài)方法send()來(lái)發(fā)送消息：
Transport.send(message);
當(dāng)然，方法是多樣的。我們也可由Session獲得相應(yīng)協(xié)議對(duì)應(yīng)的Transport實(shí)例。并通過(guò)傳遞用戶名、密碼、郵件服務(wù)器主機(jī)名等參數(shù)建立與郵件服務(wù)器的連接，并使用sendMessage()方法將信息發(fā)送，***關(guān)閉連接：
- message.saveChanges();
- // implicit with send()Transport transport = session.getTransport("smtp");
- transport.connect(host, username, password);
- transport.sendMessage(message, message.getAllRecipients());transport.close();
評(píng)論：上面的方法是一個(gè)很好的方法，尤其是在我們?cè)谕粋€(gè)郵件服務(wù)器上發(fā)送多個(gè)郵件時(shí)。因?yàn)檫@時(shí)我們將在連接郵件服務(wù)器后連續(xù)發(fā)送郵件，然后再關(guān)閉掉連接。send()這個(gè)基本的方法是在每次調(diào)用時(shí)進(jìn)行與郵件服務(wù)器的連接的，對(duì)于在同一個(gè)郵件服務(wù)器上發(fā)送多個(gè)郵件來(lái)講可謂低效的方式。
注意：如果需要在發(fā)送郵件過(guò)程中監(jiān)控mail命令的話，可以在發(fā)送前設(shè)置debug標(biāo)志：
session.setDebug(true)。
G．Store和Folder
接收郵件和發(fā)送郵件很類(lèi)似都要用到Session。但是在獲得Session后，我們需要從Session中獲取特定類(lèi)型的Store，然后連接到Store，這里的Store代表了存儲(chǔ)郵件的郵件服務(wù)器。在連接Store的過(guò)程中，極有可能需要用到用戶名、密碼或者Authenticator。
// Store store = session.getStore("imap");Store store = session.getStore("pop3");store.connect(host, username, password);
在連接到Store后，一個(gè)Folder對(duì)象即目錄對(duì)象將通過(guò)Store的getFolder()方法被返回，我們可從這個(gè)Folder中讀取郵件信息：
- Folder folder = store.getFolder("INBOX");
- folder.open(Folder.READ_ONLY);
- Message message[] = folder.getMessages();
上面的例子首先從Store中獲得INBOX這個(gè)Folder（對(duì)于POP3協(xié)議只有一個(gè)名為INBOX的Folder有效），然后以只讀（Folder.READ_ONLY）的方式打開(kāi)Folder，***調(diào)用Folder的getMessages()方法得到目錄中所有Message的數(shù)組。
注意：對(duì)于POP3協(xié)議只有一個(gè)名為INBOX的Folder有效，而對(duì)于IMAP協(xié)議，我們可以訪問(wèn)多個(gè)Folder（想想前面講的IMAP協(xié)議）。而且SUN在設(shè)計(jì)Folder的getMessages()方法時(shí)采取了很智能的方式：首先接收新郵件列表，然后再需要的時(shí)候（比如讀取郵件內(nèi)容）才從郵件服務(wù)器讀取郵件內(nèi)容。
在讀取郵件時(shí)，我們可以用Message類(lèi)的getContent()方法接收郵件或是writeTo()方法將郵件保存，getContent()方法只接收郵件內(nèi)容（不包含郵件頭），而writeTo()方法將包括郵件頭。
System.out.println(((MimeMessage)message).getContent());
在讀取郵件內(nèi)容后，別忘記了關(guān)閉Folder和Store。
folder.close(aBoolean);store.close();
傳遞給Folder.close()方法的boolean 類(lèi)型參數(shù)表示是否在刪除操作郵件后更新Folder。
H．繼續(xù)向前進(jìn)！
在講解了以上的七個(gè)Java Mail核心類(lèi)定義和理解了簡(jiǎn)單的代碼片斷后，下文將詳細(xì)講解怎樣使用這些類(lèi)實(shí)現(xiàn)JavaMail API所要完成的高級(jí)功能。
【編輯推薦】
