SpringBoot 整合Mail实现邮件发送
一、简介
邮件发送是网络应用中最常用的扩展功能之一，用户注册、忘记密码、动态验证码登录、发送运营情况等等都要使用到邮件的发送。在Spring发展的早期就提供了非常好用的 JavaMailSender接口实现邮件发送，而在Spring Boot的Starter模块中也为此提供了自动化配置，更加简化了邮件发送的过程。
二、引入依赖
在Spring Boot的工程中的 pom.xml 中引入 spring-boot-starter-mail 依赖：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-mail</artifactId>
</dependency> 三、在 application.properties 中加入mail的配置
#### 1、qq邮箱的配置 ####
# 指定默认MimeMessage的编码，默认为: UTF-8
spring.mail.default-encoding=UTF-8
# 指定SMTP server host.
spring.mail.host=smtp.qq.com
# 指定SMTP server的用户名.
[email protected]
# 指定SMTP server登陆授权码
spring.mail.password=授权码
spring.mail.port=25
# 指定SMTP server使用的协议，默认为: smtp
spring.mail.protocol=smtp
# 指定是否在启动时测试邮件服务器连接，默认为false
spring.mail.test-connection=false
#### 2、163邮箱配置 ####
spring.mail.host=smtp.163.com
[email protected]
spring.mail.password=密码
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.starttls.required=true
spring.mail.default-encoding=UTF-8QQ邮箱授权码可以在邮箱设置-账户中找到 POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务下的
开启服务 - POP3/SMTP服务 根据提示进行开启和授权码的获取。
163邮箱smtp开启：
四、邮件发送实践
在application.properties中添加邮件接收者，方便测试：
# 邮件接收者
spring.mail.to.user = [email protected]编写测试代码，完整代码如下：
package com.oycbest;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.core.io.FileSystemResource;
import org.springframework.mail.SimpleMailMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.test.context.junit4.SpringRunner;
import javax.mail.MessagingException;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import javax.mail.internet.MimeUtility;
import java.io.File;
import java.io.UnsupportedEncodingException;
/**
* @author oyc
* @Title: SpringBootMailTest
* @ProjectName springboot-mail
* @Description: 发送邮件单元测试
* @date 2019/3/10 23:15
*/
@RunWith(SpringRunner.class)
@SpringBootTest
public class SpringBootMailTest {
/**
* 自动注入的Bean
*/
@Autowired
private JavaMailSender mailSender;
/**
* 读取配置文件中的邮件发送者
*/
@Value("${spring.mail.username}")
private String from;
/**
* 读取配置文件中的邮件接收者
*/
@Value("${spring.mail.to.user}")
private String toUser;
@Test
public void sendSimpleMail() {
SimpleMailMessage message = new SimpleMailMessage();
message.setFrom(from);
message.setTo(toUser);
message.setSubject("邮件主题");
message.setText("邮件详情~~~邮件详情~~~邮件详情~~~");
mailSender.send(message);
}
@Test
public void sendHtmlMessage() {
MimeMessage message = null;
message = mailSender.createMimeMessage();
try {
MimeMessageHelper helper = new MimeMessageHelper(message, true);
InternetAddress fromAddress = new InternetAddress(MimeUtility.encodeText("Flyat") + "<" + from + ">");// 创建邮件发送者地址
helper.setFrom(fromAddress);
InternetAddress toAddress = new InternetAddress(MimeUtility.encodeText("接收方") + "<" + toUser + ">");// 创建邮件发送者地址
helper.setTo(toAddress);
helper.setSubject("邮件标题-HTML");
StringBuffer sb = new StringBuffer();
sb.append("<h1>邮件详情</h1>")
.append("<p style='color:red;'>HTML字体颜色测试</p>");
//第二个参数指定发送的是HTML格式
helper.setText(sb.toString(), true);
} catch (MessagingException e) {
e.printStackTrace();
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
mailSender.send(message);
}
@Test
public void sendAttachmentsMail() {
MimeMessage message = null;
try {
message = mailSender.createMimeMessage();
MimeMessageHelper helper = new MimeMessageHelper(message, true);
InternetAddress fromAddress = new InternetAddress(MimeUtility.encodeText("Flyat") + "<" + from + ">");// 创建邮件发送者地址
helper.setFrom(fromAddress);
InternetAddress toAddress = new InternetAddress(MimeUtility.encodeText("接收方") + "<" + toUser + ">");// 创建邮件发送者地址
helper.setTo(toAddress);
helper.setSubject("带附件的邮件");
StringBuffer sb = new StringBuffer();
sb.append("<h1>带附件的邮件内容</h1>")
.append("<p style='color:red;'>HTML字体颜色测试</p>");
//第二个参数指定发送的是HTML格式
helper.setText(sb.toString(), true);
//注意项目路径问题，自动补用项目路径
FileSystemResource file = new FileSystemResource(new File("src/main/resources/static/test.jpg"));
helper.addAttachment("图片.jpg", file);
} catch (Exception e) {
e.printStackTrace();
}
mailSender.send(message);
}
@Test
public void sendInlineMail() {
MimeMessage message = null;
try {
message = mailSender.createMimeMessage();
MimeMessageHelper helper = new MimeMessageHelper(message, true);
InternetAddress fromAddress = new InternetAddress(MimeUtility.encodeText("Flyat") + "<" + from + ">");// 创建邮件发送者地址
helper.setFrom(fromAddress);
InternetAddress toAddress = new InternetAddress(MimeUtility.encodeText("接收方") + "<" + toUser + ">");// 创建邮件发送者地址
helper.setTo(toAddress);
helper.setSubject("带静态资源的邮件");
//第二个参数指定发送的是HTML格式
helper.setText("<html><body>带静态资源的邮件内容 图片:<img src='cid:test' /></body></html>", true);
FileSystemResource file = new FileSystemResource(new File("src/main/resources/static/test.jpg"));
helper.addInline("test", file);
} catch (Exception e) {
e.printStackTrace();
}
mailSender.send(message);
}
}
将电脑中的test.jpg复制到resources/static/中用于测试附件和带静态文件的发送情况。
在运行各个单元测试即可完成邮件发送，具体发送功能需要根据业务系统进行调整。