1. 程式人生 > >SpringBoot整合JavaMail傳送郵件 --轉載

SpringBoot整合JavaMail傳送郵件 --轉載

JavaMail是SUN提供給廣大Java開發人員的一款郵件傳送和接受的一款開源類庫,支援常用的郵件協議,如:SMTP、POP3、IMAP,開發人員使用JavaMail編寫郵件程式時,不再需要考慮底層的通訊細節如:Socket而是關注在邏輯層面。JavaMail可以傳送各種複雜MIME格式的郵件內容,注意JavaMail僅支援JDK4及以上版本。雖然JavaMail是JDK的API但它並沒有直接加入JDK中,所以我們需要另外新增依賴,下面我們開始講解本章的內容。

本章目標

將Java提供的JavaMail類庫與SpringBoot專案進行整合,並且簡單封裝下JavaMail類庫。

構建專案

本章專案無關Web相關內容,所以建立專案時選擇Jar形式建立,並且不需要預先匯入依賴。專案結構如下圖1所示:

圖1

可以看到上圖1內容,多餘的依賴並沒有新增,如果你選擇的是War專案也沒有關係名,那好,我們接下來把我們的主角JavaMail請出來吧,把對應的依賴新增到pom.xml配置檔案內。如下圖2所示:

圖2

依賴我們已經匯入成功了,接下來我們開始編寫JavaMail的封裝,我這裡簡單的對JavaMail做出封裝,如果您需要更完美的封裝,請對我的程式碼做出修改即可,先來編寫一個MailEntity類來儲存傳送郵件時需要的引數欄位,如下圖3所示:

圖3

我們的MailEntity包含了上圖3的欄位內容,都是一些必填選項,下面我們來建立一個MailSender也就是郵件傳送者實體,主要作用就是用來配置傳送郵件引數以及執行傳送郵件,程式碼如下圖4、5、6、7、8所示:

圖4

圖5

圖6

圖7

圖8

因為簡書的富文字編輯器不支援程式碼塊,下次編寫文章使用MarkDown方式來寫,類過長貼起來圖挺費勁。上面可以看到我使用到了MailContentTypeEnum以及PropertiesUtil工具類。

MailContentTypeEnum

這是一個我自定義的列舉型別,列舉型別包含了郵件內容的型別,目前我僅僅添加了兩種,一種是html

另外一種則是text形式,具體程式碼如下圖9所示:

圖9

PropertiesUtil

PropertiesUtil是用於讀取*.properties配置檔案的工具類,使用JavaMail需要配置SMTP以及使用者名稱、密碼等也就是MailEntity內的欄位,那麼我們在/resource目錄下建立一個名字叫mail.properties的配置檔案,裡面存放我們定義的郵件傳送引數配置,這樣方便修改,我分別貼出PropertiesUtil、mail.properties程式碼內容,如下圖10、圖11所示:

圖10

圖11

我使用的QQ郵箱地址作為測試,如果你需要使用你的QQ地址作為測試,請先到QQ郵箱開啟POP3/SMTP服務,開啟步驟如下。

開啟POP3/SMTP

第一步:進入郵箱點選“設定”,如下圖12所示:

圖12

第二步:點選“賬戶”後往下拉找到POP3/IMAP/SMTP...,如下圖13所示:

圖13

我的POP3以及SMTP以及開啟了所以這裡顯示的狀態是已開啟,如果您第一次使用QQ郵箱的SMTP服務,請點選“開啟”並且按照提示步驟完成獲取“授權碼”即可,授權碼就是傳送郵件引數的smtp.pwd屬性。

測試傳送郵件

我們建立一個TestMail類來作為測試入口,因為我們的專案是jar形式,所以我們直接新建一個main方法直接呼叫傳送郵件就可以了,如下圖14所示測試程式碼:

圖14

我是向我的釘釘郵箱傳送了一條文字型別的測試郵件,傳送效果圖如下圖15所示:

圖15

可以看到我們的郵件收到了,證明我們已經完成了郵件傳送的功能了,但是你在傳送中配置mail.properties檔案時配置暱稱的時候最有可能出現的問題就是亂碼,那麼該問題如何解決呢?

暱稱亂碼問題解決

第一步:修改InteiiJ IDEA工具的properties檔案的編碼,點選File->Setting->Editor->File Encodings將下面的Default encoding設定為UTF-8,如下圖16所示:

圖16

那麼我們的mail.properties內使用ASCII編碼進行配置暱稱就可以了,具體中文如何轉換ASCII,請大家訪問tool.oschina.net/encode線上轉換即可。修改完成後再次測試傳送郵件,你就會發現亂碼問題解決了。

總結

上述內容就是本章的所有講解,本章主要講解了在SpringBoot專案內是如何使用JavaMail來進行傳送簡單郵件,簡單封裝了下MailSender類以及物件實體MailEntity,如果需要傳送HTML內容的郵件修改contentType(MailContentTypeEnum.HTML)然後content("html程式碼")即可。



作者:恆宇少年
連結:https://www.jianshu.com/p/0991f0841b0a
來源:簡書
簡書著作權歸作者所有,任何形式的轉載都請聯絡作者獲得授權並註明出處。