1.介紹:
Java Mail API的開發是SUN為Java開發者提供公用API框架的持續努力的良好例證。提倡公用框架,反對受限于供應商的解決方案,充分預示著一個日益開放的開發環境的建立。
Java Mail API的結構本身證明了它的開發者的基本目標之一--軟件開發的工作量應該取決于應用程序本身的復雜程度以及開發者所要求的控制程度。換句話說,Java Mail API盡可能地保持簡單。乍看起來,JavaMail API所擁有的類總數以及類之間的關系可能讓人誤解為要花費漫長的學習時間。實際上,一旦正式開始使用,你就會發現該API不失為在應用程序中加入健壯的郵件/通訊支持的簡單工具。
在我們步入JavaMail API之前,先看一下API所涉及的協議。以下便是大家日常所知、所樂于使用的4大信息傳輸協議:SMTP POP IMAP MIME NNTP。
當然,上面的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協議。
2.安裝:
安裝前要確保你的機子上安裝得有標準版的JDK和Web服務器,并且已配置好,有關它們的安裝方法,請參考其它文章(網上到處都有).
(1).安裝JavaMail API。現在最常用的 JavaMail API 版本是1.3.
要使用 JavaMail 1.3 API,請下載 JavaMail 1.3 實現,解開Javamail-1_3.zip 文件,并將 mail.jar 文件添加到 CLASSPATH 中。除了核心類,隨版本 1.3 實現一起提供的還有 SMTP、IMAP4 和 POP3 供應商。
(2).JavaBeans Activation Framework(1.0.2版) 的安裝
JavaMail API 的所有版本都需要 JavaBeans Activation Framework 來
支持任意數據塊的輸入及相應處理。功能似乎不多,但目前許多瀏覽器和郵件工具中都能找到這種基本的 MIME 型支持。下載完框架后,解開 jaf1_0_2.zip 文件,并將 activation.jar 文件添加到 CLASSPATH 中。
注: 如果您使用的JDK是J2EE,就沒有什么特定的事非要用基本 JavaMail API來做不可;J2EE 的類就能處理了,因為它本身就包含有JavaMail API和JAF,您只需要確將 j2ee.jar 文件添加到您的CLASSPATH 中并已全部設置好。
3.JavaMail的常用類介紹
(1)
javax.mail.Properties類
JavaMail需要Properties來創建一個session對象。它將尋找字符串"mail.smtp.host",屬性值就是發送郵件的主機.
用法:
Properties props = new Properties ();
props.put("mail.smtp.host", "smtp.163.com");//可以換上你的smtp主機名。
(2)
javax.mail.Session類
這個Session類代表JavaMail 中的一個郵件session. 每一個基于 JavaMail的應用程序至少有一個session但是可以有任意多的session。 在這個例子中, Session對象需要知道用來處理郵件的SMTP 服務器。
用法:
Session sendMailSession;
sendMailSession = Session.getInstance(props, null);
(3)
javax.mail.Transport類
郵件是既可以被發送也可以被受到。JavaMail使用了兩個不同的類來完成這兩個功能:Transport 和Store. Transport 是用來發送信息的,而Store用來收信。對于這的教程我們只需要用到Transport對象。
用法:
Transport transport;
transport = sendMailSession.getTransport("smtp");
用JavaMail Session對象的getTransport 方法來初始化Transport。傳過去的字符串申明了對象所要使用的協議,如"smtp"。這將為我們省了很多時間。因為JavaMail以境內置了很多協議的實現方法。
注意: JavaMail并不是絕對支持每一個協議,目前支持IMAP、 SMTP和 POP3.
(4)
javax.mail.MimeMessage類
Message對象將存儲我們實際發送的電子郵件信息,Message對象被作為一個MimeMessage對象來創建并且需要知道應當選擇哪一個JavaMail session。
用法:
Message newMessage = new MimeMessage(sendMailSession);
(5)
javax.mail.InternetAddress類
一旦您創建了 Session 和 Message,并將內容填入消息后,就可以用Address確定信件地址了。和 Message 一樣,Address 也是個抽象類。您用的是Javax.mail.internet.InternetAddress 類.
用法:
InternetAddress from=new InternetAddress("xxf@cafe.com");
(6)
javax.mail.Store類
Store類實現特定郵件協議上的讀、寫、監視、查找等操作。通過Javax.mail.Store類可以訪問Javax.mail.Folder類。
用法:
Store store=session.getSorte("pop3");//session為一個郵件會話
store.connect(pop3server,username,password);//通過你提供的pop3地址,用戶名和密碼登錄你的郵箱
(7)
javax.mail.Folder類
Folder類用于分級組織郵件,并提供照Javax.mail.Message格式訪問email的能力。
用法:
Folder folder=store.getFolder("INBOX");
folder.open(Folder.READ_ONLY);
(8)
javax.mail.Internet.MimeMultpart
一般保存電子郵件內容的容器是Multipart抽象類,它定義了增加和刪除及獲得電子郵件不同部分內容的方法.由于Multipart是抽象類,我們必須為它使用一個具體的子類,JavaMail API提供
javax.mail.Internet.MimeMultpart類來使用MimeMessage對象.
用法:
MimeMultipart multipart=new MimeMultipart();
注:我們使用MimeMultipart對象的一個方法是addBodyPart(),它在我們的電子郵件內容里添加BodyPart(BodyPart類在下面緊接著要介紹)對象.消息可以有很多部分,一個BodyPart可以代表一個部分.
(9)
javax.mail.Internet.MimeBodyPart類
MimeBodyPart是BodyPart具體用于mimeMessage的一個子類.
MimeBodyPart對象代表一個MimeMessage對象內容的一部分.每個MimeBodyPart被認為有兩部分:
⊙一個MIME類型
⊙匹配這個類型的內容
用法:
MimeBodyPart mdp=new MimeBodyPart();
String text="Hello JavaMail!";
mdp.setContent(text,"text/plain");//定義MIME類型為text/plain,并設置MimeBodyPart的內容.
(10)
javax.activation.DataHandler類(包含在JAF中)
JavaMail API不限制信息只為文本,任何形式的信息都可能作繭自縛MimeMessage的一部分.除了文本信息,作為文件附件包含在電子郵件信息的一部分是很普遍的.JavaMail API通過使用DataHandler對象,提供一個允許我們包含非文本BodyPart對象的簡便方法.
用法:
DataHandler dh=new DataHandler(text,type);
mdp.setDatahandler(dh);//mdp是一個MimeBodyPart對象
(11)
javax.activation.FileDataSource類(包含在JAF中)
一個FileDataSource對象可以表示本地文件和服務器可以直接訪問的資源.一個本地文件可以通過創建一個新的MimeBodyPart對象附在一個mimeMessage對象上.
用法:
MimeMultipart mm=new MimeMultipart();
MimeBodyPart mdp=new MimeBodyPart();
FileDataSource fds=new FileDataSource("c:/exam.txt");
mdp.setDataHandler(new DataHandler(fds)); //設置數據源
mm.addBodyPart(mdp); //為當前消息MimeMultipart對象增加MimeBodyPart
(12)
javax.activation.URLDataSource類(包含在JAF中)
遠程資源,URL不會指向它們,由一個URLDataSource對象表示.一個遠程資源可以通過創建一個新mimeBodyPart對象附在一個mimeMessage對象上(同FileDataSource差不多).
用法:
與FileDataSource唯一不同的是數據源的設置:
URLDataSource uds=new URLDataSource("/JAVA/UploadFiles_6441/200703/20070320105128501.gif");
4.使用JavaMail API
在明確了JavaMail API的核心部分如何工作后,本人將帶領大家學習一些使用Java Mail API任務案例。
1.發送郵件
在獲得了Session后,建立并填入郵件信息,然后發送它到郵件服務器。這便是使用Java Mail API發送郵件的過程,在發送郵件之前,我們需要設置SMTP服務器:通過設置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);
由于建立郵件信息和發送郵件的過程中可能會拋出異常,所以我們需要將上面的代碼放入到try-catch結構塊中。
2.接收郵件
為了在讀取郵件,我們獲得了session,并且連接到了郵箱的相應store,打開相應的Folder,然后得到我們想要的郵件,當然別忘記了在結束時關閉連接。
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();
上面的代碼所作的是從郵箱中讀取每個郵件,并且顯示郵件的發信人地址和主題。從技術角度講,這里存在著一個異常的可能:當發信人地址為空時,getFrom()[0]將拋出異常。
下面的代碼片斷有效的說明了如何讀取郵件內容,在顯示每個郵件發信人和主題后,將出現用戶提示從而得到用戶是否讀取該郵件的確認,如果輸入YES的話,我們可用Message.writeTo(java.io.OutputStream os)方法將郵件內容輸出到控制臺上,關于 Message.writeTo()的具體用法請看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.刪除郵件和標志
設置與message相關的Flags是刪除郵件的常用方法。這些Flags表示了一些系統定義和用戶定義的不同狀態。在Flags類的內部類Flag中預定義了一些標志:
Flags.Flag.ANSWERED
Flags.Flag.DELETED
Flags.Flag.DRAFT
Flags.Flag.FLAGGED
Flags.Flag.RECENT
Flags.Flag.SEEN
Flags.Flag.USER
但需要在使用時注意的:標志存在并非意味著這個標志被所有的郵件服務器所支持。例如,對于刪除郵件的操作,POP協議不支持上面的任何一個。所以要確定哪些標志是被支持的??通過訪問一個已經打開的Folder對象的getPermanetFlags()方法,它將返回當前被支持的Flags類對象。
刪除郵件時,我們可以設置郵件的DELETED標志:
message.setFlag(Flags.Flag.DELETED, true);
但是首先要采用READ_WRITE的方式打開Folder:
folder.open(Folder.READ_WRITE);
在對郵件進行刪除操作后關閉Folder時,需要傳遞一個true作為對刪除郵件的擦除確認。
folder.close(true);
Folder類中另一種用于刪除郵件的方法expunge()也同樣可刪除郵件,但是它并不為sun提供的POP3實現支持,而其它第三方提供的POP3實現支持或者并不支持這種方法。
另外,介紹一種檢查某個標志是否被設置的方法:Message.isSet(Flags.Flag flag)方法,其中參數為被檢查的標志。
4.郵件認證
我們在前面已經學會了如何使用Authenticator類來代替直接使用用戶名和密碼這兩字符串作為 Session.getDefaultInstance()或者Session.getInstance()方法的參數。在前面的小試牛刀后,現在我們將
了解到全面認識一下郵件認證。
我們在此取代了直接使用郵件服務器主機名、用戶名、密碼這三個字符串作為連接到POP3 Store的方式,使用存儲了郵件服務器主機名信息的屬性文件,并在獲得Session時傳入自定義的Authenticator實例:
// 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 storeStore store = session.getStore("pop3");
store.connect();
PopupAuthenticator 類繼承了抽象類Authenticator,并且通過重載Authenticator類的getPasswordAuthentication()方法返回PasswordAuthentication類對象。而getPasswordAuthentication()方法的參數param是以逗號分割的用戶名、密碼組成的字符串。
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.回復郵件
回復郵件的方法很簡單:使用Message類的reply()方法,通過配置回復郵件的收件人地址和主題(如果沒有提供主題的話,系統將默認將“Re:”作為郵件的主體),這里不需要設置任何的郵件內容,只要復制發信人或者reply-to到新的收件人。而reply()方法中的boolean參數表示是否將郵件回復給發送者(參數值為false),或是恢復給所有人(參數值為true)。
補充一下,reply-to地址需要在發信時使用setReplyTo()方法設置。
MimeMessage reply = (MimeMessage)message.reply(false);
reply.setFrom(new InternetAddress("president@whitehouse.gov"));
reply.setText("Thanks");
Transport.send(reply);
6.轉發郵件
轉發郵件的過程不如前面的回復郵件那樣簡單,它將建立一個轉發郵件,這并非一個方法就能做到。
每個郵件是由多個部分組成,每個部分稱為一個郵件體部分,是一個BodyPart類對象,對于MIME類型郵件來講就是MimeBodyPart類對象。這些郵件體包含在成為Multipart的容器中對于MIME類型郵件來講就是MimeMultiPart類對象。在轉發郵件時,我們建立一個文字郵件體部分和一個被轉發的文字郵件體部分,然后將這兩個郵件體放到一個Multipart中。說明一下,復制一個郵件內容到另一個郵件的方法是僅復制它的 DataHandler(數據處理者)即可。這是由JavaBeans Activation Framework定義的一個類,它提供了對郵件內容的操作命令的訪問、管理了郵件內容操作,是不同的數據源和數據格式之間的一致性接口。
// Create the message to forward
Message forward = new MimeMessage(session);
// Fill in headerforward.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 contentmessage
BodyPart = 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.使用附件
附件作為與郵件相關的資源經常以文本、表格、圖片等格式出現,如流行的郵件客戶端一樣,我們可以用JavaMail API從郵件中獲取附件或是發送帶有附件的郵件。
A.發送帶有附件的郵件
發送帶有附件的郵件的過程有些類似轉發郵件,我們需要建立一個完整郵件的各個郵件體部分,在第一個部分(即我們的郵件內容文字)后,增加一個具有DataHandler的附件而不是在轉發郵件時那樣復制第一個部分的DataHandler。
如果我們將文件作為附件發送,那么要建立FileDataSource類型的對象作為附件數據源;如果從URL讀取數據作為附件發送,那么將要建立URLDataSource類型的對象作為附件數據源。
然后將這個數據源(FileDataSource或是URLDataSource)對象作為DataHandler類構造方法的參數傳入,從而建立一個DataHandler對象作為數據源的DataHandler。
接著將這個DataHandler設置為郵件體部分的DataHandler。這樣就完成了郵件體與附件之間的關聯工作,下面的工作就是BodyPart的setFileName()方法設置附件名為原文件名。
最后將兩個郵件體放入到Multipart中,設置郵件內容為這個容器Multipart,發送郵件。
// 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 message
BodyPart = 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實現發送帶有附件的郵件,則必須上傳附件給servlet,這時需要注意提交頁面form中對編碼類型的設置應為multipart/form-data。
<FORM ENCTYPE="multipart/form-data" method="post" action="/myservlet">
<INPUT TYPE="file" NAME="thefile">
<INPUT TYPE="submit" VALUE="Upload">
</FORM>
B.讀取郵件中的附件
讀取郵件中的附件的過程要比發送它的過程復雜一點。因為帶有附件的郵件是多部分組成的,我們必須處理每一個部分獲得郵件的內容和附件。
但是如何辨別郵件信息內容和附件呢?Sun在Part類(BodyPart類實現的接口類)中提供了getDisposition()方法讓開發者獲得郵件體部分的部署類型,當該部分是附件時,其返回之將是Part.ATTACHMENT。但附件也可以沒有部署類型的方式存在或者部署類型為 Part.INLINE,無論部署類型為Part.ATTACHMENT還是Part.INLINE,我們都能把該郵件體部分導出保存。
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方法是自定義的方法,它根據附件的文件名建立一個文件,如果本地磁盤上存在名為附件的文件,那么將在文件名后增加數字表示區別。然后從郵件體中讀取數據寫入到本地文件中(代碼省略)。
// from saveFile()
File file = new File(filename);
for (int i=0; file.exists(); i++) {
file = new File(filename+i);
}
以上是郵件體部分被正確設置的簡單例子,如果郵件體部分的部署類型為null,那么我們通過獲得郵件體部分的MIME類型來判斷其類型作相應的處理,代碼結構框架如下:
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郵件
前面的例子中發送的郵件都是以文本為內容的(除了附件),下面將介紹如何接收和發送基于HTML的郵件。
A.發送HTML郵件
假如我們需要發送一個HTML文件作為郵件內容,并使郵件客戶端在讀取郵件時獲取相關的圖片或者文字的話,只要設置郵件內容為html代碼,并設置內容類型為text/html即可:
String htmlText = "<H1>Hello</H1>" + "<img src=\"http://www.jguru.com/images/logo.gif\">";
message.setContent(htmlText, "text/html"));
請注意:這里的圖片并不是在郵件中內嵌的,而是在URL中定義的。郵件接收者只有在線時才能看到。
在接收郵件時,如果我們使用JavaMail API接收郵件的話是無法實現以HTML方式顯示郵件內容的。因為JavaMail API郵件內容視為二進制流。所以要顯示HTML內容的郵件,我們必須使用JEditorPane或者第三方HTML展現組件。
以下代碼顯示了如何使用JEditorPane顯示郵件內容:
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.在郵件中包含圖片
如果我們在郵件中使用HTML作為內容,那么最好將HTML中使用的圖片作為郵件的一部分,這樣無論是否在線都會正確的顯示HTML中的圖片。處理方法就是將HTML中用到的圖片作為郵件附件并使用特殊的cid URL作為圖片的引用,這個cid就是對圖片附件的Content-ID頭的引用。
處理內嵌圖片就像向郵件中添加附件一樣,不同之處在于我們必須通過設置圖片附件所在的郵件體部分的header中Content-ID為一個隨機字符串,并在HTML中img的src標記中設置為該字符串。這樣就完成了圖片附件與HTML的關聯。
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
messagemessage.setContent(multipart);
9.在郵件中搜索短語
JavaMail API提供了過濾器機制,它被用來建立搜索短語。這個短語由javax.mail.search包中的SearchTerm抽象類來定義,在定義后我們便可以使用Folder的Search()方法在Folder中查找郵件:
SearchTerm st = ...;Message[] msgs = folder.search(st);
下面有22個不同的類(繼承了SearchTerm類)供我們使用:
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.)
使用這些類定義的斷語集合,我們可以構造一個邏輯表達式,并在Folder中進行搜索。下面是一個實例:在Folder中搜索郵件主題含有“ADV”字符串或者發信人地址為friend@public.com的郵件。
SearchTerm st = new OrTerm(new SubjectTerm("ADV:"), new FromStringTerm("friend@public.com"));
Message[] msgs = folder.search(st);