這篇文章主要為大家詳細介紹了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 = "xxx@163.com"; //收件人地址 public static String recipientAddress = "xxx@qq.com"; //发件人账户名 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("xxx@qq.com")}); //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 = "xxx@163.com"; //收件人账户名 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 = "xxx@163.com"; //收件人地址 public static String recipientAddress = "xxx@qq.com"; //发件人账户名 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實現發送圖片和附件以及接收郵件的詳解的詳細內容。更多資訊請關注PHP中文網其他相關文章!