11：SpringBoot整合JavaMail實(shí)現(xiàn)郵

11：SpringBoot整合JavaMail實(shí)現(xiàn)郵件發(fā)送功能

avaMail是SUN提供給廣大Java開發(fā)人員的一款郵件發(fā)送和接受的一款開源類庫(kù)，支持常用的郵件協(xié)議，如：SMTP、POP3、IMAP，開發(fā)人員使用JavaMail編寫郵件程序時(shí)，不再需要考慮底層的通訊細(xì)節(jié)如：Socket而是關(guān)注在邏輯層面。JavaMail可以發(fā)送各種復(fù)雜MIME格式的郵件內(nèi)容，注意JavaMail僅支持JDK4及以上版本。雖然JavaMail是JDK的API但它并沒有直接加入JDK中，所以我們需要另外添加依賴，下面我們開始講解本章的內(nèi)容。

本章目標(biāo)

將Java提供的JavaMail類庫(kù)與SpringBoot項(xiàng)目進(jìn)行整合，并且簡(jiǎn)單封裝下JavaMail類庫(kù)。

構(gòu)建項(xiàng)目

本章項(xiàng)目無關(guān)Web相關(guān)內(nèi)容，所以創(chuàng)建項(xiàng)目時(shí)選擇Jar形式創(chuàng)建，并且不需要預(yù)先導(dǎo)入依賴。項(xiàng)目結(jié)構(gòu)如下圖1所示：

圖1

可以看到上圖1內(nèi)容，多余的依賴并沒有添加，如果你選擇的是War項(xiàng)目也沒有關(guān)系名，那好，我們接下來把我們的主角JavaMail請(qǐng)出來吧，把對(duì)應(yīng)的依賴添加到pom.xml配置文件內(nèi)。如下圖2所示：

圖2

依賴我們已經(jīng)導(dǎo)入成功了，接下來我們開始編寫JavaMail的封裝，我這里簡(jiǎn)單的對(duì)JavaMail做出封裝，如果您需要更完美的封裝，請(qǐng)對(duì)我的代碼做出修改即可，先來編寫一個(gè)MailEntity類來保存發(fā)送郵件時(shí)需要的參數(shù)字段，如下圖3所示：

圖3

我們的MailEntity包含了上圖3的字段內(nèi)容，都是一些必填選項(xiàng)，下面我們來創(chuàng)建一個(gè)MailSender也就是郵件發(fā)送者實(shí)體，主要作用就是用來配置發(fā)送郵件參數(shù)以及執(zhí)行發(fā)送郵件，代碼如下圖4、5、6、7、8所示：

圖4

圖5

圖6

圖7

圖8

下次編寫文章使用MarkDown方式來寫，類過長(zhǎng)貼起來圖挺費(fèi)勁。上面可以看到我使用到了MailContentTypeEnum以及PropertiesUtil工具類。

MailContentTypeEnum

這是一個(gè)我自定義的枚舉類型，枚舉類型包含了郵件內(nèi)容的類型，目前我僅僅添加了兩種，一種是html另外一種則是text形式，具體代碼如下圖9所示：

圖9

PropertiesUtil

PropertiesUtil是用于讀取*.properties配置文件的工具類，使用JavaMail需要配置SMTP以及用戶名、密碼等也就是MailEntity內(nèi)的字段，那么我們?cè)?resource目錄下創(chuàng)建一個(gè)名字叫mail.properties的配置文件，里面存放我們定義的郵件發(fā)送參數(shù)配置，這樣方便修改，我分別貼出PropertiesUtil、mail.properties代碼內(nèi)容，如下圖10、圖11所示：

圖10

圖11

我使用的QQ郵箱地址作為測(cè)試，如果你需要使用你的QQ地址作為測(cè)試，請(qǐng)先到QQ郵箱開啟POP3/SMTP服務(wù)，開啟步驟如下。

開啟POP3/SMTP

第一步：進(jìn)入郵箱點(diǎn)擊“設(shè)置”，如下圖12所示：

圖12

第二步：點(diǎn)擊“賬戶”后往下拉找到POP3/IMAP/SMTP...，如下圖13所示：

圖13

我的POP3以及SMTP以及開啟了所以這里顯示的狀態(tài)是已開啟，如果您第一次使用QQ郵箱的SMTP服務(wù)，請(qǐng)點(diǎn)擊“開啟”并且按照提示步驟完成獲取“授權(quán)碼”即可，授權(quán)碼就是發(fā)送郵件參數(shù)的smtp.pwd屬性。

測(cè)試發(fā)送郵件

我們創(chuàng)建一個(gè)TestMail類來作為測(cè)試入口，因?yàn)槲覀兊捻?xiàng)目是jar形式，所以我們直接新建一個(gè)main方法直接調(diào)用發(fā)送郵件就可以了，如下圖14所示測(cè)試代碼：

