郵件實現詳解(四)------JavaMail 發送(帶圖片和附件)和接收郵件
好了,進入這個系列教程最主要的步驟了,前面郵件的理論知識我們都了解了,那麽這篇博客我們將用代碼完成郵件的發送。這在實際項目中應用的非常廣泛,比如註冊需要發送郵件進行賬號激活,再比如OA項目中利用郵件進行任務提醒等等。我們這裏所講的就是利用 JavaMail 完成郵件的發送和接收功能。
PS:本篇博客源碼下載鏈接:https://github.com/YSOcean/cnblogs
1、JavaMail 介紹
JavaMail 是sun公司(現以被甲骨文收購)為方便Java開發人員在應用程序中實現郵件發送和接收功能而提供的一套標準開發包,它支持一些常用的郵件協議,如前面所講的SMTP,POP3,IMAP,還有MIME等。我們在使用JavaMail API 編寫郵件時,無須考慮郵件的底層實現細節,只要調用JavaMail 開發包中相應的API類就可以了。
JavaMail 下載地址: https://github.com/javaee/javamail/releases
下載這個版本的JavaMail,包含了SMTP, IMAP, 和 POP3 協議的實現。
2、JavaMail API
JavaMail API 按照功能可以劃分為如下三大類:
①、創建和解析郵件的API
②、發送郵件的API
③、接收郵件的API
以上三種類型的API在JavaMail 中由多個類組成,但是主要有四個核心類,我們在編寫程序時,記住這四個核心類,就很容易編寫出Java郵件處理程序。
①、Message 類:javax.mail.Message 類是創建和解析郵件的核心 API,這是一個抽象類,通常使用它的子類javax.mail.internet.MimeMessage 類。它的實例對象表示一份電子郵件。客戶端程序發送郵件時,首先使用創建郵件的 JavaMail API 創建出封裝了郵件數據的 Message 對象,然後把這個對象傳遞給郵件發送API(Transport 類) 發送。客戶端程序接收郵件時,郵件接收API把接收到的郵件數據封裝在Message 類的實例中,客戶端程序在使用郵件解析API從這個對象中解析收到的郵件數據。
②、Transport 類:javax.mail.Transport 類是發送郵件的核心API 類,它的實例對象代表實現了某個郵件發送協議的郵件發送對象,例如 SMTP 協議,客戶端程序創建好 Message 對象後,只需要使用郵件發送API 得到 Transport 對象,然後把 Message 對象傳遞給 Transport 對象,並調用它的發送方法,就可以把郵件發送給指定的 SMTP 服務器。
③、Store 類:javax.mail.Store 類是接收郵件的核心 API 類,它的實例對象代表實現了某個郵件接收協議的郵件接收對象,例如 POP3 協議,客戶端程序接收郵件時,只需要使用郵件接收 API 得到 Store 對象,然後調用 Store 對象的接收方法,就可以從指定的 POP3 服務器獲得郵件數據,並把這些郵件數據封裝到表示郵件的 Message 對象中。
④、Session 類:javax.mail.Session 類用於定義整個應用程序所需的環境信息,以及收集客戶端與郵件服務器建立網絡連接的會話信息,例如郵件服務器的主機名、端口號、采用的郵件發送和接收協議等。Session 對象根據這些信息構建用於郵件收發的 Transport 和 Store 對象,以及為客戶端創建 Message 對象時提供信息支持。
3、使用 JavaMail 發送簡單的純文本郵件
在理解下面通過代碼實現郵件的發送時,我們可以將郵件發送假想為火箭運載這衛星發送。其中Message 是衛星,Transport 是火箭,而衛星和火箭的構建都需要 Session 的幫助,這樣的關系更加便於記憶。
package com.ys.mail; import java.io.ObjectInputStream.GetField; import java.util.Date; import java.util.Properties; import javax.mail.Address; import javax.mail.Message; import javax.mail.MessagingException; import javax.mail.Session; import javax.mail.Transport; import javax.mail.internet.AddressException; import javax.mail.internet.InternetAddress; import javax.mail.internet.MimeMessage; import javax.swing.text.html.MinimalHTMLWriter; public class SendMailText { //發件人地址 public static String senderAddress = "[email protected]"; //收件人地址 public static String recipientAddress = "[email protected]"; //發件人賬戶名 public static String senderAccount = "xxx"; //發件人賬戶密碼 public static String senderPassword = "xxx"; public static void main(String[] args) throws Exception { //1、連接郵件服務器的參數配置 Properties props = new Properties(); //設置用戶的認證方式 props.setProperty("mail.smtp.auth", "true"); //設置傳輸協議 props.setProperty("mail.transport.protocol", "smtp"); //設置發件人的SMTP服務器地址 props.setProperty("mail.smtp.host", "smtp.163.com"); //2、創建定義整個應用程序所需的環境信息的 Session 對象 Session session = Session.getInstance(props); //設置調試信息在控制臺打印出來 session.setDebug(true); //3、創建郵件的實例對象 Message msg = getMimeMessage(session); //4、根據session對象獲取郵件傳輸對象Transport Transport transport = session.getTransport(); //設置發件人的賬戶名和密碼 transport.connect(senderAccount, senderPassword); //發送郵件,並發送到所有收件人地址,message.getAllRecipients() 獲取到的是在創建郵件對象時添加的所有收件人, 抄送人, 密送人 transport.sendMessage(msg,msg.getAllRecipients()); //如果只想發送給指定的人,可以如下寫法 //transport.sendMessage(msg, new Address[]{new InternetAddress("[email protected]")}); //5、關閉郵件連接 transport.close(); } /** * 獲得創建一封郵件的實例對象 * @param session * @return * @throws MessagingException * @throws AddressException */ public static MimeMessage getMimeMessage(Session session) throws Exception{ //創建一封郵件的實例對象 MimeMessage msg = new MimeMessage(session); //設置發件人地址 msg.setFrom(new InternetAddress(senderAddress)); /** * 設置收件人地址(可以增加多個收件人、抄送、密送),即下面這一行代碼書寫多行 * MimeMessage.RecipientType.TO:發送 * MimeMessage.RecipientType.CC:抄送 * MimeMessage.RecipientType.BCC:密送 */ msg.setRecipient(MimeMessage.RecipientType.TO,new InternetAddress(recipientAddress)); //設置郵件主題 msg.setSubject("郵件主題","UTF-8"); //設置郵件正文 msg.setContent("簡單的純文本郵件!", "text/html;charset=UTF-8"); //設置郵件的發送時間,默認立即發送 msg.setSentDate(new Date()); return msg; } }
上述的代碼有詳細的註釋,大家不懂得可以留言。註意:大家自己在運行時請將收件人,發件人等信息更改成自己的。
執行完上述代碼,然後我們查看收件箱:
那麽一封簡單的純文本文件就發送完畢了。
4、郵件發送問題
①、發件人的郵箱賬戶名和密碼:有的郵箱設置了獨立密碼,還有的必須用授權碼登錄(qq郵箱),這在 手工體驗smtp和pop3協議 這篇博客中有介紹。
②、發件人的SMTP服務器地址:一般是 smtp.xxx.com,比如163郵箱是smtp.163.com,qq郵箱是smtp.qq.com。
③、有可能你收件人地址,發件人地址等信息都正確了,控制臺也打印了正確的信息,但是在收件箱就是收不到信息。這是因為可能收件箱服務器拒收了你發的郵件(比如認為你的郵件是廣告),這時候可能在垃圾箱裏能找到,可能找不到。解決辦法是重復的郵件內容不要多次發送,或者更換收件箱試試。
④、本實例使用的是JavaMail1.6版本,支持的JDK必須是jdk1.7版本!!!
5、使用 JavaMail 接收郵件
由於接收郵件的用處不多,這裏我們就簡單的給出一個實例:
package com.ys.mail; import java.util.Properties; import javax.mail.Address; import javax.mail.Folder; import javax.mail.Message; import javax.mail.Session; import javax.mail.Store; public class RecipientMail { //收件人地址 public static String recipientAddress = "[email protected]"; //收件人賬戶名 public static String recipientAccount = "xxx"; //收件人賬戶密碼 public static String recipientPassword = "xxx"; public static void main(String[] args) throws Exception { //1、連接郵件服務器的參數配置 Properties props = new Properties(); //設置傳輸協議 props.setProperty("mail.store.protocol", "pop3"); //設置收件人的POP3服務器 props.setProperty("mail.pop3.host", "pop3.163.com"); //2、創建定義整個應用程序所需的環境信息的 Session 對象 Session session = Session.getInstance(props); //設置調試信息在控制臺打印出來 //session.setDebug(true); Store store = session.getStore("pop3"); //連接收件人POP3服務器 store.connect("pop3.163.com", recipientAccount, recipientPassword); //獲得用戶的郵件賬戶,註意通過pop3協議獲取某個郵件夾的名稱只能為inbox Folder folder = store.getFolder("inbox"); //設置對郵件賬戶的訪問權限 folder.open(Folder.READ_WRITE); //得到郵件賬戶的所有郵件信息 Message [] messages = folder.getMessages(); for(int i = 0 ; i < messages.length ; i++){ //獲得郵件主題 String subject = messages[i].getSubject(); //獲得郵件發件人 Address[] from = messages[i].getFrom(); //獲取郵件內容(包含郵件內容的html代碼) String content = (String) messages[i].getContent(); } //關閉郵件夾對象 folder.close(); //關閉連接對象 store.close(); } }
6、使用 JavaMail 發送帶圖片、附件的郵件
我們先看項目結構,在src目錄下包含圖片和附件:
然後看代碼:
package com.ys.mail; import java.util.Date; import java.util.Properties; import javax.activation.DataHandler; import javax.activation.FileDataSource; import javax.mail.Message; import javax.mail.MessagingException; import javax.mail.Session; import javax.mail.Transport; import javax.mail.internet.AddressException; import javax.mail.internet.InternetAddress; import javax.mail.internet.MimeBodyPart; import javax.mail.internet.MimeMessage; import javax.mail.internet.MimeMultipart; import javax.mail.internet.MimeUtility; public class SendMailText_Picture_Enclosure { //發件人地址 public static String senderAddress = "[email protected]"; //收件人地址 public static String recipientAddress = "[email protected]"; //發件人賬戶名 public static String senderAccount = "xxx"; //發件人賬戶密碼 public static String senderPassword = "xxx"; public static void main(String[] args) throws Exception { //1、連接郵件服務器的參數配置 Properties props = new Properties(); //設置用戶的認證方式 props.setProperty("mail.smtp.auth", "true"); //設置傳輸協議 props.setProperty("mail.transport.protocol", "smtp"); //設置發件人的SMTP服務器地址 props.setProperty("mail.smtp.host", "smtp.163.com"); //2、創建定義整個應用程序所需的環境信息的 Session 對象 Session session = Session.getInstance(props); //設置調試信息在控制臺打印出來 session.setDebug(true); //3、創建郵件的實例對象 Message msg = getMimeMessage(session); //4、根據session對象獲取郵件傳輸對象Transport Transport transport = session.getTransport(); //設置發件人的賬戶名和密碼 transport.connect(senderAccount, senderPassword); //發送郵件,並發送到所有收件人地址,message.getAllRecipients() 獲取到的是在創建郵件對象時添加的所有收件人, 抄送人, 密送人 transport.sendMessage(msg,msg.getAllRecipients()); //5、關閉郵件連接 transport.close(); } /** * 獲得創建一封郵件的實例對象 * @param session * @return * @throws MessagingException * @throws AddressException */ public static MimeMessage getMimeMessage(Session session) throws Exception{ //1.創建一封郵件的實例對象 MimeMessage msg = new MimeMessage(session); //2.設置發件人地址 msg.setFrom(new InternetAddress(senderAddress)); /** * 3.設置收件人地址(可以增加多個收件人、抄送、密送),即下面這一行代碼書寫多行 * MimeMessage.RecipientType.TO:發送 * MimeMessage.RecipientType.CC:抄送 * MimeMessage.RecipientType.BCC:密送 */ msg.setRecipient(MimeMessage.RecipientType.TO,new InternetAddress(recipientAddress)); //4.設置郵件主題 msg.setSubject("郵件主題(包含圖片和附件)","UTF-8"); //下面是設置郵件正文 //msg.setContent("簡單的純文本郵件!", "text/html;charset=UTF-8"); // 5. 創建圖片"節點" MimeBodyPart image = new MimeBodyPart(); // 讀取本地文件 DataHandler dh = new DataHandler(new FileDataSource("src\\mailTestPic.png")); // 將圖片數據添加到"節點" image.setDataHandler(dh); // 為"節點"設置一個唯一編號(在文本"節點"將引用該ID) image.setContentID("mailTestPic"); // 6. 創建文本"節點" MimeBodyPart text = new MimeBodyPart(); // 這裏添加圖片的方式是將整個圖片包含到郵件內容中, 實際上也可以以 http 鏈接的形式添加網絡圖片 text.setContent("這是一張圖片<br/><a href=‘http://www.cnblogs.com/ysocean/p/7666061.html‘><img src=‘cid:mailTestPic‘/></a>", "text/html;charset=UTF-8"); // 7. (文本+圖片)設置 文本 和 圖片"節點"的關系(將 文本 和 圖片"節點"合成一個混合"節點") MimeMultipart mm_text_image = new MimeMultipart(); mm_text_image.addBodyPart(text); mm_text_image.addBodyPart(image); mm_text_image.setSubType("related"); // 關聯關系 // 8. 將 文本+圖片 的混合"節點"封裝成一個普通"節點" // 最終添加到郵件的 Content 是由多個 BodyPart 組成的 Multipart, 所以我們需要的是 BodyPart, // 上面的 mailTestPic 並非 BodyPart, 所有要把 mm_text_image 封裝成一個 BodyPart MimeBodyPart text_image = new MimeBodyPart(); text_image.setContent(mm_text_image); // 9. 創建附件"節點" MimeBodyPart attachment = new MimeBodyPart(); // 讀取本地文件 DataHandler dh2 = new DataHandler(new FileDataSource("src\\mailTestDoc.docx")); // 將附件數據添加到"節點" attachment.setDataHandler(dh2); // 設置附件的文件名(需要編碼) attachment.setFileName(MimeUtility.encodeText(dh2.getName())); // 10. 設置(文本+圖片)和 附件 的關系(合成一個大的混合"節點" / Multipart ) MimeMultipart mm = new MimeMultipart(); mm.addBodyPart(text_image); mm.addBodyPart(attachment); // 如果有多個附件,可以創建多個多次添加 mm.setSubType("mixed"); // 混合關系 // 11. 設置整個郵件的關系(將最終的混合"節點"作為郵件的內容添加到郵件對象) msg.setContent(mm); //設置郵件的發送時間,默認立即發送 msg.setSentDate(new Date()); return msg; } }
執行程序後,我們查看郵箱:
那麽一封包含圖片(點擊圖片跳轉到指定超鏈接),和附件的郵件就生成了。
郵件實現詳解(四)------JavaMail 發送(帶圖片和附件)和接收郵件