JavaMail是SUN提供給廣大Java開發人員的一款郵件發送和接受的一款開源類庫,支持常用的郵件協議,如:SMTP、POP3、IMAP,開發人員使用JavaMail編寫郵件程序時,不再需要考慮底層的通訊細節如:Socket而是關注在邏輯層面。JavaMail可以發送各種復雜MIME格式的郵件內容,注意JavaMail僅支持JDK4及以上版本。雖然JavaMail是JDK的API但它并沒有直接加入JDK中,所以我們需要另外添加依賴,下面我們開始講解本章的內容。
免費專題文章匯總
恒宇少年在博客整理出來了SpringBoot、ApiBoot、SpringCloud的文章匯總【SpringBoot基礎教程專題】,【SpringCloud基礎教程專題】,【ApiBoot組件使用專題】
本章目標
將Java提供的JavaMail類庫與SpringBoot項目進行整合,并且簡單封裝下JavaMail類庫。
構建項目
本章項目無關Web相關內容,所以創建項目時選擇Jar形式創建,并且不需要預先導入依賴。項目結構如下圖1所示:
可以看到上圖1內容,多余的依賴并沒有添加,如果你選擇的是War項目也沒有關系名,那好,我們接下來把我們的主角JavaMail請出來吧,把對應的依賴添加到pom.xml配置文件內。如下圖2所示:
依賴我們已經導入成功了,接下來我們開始編寫JavaMail的封裝,我這里簡單的對JavaMail做出封裝,如果您需要更完美的封裝,請對我的代碼做出修改即可,先來編寫一個MailEntity類來保存發送郵件時需要的參數字段,如下圖3所示:
我們的MailEntity包含了上圖3的字段內容,都是一些必填選項,下面我們來創建一個MailSender也就是郵件發送者實體,主要作用就是用來配置發送郵件參數以及執行發送郵件,代碼如下圖4、5、6、7、8所示:
因為簡書的富文本編輯器不支持代碼塊,下次編寫文章使用MarkDown方式來寫,類過長貼起來圖挺費勁。上面可以看到我使用到了MailContentTypeEnum以及PropertiesUtil工具類。
MailContentTypeEnum
這是一個我自定義的枚舉類型,枚舉類型包含了郵件內容的類型,目前我僅僅添加了兩種,一種是html另外一種則是text形式,具體代碼如下圖9所示:
PropertiesUtil
PropertiesUtil是用于讀取*.properties配置文件的工具類,使用JavaMail需要配置SMTP以及用戶名、密碼等也就是MailEntity內的字段,那么我們在/resource目錄下創建一個名字叫mail.properties的配置文件,里面存放我們定義的郵件發送參數配置,這樣方便修改,我分別貼出PropertiesUtil、mail.properties代碼內容,如下圖10、圖11所示:
我使用的QQ郵箱地址作為測試,如果你需要使用你的QQ地址作為測試,請先到QQ郵箱開啟POP3/SMTP服務,開啟步驟如下。
開啟POP3/SMTP
第一步:進入郵箱點擊“設置”,如下圖12所示:
第二步:點擊“賬戶”后往下拉找到POP3/IMAP/SMTP...,如下圖13所示:
我的POP3以及SMTP以及開啟了所以這里顯示的狀態是已開啟,如果您第一次使用QQ郵箱的SMTP服務,請點擊“開啟”并且按照提示步驟完成獲取“授權碼”即可,授權碼就是發送郵件參數的smtp.pwd屬性。
測試發送郵件
我們創建一個TestMail類來作為測試入口,因為我們的項目是jar形式,所以我們直接新建一個main方法直接調用發送郵件就可以了,如下圖14所示測試代碼:
我是向我的釘釘郵箱發送了一條文本類型的測試郵件,發送效果圖如下圖15所示:
可以看到我們的郵件收到了,證明我們已經完成了郵件發送的功能了,但是你在發送中配置mail.properties文件時配置昵稱的時候最有可能出現的問題就是亂碼,那么該問題如何解決呢?
昵稱亂碼問題解決
第一步:修改InteiiJ IDEA工具的properties文件的編碼,點擊File->Setting->Editor->File Encodings將下面的Default encoding設置為UTF-8,如下圖16所示:
那么我們的mail.properties內使用ASCII編碼進行配置昵稱就可以了,具體中文如何轉換ASCII,請大家訪問tool.oschina.net/encode在線轉換即可。修改完成后再次測試發送郵件,你就會發現亂碼問題解決了。
總結
上述內容就是本章的所有講解,本章主要講解了在SpringBoot項目內是如何使用JavaMail來進行發送簡單郵件,簡單封裝了下MailSender類以及對象實體MailEntity,如果需要發送HTML內容的郵件修改contentType(MailContentTypeEnum.HTML)然后content("html代碼")即可。
本章代碼已經上傳碼云:
SpringBoot配套源碼地址:https://gitee.com/hengboy/spring-boot-chapter
SpringCloud配套源碼地址:https://gitee.com/hengboy/spring-cloud-chapter
SpringBoot相關系列文章請訪問:目錄:SpringBoot學習目錄
QueryDSL相關系列文章請訪問:QueryDSL通用查詢框架學習目錄
SpringDataJPA相關系列文章請訪問:目錄:SpringDataJPA學習目錄
SpringBoot相關文章請訪問:目錄:SpringBoot學習目錄,感謝閱讀!
歡迎微信掃碼加入知識星球,恒宇少年帶你走以后的技術道路?。。?/h4>
知識星球 - 恒宇少年