圖14

我是向我的釘釘郵箱發(fā)送了一條文本類型的測(cè)試郵件，發(fā)送效果圖如下圖15所示：

圖15

可以看到我們的郵件收到了，證明我們已經(jīng)完成了郵件發(fā)送的功能了，但是你在發(fā)送中配置mail.properties文件時(shí)配置昵稱的時(shí)候最有可能出現(xiàn)的問題就是亂碼，那么該問題如何解決呢？

昵稱亂碼問題解決

第一步：修改InteiiJ IDEA工具的properties文件的編碼，點(diǎn)擊File->Setting->Editor->File Encodings將下面的Default encoding設(shè)置為UTF-8，如下圖16所示：

圖16

那么我們的mail.properties內(nèi)使用ASCII編碼進(jìn)行配置昵稱就可以了，具體中文如何轉(zhuǎn)換ASCII，請(qǐng)大家訪問tool.oschina.net/encode在線轉(zhuǎn)換即可。修改完成后再次測(cè)試發(fā)送郵件，你就會(huì)發(fā)現(xiàn)亂碼問題解決了。

總結(jié)

上述內(nèi)容就是本章的所有講解，本章主要講解了在SpringBoot項(xiàng)目?jī)?nèi)是如何使用JavaMail來進(jìn)行發(fā)送簡(jiǎn)單郵件，簡(jiǎn)單封裝了下MailSender類以及對(duì)象實(shí)體MailEntity，如果需要發(fā)送HTML內(nèi)容的郵件修改contentType(MailContentTypeEnum.HTML)然后content("html代碼")即可。

本號(hào)已開設(shè)如下二十大專題，歡迎關(guān)注，查看相關(guān)專題！

【springboot專題】【spring源碼】
【mysql優(yōu)化專題】【HTTP協(xié)議】
【架構(gòu)技術(shù)專題】【多線程專題】
【dubbo專題】【dubbo源碼專題】
【JVM調(diào)優(yōu)專題】【HTTP專題】
【設(shè)計(jì)模式專題】【高并發(fā)專題】
【架構(gòu)技術(shù)專題】【Lucene專題】
【數(shù)據(jù)結(jié)構(gòu)專題】【redis專題】
【mq中間件專題】【netty專題】
【java面試專題】【zookeeper】

使用Java應(yīng)用程序發(fā)送E-mail十分簡(jiǎn)單，但是首先你應(yīng)該在你的機(jī)器上安裝JavaMail API 和Java Activation Framework (JAF) 。

你可以在 JavaMail (Version 1.2) 下載最新的版本。

你可以再在JAF (Version 1.1.1)下載最新的版本。

下載并解壓這些文件，最上層文件夾你會(huì)發(fā)現(xiàn)很多的jar文件。你需要將mail.jar和activation.jar 添加到你的CLASSPATH中。

如果你使用第三方郵件服務(wù)器如QQ的SMTP服務(wù)器，可查看文章底部用戶認(rèn)證完整的實(shí)例。

發(fā)送一封簡(jiǎn)單的 E-mail

下面是一個(gè)發(fā)送簡(jiǎn)單E-mail的例子。假設(shè)你的localhost已經(jīng)連接到網(wǎng)絡(luò)。

// 文件名 SendEmail.java

import java.util.*;import javax.mail.*;import javax.mail.internet.*;import javax.activation.*;

public class SendEmail{

public static void main(String [] args)

{

// 收件人電子郵箱

String to="abcd@gmail.com";

// 發(fā)件人電子郵箱

String from="web@gmail.com";

// 指定發(fā)送郵件的主機(jī)為 localhost

String host="localhost";

// 獲取系統(tǒng)屬性

Properties properties=System.getProperties();

// 設(shè)置郵件服務(wù)器

properties.setProperty("mail.smtp.host", host);

// 獲取默認(rèn)session對(duì)象

Session session=Session.getDefaultInstance(properties);

try{

// 創(chuàng)建默認(rèn)的 MimeMessage 對(duì)象

MimeMessage message=new MimeMessage(session);

// Set From: 頭部頭字段

message.setFrom(new InternetAddress(from));

// Set To: 頭部頭字段

message.addRecipient(Message.RecipientType.TO,

new InternetAddress(to));

// Set Subject: 頭部頭字段

message.setSubject("This is the Subject Line!");

// 設(shè)置消息體

message.setText("This is actual message");

// 發(fā)送消息

Transport.send(message);

System.out.println("Sent message successfully....");

}catch (MessagingException mex) {

mex.printStackTrace();

}

}}

編譯并運(yùn)行這個(gè)程序來發(fā)送一封簡(jiǎn)單的E-mail：

$ java SendEmailSent message successfully....

