发送邮件是常用的业务手法，这里记录使用 Spring 发送邮件和 Hutool 发送.
Spring
流程图，参考Spring文档Email部分
首先要启用发件人邮箱的SMTP发邮件服务，这里使用QQ邮箱，QQ邮箱中SMTP密码是单独生成的授权码，需要记录下。
导入依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-mail</artifactId>
</dependency>
参数配置
spring:
mail:
host: smtp.qq.com # 邮件服务器的SMTP地址
port: 465 # 邮件服务器的SMTP端口
username: xxx@qq.com # 发件人
password: xxxxxxxxxxxxx # 密码，授权码
protocol: smtps # 使用安全协议
properties:
mail.smtp.ssl.enable: true # 使用 qq, gmail邮箱时需强制开启SSL安全连接
参数封装到MailProperties，就是配置邮件的SMTP服务器
发送邮件方法
/**
* @author mafei007
* @date 2020/3/31 22:38
*/
@Component
@Slf4j
public class MailClient {
private final JavaMailSender mailSender;
private final MailProperties mailProperties;
public MailClient(JavaMailSender mailSender, MailProperties mailProperties) {
this.mailSender = mailSender;
this.mailProperties = mailProperties;
}
@Async
public void sendMail(String to, String subject, String content) {
try {
MimeMessage message = mailSender.createMimeMessage();
MimeMessageHelper helper = new MimeMessageHelper(message);
//设置发件人
helper.setFrom(mailProperties.getUsername());
helper.setTo(to);
helper.setSubject(subject);
// 指定内容为 html 文本
helper.setText(content, true);
mailSender.send(helper.getMimeMessage());
} catch (MessagingException e) {
log.error("发送邮件失败：" + e.getMessage(), e);
}
}
}
JavaMailSender 由 SpringBoot 自动配置类生成，详情见MailSenderAutoConfiguration.java。
Thymeleaf模板文件
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.com">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
<p>欢迎你，<span style="color:red;" th:text="${username}"></span></p>
</body>
</html>
存放在 resources/templates/mail/demo.html
发送
@Test
public void testHtmlMail(){
Context context = new Context();
context.setVariable("username", "zhangsan");
// 模板引擎渲染后的 html 文本
String content = templateEngine.process("/mail/demo", context);
mailClient.sendMail("xxxx@gmail.com", "测试html邮件", content);
}
这里使用了Thymeleaf渲染模板引擎的代码，解释下：
Thymeleaf渲染解读
先说下Thymeleaf中的几个概念：
- Context: 运行上下文
- TemplateResolver：模板解析器
- TemplateEngine：模板引擎
Context
上下文： 用来保存模型数据，就是个 map 存放 key value，当模板引擎渲染时，可以从Context上下文中获取数据用于渲染。
当与SpringBoot结合使用时，我们放入Model的数据就会被处理到Context，作为模板渲染的数据使用。
TemplateResolver
模板解析器：用来读取模板相关的配置，例如：模板存放的位置信息，模板文件名称，模板文件的类型等等。
当与SpringBoot结合时，TemplateResolver已经由其创建完成，并且各种配置也都有默认值，比如模板存放位置，其默认值就是：templates。比如模板文件类型，其默认值就是html。
TemplateEngine
模板引擎：用来解析模板的引擎，需要使用到 Context上下文、TemplateResolver 模板解析器。分别从两者中获取模板中需要的数据，模板文件。然后利用内置的语法规则解析，从而输出解析后的文件。来看下模板引擎进行处理的函数：
templateEngine.process("模板名", context, writer);
三个参数：
- 模板名称
- 上下文：里面包含模型数据
- writer：输出目的地的流
在输出时，我们可以指定输出的目的地，如果目的地是Response的流，那就是网络响应。如果目的地是本地文件，那就实现静态化了。
而在SpringBoot中已经自动配置了模板引擎，可以直接注入使用。
如果不指定输出流：
String content = templateEngine.process("模板名", context);
就可以得到 Thymeleaf 模板渲染后的 html 文本。
使用Hutool发送邮件
sendMail() 方法封装下来跟原生的 javax.mail 邮件操作就没差多少代码，Spring封装的还是非常繁琐，使用 Hutool 就方便多了。
引入依赖
<dependency>
<groupId>cn.hutool</groupId>
<artifactId>hutool-extra</artifactId>
<version>5.2.5</version>
</dependency>
<dependency>
<groupId>javax.mail</groupId>
<artifactId>mail</artifactId>
<version>1.4.7</version>
</dependency>
邮件服务器配置
在classpath（在标准Maven项目中为src/main/resources）的config目录下新建mail.setting文件.
# 邮件服务器的SMTP地址，可选，默认为smtp.<发件人邮箱后缀>
host = smtp.yeah.net
# 邮件服务器的SMTP端口
port = 465
# 发件人（必须正确，否则发送失败）
from = hutool@yeah.net
# 密码（注意，某些邮箱需要为SMTP服务单独设置密码）
pass = q1w2e3
# 使用SSL安全连接
sslEnable = true
#### 以上是建议手动配置的参数#################################################################
#### 下面的参数可以不用配置,默认即可##########################################################
# 用户名（默认提取你邮箱@前面的部分。注意：如果使用foxmail邮箱，此处user为qq号）
user = hutool
#使用 STARTTLS安全连接，STARTTLS是对纯文本通信协议的扩展。
starttlsEnable = true
# 指定实现javax.net.SocketFactory接口的类的名称,这个类将被用于创建SMTP的套接字
socketFactoryClass = javax.net.ssl.SSLSocketFactory
# 如果设置为true,未能创建一个套接字使用指定的套接字工厂类将导致使用java.net.Socket创建的套接字类, 默认值为true
socketFactoryFallback = true
# 指定的端口连接到在使用指定的套接字工厂。如果没有设置,将使用默认端口456
socketFactoryPort = 465
# SMTP超时时长，单位毫秒，缺省值不超时
timeout = 0
# Socket连接超时值，单位毫秒，缺省值不超时
connectionTimeout = 0
发送邮件
- 发送普通文本邮件，最后一个参数可选是否添加多个附件：
MailUtil.send("hutool@foxmail.com", "测试", "邮件来自Hutool测试", false);
- 发送HTML格式的邮件并附带附件，最后一个参数可选是否添加多个附件：
MailUtil.send("hutool@foxmail.com", "测试", "<h1>邮件来自Hutool测试</h1>", true, FileUtil.file("d:/aaa.xml"));
3.发邮件，可选HTML或普通文本，可选多个附件：
ArrayList<String> tos = CollUtil.newArrayList(
"person1@bbb.com",
"person2@bbb.com",
"person3@bbb.com",
"person4@bbb.com");
MailUtil.send(tos, "测试", "邮件来自Hutool群发测试", false);
发送邮件非常简单，只需一个方法即可搞定其中按照参数顺序说明如下：
- tos: 对方的邮箱地址，可以是单个，也可以是多个（Collection表示）
- subject：标题
- content：邮件正文，可以是文本，也可以是HTML内容
- isHtml： 是否为HTML，如果是，那参数3识别为HTML内容
- files： 可选：附件，可以为多个或没有，将File对象加在最后一个可变参数中即可
@Test
public void testHtmlMailByHutool(){
Context context = new Context();
context.setVariable("username", "zhangsan");
// 模板引擎渲染后的 html 文本
String content = templateEngine.process("/mail/demo", context);
MailUtil.send(mailProperties.getUsername(), "htmlByHutool", content, true);
}
使用 Hutool 工具包就不用我们封装一些发送邮件的代码了，比 Spring 的简单点。
网友评论