本文鏈接：http://blog.csdn.net/xietansheng/article/details/51673073
電子郵件的應(yīng)用非常廣泛，例如在某網(wǎng)站注冊(cè)了一個(gè)賬戶，自動(dòng)發(fā)送一封歡迎郵件，通過(guò)郵件找回密碼，自動(dòng)批量發(fā)送活動(dòng)信息等，但這些應(yīng)用不可能和我們自己平時(shí)發(fā)郵件一樣，先打開(kāi)瀏覽器，登錄郵箱，創(chuàng)建郵件再發(fā)送，本文將簡(jiǎn)單介紹如何通過(guò) Java 代碼來(lái)創(chuàng)建電子郵件，并連接郵件服務(wù)器發(fā)送郵件
1. 電子郵件協(xié)議
電子郵件的在網(wǎng)絡(luò)中傳輸和網(wǎng)頁(yè)一樣需要遵從特定的協(xié)議，常用的電子郵件協(xié)議包括 SMTP、POP3、IMAP，其中郵件的創(chuàng)建和發(fā)送只需要用到 SMTP協(xié)議，所以本文也只會(huì)涉及到SMTP協(xié)議，SMTP 是 Simple Mail Transfer Protocol 的簡(jiǎn)稱(chēng)，即簡(jiǎn)單郵件傳輸協(xié)議
2. JavaMail
我們平時(shí)通過(guò) Java 代碼打開(kāi)一個(gè) http 網(wǎng)頁(yè)鏈接時(shí)，通常可以使用已經(jīng)對(duì) http 協(xié)議封裝好的 HttpURLConnection 類(lèi)來(lái)快速地實(shí)現(xiàn)，Java 官方也提供了對(duì)電子郵件協(xié)議封裝的 Java 類(lèi)庫(kù)，就是JavaMail，但并沒(méi)有包含到標(biāo)準(zhǔn)的 JDK 中，需要去下載
3. 創(chuàng)建一封簡(jiǎn)單的電子郵件
郵件創(chuàng)建步驟:
- 創(chuàng)建一個(gè)郵件對(duì)象（MimeMessage）
- 設(shè)置發(fā)件人，收件人，可選增加多個(gè)收件人，抄送人，密送人
- 設(shè)置郵件的主題（標(biāo)題）
- 設(shè)置郵件的正文（內(nèi)容）
- 設(shè)置顯示的發(fā)送時(shí)間
- 保存到本地
代碼實(shí)現(xiàn):
import javax.mail.Session;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import java.io.FileOutputStream;
import java.io.OutputStream;
import java.util.Date;
import java.util.Properties;
/**
* JavaMail
*/
public class Main {
public static void main(String[] args) throws Exception {
// 1. 創(chuàng)建一封郵件
Properties props = new Properties(); // 用于連接郵件服務(wù)器的參數(shù)配置（發(fā)送郵件時(shí)才需要用到）
Session session= Session.getInstance(props); // 根據(jù)參數(shù)配置，創(chuàng)建會(huì)話對(duì)象（為了發(fā)送郵件準(zhǔn)備的）
MimeMessage message = new MimeMessage(session); // 創(chuàng)建郵件對(duì)象
/*
* 也可以根據(jù)已有的eml郵件文件創(chuàng)建 MimeMessage 對(duì)象
* MimeMessage message = new MimeMessage(session, new FileInputStream("MyEmail.eml"));
*/
// 2. From: 發(fā)件人
// 其中 InternetAddress 的三個(gè)參數(shù)分別為: 郵箱, 顯示的昵稱(chēng)(只用于顯示, 沒(méi)有特別的要求), 昵稱(chēng)的字符集編碼
// 真正要發(fā)送時(shí), 郵箱必須是真實(shí)有效的郵箱。
message.setFrom(new InternetAddress("aa@send.com", "USER_AA", "UTF-8"));
// 3. To: 收件人
message.setRecipient(MimeMessage.RecipientType.TO, new InternetAddress("cc@receive.com", "USER_CC", "UTF-8"));
// To: 增加收件人（可選）
message.addRecipient(MimeMessage.RecipientType.TO, new InternetAddress("dd@receive.com", "USER_DD", "UTF-8"));
// Cc: 抄送（可選）
message.setRecipient(MimeMessage.RecipientType.CC, new InternetAddress("ee@receive.com", "USER_EE", "UTF-8"));
// Bcc: 密送（可選）
message.setRecipient(MimeMessage.RecipientType.BCC, new InternetAddress("ff@receive.com", "USER_FF", "UTF-8"));
// 4. Subject: 郵件主題
message.setSubject("TEST郵件主題", "UTF-8");
// 5. Content: 郵件正文（可以使用html標(biāo)簽）
message.setContent("TEST這是郵件正文。。。", "text/html;charset=UTF-8");
// 6. 設(shè)置顯示的發(fā)件時(shí)間
message.setSentDate(new Date());
// 7. 保存前面的設(shè)置
message.saveChanges();
// 8. 將該郵件保存到本地
OutputStream out = new FileOutputStream("MyEmail.eml");
message.writeTo(out);
out.flush();
out.close();
}
}
保存的 MyEmail.eml 可以使用郵件客戶端打開(kāi)查看，實(shí)際上就是一堆符合SMTP協(xié)議格式的文本（內(nèi)容使用base64進(jìn)行了編碼），也可用記事本打開(kāi)
4. 發(fā)送電子郵件
發(fā)送郵件首先需要有一個(gè)郵箱賬號(hào)和密碼，本文以網(wǎng)易163郵箱為例，郵箱賬號(hào)必須要開(kāi)啟 SMTP 服務(wù)，在瀏覽器網(wǎng)頁(yè)登錄郵箱后一般在郵箱的“設(shè)置”選項(xiàng)中可以開(kāi)啟，并記下郵箱的 SMTP 服務(wù)器地址，如下所示（其他郵箱大同小異）
代碼實(shí)現(xiàn):
package com.xiets.javamaildemo;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import java.util.Date;
import java.util.Properties;
/**
* JavaMail 版本: 1.6.0
* JDK 版本: JDK 1.7 以上（必須）
*/
public class Main {
// 發(fā)件人的 郵箱 和 密碼（替換為自己的郵箱和密碼）
// PS: 某些郵箱服務(wù)器為了增加郵箱本身密碼的安全性，給 SMTP 客戶端設(shè)置了獨(dú)立密碼（有的郵箱稱(chēng)為“授權(quán)碼”）,
// 對(duì)于開(kāi)啟了獨(dú)立密碼的郵箱, 這里的郵箱密碼必需使用這個(gè)獨(dú)立密碼（授權(quán)碼）。
public static String myEmailAccount = "xxxxxxxxx@163.com";
public static String myEmailPassword = "xxxxxxxxx";
// 發(fā)件人郵箱的 SMTP 服務(wù)器地址, 必須準(zhǔn)確, 不同郵件服務(wù)器地址不同, 一般(只是一般, 絕非絕對(duì))格式為: smtp.xxx.com
// 網(wǎng)易163郵箱的 SMTP 服務(wù)器地址為: smtp.163.com
public static String myEmailSMTPHost = "smtp.163.com";
// 收件人郵箱（替換為自己知道的有效郵箱）
public static String receiveMailAccount = "xxxxxxxxx@qq.com";
public static void main(String[] args) throws Exception {
// 1. 創(chuàng)建參數(shù)配置, 用于連接郵件服務(wù)器的參數(shù)配置
Properties props = new Properties(); // 參數(shù)配置
props.setProperty("mail.transport.protocol", "smtp"); // 使用的協(xié)議（JavaMail規(guī)范要求）
props.setProperty("mail.smtp.host", myEmailSMTPHost); // 發(fā)件人的郵箱的 SMTP 服務(wù)器地址
props.setProperty("mail.smtp.auth", "true"); // 需要請(qǐng)求認(rèn)證
// PS: 某些郵箱服務(wù)器要求 SMTP 連接需要使用 SSL 安全認(rèn)證 (為了提高安全性, 郵箱支持SSL連接, 也可以自己開(kāi)啟),
// 如果無(wú)法連接郵件服務(wù)器, 仔細(xì)查看控制臺(tái)打印的 log, 如果有有類(lèi)似 “連接失敗, 要求 SSL 安全連接” 等錯(cuò)誤,
// 打開(kāi)下面 /* ... */ 之間的注釋代碼, 開(kāi)啟 SSL 安全連接。
/*
// SMTP 服務(wù)器的端口 (非 SSL 連接的端口一般默認(rèn)為 25, 可以不添加, 如果開(kāi)啟了 SSL 連接,
// 需要改為對(duì)應(yīng)郵箱的 SMTP 服務(wù)器的端口, 具體可查看對(duì)應(yīng)郵箱服務(wù)的幫助,
// QQ郵箱的SMTP(SLL)端口為465或587, 其他郵箱自行去查看)
final String smtpPort = "465";
props.setProperty("mail.smtp.port", smtpPort);
props.setProperty("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
props.setProperty("mail.smtp.socketFactory.fallback", "false");
props.setProperty("mail.smtp.socketFactory.port", smtpPort);
*/
// 2. 根據(jù)配置創(chuàng)建會(huì)話對(duì)象, 用于和郵件服務(wù)器交互
Session session = Session.getInstance(props);
session.setDebug(true); // 設(shè)置為debug模式, 可以查看詳細(xì)的發(fā)送 log
// 3. 創(chuàng)建一封郵件
MimeMessage message = createMimeMessage(session, myEmailAccount, receiveMailAccount);
// 4. 根據(jù) Session 獲取郵件傳輸對(duì)象
Transport transport = session.getTransport();
// 5. 使用 郵箱賬號(hào) 和 密碼 連接郵件服務(wù)器, 這里認(rèn)證的郵箱必須與 message 中的發(fā)件人郵箱一致, 否則報(bào)錯(cuò)
//
// PS_01: 成敗的判斷關(guān)鍵在此一句, 如果連接服務(wù)器失敗, 都會(huì)在控制臺(tái)輸出相應(yīng)失敗原因的 log,
// 仔細(xì)查看失敗原因, 有些郵箱服務(wù)器會(huì)返回錯(cuò)誤碼或查看錯(cuò)誤類(lèi)型的鏈接, 根據(jù)給出的錯(cuò)誤
// 類(lèi)型到對(duì)應(yīng)郵件服務(wù)器的幫助網(wǎng)站上查看具體失敗原因。
//
// PS_02: 連接失敗的原因通常為以下幾點(diǎn), 仔細(xì)檢查代碼:
// (1) 郵箱沒(méi)有開(kāi)啟 SMTP 服務(wù);
// (2) 郵箱密碼錯(cuò)誤, 例如某些郵箱開(kāi)啟了獨(dú)立密碼;
// (3) 郵箱服務(wù)器要求必須要使用 SSL 安全連接;
// (4) 請(qǐng)求過(guò)于頻繁或其他原因, 被郵件服務(wù)器拒絕服務(wù);
// (5) 如果以上幾點(diǎn)都確定無(wú)誤, 到郵件服務(wù)器網(wǎng)站查找?guī)椭? //
// PS_03: 仔細(xì)看log, 認(rèn)真看log, 看懂log, 錯(cuò)誤原因都在log已說(shuō)明。
transport.connect(myEmailAccount, myEmailPassword);
// 6. 發(fā)送郵件, 發(fā)到所有的收件地址, message.getAllRecipients() 獲取到的是在創(chuàng)建郵件對(duì)象時(shí)添加的所有收件人, 抄送人, 密送人
transport.sendMessage(message, message.getAllRecipients());
// 7. 關(guān)閉連接
transport.close();
}
/**
* 創(chuàng)建一封只包含文本的簡(jiǎn)單郵件
*
* @param session 和服務(wù)器交互的會(huì)話
* @param sendMail 發(fā)件人郵箱
* @param receiveMail 收件人郵箱
* @return
* @throws Exception
*/
public static MimeMessage createMimeMessage(Session session, String sendMail, String receiveMail) throws Exception {
// 1. 創(chuàng)建一封郵件
MimeMessage message = new MimeMessage(session);
// 2. From: 發(fā)件人（昵稱(chēng)有廣告嫌疑，避免被郵件服務(wù)器誤認(rèn)為是濫發(fā)廣告以至返回失敗，請(qǐng)修改昵稱(chēng)）
message.setFrom(new InternetAddress(sendMail, "某寶網(wǎng)", "UTF-8"));
// 3. To: 收件人（可以增加多個(gè)收件人、抄送、密送）
message.setRecipient(MimeMessage.RecipientType.TO, new InternetAddress(receiveMail, "XX用戶", "UTF-8"));
// 4. Subject: 郵件主題（標(biāo)題有廣告嫌疑，避免被郵件服務(wù)器誤認(rèn)為是濫發(fā)廣告以至返回失敗，請(qǐng)修改標(biāo)題）
message.setSubject("打折鉅惠", "UTF-8");
// 5. Content: 郵件正文（可以使用html標(biāo)簽）（內(nèi)容有廣告嫌疑，避免被郵件服務(wù)器誤認(rèn)為是濫發(fā)廣告以至返回失敗，請(qǐng)修改發(fā)送內(nèi)容）
message.setContent("XX用戶你好, 今天全場(chǎng)5折, 快來(lái)?yè)屬?gòu), 錯(cuò)過(guò)今天再等一年。。。", "text/html;charset=UTF-8");
// 6. 設(shè)置發(fā)件時(shí)間
message.setSentDate(new Date());
// 7. 保存設(shè)置
message.saveChanges();
return message;
}
}
5. 復(fù)雜郵件發(fā)送
一封復(fù)雜的郵件內(nèi)容可以看做是由很多節(jié)點(diǎn)（或者可以說(shuō)是“片段”/“部分”/“零件”）組成，文本、圖片、附件等都可以看成是郵件內(nèi)容中的一個(gè)節(jié)點(diǎn)，這些節(jié)點(diǎn)之間又可以相互關(guān)聯(lián)組合成一個(gè)節(jié)點(diǎn)，最終組合成一個(gè)大節(jié)點(diǎn)就是郵件的正文內(nèi)容
代碼實(shí)現(xiàn)：
import java.util.Date;
import java.util.Properties;
import javax.activation.DataHandler;
import javax.activation.FileDataSource;
import javax.mail.Message.RecipientType;
import javax.mail.Session;
import javax.mail.Transport;
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;
/**
* 創(chuàng)建并發(fā)送一封包含文本、圖片、附件的復(fù)雜郵件
*/
public class Main {
// 發(fā)件人的 郵箱 和 密碼（替換為自己的郵箱和密碼）
public static String myEmailAccount = "xxxxxxxx@163.com";
public static String myEmailPassword = "xxxxxxxx";
// 發(fā)件人郵箱的 SMTP 服務(wù)器地址, 必須準(zhǔn)確, 不同郵件服務(wù)器地址不同, 一般格式為: smtp.xxx.com
// 網(wǎng)易163郵箱的 SMTP 服務(wù)器地址為: smtp.163.com
public static String myEmailSMTPHost = "smtp.163.com";
// 收件人郵箱（替換為自己知道的有效郵箱）
public static String receiveMailAccount = "xxxxxxxxx@qq.com";
public static void main(String[] args) throws Exception {
// 1. 創(chuàng)建參數(shù)配置, 用于連接郵件服務(wù)器的參數(shù)配置
Properties props = new Properties(); // 參數(shù)配置
props.setProperty("mail.transport.protocol", "smtp"); // 使用的協(xié)議（JavaMail規(guī)范要求）
props.setProperty("mail.smtp.host", myEmailSMTPHost); // 發(fā)件人的郵箱的 SMTP 服務(wù)器地址
props.setProperty("mail.smtp.auth", "true"); // 需要請(qǐng)求認(rèn)證
// 開(kāi)啟 SSL 連接, 以及更詳細(xì)的發(fā)送步驟請(qǐng)看上一篇: 基于 JavaMail 的 Java 郵件發(fā)送：簡(jiǎn)單郵件發(fā)送
// 2. 根據(jù)配置創(chuàng)建會(huì)話對(duì)象, 用于和郵件服務(wù)器交互
Session session = Session.getInstance(props);
session.setDebug(true); // 設(shè)置為debug模式, 可以查看詳細(xì)的發(fā)送 log
// 3. 創(chuàng)建一封郵件
MimeMessage message = createMimeMessage(session, myEmailAccount, receiveMailAccount);
// 也可以保持到本地查看
// message.writeTo(file_out_put_stream);
// 4. 根據(jù) Session 獲取郵件傳輸對(duì)象
Transport transport = session.getTransport();
// 5. 使用 郵箱賬號(hào) 和 密碼 連接郵件服務(wù)器
// 這里認(rèn)證的郵箱必須與 message 中的發(fā)件人郵箱一致，否則報(bào)錯(cuò)
transport.connect(myEmailAccount, myEmailPassword);
// 6. 發(fā)送郵件, 發(fā)到所有的收件地址, message.getAllRecipients() 獲取到的是在創(chuàng)建郵件對(duì)象時(shí)添加的所有收件人, 抄送人, 密送人
transport.sendMessage(message, message.getAllRecipients());
// 7. 關(guān)閉連接
transport.close();
}
/**
* 創(chuàng)建一封復(fù)雜郵件（文本+圖片+附件）
*/
public static MimeMessage createMimeMessage(Session session, String sendMail, String receiveMail) throws Exception {
// 1. 創(chuàng)建郵件對(duì)象
MimeMessage message = new MimeMessage(session);
// 2. From: 發(fā)件人
message.setFrom(new InternetAddress(sendMail, "我的測(cè)試郵件_發(fā)件人昵稱(chēng)", "UTF-8"));
// 3. To: 收件人（可以增加多個(gè)收件人、抄送、密送）
message.addRecipient(RecipientType.TO, new InternetAddress(receiveMail, "我的測(cè)試郵件_收件人昵稱(chēng)", "UTF-8"));
// 4. Subject: 郵件主題
message.setSubject("TEST郵件主題（文本+圖片+附件）", "UTF-8");
/*
* 下面是郵件內(nèi)容的創(chuàng)建:
*/
// 5. 創(chuàng)建圖片“節(jié)點(diǎn)”
MimeBodyPart image = new MimeBodyPart();
DataHandler dh = new DataHandler(new FileDataSource("FairyTail.jpg")); // 讀取本地文件
image.setDataHandler(dh); // 將圖片數(shù)據(jù)添加到“節(jié)點(diǎn)”
image.setContentID("image_fairy_tail"); // 為“節(jié)點(diǎn)”設(shè)置一個(gè)唯一編號(hào)（在文本“節(jié)點(diǎn)”將引用該ID）
// 6. 創(chuàng)建文本“節(jié)點(diǎn)”
MimeBodyPart text = new MimeBodyPart();
// 這里添加圖片的方式是將整個(gè)圖片包含到郵件內(nèi)容中, 實(shí)際上也可以以 http 鏈接的形式添加網(wǎng)絡(luò)圖片
text.setContent("這是一張圖片<br/><img src='cid:image_fairy_tail'/>", "text/html;charset=UTF-8");
// 7. （文本+圖片）設(shè)置 文本 和 圖片 “節(jié)點(diǎn)”的關(guān)系（將 文本 和 圖片 “節(jié)點(diǎn)”合成一個(gè)混合“節(jié)點(diǎn)”）
MimeMultipart mm_text_image = new MimeMultipart();
mm_text_image.addBodyPart(text);
mm_text_image.addBodyPart(image);
mm_text_image.setSubType("related"); // 關(guān)聯(lián)關(guān)系
// 8. 將 文本+圖片 的混合“節(jié)點(diǎn)”封裝成一個(gè)普通“節(jié)點(diǎn)”
// 最終添加到郵件的 Content 是由多個(gè) BodyPart 組成的 Multipart, 所以我們需要的是 BodyPart,
// 上面的 mm_text_image 并非 BodyPart, 所有要把 mm_text_image 封裝成一個(gè) BodyPart
MimeBodyPart text_image = new MimeBodyPart();
text_image.setContent(mm_text_image);
// 9. 創(chuàng)建附件“節(jié)點(diǎn)”
MimeBodyPart attachment = new MimeBodyPart();
DataHandler dh2 = new DataHandler(new FileDataSource("妖精的尾巴目錄.doc")); // 讀取本地文件
attachment.setDataHandler(dh2); // 將附件數(shù)據(jù)添加到“節(jié)點(diǎn)”
attachment.setFileName(MimeUtility.encodeText(dh2.getName())); // 設(shè)置附件的文件名（需要編碼）
// 10. 設(shè)置（文本+圖片）和 附件 的關(guān)系（合成一個(gè)大的混合“節(jié)點(diǎn)” / Multipart ）
MimeMultipart mm = new MimeMultipart();
mm.addBodyPart(text_image);
mm.addBodyPart(attachment); // 如果有多個(gè)附件，可以創(chuàng)建多個(gè)多次添加
mm.setSubType("mixed"); // 混合關(guān)系
// 11. 設(shè)置整個(gè)郵件的關(guān)系（將最終的混合“節(jié)點(diǎn)”作為郵件的內(nèi)容添加到郵件對(duì)象）
message.setContent(mm);
// 12. 設(shè)置發(fā)件時(shí)間
message.setSentDate(new Date());
// 13. 保存上面的所有設(shè)置
message.saveChanges();
return message;
}
}
