基于JavaMail的Java實現(xiàn)簡單郵件發(fā)送功能
電子郵件的應(yīng)用非常廣泛,例如在某網(wǎng)站注冊了一個賬戶,自動發(fā)送一封歡迎郵件,通過郵件找回密碼,自動批量發(fā)送活動信息等。但這些應(yīng)用不可能和我們自己平時發(fā)郵件一樣,先打開瀏覽器,登錄郵箱,創(chuàng)建郵件再發(fā)送。本文將簡單介紹如何通過 Java 代碼來創(chuàng)建電子郵件,并連接郵件服務(wù)器發(fā)送郵件。
1. 電子郵件協(xié)議
電子郵件的在網(wǎng)絡(luò)中傳輸和網(wǎng)頁一樣需要遵從特定的協(xié)議,常用的電子郵件協(xié)議包括 SMTP,POP3,IMAP。其中郵件的創(chuàng)建和發(fā)送只需要用到 SMTP協(xié)議,所以本文也只會涉及到SMTP協(xié)議。SMTP 是 Simple Mail Transfer Protocol 的簡稱,即簡單郵件傳輸協(xié)議。
2. JavaMail
我們平時通過 Java 代碼打開一個 http 網(wǎng)頁鏈接時,通??梢允褂靡呀?jīng)對 http 協(xié)議封裝好的 HttpURLConnection 類來快速地實現(xiàn)。Java 官方也提供了對電子郵件協(xié)議封裝的 Java 類庫,就是JavaMail,但并沒有包含到標準的 JDK 中,需要我們自己去官方下載,這里我從 JavaEE 官方的 Github 倉庫下載。
JavaMail 下載地址: https://github.com/javaee/javamail/releases
這里我下載的版本是 1.6.0 版本,包含了 SMTP, IMAP, 和 POP3 協(xié)議的實現(xiàn)的 jar 包:
我把 JavaMail 1.6.0 的 jar 包上傳到了 CSDN,如果無法從 Github 下載,可以從這下載:
特別注意:
- 本測試用例用的 JavaMail 版本是 1.6.0,如果下載到其他版本的 JavaMail 運行時出現(xiàn)問題,請使用 JavaMail 1.6.0 版本再進行嘗試。
- 使用 JavaMail 1.6.0 要求的 JDK 版本必須是 JDK 1.7 以上(建議使用最新版 JDK)。
- 不要直接就完完全全復(fù)制我的代碼,需要 修改一下發(fā)送的標題、內(nèi)容、用戶昵稱,要不然所有人都直接復(fù)制我的代碼發(fā)送,內(nèi)容一致,郵箱服務(wù)器就可能會檢測到這些內(nèi)容是垃圾廣告內(nèi)容,不讓你發(fā)送,會返回錯誤碼,查詢錯誤碼也能查詢到失敗原因。
有些童鞋反應(yīng)代碼提示某些類找不到,或運行出現(xiàn)問題,往往都是 JDK 版本過低,或 JavaMail 版本過低,出現(xiàn)問題時 請使用推薦的版本。
再出現(xiàn)問題,只要能連接成功,都有錯誤碼返回,有些童鞋發(fā)送失敗在控制臺已經(jīng)給出了錯誤碼,大部分還給出了查看錯誤碼含義的鏈接,點開鏈接,查詢對應(yīng)的錯誤碼,為什么失敗,已經(jīng)明明白白的告訴你了,針對失敗原因修改即可!
郵件發(fā)送,涉及多端(本地代碼端、郵件發(fā)送服務(wù)器端、郵件接收服務(wù)器端),保證自己的代碼沒問題了,不一定就能成功,你把你的郵件提交到郵件發(fā)送服務(wù)器,發(fā)送的服務(wù)器可以給你拒絕服務(wù)(比如認為發(fā)送的內(nèi)容是垃圾廣告,或者你頻繁請求發(fā)送),這不是代碼端能管的事情,但都有錯誤碼返回,明確告訴你為什么錯誤。就算你發(fā)送成功了,對方也有可能接收不到,成功發(fā)送到對方的郵件接收服務(wù)器后,對方的服務(wù)器可以根據(jù)你的內(nèi)容拒絕收你的郵件(比如認為你的內(nèi)容是廣告詐騙等信息,或者發(fā)送過于頻繁),對方的服務(wù)器可能直接把你的郵件扔垃圾箱,或者直接忽略。出現(xiàn)這些問題,請修改發(fā)送的標題、內(nèi)容、昵稱等,重復(fù)的內(nèi)容不要反復(fù)發(fā)送,或多更換收件箱和發(fā)件箱試試!??!
3. 創(chuàng)建一封簡單的電子郵件
首先創(chuàng)建一個 Java 工程,把下載好的 javax.mail.jar 作為類庫加入工程,這里不多說。
郵件創(chuàng)建步驟:
- 創(chuàng)建一個郵件對象(MimeMessage);
- 設(shè)置發(fā)件人,收件人,可選增加多個收件人,抄送人,密送人;
- 設(shè)置郵件的主題(標題);
- 設(shè)置郵件的正文(內(nèi)容);
- 設(shè)置顯示的發(fā)送時間;
- 保存到本地。
代碼實現(xiàn):
package com.xiets.javamaildemo; 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 版本: 1.6.0 * JDK 版本: JDK 1.7 以上(必須) */ public class Main { public static void main(String[] args) throws Exception { // 1. 創(chuàng)建一封郵件 Properties props = new Properties(); // 用于連接郵件服務(wù)器的參數(shù)配置(發(fā)送郵件時才需要用到) Session session= Session.getDefaultInstance(props); // 根據(jù)參數(shù)配置,創(chuàng)建會話對象(為了發(fā)送郵件準備的) MimeMessage message = new MimeMessage(session); // 創(chuàng)建郵件對象 /* * 也可以根據(jù)已有的eml郵件文件創(chuàng)建 MimeMessage 對象 * MimeMessage message = new MimeMessage(session, new FileInputStream("MyEmail.eml")); */ // 2. From: 發(fā)件人 // 其中 InternetAddress 的三個參數(shù)分別為: 郵箱, 顯示的昵稱(只用于顯示, 沒有特別的要求), 昵稱的字符集編碼 // 真正要發(fā)送時, 郵箱必須是真實有效的郵箱。 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標簽) message.setContent("TEST這是郵件正文。。。", "text/html;charset=UTF-8"); // 6. 設(shè)置顯示的發(fā)件時間 message.setSentDate(new Date()); // 7. 保存前面的設(shè)置 message.saveChanges(); // 8. 將該郵件保存到本地 OutputStream out = new FileOutputStream("MyEmail.eml"); message.writeTo(out); out.flush(); out.close(); } }
保存的 MyEmail.eml 可以使用郵件客戶端打開查看,實際上就是一堆符合SMTP協(xié)議格式的文本(內(nèi)容使用base64進行了編碼),也可用記事本打開,如下所示:
4. 發(fā)送電子郵件
發(fā)送郵件首先需要有一個郵箱賬號和密碼,本文以網(wǎng)易163郵箱為例,郵箱賬號必須要開啟 SMTP 服務(wù),在瀏覽器網(wǎng)頁登錄郵箱后一般在郵箱的“設(shè)置”選項中可以開啟,并記下郵箱的 SMTP 服務(wù)器地址,如下所示(其他郵箱大同小異):
代碼實現(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è)置了獨立密碼(有的郵箱稱為“授權(quán)碼”), // 對于開啟了獨立密碼的郵箱, 這里的郵箱密碼必需使用這個獨立密碼(授權(quán)碼)。 public static String myEmailAccount = "xxxxxxxxx@163.com"; public static String myEmailPassword = "xxxxxxxxx"; // 發(fā)件人郵箱的 SMTP 服務(wù)器地址, 必須準確, 不同郵件服務(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"); // 需要請求認證 // PS: 某些郵箱服務(wù)器要求 SMTP 連接需要使用 SSL 安全認證 (為了提高安全性, 郵箱支持SSL連接, 也可以自己開啟), // 如果無法連接郵件服務(wù)器, 仔細查看控制臺打印的 log, 如果有有類似 “連接失敗, 要求 SSL 安全連接” 等錯誤, // 打開下面 /* ... */ 之間的注釋代碼, 開啟 SSL 安全連接。 /* // SMTP 服務(wù)器的端口 (非 SSL 連接的端口一般默認為 25, 可以不添加, 如果開啟了 SSL 連接, // 需要改為對應(yīng)郵箱的 SMTP 服務(wù)器的端口, 具體可查看對應(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)建會話對象, 用于和郵件服務(wù)器交互 Session session = Session.getDefaultInstance(props); session.setDebug(true); // 設(shè)置為debug模式, 可以查看詳細的發(fā)送 log // 3. 創(chuàng)建一封郵件 MimeMessage message = createMimeMessage(session, myEmailAccount, receiveMailAccount); // 4. 根據(jù) Session 獲取郵件傳輸對象 Transport transport = session.getTransport(); // 5. 使用 郵箱賬號 和 密碼 連接郵件服務(wù)器, 這里認證的郵箱必須與 message 中的發(fā)件人郵箱一致, 否則報錯 // // PS_01: 成敗的判斷關(guān)鍵在此一句, 如果連接服務(wù)器失敗, 都會在控制臺輸出相應(yīng)失敗原因的 log, // 仔細查看失敗原因, 有些郵箱服務(wù)器會返回錯誤碼或查看錯誤類型的鏈接, 根據(jù)給出的錯誤 // 類型到對應(yīng)郵件服務(wù)器的幫助網(wǎng)站上查看具體失敗原因。 // // PS_02: 連接失敗的原因通常為以下幾點, 仔細檢查代碼: // (1) 郵箱沒有開啟 SMTP 服務(wù); // (2) 郵箱密碼錯誤, 例如某些郵箱開啟了獨立密碼; // (3) 郵箱服務(wù)器要求必須要使用 SSL 安全連接; // (4) 請求過于頻繁或其他原因, 被郵件服務(wù)器拒絕服務(wù); // (5) 如果以上幾點都確定無誤, 到郵件服務(wù)器網(wǎng)站查找?guī)椭? // // PS_03: 仔細看log, 認真看log, 看懂log, 錯誤原因都在log已說明。 transport.connect(myEmailAccount, myEmailPassword); // 6. 發(fā)送郵件, 發(fā)到所有的收件地址, message.getAllRecipients() 獲取到的是在創(chuàng)建郵件對象時添加的所有收件人, 抄送人, 密送人 transport.sendMessage(message, message.getAllRecipients()); // 7. 關(guān)閉連接 transport.close(); } /** * 創(chuàng)建一封只包含文本的簡單郵件 * * @param session 和服務(wù)器交互的會話 * @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ā)件人(昵稱有廣告嫌疑,避免被郵件服務(wù)器誤認為是濫發(fā)廣告以至返回失敗,請修改昵稱) message.setFrom(new InternetAddress(sendMail, "某寶網(wǎng)", "UTF-8")); // 3. To: 收件人(可以增加多個收件人、抄送、密送) message.setRecipient(MimeMessage.RecipientType.TO, new InternetAddress(receiveMail, "XX用戶", "UTF-8")); // 4. Subject: 郵件主題(標題有廣告嫌疑,避免被郵件服務(wù)器誤認為是濫發(fā)廣告以至返回失敗,請修改標題) message.setSubject("打折鉅惠", "UTF-8"); // 5. Content: 郵件正文(可以使用html標簽)(內(nèi)容有廣告嫌疑,避免被郵件服務(wù)器誤認為是濫發(fā)廣告以至返回失敗,請修改發(fā)送內(nèi)容) message.setContent("XX用戶你好, 今天全場5折, 快來搶購, 錯過今天再等一年。。。", "text/html;charset=UTF-8"); // 6. 設(shè)置發(fā)件時間 message.setSentDate(new Date()); // 7. 保存設(shè)置 message.saveChanges(); return message; } }
發(fā)送后查看收件人的收件箱:
包含文本、圖片、附件 的復(fù)雜郵件的創(chuàng)建請看下一篇:基于 JavaMail 的 Java 郵件發(fā)送:復(fù)雜郵件發(fā)送
以上就是本文的全部內(nèi)容,希望對大家的學習有所幫助,也希望大家多多支持腳本之家。
- Java基于JavaMail實現(xiàn)向QQ郵箱發(fā)送郵件
- java中javamail發(fā)送帶附件的郵件實現(xiàn)方法
- java中javamail收發(fā)郵件實現(xiàn)方法
- JavaWeb中使用JavaMail實現(xiàn)發(fā)送郵件功能實例詳解
- Java程序中使用JavaMail發(fā)送帶圖片和附件的郵件
- 基于SSM框架+Javamail發(fā)送郵件的代碼實例
- Spring框架JavaMailSender發(fā)送郵件工具類詳解
- Java使用JavaMail API發(fā)送和接收郵件的代碼示例
- JavaMail實現(xiàn)發(fā)送超文本(html)格式郵件的方法
- 輕松學會使用JavaMail?API發(fā)送郵件
相關(guān)文章
springboot項目打包發(fā)布部署的過程及jar和war的區(qū)別
Spring Boot使用了內(nèi)嵌容器,因此它的部署方式也變得非常簡單靈活,可以將Spring Boot項目打包成JAR包來獨立運行,Spring Boot項目既可以生成WAR包發(fā)布,也可以生成JAR包發(fā)布,那么它們有什么區(qū)別呢2022-11-11Java編程實現(xiàn)判斷網(wǎng)上鄰居文件是否存在的方法
這篇文章主要介紹了Java編程實現(xiàn)判斷網(wǎng)上鄰居文件是否存在的方法,涉及Java針對路徑轉(zhuǎn)換及字符串操作的相關(guān)技巧,需要的朋友可以參考下2015-10-10被遺忘的Java關(guān)鍵字transient的使用詳解
在 Java 中,transient 是一個關(guān)鍵字,用于指定一個類的字段(成員變量)在序列化時應(yīng)該被忽略。本文將通過示例為大家簡單講講transient的使用,需要的可以參考一下2023-04-04關(guān)于SpringBoot創(chuàng)建存儲令牌的媒介類和過濾器的問題
這篇文章主要介紹了SpringBoot創(chuàng)建存儲令牌的媒介類和過濾器的問題,需要在配置文件中,添加JWT需要的密匙,過期時間和緩存過期時間,具體實例代碼參考下本文2021-09-09