如果你想發(fā)送一封e-mail給多個(gè)收件人，那么使用下面的方法來指定多個(gè)收件人ID：

void addRecipients(Message.RecipientType type,

Address[] addresses)throws MessagingException

下面是對(duì)于參數(shù)的描述：

type:要被設(shè)置為TO, CC 或者BCC. 這里CC 代表抄送、BCC 代表秘密抄送y. 舉例：Message.RecipientType.TO
addresses: 這是email ID的數(shù)組。在指定電子郵件ID時(shí)，你將需要使用InternetAddress()方法。

發(fā)送一封HTML E-mail

下面是一個(gè)發(fā)送HTML E-mail的例子。假設(shè)你的localhost已經(jīng)連接到網(wǎng)絡(luò)。

和上一個(gè)例子很相似，除了我們要使用setContent()方法來通過第二個(gè)參數(shù)為"text/html"，來設(shè)置內(nèi)容來指定要發(fā)送HTML內(nèi)容。

// 文件名 SendHTMLEmail.java

import java.util.*;import javax.mail.*;import javax.mail.internet.*;import javax.activation.*;

public class SendHTMLEmail{

public static void main(String [] args)

{

// 收件人電子郵箱

String to="abcd@gmail.com";

// 發(fā)件人電子郵箱

String from="web@gmail.com";

// 指定發(fā)送郵件的主機(jī)為 localhost

String host="localhost";

// 獲取系統(tǒng)屬性

Properties properties=System.getProperties();

// 設(shè)置郵件服務(wù)器

properties.setProperty("mail.smtp.host", host);

// 獲取默認(rèn)的 Session 對(duì)象。

Session session=Session.getDefaultInstance(properties);

try{

// 創(chuàng)建默認(rèn)的 MimeMessage 對(duì)象。

MimeMessage message=new MimeMessage(session);

// Set From: 頭部頭字段

message.setFrom(new InternetAddress(from));

// Set To: 頭部頭字段

message.addRecipient(Message.RecipientType.TO,

new InternetAddress(to));

// Set Subject: 頭字段

message.setSubject("This is the Subject Line!");

// 發(fā)送 HTML 消息, 可以插入html標(biāo)簽

message.setContent("<h1>This is actual message</h1>",

"text/html" );

// 發(fā)送消息

Transport.send(message);

System.out.println("Sent message successfully....");

}catch (MessagingException mex) {

mex.printStackTrace();

}

}}

編譯并運(yùn)行此程序來發(fā)送HTML e-mail：

$ java SendHTMLEmailSent message successfully....

發(fā)送帶有附件的 E-mail

下面是一個(gè)發(fā)送帶有附件的 E-mail的例子。假設(shè)你的localhost已經(jīng)連接到網(wǎng)絡(luò)。

// 文件名 SendFileEmail.java

import java.util.*;import javax.mail.*;import javax.mail.internet.*;import javax.activation.*;

public class SendFileEmail{

public static void main(String [] args)

{

// 收件人電子郵箱

String to="abcd@gmail.com";

// 發(fā)件人電子郵箱

String from="web@gmail.com";

// 指定發(fā)送郵件的主機(jī)為 localhost

String host="localhost";

// 獲取系統(tǒng)屬性

Properties properties=System.getProperties();

// 設(shè)置郵件服務(wù)器

properties.setProperty("mail.smtp.host", host);

// 獲取默認(rèn)的 Session 對(duì)象。

Session session=Session.getDefaultInstance(properties);

try{

// 創(chuàng)建默認(rèn)的 MimeMessage 對(duì)象。

MimeMessage message=new MimeMessage(session);

// Set From: 頭部頭字段

message.setFrom(new InternetAddress(from));

// Set To: 頭部頭字段

message.addRecipient(Message.RecipientType.TO,

new InternetAddress(to));

// Set Subject: 頭字段

message.setSubject("This is the Subject Line!");

// 創(chuàng)建消息部分

BodyPart messageBodyPart=new MimeBodyPart();

// 消息

messageBodyPart.setText("This is message body");

// 創(chuàng)建多重消息

Multipart multipart=new MimeMultipart();

// 設(shè)置文本消息部分

multipart.addBodyPart(messageBodyPart);

// 附件部分

messageBodyPart=new MimeBodyPart();

String filename="file.txt";

DataSource source=new FileDataSource(filename);

messageBodyPart.setDataHandler(new DataHandler(source));

messageBodyPart.setFileName(filename);

multipart.addBodyPart(messageBodyPart);

// 發(fā)送完整消息

message.setContent(multipart );

// 發(fā)送消息

Transport.send(message);

System.out.println("Sent message successfully....");

}catch (MessagingException mex) {

mex.printStackTrace();

}

}}

編譯并運(yùn)行你的程序來發(fā)送一封帶有附件的郵件。

