電子郵件的應用非常廣泛,常見的如在某網站註冊了一個賬戶,自動發送一封激活郵件,通過郵件找回密碼,自動批量發送活動信息等。很顯然這些應用不可能和我們自己平時發郵件一樣,先打開瀏覽器,登錄郵箱,創建郵件再發送。本文將簡單介紹如何通過 Java 代碼來創建電子郵件,並連接郵件服務器發送郵件。
電子郵件協議
電子郵件在網絡中傳輸和網頁一樣需要遵從特定的協議,常用的電子郵件協議包括 SMTP,POP3,IMAP。其中郵件的創建和發送只需要用到 SMTP協議,所以本文也只會涉及到SMTP協議。SMTP 是 Simple Mail Transfer Protocol 的簡稱,即簡單郵件傳輸協議。
JavaMail
我們平時通過 Java 代碼打開一個 http 網頁鏈接時,通常可以使用已經對 http 協議封裝好的 HttpURLConnection 類來快速地實現。Java 官方也提供了對電子郵件協議封裝的 Java 類庫,就是JavaMail,但並沒有包含到標準的 JDK 中,需要我們自己去官方下載,這裏我從 JavaEE 官方的 Github 倉庫下載。
JavaMail 下載地址:https://github.com/javaee/javamail/releases
最新的版本是 1.6.0 ,包含了 SMTP, IMAP, 和 POP3 協議的實現:
如果是mvn項目的話,我們只需要添加依賴即可
<dependency>
<groupId>javax.mail</groupId>
<artifactId>mail</artifactId>
<version>1.5.0-b01</version>
</dependency>
創建一封簡單的電子郵件
郵件創建步驟:
1. 創建一個郵件對象(MimeMessage);
2. 設置發件人,收件人,可選增加多個收件人,抄送人,密送人;
3. 設置郵件的主題(標題);
4. 設置郵件的正文(內容);
5. 設置顯示的發送時間;
6. 保存到本地。
代碼如下:
public class TestMail {
public static void main(String[] args) throws Exception {
// 1. 創建一封郵件
Properties props = new Properties(); // 用於連接郵件服務器的參數配置(發送郵件時才需要用到)
Session session= Session.getInstance(props); // 根據參數配置,創建會話對象(爲了發送郵件準備的)
MimeMessage message = new MimeMessage(session); // 創建郵件對象
/*
* 也可以根據已有的eml郵件文件創建 MimeMessage 對象
* MimeMessage message = new MimeMessage(session, new FileInputStream("myEmail.eml"));
*/
// 2. From: 發件人
// 其中 InternetAddress 的三個參數分別爲: 郵箱, 顯示的暱稱(只用於顯示, 沒有特別的要求), 暱稱的字符集編碼
// 真正要發送時, 郵箱必須是真實有效的郵箱。
message.setFrom(new InternetAddress("[email protected]", "USER_AA", "UTF-8"));
// 3. To: 收件人
message.setRecipient(MimeMessage.RecipientType.TO, new InternetAddress("[email protected]", "USER_CC", "UTF-8"));
// To: 增加收件人(可選)
message.addRecipient(MimeMessage.RecipientType.TO, new InternetAddress("[email protected]", "USER_DD", "UTF-8"));
// Cc: 抄送(可選)
message.setRecipient(MimeMessage.RecipientType.CC, new InternetAddress("[email protected]", "USER_EE", "UTF-8"));
// Bcc: 密送(可選)
message.setRecipient(MimeMessage.RecipientType.BCC, new InternetAddress("[email protected]", "USER_FF", "UTF-8"));
// 4. Subject: 郵件主題
message.setSubject("郵件主題", "UTF-8");
// 5. Content: 郵件正文(可以使用html標籤)
message.setContent("這是郵件正文", "text/html;charset=UTF-8");
// 6. 設置顯示的發件時間
message.setSentDate(new Date());
// 7. 保存前面的設置
message.saveChanges();
// 8. 將該郵件保存到本地
OutputStream out = new FileOutputStream("myEmail.eml");
message.writeTo(out);
out.flush();
out.close();
}
}
保存的 myEmail.eml 可以使用郵件客戶端打開查看,實際上就是一堆符合SMTP協議格式的文本(內容使用base64進行了編碼),也可用記事本打開,如下所示:
發送電子郵件
發送郵件首先需要有一個郵箱賬號和密碼,本文以網易126郵箱爲例,郵箱賬號必須要開啓 SMTP 服務,在瀏覽器網頁登錄郵箱後一般在郵箱的“設置”選項中可以開啓,並記下郵箱的 SMTP 服務器地址,如下所示(其他郵箱大同小異):
代碼實現:
public class SendMail {
// 發件人的 郵箱 和 密碼(替換爲自己的郵箱和密碼)
// PS: 某些郵箱服務器爲了增加郵箱本身密碼的安全性,給 SMTP 客戶端設置了獨立密碼(有的郵箱稱爲“授權碼”),
// 對於開啓了獨立密碼的郵箱, 這裏的郵箱密碼必需使用這個獨立密碼(授權碼)。
public static String myEmailAccount = "[email protected]";
public static String myEmailPassword = "xxxxxxxx";
// 發件人郵箱的 SMTP 服務器地址, 必須準確, 不同郵件服務器地址不同, 一般(只是一般, 絕非絕對)格式爲: smtp.xxx.com
// 網易126郵箱的 SMTP 服務器地址爲: smtp.126.com
public static String myEmailSMTPHost = "smtp.126.com";
// 收件人郵箱(替換爲自己知道的有效郵箱)
public static String receiveMailAccount = "[email protected]";
public static void main(String[] args) throws Exception {
// 1. 創建參數配置, 用於連接郵件服務器的參數配置
Properties props = new Properties(); // 參數配置
props.setProperty("mail.transport.protocol", "smtp"); // 使用的協議(JavaMail規範要求)
props.setProperty("mail.smtp.host", myEmailSMTPHost); // 發件人的郵箱的 SMTP 服務器地址
props.setProperty("mail.smtp.auth", "true"); // 需要請求認證
// PS: 某些郵箱服務器要求 SMTP 連接需要使用 SSL 安全認證 (爲了提高安全性, 郵箱支持SSL連接, 也可以自己開啓),
// 如果無法連接郵件服務器, 仔細查看控制檯打印的 log, 如果有有類似 “連接失敗, 要求 SSL 安全連接” 等錯誤,
// 取消下面 /* ... */ 之間的註釋代碼, 開啓 SSL 安全連接。
/*
// SMTP 服務器的端口 (非 SSL 連接的端口一般默認爲 25, 可以不添加, 如果開啓了 SSL 連接,
// 需要改爲對應郵箱的 SMTP 服務器的端口, 具體可查看對應郵箱服務的幫助,
// 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. 根據配置創建會話對象, 用於和郵件服務器交互
Session session = Session.getInstance(props);
// 設置爲debug模式, 可以查看詳細的發送 log
session.setDebug(true);
// 3. 創建一封郵件
MimeMessage message = createMimeMessage(session, myEmailAccount, receiveMailAccount);
// 4. 根據 Session 獲取郵件傳輸對象
Transport transport = session.getTransport();
// 5. 使用 郵箱賬號 和 密碼 連接郵件服務器, 這裏認證的郵箱必須與 message 中的發件人郵箱一致, 否則報錯
//
// PS_01: 如果連接服務器失敗, 都會在控制檯輸出相應失敗原因的log。
// 仔細查看失敗原因, 有些郵箱服務器會返回錯誤碼或查看錯誤類型的鏈接,
// 根據給出的錯誤類型到對應郵件服務器的幫助網站上查看具體失敗原因。
//
// PS_02: 連接失敗的原因通常爲以下幾點, 仔細檢查代碼:
// (1) 郵箱沒有開啓 SMTP 服務;
// (2) 郵箱密碼錯誤, 例如某些郵箱開啓了獨立密碼;
// (3) 郵箱服務器要求必須要使用 SSL 安全連接;
// (4) 請求過於頻繁或其他原因, 被郵件服務器拒絕服務;
// (5) 如果以上幾點都確定無誤, 到郵件服務器網站查找幫助。
//
transport.connect(myEmailAccount, myEmailPassword);
// 6. 發送郵件, 發到所有的收件地址, message.getAllRecipients() 獲取到的是在創建郵件對象時添加的所有收件人, 抄送人, 密送人
transport.sendMessage(message, message.getAllRecipients());
// 7. 關閉連接
transport.close();
}
/**
* 創建一封只包含文本的簡單郵件
*
* @param session 和服務器交互的會話
* @param sendMail 發件人郵箱
* @param receiveMail 收件人郵箱
* @return
* @throws Exception
*/
public static MimeMessage createMimeMessage(Session session, String sendMail, String receiveMail) throws Exception {
// 1. 創建一封郵件
MimeMessage message = new MimeMessage(session);
// 2. From: 發件人
message.setFrom(new InternetAddress(sendMail, "暱稱", "UTF-8"));
// 3. To: 收件人(可以增加多個收件人、抄送、密送)
message.setRecipient(MimeMessage.RecipientType.TO, new InternetAddress(receiveMail, "XX用戶", "UTF-8"));
// 4. Subject: 郵件主題
message.setSubject("主題", "UTF-8");
// 5. Content: 郵件正文(可以使用html標籤)
message.setContent("郵件正文", "text/html;charset=UTF-8");
// 6. 設置發件時間
message.setSentDate(new Date());
// 7. 保存設置
message.saveChanges();
return message;
}
}
下面我們對我們的代碼解析一下:
1、對應用程序配置郵件會話
javax.mail.Session保存郵件系統的配置屬性和提供用戶驗證的信息,發送email首先要獲取session對象。
(1)Session.getInstance(java.util.Properties)獲取非共享的session對象
(2)Session.getDefaultInstance(java.utilProperties)獲取共享的session對象
兩者都必須建立Properties prop=new Properties()對象;
注意:一般對單用戶桌面應用程序使用共享Session對象。
用SMTP協議發送Email時通常要設置mail.smtp.host(mail.protocol.host協議特定郵件服務器名)屬性。
prop.put("mail.smtp.host","smtp.mailServer.com");
Session mailSession=Session.getInstance(prop);
注意:在真正使用創建的過程中,往往會讓我們驗證密碼,這是我們要寫一個密碼驗證類。javax.mail.Authenticator是一個抽象類,我們要寫MyAuthenticator的密碼驗證類,該類繼承Authenticator實現:
protected PasswordAuthentication getPasswordAuthentication(){
return new PasswordAuthentication(String userName, String password);
}
這時我們創建Session對象:
Session mailSession=Session.getInstance(prop,new MyAuthenticator(userName,Password));
並且要設置使用驗證:prop.put("mail.smtp.auth","true");
使用 STARTTLS安全連接:prop.put("mail.smtp.starttls.enable","true");
2、配置郵件會話之後,要編寫消息
要編寫消息就要生成javax.mail.Message子類的實例或對Internet郵件使用javax.mail.interet.MimeMessage類。
(1)建立MimeMessage對象
MimeMessage擴展抽象的Message類,構造MimeMessage對象:
MimeMessage message=new MimeMessage(mailSession);
(2)消息發送者、日期、主題
message.setFrom(Address theSender);
message.setSentDate(java.util.Date theDate);
message.setSubject(String theSubject);
(3)設置消息的接受者與發送者(尋址接收)
setRecipient(Message.RecipientType type , Address theAddress);
setRecipients(Message.RecipientType type , Address[] theAddress);
addRecipient(Message.RecipientType type , Address theAddress);
addRecipients(Message.RecipientType type,Address[] theAddress);
方法都可以指定接受者類型,但是一般用後兩個,這樣可以避免意外的替換或者覆蓋接受者名單。定義接受者類型:
Message.RecipientType.TO:消息接受者
Message.RecipientType.CC:消息抄送者
Message.RecipientType.BCC:匿名抄送接收者(其他接受者看不到這個接受者的姓名和地址)
(4)設置消息內容
JavaMail基於JavaBean Activation FrameWork(JAF),JAF可以構造文本消息也可以支持附件。
設置消息內容時,要提供消息的內容類型-----即方法簽名:
MimeMessage.setContent(Object theContent,String type);
也可以不用顯式的制定消息的內容類型:MimeMessage.setText(String theText);
注意:建立地址javax.mail.InternetAddress toAddress=new InternetAddress(String address);
源碼
參考:
http://blog.csdn.net/qq_32371887/article/details/72821291
http://www.cnblogs.com/codeplus/archive/2011/10/30/2229391.html
http://blog.csdn.net/xietansheng/article/details/51673073
http://blog.csdn.net/xietansheng/article/details/51722660
http://www.cnblogs.com/jiaguozhilian/p/5809815.html
http://blog.csdn.net/karem/article/details/4646071
http://blog.csdn.net/csh624366188/article/details/7183457
http://www.cnblogs.com/Ant-soldier/p/6592858.html
http://blog.csdn.net/shuaicihai/article/details/59484175
————————————————
版權聲明:本文爲CSDN博主「爆米花9958」的原創文章,遵循 CC 4.0 BY-SA 版權協議,轉載請附上原文出處鏈接及本聲明。
原文鏈接:https://blog.csdn.net/xuemengrui12/article/details/78530594