<rt id="bn8ez"></rt>
<label id="bn8ez"></label>

  • <span id="bn8ez"></span>

    <label id="bn8ez"><meter id="bn8ez"></meter></label>

    隨筆-314  評(píng)論-209  文章-0  trackbacks-0

    摘要:

    JavaMail API是讀取、撰寫(xiě)、發(fā)送電子信息的可選包。我們可用它來(lái)建立如Eudora、Foxmail、MS Outlook Express一般的郵件用戶(hù)代理程序(Mail User Agent,簡(jiǎn)稱(chēng)MUA)。讓我們看看JavaMail API是如何提供信息訪(fǎng)問(wèn)功能的吧!JavaMail API被設(shè)計(jì)用于以不依賴(lài)協(xié)議的方式去發(fā)送和接收電子信息,文中著重:如何以不依賴(lài)于協(xié)議的方式發(fā)送接收電子信息,這也是本文所要描述的.

    作者:cleverpig(作者的Blog:http://blog.matrix.org.cn/page/cleverpig)
    原文:http://www.matrix.org.cn/resource/article/44/44101_JavaMail.html
    關(guān)鍵字:java,mail,pop,smtp

    一、JavaMail API簡(jiǎn)介
    JavaMail API是讀取、撰寫(xiě)、發(fā)送電子信息的可選包。我們可用它來(lái)建立如Eudora、Foxmail、MS Outlook Express一般的郵件用戶(hù)代理程序(Mail User Agent,簡(jiǎn)稱(chēng)MUA)。而不是像sendmail或者其它的郵件傳輸代理(Mail Transfer Agent,簡(jiǎn)稱(chēng)MTA)程序那樣可以傳送、遞送、轉(zhuǎn)發(fā)郵件。從另外一個(gè)角度來(lái)看,我們這些電子郵件用戶(hù)日常用MUA程序來(lái)讀寫(xiě)郵件,而MUA依賴(lài)著MTA處理郵件的遞送。
    在清楚了到MUA與MTA之間的關(guān)系后,讓我們看看JavaMail API是如何提供信息訪(fǎng)問(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定義了一種用戶(hù)如何獲得郵件的機(jī)制。它規(guī)定了每個(gè)用戶(hù)使用一個(gè)單獨(dú)的郵箱。大多數(shù)人在使用POP時(shí)所熟悉的功能并非都被支持,例如查看郵箱中的新郵件數(shù)量。而這個(gè)功能是微軟的Outlook內(nèi)建的,那么就說(shuō)明微軟Outlook之類(lèi)的郵件客戶(hù)端軟件是通過(guò)查詢(xún)最近收到的郵件來(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è)用戶(hù)在服務(wù)器上可具有多個(gè)目錄,這些目錄能在多個(gè)用戶(hù)之間共享。
    其與POP相比高級(jí)之處顯而易見(jiàn),但是在嘗試采取IMAP時(shí),我們認(rèn)識(shí)到它并不是十分完美的:由于IMAP需要從其它服務(wù)器上接收新信息,將這些信息遞送給用戶(hù),維護(hù)每個(gè)用戶(hù)的多個(gè)目錄,這都為郵件服務(wù)器帶來(lái)了高負(fù)載。并且IMAP與POP的一個(gè)不同之處是POP用戶(hù)在接收郵件時(shí)將從郵件服務(wù)器上下載郵件,而IMAP允許用戶(hù)直接訪(fǎng)問(wèn)郵件目錄,所以在郵件服務(wù)器進(jìn)行備份作業(yè)時(shí),由于每個(gè)長(zhǎng)期使用此郵件系統(tǒng)的用戶(hù)所用的郵件目錄會(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é)議。

    三、安裝
    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的話(huà),那么我們并無(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ì)話(huà)。就像Http會(huì)話(huà)那樣,我們進(jìn)行收發(fā)郵件的工作都是基于這個(gè)會(huì)話(huà)的。Session對(duì)象利用了java.util.Properties對(duì)象獲得了郵件服務(wù)器、用戶(hù)名、密碼信息和整個(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 information
    Session session = Session.getDefaultInstance(props, null);

    或者使用getInstance()這個(gè)靜態(tài)工廠方法獲得自定義的Session:

    Properties props = new Properties();
    // fill props with any information
    Session 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)行訪(fǎng)問(wèn)的過(guò)程中使用共享的Session是足夠的,即使是工作在多個(gè)用戶(hù)郵箱的模式下也不例外。

    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)容是文本的話(huà),我們便可以直接使用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");

    如果要在郵件地址后面增加名字的話(huà),可以通過(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è)副本給第一夫人的話(huà),下面的方法將被用到:

    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)以用戶(hù)名、密碼的方式訪(fǎng)問(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í)要用到的用戶(hù)名、密碼)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 information
    Authenticator 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ò)傳遞用戶(hù)名、密碼、郵件服務(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命令的話(huà),可以在發(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ò)程中,極有可能需要用到用戶(hù)名、密碼或者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é)議,我們可以訪(fǎng)問(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í)功能。

    五、使用JavaMail API
    在明確了JavaMail API的核心部分如何工作后,本人將帶領(lǐng)大家學(xué)習(xí)一些使用Java Mail API任務(wù)案例。
    1.發(fā)送郵件
    在獲得了Session后,建立并填入郵件信息,然后發(fā)送它到郵件服務(wù)器。這便是使用Java Mail API發(fā)送郵件的過(guò)程,在發(fā)送郵件之前,我們需要設(shè)置SMTP服務(wù)器:通過(guò)設(shè)置Properties的mail.smtp.host屬性。

    String host = ...;
    String from = ...;
    String to = ...;

    // Get system properties
    Properties props = System.getProperties();

    // Setup mail server
    props.put("mail.smtp.host", host);

    // Get session
    Session session = Session.getDefaultInstance(props, null);

    // Define message
    MimeMessage message = new MimeMessage(session);
    message.setFrom(new InternetAddress(from));
    message.addRecipient(Message.RecipientType.TO,
      new InternetAddress(to));
    message.setSubject("Hello JavaMail");
    message.setText("Welcome to JavaMail");
    // Send message
    Transport.send(message);

    由于建立郵件信息和發(fā)送郵件的過(guò)程中可能會(huì)拋出異常,所以我們需要將上面的代碼放入到try-catch結(jié)構(gòu)塊中。

    2.接收郵件
    為了在讀取郵件,我們獲得了session,并且連接到了郵箱的相應(yīng)store,打開(kāi)相應(yīng)的Folder,然后得到我們想要的郵件,當(dāng)然別忘記了在結(jié)束時(shí)關(guān)閉連接。

    String host = ...;
    String username = ...;
    String password = ...;

    // Create empty properties
    Properties props = new Properties();

    // Get session
    Session session = Session.getDefaultInstance(props, null);

    // Get the store
    Store store = session.getStore("pop3");
    store.connect(host, username, password);

    // Get folder
    Folder folder = store.getFolder("INBOX");
    folder.open(Folder.READ_ONLY);

    // Get directory
    Message message[] = folder.getMessages();

    for (int i=0, n=message.length; i<n; i++) {
       System.out.println(i + ": " + message[i].getFrom()[0]
         + "\t" + message[i].getSubject());
    }

    // Close connection
    folder.close(false);
    store.close();

    上面的代碼所作的是從郵箱中讀取每個(gè)郵件,并且顯示郵件的發(fā)信人地址和主題。從技術(shù)角度講,這里存在著一個(gè)異常的可能:當(dāng)發(fā)信人地址為空時(shí),getFrom()[0]將拋出異常。

    下面的代碼片斷有效的說(shuō)明了如何讀取郵件內(nèi)容,在顯示每個(gè)郵件發(fā)信人和主題后,將出現(xiàn)用戶(hù)提示從而得到用戶(hù)是否讀取該郵件的確認(rèn),如果輸入YES的話(huà),我們可用Message.writeTo(java.io.OutputStream os)方法將郵件內(nèi)容輸出到控制臺(tái)上,關(guān)于Message.writeTo()的具體用法請(qǐng)看JavaMail API。

    BufferedReader reader = new BufferedReader (
      new InputStreamReader(System.in));

    // Get directory
    Message message[] = folder.getMessages();
    for (int i=0, n=message.length; i<n; i++) {
      System.out.println(i + ": " + message[i].getFrom()[0]
        + "\t" + message[i].getSubject());

      System.out.println("Do you want to read message? " +
        "[YES to read/QUIT to end]");
      String line = reader.readLine();
      if ("YES".equals(line)) {
        message[i].writeTo(System.out);
      } else if ("QUIT".equals(line)) {
        break;
      }
    }


    3.刪除郵件和標(biāo)志
    設(shè)置與message相關(guān)的Flags是刪除郵件的常用方法。這些Flags表示了一些系統(tǒng)定義和用戶(hù)定義的不同狀態(tài)。在Flags類(lèi)的內(nèi)部類(lèi)Flag中預(yù)定義了一些標(biāo)志:
    Flags.Flag.ANSWERED
    Flags.Flag.DELETED
    Flags.Flag.DRAFT
    Flags.Flag.FLAGGED
    Flags.Flag.RECENT
    Flags.Flag.SEEN
    Flags.Flag.USER
    但需要在使用時(shí)注意的:標(biāo)志存在并非意味著這個(gè)標(biāo)志被所有的郵件服務(wù)器所支持。例如,對(duì)于刪除郵件的操作,POP協(xié)議不支持上面的任何一個(gè)。所以要確定哪些標(biāo)志是被支持的——通過(guò)訪(fǎng)問(wèn)一個(gè)已經(jīng)打開(kāi)的Folder對(duì)象的getPermanetFlags()方法,它將返回當(dāng)前被支持的Flags類(lèi)對(duì)象。
    刪除郵件時(shí),我們可以設(shè)置郵件的DELETED標(biāo)志:

    message.setFlag(Flags.Flag.DELETED, true);

    但是首先要采用READ_WRITE的方式打開(kāi)Folder:

    folder.open(Folder.READ_WRITE);

    在對(duì)郵件進(jìn)行刪除操作后關(guān)閉Folder時(shí),需要傳遞一個(gè)true作為對(duì)刪除郵件的擦除確認(rèn)。

    folder.close(true);

    Folder類(lèi)中另一種用于刪除郵件的方法expunge()也同樣可刪除郵件,但是它并不為sun提供的POP3實(shí)現(xiàn)支持,而其它第三方提供的POP3實(shí)現(xiàn)支持或者并不支持這種方法。
    另外,介紹一種檢查某個(gè)標(biāo)志是否被設(shè)置的方法:Message.isSet(Flags.Flag flag)方法,其中參數(shù)為被檢查的標(biāo)志。

    4.郵件認(rèn)證
    我們?cè)谇懊嬉呀?jīng)學(xué)會(huì)了如何使用Authenticator類(lèi)來(lái)代替直接使用用戶(hù)名和密碼這兩字符串作為Session.getDefaultInstance()或者Session.getInstance()方法的參數(shù)。在前面的小試牛刀后,現(xiàn)在我們將了解到全面認(rèn)識(shí)一下郵件認(rèn)證。
    我們?cè)诖巳〈酥苯邮褂绵]件服務(wù)器主機(jī)名、用戶(hù)名、密碼這三個(gè)字符串作為連接到POP3 Store的方式,使用存儲(chǔ)了郵件服務(wù)器主機(jī)名信息的屬性文件,并在獲得Session時(shí)傳入自定義的Authenticator實(shí)例:

    // Setup properties
    Properties props = System.getProperties();
    props.put("mail.pop3.host", host);

    // Setup authentication, get session
    Authenticator auth = new PopupAuthenticator();
    Session session = Session.getDefaultInstance(props, auth);

    // Get the store
    Store store = session.getStore("pop3");
    store.connect();


    PopupAuthenticator類(lèi)繼承了抽象類(lèi)Authenticator,并且通過(guò)重載Authenticator類(lèi)的getPasswordAuthentication()方法返回PasswordAuthentication類(lèi)對(duì)象。而getPasswordAuthentication()方法的參數(shù)param是以逗號(hào)分割的用戶(hù)名、密碼組成的字符串。

    import javax.mail.*;
    import java.util.*;

    public class PopupAuthenticator extends Authenticator {

      public PasswordAuthentication getPasswordAuthentication(String param) {
        String username, password;

        StringTokenizer st = new StringTokenizer(param, ",");
        username = st.nextToken();
        password = st.nextToken();

        return new PasswordAuthentication(username, password);
      }

    }


    5.回復(fù)郵件
    回復(fù)郵件的方法很簡(jiǎn)單:使用Message類(lèi)的reply()方法,通過(guò)配置回復(fù)郵件的收件人地址和主題(如果沒(méi)有提供主題的話(huà),系統(tǒng)將默認(rèn)將“Re:”作為郵件的主體),這里不需要設(shè)置任何的郵件內(nèi)容,只要復(fù)制發(fā)信人或者reply-to到新的收件人。而reply()方法中的boolean參數(shù)表示是否將郵件回復(fù)給發(fā)送者(參數(shù)值為false),或是恢復(fù)給所有人(參數(shù)值為true)。
    補(bǔ)充一下,reply-to地址需要在發(fā)信時(shí)使用setReplyTo()方法設(shè)置。

    MimeMessage reply = (MimeMessage)message.reply(false);
    reply.setFrom(new InternetAddress("president@whitehouse.gov"));
    reply.setText("Thanks");
    Transport.send(reply);


    6.轉(zhuǎn)發(fā)郵件
    轉(zhuǎn)發(fā)郵件的過(guò)程不如前面的回復(fù)郵件那樣簡(jiǎn)單,它將建立一個(gè)轉(zhuǎn)發(fā)郵件,這并非一個(gè)方法就能做到。
    每個(gè)郵件是由多個(gè)部分組成,每個(gè)部分稱(chēng)為一個(gè)郵件體部分,是一個(gè)BodyPart類(lèi)對(duì)象,對(duì)于MIME類(lèi)型郵件來(lái)講就是MimeBodyPart類(lèi)對(duì)象。這些郵件體包含在成為Multipart的容器中對(duì)于MIME類(lèi)型郵件來(lái)講就是MimeMultiPart類(lèi)對(duì)象。在轉(zhuǎn)發(fā)郵件時(shí),我們建立一個(gè)文字郵件體部分和一個(gè)被轉(zhuǎn)發(fā)的文字郵件體部分,然后將這兩個(gè)郵件體放到一個(gè)Multipart中。說(shuō)明一下,復(fù)制一個(gè)郵件內(nèi)容到另一個(gè)郵件的方法是僅復(fù)制它的DataHandler(數(shù)據(jù)處理者)即可。這是由JavaBeans Activation Framework定義的一個(gè)類(lèi),它提供了對(duì)郵件內(nèi)容的操作命令的訪(fǎng)問(wèn)、管理了郵件內(nèi)容操作,是不同的數(shù)據(jù)源和數(shù)據(jù)格式之間的一致性接口。

    // Create the message to forward
    Message forward = new MimeMessage(session);

    // Fill in header
    forward.setSubject("Fwd: " + message.getSubject());
    forward.setFrom(new InternetAddress(from));
    forward.addRecipient(Message.RecipientType.TO,
      new InternetAddress(to));

    // Create your new message part
    BodyPart messageBodyPart = new MimeBodyPart();
    messageBodyPart.setText(
      "Here you go with the original message:\n\n");

    // Create a multi-part to combine the parts
    Multipart multipart = new MimeMultipart();
    multipart.addBodyPart(messageBodyPart);

    // Create and fill part for the forwarded content
    messageBodyPart = new MimeBodyPart();
    messageBodyPart.setDataHandler(message.getDataHandler());

    // Add part to multi part
    multipart.addBodyPart(messageBodyPart);

    // Associate multi-part with message
    forward.setContent(multipart);

    // Send message
    Transport.send(forward);


    7.使用附件
    附件作為與郵件相關(guān)的資源經(jīng)常以文本、表格、圖片等格式出現(xiàn),如流行的郵件客戶(hù)端一樣,我們可以用JavaMail API從郵件中獲取附件或是發(fā)送帶有附件的郵件。

    A.發(fā)送帶有附件的郵件
    發(fā)送帶有附件的郵件的過(guò)程有些類(lèi)似轉(zhuǎn)發(fā)郵件,我們需要建立一個(gè)完整郵件的各個(gè)郵件體部分,在第一個(gè)部分(即我們的郵件內(nèi)容文字)后,增加一個(gè)具有DataHandler的附件而不是在轉(zhuǎn)發(fā)郵件時(shí)那樣復(fù)制第一個(gè)部分的DataHandler。

    如果我們將文件作為附件發(fā)送,那么要建立FileDataSource類(lèi)型的對(duì)象作為附件數(shù)據(jù)源;如果從URL讀取數(shù)據(jù)作為附件發(fā)送,那么將要建立URLDataSource類(lèi)型的對(duì)象作為附件數(shù)據(jù)源。

    然后將這個(gè)數(shù)據(jù)源(FileDataSource或是URLDataSource)對(duì)象作為DataHandler類(lèi)構(gòu)造方法的參數(shù)傳入,從而建立一個(gè)DataHandler對(duì)象作為數(shù)據(jù)源的DataHandler。

    接著將這個(gè)DataHandler設(shè)置為郵件體部分的DataHandler。這樣就完成了郵件體與附件之間的關(guān)聯(lián)工作,下面的工作就是BodyPart的setFileName()方法設(shè)置附件名為原文件名。

    最后將兩個(gè)郵件體放入到Multipart中,設(shè)置郵件內(nèi)容為這個(gè)容器Multipart,發(fā)送郵件。

    // Define message
    Message message = new MimeMessage(session);
    message.setFrom(new InternetAddress(from));
    message.addRecipient(Message.RecipientType.TO,
      new InternetAddress(to));
    message.setSubject("Hello JavaMail Attachment");

    // Create the message part
    BodyPart messageBodyPart = new MimeBodyPart();

    // Fill the message
    messageBodyPart.setText("Pardon Ideas");

    Multipart multipart = new MimeMultipart();
    multipart.addBodyPart(messageBodyPart);

    // Part two is attachment
    messageBodyPart = new MimeBodyPart();
    DataSource source = new FileDataSource(filename);
    messageBodyPart.setDataHandler(new DataHandler(source));
    messageBodyPart.setFileName(filename);
    multipart.addBodyPart(messageBodyPart);

    // Put parts in message
    message.setContent(multipart);

    // Send the message
    Transport.send(message);

    如果我們使用servlet實(shí)現(xiàn)發(fā)送帶有附件的郵件,則必須上傳附件給servlet,這時(shí)需要注意提交頁(yè)面form中對(duì)編碼類(lèi)型的設(shè)置應(yīng)為multipart/form-data。

    <FORM ENCTYPE="multipart/form-data"
        method=post action="/myservlet">
      <INPUT TYPE="file" NAME="thefile">
      <INPUT TYPE="submit" VALUE="Upload">
    </FORM>


    B.讀取郵件中的附件
    讀取郵件中的附件的過(guò)程要比發(fā)送它的過(guò)程復(fù)雜一點(diǎn)。因?yàn)閹в懈郊泥]件是多部分組成的,我們必須處理每一個(gè)部分獲得郵件的內(nèi)容和附件。
    但是如何辨別郵件信息內(nèi)容和附件呢?Sun在Part類(lèi)(BodyPart類(lèi)實(shí)現(xiàn)的接口類(lèi))中提供了getDisposition()方法讓開(kāi)發(fā)者獲得郵件體部分的部署類(lèi)型,當(dāng)該部分是附件時(shí),其返回之將是Part.ATTACHMENT。但附件也可以沒(méi)有部署類(lèi)型的方式存在或者部署類(lèi)型為Part.INLINE,無(wú)論部署類(lèi)型為Part.ATTACHMENT還是Part.INLINE,我們都能把該郵件體部分導(dǎo)出保存。

    Multipart mp = (Multipart)message.getContent();

    for (int i=0, n=multipart.getCount(); i<n; i++) {
      Part part = multipart.getBodyPart(i));

      String disposition = part.getDisposition();

      if ((disposition != null) &&
          ((disposition.equals(Part.ATTACHMENT) ||
           (disposition.equals(Part.INLINE))) {
        saveFile(part.getFileName(), part.getInputStream());
      }
    }

    下列代碼中使用了saveFile方法是自定義的方法,它根據(jù)附件的文件名建立一個(gè)文件,如果本地磁盤(pán)上存在名為附件的文件,那么將在文件名后增加數(shù)字表示區(qū)別。然后從郵件體中讀取數(shù)據(jù)寫(xiě)入到本地文件中(代碼省略)。

    // from saveFile()
    File file = new File(filename);
    for (int i=0; file.exists(); i++) {
      file = new File(filename+i);
    }

    以上是郵件體部分被正確設(shè)置的簡(jiǎn)單例子,如果郵件體部分的部署類(lèi)型為null,那么我們通過(guò)獲得郵件體部分的MIME類(lèi)型來(lái)判斷其類(lèi)型作相應(yīng)的處理,代碼結(jié)構(gòu)框架如下:

    if (disposition == null) {
      // Check if plain
      MimeBodyPart mbp = (MimeBodyPart)part;
      if (mbp.isMimeType("text/plain")) {
        // Handle plain
      } else {
        // Special non-attachment cases here of
        // image/gif, text/html, ...
      }
    ...
    }


    8.處理HTML郵件
    前面的例子中發(fā)送的郵件都是以文本為內(nèi)容的(除了附件),下面將介紹如何接收和發(fā)送基于HTML的郵件。
    A.發(fā)送HTML郵件
    假如我們需要發(fā)送一個(gè)HTML文件作為郵件內(nèi)容,并使郵件客戶(hù)端在讀取郵件時(shí)獲取相關(guān)的圖片或者文字的話(huà),只要設(shè)置郵件內(nèi)容為html代碼,并設(shè)置內(nèi)容類(lèi)型為text/html即可:

    String htmlText = "<H1>Hello</H1>" +
      "<img src=\"http://www.jguru.com/images/logo.gif\">";
    message.setContent(htmlText, "text/html"));

    請(qǐng)注意:這里的圖片并不是在郵件中內(nèi)嵌的,而是在URL中定義的。郵件接收者只有在線(xiàn)時(shí)才能看到。
    在接收郵件時(shí),如果我們使用JavaMail API接收郵件的話(huà)是無(wú)法實(shí)現(xiàn)以HTML方式顯示郵件內(nèi)容的。因?yàn)镴avaMail API郵件內(nèi)容視為二進(jìn)制流。所以要顯示HTML內(nèi)容的郵件,我們必須使用JEditorPane或者第三方HTML展現(xiàn)組件。

    以下代碼顯示了如何使用JEditorPane顯示郵件內(nèi)容:

    if (message.getContentType().equals("text/html")) {
      String content = (String)message.getContent();
      JFrame frame = new JFrame();
      JEditorPane text = new JEditorPane("text/html", content);
      text.setEditable(false);
      JScrollPane pane = new JScrollPane(text);
      frame.getContentPane().add(pane);
      frame.setSize(300, 300);
      frame.setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE);
      frame.show();
    }


    B.在郵件中包含圖片
    如果我們?cè)卩]件中使用HTML作為內(nèi)容,那么最好將HTML中使用的圖片作為郵件的一部分,這樣無(wú)論是否在線(xiàn)都會(huì)正確的顯示HTML中的圖片。處理方法就是將HTML中用到的圖片作為郵件附件并使用特殊的cid URL作為圖片的引用,這個(gè)cid就是對(duì)圖片附件的Content-ID頭的引用。
    處理內(nèi)嵌圖片就像向郵件中添加附件一樣,不同之處在于我們必須通過(guò)設(shè)置圖片附件所在的郵件體部分的header中Content-ID為一個(gè)隨機(jī)字符串,并在HTML中img的src標(biāo)記中設(shè)置為該字符串。這樣就完成了圖片附件與HTML的關(guān)聯(lián)。

    String file = ...;

    // Create the message
    Message message = new MimeMessage(session);

    // Fill its headers
    message.setSubject("Embedded Image");
    message.setFrom(new InternetAddress(from));
    message.addRecipient(Message.RecipientType.TO,
      new InternetAddress(to));

    // Create your new message part
    BodyPart messageBodyPart = new MimeBodyPart();
    String htmlText = "<H1>Hello</H1>" +
      "<img src=\"cid:memememe\">";
    messageBodyPart.setContent(htmlText, "text/html");

    // Create a related multi-part to combine the parts
    MimeMultipart multipart = new MimeMultipart("related");
    multipart.addBodyPart(messageBodyPart);

    // Create part for the image
    messageBodyPart = new MimeBodyPart();

    // Fetch the image and associate to part
    DataSource fds = new FileDataSource(file);
    messageBodyPart.setDataHandler(new DataHandler(fds));
    messageBodyPart.setHeader("Content-ID","<memememe>");

    // Add part to multi-part
    multipart.addBodyPart(messageBodyPart);

    // Associate multi-part with message
    message.setContent(multipart);


    9.在郵件中搜索短語(yǔ)
    JavaMail API提供了過(guò)濾器機(jī)制,它被用來(lái)建立搜索短語(yǔ)。這個(gè)短語(yǔ)由javax.mail.search包中的SearchTerm抽象類(lèi)來(lái)定義,在定義后我們便可以使用Folder的Search()方法在Folder中查找郵件:

    SearchTerm st = ...;
    Message[] msgs = folder.search(st);

    下面有22個(gè)不同的類(lèi)(繼承了SearchTerm類(lèi))供我們使用:
    AND terms (class AndTerm)
    OR terms (class OrTerm)
    NOT terms (class NotTerm)
    SENT DATE terms (class SentDateTerm)
    CONTENT terms (class BodyTerm)
    HEADER terms (FromTerm / FromStringTerm, RecipientTerm / RecipientStringTerm, SubjectTerm, etc.)
    使用這些類(lèi)定義的斷語(yǔ)集合,我們可以構(gòu)造一個(gè)邏輯表達(dá)式,并在Folder中進(jìn)行搜索。下面是一個(gè)實(shí)例:在Folder中搜索郵件主題含有“ADV”字符串或者發(fā)信人地址為friend@public.com的郵件。

    SearchTerm st =
      new OrTerm(
        new SubjectTerm("ADV:"),
        new FromStringTerm("friend@public.com"));
    Message[] msgs = folder.search(st);


    六、參考資源
    JavaMail API Home
    Sun’s JavaMail API基礎(chǔ)
    JavaBeans Activation Framework Home
    javamail-interest mailing list
    Sun's JavaMail FAQ
    jGuru's JavaMail FAQ
    Third Party Products List

    七、代碼下載
    http://java.sun.com/developer/onlineTraining/JavaMail/exercises.html
    posted on 2006-09-04 17:12 xzc 閱讀(211) 評(píng)論(0)  編輯  收藏 所屬分類(lèi): Java
    主站蜘蛛池模板: 亚洲国产精品综合久久网络| 免费乱理伦在线播放| 成年性午夜免费视频网站不卡| 免费观看男人免费桶女人视频 | 精品熟女少妇aⅴ免费久久 | 91精品国产免费久久国语蜜臀| 青青在线久青草免费观看| 免费观看的毛片手机视频| 国产91精品一区二区麻豆亚洲| 亚洲AV日韩精品久久久久久| 亚洲国产最大av| 午夜在线免费视频| 99精品视频在线免费观看| 在线观看成人免费| 亚洲中文字幕日产乱码高清app| 久久久久久久亚洲Av无码 | 亚洲国产成人资源在线软件| 亚洲国产精品无码久久| 午夜肉伦伦影院久久精品免费看国产一区二区三区 | 在线观看免费a∨网站| 亚洲国产人成精品| 亚洲日本中文字幕| 久久综合亚洲色hezyo| 日本一区午夜艳熟免费| 毛片a级毛片免费观看免下载| 亚洲日韩VA无码中文字幕| 亚洲熟妇无码久久精品| 曰批免费视频播放免费| 99re在线精品视频免费| 日韩a在线观看免费观看| 亚洲AV无码国产精品色午友在线 | 99久久精品免费视频| 四虎永久免费网站免费观看| 亚洲AV无码一区东京热久久| 亚洲乱码av中文一区二区| 免费看黄的成人APP| 国产成人免费福利网站| 亚洲综合图片小说区热久久| 羞羞漫画小舞被黄漫免费| 国产国产人免费视频成69堂| 亚洲色精品88色婷婷七月丁香|