$ java SendFileEmailSent message successfully....

用戶認(rèn)證部分

如果需要提供用戶名和密碼給e-mail服務(wù)器來達(dá)到用戶認(rèn)證的目的，你可以通過如下設(shè)置來完成：

props.put("mail.smtp.auth", "true");

props.setProperty("mail.user", "myuser");

props.setProperty("mail.password", "mypwd");

e-mail其他的發(fā)送機(jī)制和上述保持一致。

需要用戶名密碼驗(yàn)證郵件發(fā)送實(shí)例:

本實(shí)例以QQ郵件服務(wù)器為例，你需要在登錄QQ郵箱后臺(tái)在"設(shè)置"=》賬號(hào)中開啟POP3/SMTP服務(wù) ，如下圖所示：

Java 代碼如下：

// 需要用戶名密碼郵件發(fā)送實(shí)例//文件名 SendEmail2.java//本實(shí)例以QQ郵箱為例，你需要在qq后臺(tái)設(shè)置import java.util.Properties;import javax.mail.Authenticator;import javax.mail.Message;import javax.mail.MessagingException;import javax.mail.PasswordAuthentication;import javax.mail.Session;import javax.mail.Transport;import javax.mail.internet.InternetAddress;import javax.mail.internet.MimeMessage;public class SendEmail2{

public static void main(String [] args)

{

// 收件人電子郵箱

String to="xxx@qq.com";

// 發(fā)件人電子郵箱

String from="xxx@qq.com";

// 指定發(fā)送郵件的主機(jī)為 localhost

String host="smtp.qq.com"; //QQ 郵件服務(wù)器

// 獲取系統(tǒng)屬性

Properties properties=System.getProperties();

// 設(shè)置郵件服務(wù)器

properties.setProperty("mail.smtp.host", host);

properties.put("mail.smtp.auth", "true");

// 獲取默認(rèn)session對(duì)象

Session session=Session.getDefaultInstance(properties,new Authenticator(){

public PasswordAuthentication getPasswordAuthentication()

{

return new PasswordAuthentication("xxx@qq.com", "qq郵箱密碼"); //發(fā)件人郵件用戶名、密碼

}

});

try{

// 創(chuàng)建默認(rèn)的 MimeMessage 對(duì)象

MimeMessage message=new MimeMessage(session);

// Set From: 頭部頭字段

message.setFrom(new InternetAddress(from));

// Set To: 頭部頭字段

message.addRecipient(Message.RecipientType.TO,

new InternetAddress(to));

// Set Subject: 頭部頭字段

message.setSubject("This is the Subject Line!");

// 設(shè)置消息體

message.setText("This is actual message");

// 發(fā)送消息

Transport.send(message);

System.out.println("Sent message successfully....from w3cschool.cc");

}catch (MessagingException mex) {

mex.printStackTrace();

}

}}

如您還有不明白的可以在下面與我留言或是與我探討QQ群308855039，我們一起飛！

pring 對(duì) Java Mail 有很好的支持。因此，Spring Boot 也提供了自動(dòng)配置的支持。

Spring Boot 集成 Java Mail

Spring Boot 中使用 Java Mail 非常簡(jiǎn)單方便。修改 pom 文件，添加依賴。

<dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-mail</artifactId>
</dependency>

在 src/main/resources/application.properties 中配置郵件信息

#email
spring.mail.host=smtp.163.com
spring.mail.username=請(qǐng)輸入用戶名
spring.mail.password=請(qǐng)輸入密碼
spring.mail.port=25
spring.mail.protocol=smtp
spring.mail.default-encoding=UTF-8

單元測(cè)試

我們通過編寫單元測(cè)試用例，測(cè)試 Java Mail 是否正常工作。值得注意的是，郵件包括幾種類型：簡(jiǎn)單文本的郵件、 HTML 文本的郵件、內(nèi)嵌圖片的郵件、包含附件的郵件。

發(fā)送包含HTML文本的郵件

發(fā)送包含內(nèi)嵌圖片的郵件

發(fā)送包含附件的郵件

喜歡的小伙伴，點(diǎn)個(gè)關(guān)注吧！

在線咨詢

上一篇：HTML選擇器和JS基礎(chǔ)
下一篇：技術(shù)分享 - MySQL 內(nèi)部臨時(shí)表是怎么存放的

您的項(xiàng)目需求

*請(qǐng)認(rèn)真填寫需求信息，我們會(huì)在24小時(shí)內(nèi)與您取得聯(lián)系。

整合營(yíng)銷服務(wù)商

11：SpringBoot整合JavaMail實(shí)現(xiàn)郵

本章目標(biāo)

構(gòu)建項(xiàng)目

測(cè)試發(fā)送郵件

總結(jié)

單元測(cè)試

您的項(xiàng)目需求