SpringBoot邮件发送
邮件发送是一个非常常见的功能,注册时的身份认证、重要通知发送等都会用到邮件发送。Sun公司提供了JavaMail用来实现邮件发送,但是配置烦琐,Spring 中提供了JavaMailSender 用来简化邮件配置,Spring Boot则提供了MailSenderAutoConfiguration 对邮件的发送做了进一步简化。
1. 发送前的准备
本节以QQ邮箱为例向读者介绍邮件的发送过程。使用QQ邮箱发送邮件,首先要申请开通POP3/SMTP服务或者IMAP/SMTP服务。SMTP全称为Simple Mail Transfer Protocol,译作简单邮件传输协议,它定义了邮件客户端软件与SMTP服务器之间,以及SMTP服务器与SMTP服务器之间的通信规则。也就是说,aaa@qq.com 用户先将邮件投递到腾讯的SMTP服务器,这个过程就使用了SMTP协议,然后腾讯的SMTP服务器将邮件投递到网易的SMTP服务器,这个过程依然使用了SMTP协议,SMTP服务器就是用来接收邮件的。而POP3全称为Post Office Protocol3,译作邮局协议,它定义了邮件客户端与POP3服务器之间的通信规则。该协议在什么场景下会用到呢?当邮件到达网易的SMTP服务器之后,111@163.com 用户需要登录服务器查看邮件,这个时候就用上该协议了:邮件服务商会为每一个用户提供专门的邮件存储空间,SMTP服务器收到邮件之后,将邮件保存到相应用户的邮件存储空间中,如果用户要读取邮件,就需要通过邮件服务商的POP3邮件服务器来完成。至于IMAP协议,则是对POP3协议的扩展,功能更强,作用类似。下面介绍QQ邮箱开通POP3/SMTP服务或者IMAP/SMTP服务的步骤。
步骤01 登录QQ邮箱,依次单击顶部的设置按钮和账户按钮如图所示。
步骤02 在账户选项卡 下方找到POP3/SMTP服务,单击后方的“开启”按钮,如图所示。
单击“开启”按钮后,按照引导步骤发送短信,操作成功后,会获取一个授权码,将授权码保存下来过后使用。
拿到授权码后,准备工作就完成了。
2. 发送
2.1 环境搭建
使用Spring Boot发送邮件,环境搭建非常容易,首先在创建项目时添加邮件依赖,代码如下:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-mail</artifactId>
</dependency>
项目创建成功后,在application.properties中完成邮件基本信息配置,代码如下:
# 配置邮件服务器的地址
spring.mail.host=smtp.qq.com
# 配置邮件服务器的端口(465或587)
spring.mail.port=465
# 配置用户的账号
spring.mail.username=123@qq.com
# 配置用户的密码(即上面我们申请到的授权码)
spring.mail.password=qgczjydhuqytabcd
# 配置默认编码
spring.mail.default-encoding=UTF-8
# SSL 连接配置
spring.mail.properties.mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory
# 开启 debug,这样方便开发者查看邮件发送日志
spring.mail.properties.mail.debug=true
这里配置了邮件服务器的地址、端口(可以是465或者587)、用户的账号和密码以及默认编码、SSL连接配置等,最后开启debug,这样方便开发者查看邮件发送日志。注意,SSL的配置可以在QQ邮箱帮助中心看到相关文档,如图所示。
完成这些配置之后,基本的邮件发送环境就搭建成功了,接下来就可以发送邮件了。邮件从简单到复杂有多种类型,下面分别予以介绍。
2.2 发送简单邮件
创建一个MailService用来封装邮件的发送,代码如下:
@Component
public class MailService {
// JavaMailSender 在Mail 自动配置类 MailSenderAutoConfiguration 中已经导入,这里直接注入使用即可
@Autowired
JavaMailSender javaMailSender;
//方法5个参数分别表示:邮件发送者、收件人、抄送人、邮件主题以及邮件内容
public void sendSimpleMail(String from, String to, String cc, String subject, String content) {
// 简单邮件直接构建一个 SimpleMailMessage 对象进行配置并发送即可
SimpleMailMessage simpMsg = new SimpleMailMessage();
simpMsg.setFrom(from);
simpMsg.setTo(to);
simpMsg.setCc(cc);
simpMsg.setSubject(subject);
simpMsg.setText(content);
javaMailSender.send(simpMsg);
}
}
代码解释:
- JavaMailSender 是Spring Boot在MailSenderPropertiesConfiguration 类中配置好的,该类在Mail自动配置类MailSenderAutoConfiguration中导入,因此这里注入JavaMailSender就可以使用了。
- sendSimpleMail方法的5个参数分别表示邮件发送者、收件人、抄送人、邮件主题以及邮件内容。
- 简单邮件可以直接构建一个SimpleMailMessage 对象进行配置,配置完成后,通过JavaMailSender将邮件发送出去。
接着我们创建一个 Controller 调用这个 Service 方法进行测试:
@RestController
public class HelloController {
@Autowired
MailService mailService;
@GetMapping("/hello")
public void hello() {
mailService.sendSimpleMail("123@QQ.com",
"1421548723@qq.com",
"123456@qq.com",
"我是邮件的标题",
"我是邮件的内容");
}
}
这里使用MimeMessageHelper简化了邮件配置,它的构造方法的第二个参数true表示构造个multipart message类型的邮件,multipart message类型的邮件包含多个正文、附件以及内嵌资源,邮件的表现形式更加丰富。最后通过addAttachment方法添加附件。
执行该方法,即可看到邮件发送成功,如图所示。
2.3 发送带附件的邮件
要发送一个带附件的邮件也非常容易,通过调用Attachment 方法即可添加附件,该方法调用多次即可添加多个附件。在MailService中添加如下方法:
这里使用 MimeMessageHelper 简化邮件配置,通过 MimeMessageHelper 构造一个 multipart message 类型邮件来发送,multipart message 类型邮件可以包含多个正文、附件以及内嵌资源。
@Component
public class MailService {
// JavaMailSender 在Mail 自动配置类 MailSenderAutoConfiguration 中已经导入,这里直接注入使用即可
@Autowired
JavaMailSender javaMailSender;
// 发送带附件的邮件
// 方法5个参数分别表示:邮件发送者、收件人、邮件主题、邮件内容、以及附件
public void sendAttachFileMail(String from, String to,
String subject, String content, File file) {
try {
MimeMessage message = javaMailSender.createMimeMessage();
// 这里使用 MimeMessageHelper 简化了邮件配置
// 第二个参数true表示构造一个 multipart message 类型邮件
// multipart message类型邮件包含多个正文、附件以及内嵌资源,邮件表现形式更加丰富
MimeMessageHelper helper = new MimeMessageHelper(message, true);
helper.setFrom(from);
helper.setTo(to);
helper.setSubject(subject);
helper.setText(content);
// 最后通过 addAttachment 方法添加附件
helper.addAttachment(file.getName(), file);
javaMailSender.send(message);
} catch (MessagingException e) {
e.printStackTrace();
}
}
}
接着我们创建一个 Controller 调用这个 Service 方法进行测试:
@RestController
public class HelloController {
@Autowired
MailService mailService;
@GetMapping("/hello")
public void hello() {
mailService.sendAttachFileMail("123@QQ.com",
"1421548723@qq.com",
"我是邮件的标题",
"我是邮件的内容",
new File("C:/Users/Administrator/Pictures/Saved Pictures/fthsrethstrywegwerrg5.jpg"));
}
}
执行该方法,即可看到邮件发送成功,如图所示。
2.4 发送带图片资源的邮件
有的邮件正文中可能要插入图片,使用FileSystemResource可以实现这一功能,代码如下:
@Component
public class MailService {
// JavaMailSender 在Mail 自动配置类 MailSenderAutoConfiguration 中已经导入,这里直接注入使用即可
@Autowired
JavaMailSender javaMailSender;
// 发送带附件的邮件
// 方法5个参数分别表示:邮件发送者、收件人、邮件主题、邮件内容、图片资源路径、以及资源id
public void sendMailWithImg(String from, String to,
String subject, String content,
String[] srcPath, String[] resIds) {
if (srcPath.length != resIds.length) {
System.out.println("发送失败");
return;
}
try {
MimeMessage message = javaMailSender.createMimeMessage();
MimeMessageHelper helper =
new MimeMessageHelper(message, true);
helper.setFrom(from);
helper.setTo(to);
helper.setSubject(subject);
// 第二个参数true表示邮件正文是HTML格式(默认为false)
helper.setText(content, true);
for (int i = 0; i < srcPath.length; i++) {
// 通过FileSystemResource构造静态资源,让后调用addInline方法将资源加入到邮件对象中
FileSystemResource res =
new FileSystemResource(new File(srcPath[i]));
helper.addInline(resIds[i], res);
}
javaMailSender.send(message);
} catch (MessagingException e) {
System.out.println("发送失败");
}
}
}
首先我们创建一个Controller调用这个Service方法进行测试:
@RestController
public class HelloController {
@Autowired
MailService mailService;
@GetMapping("/hello")
public void hello() {
mailService.sendMailWithImg("1036516218@QQ.com",
"1421548723@qq.com",
"这个是邮件的标题",
"<div>hello,这是一封带图片资源的邮件:<br>" +
"这是图片1:<div><img src='cid:p01'/></div>" +
"这是图片2:<div><img src='cid:p02'/></div>" +
"</div>",
new String[]{"C:/Users/Administrator/Pictures/Saved Pictures/fthsrethstrywegwerrg5.jpg",
"C:/Users/Administrator/Pictures/Saved Pictures/th.jfif"},
new String[]{"p01", "p02"});
}
}
邮件的正文是一段HTML文本,用cid标注出两个静态资源,分别为p01和p02。执行该方法,邮件发送结果如图所示。
2.5 使用FreeMarker构建邮件模板
对于格式复杂的邮件,如果采用字符串进行HTML拼接,不但容易出错,而且不易于维护,使用HTML模板可以很好地解决这一问题。使用FreeMarker构建邮件模板,首先加入FreeMarker依赖,代码如下:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-mail</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
创建一个MailService用来封装邮件的发送,代码如下:
@Component
public class MailService {
// JavaMailSender 在Mail 自动配置类 MailSenderAutoConfiguration 中已经导入,这里直接注入使用即可
@Autowired
JavaMailSender javaMailSender;
// 发送带HTML内容的邮件
// 方法4个参数分别表示:邮件发送者、收件人、邮件主题、html格式的邮件内容
public void sendHtmlMail(String from, String to, String subject, String content){
try {
MimeMessage message = javaMailSender.createMimeMessage();
MimeMessageHelper helper = new MimeMessageHelper(message, true);
helper.setTo(to);
helper.setFrom(from);
helper.setSubject(subject);
helper.setText(content, true);
javaMailSender.send(message);
} catch (MessagingException e) {
System.out.println("发送失败");
}
}
}
在项目resources目录下创建ftl目录作为模版存放位置,在该目录下创建mailtemplate.ftl作为邮件模版,内容如下:
<div>邮箱激活</div>
<div>您的注册信息是:
<table border="1">
<tr>
<td>用户名</td>
<td>${username}</td>
</tr>
<tr>
<td>用户性别</td>
<td>${sex}</td>
</tr>
</table>
</div>
<div>
<a href="#">核对无误请点击本链接激活邮箱</a>
</div>
当然,再创建一个简单的User实体类,代码如下:
@Data
@NoArgsConstructor
public class User {
private String username;
private String sex;
}
首先我们创建一个Controller来发送邮件,这次我们通过FreeMarker模版渲染出邮件正文内容:
@RestController
public class HelloController {
@Autowired
MailService mailService;
//
@GetMapping("/hello")
public void hello() {
try {
// 首先配置 FreeMarker 模版位置
Configuration configuration =
new Configuration(Configuration.VERSION_2_3_0);
ClassLoader loader = TestforeverApplication.class.getClassLoader();
configuration
.setClassLoaderForTemplateLoading(loader,"ftl");
// 配置模版文件
Template template = configuration.getTemplate("mailtemplate.ftl");
// 结合 User 对象渲染模版
StringWriter mail = new StringWriter();
User user = new User();
user.setUsername("suohe");
user.setSex("男");
template.process(user, mail);
// 将渲染结果发送出去
mailService.sendHtmlMail("123@qq.com",
"1421548723@qq.com",
"这个是邮件的标题",
mail.toString());
} catch (Exception e) {
e.printStackTrace();
}
}
}
执行该方法,即可看到邮件发送成功,如图所示。
2.6 使用Thymeleaf构建邮件模板
既然可以使用FreeMarker 构建邮件模板,当然也可以使用Thymeleaf 构建邮件模板,使用Thymeleaf构建邮件模板相对来说更加方便。使用Thymeleaf构建邮件模板,首先添加Thymeleaf依赖,代码如下:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-mail</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
创建一个MailService用来封装邮件的发送,代码如下:
@Component
public class MailService {
// JavaMailSender 在Mail 自动配置类 MailSenderAutoConfiguration 中已经导入,这里直接注入使用即可
@Autowired
JavaMailSender javaMailSender;
// 发送带HTML内容的邮件
// 方法4个参数分别表示:邮件发送者、收件人、邮件主题、html格式的邮件内容
public void sendHtmlMail(String from, String to, String subject, String content){
try {
MimeMessage message = javaMailSender.createMimeMessage();
MimeMessageHelper helper = new MimeMessageHelper(message, true);
helper.setTo(to);
helper.setFrom(from);
helper.setSubject(subject);
helper.setText(content, true);
javaMailSender.send(message);
} catch (MessagingException e) {
System.out.println("发送失败");
}
}
}
首先我们创建一个 Controller来发送邮件,这次我们通过Thymeleaf模版渲染出邮件正文内容:
注意:不同于 FreeMarker**,**Thymeleaf提供了TemplateEngine来对模版进行渲染,通过Context构造模版中变量需要的值,这种方式比 FreeMarker构建邮件模版更加方便。
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>邮件</title>
</head>
<body>
<div>邮箱激活</div>
<div>您的注册信息是:
<table border="1">
<tr>
<td>用户名</td>
<td th:text="${username}"></td>
</tr>
<tr>
<td>用户性别</td>
<td th:text="${sex}"></td>
</tr>
</table>
</div>
<div>
<a href="#">核对无误请点击本链接激活邮箱</a>
</div>
</body>
</html>
@RestController
public class HelloController {
@Autowired
MailService mailService;
@Autowired
TemplateEngine templateEngine;
@GetMapping("/hello")
public void hello() {
// 通过 Context 构造模版中变量需要的值
Context ctx = new Context();
ctx.setVariable("username", "suohe");
ctx.setVariable("sex", "男");
// 使用TemplateEngine 对模版进行渲染
String mail = templateEngine.process("mailtemplate.html", ctx);
// 将渲染结果通过邮件发出
mailService.sendHtmlMail("123@qq.com",
"1421548723@qq.com",
"这个是邮件的标题",
mail);
}
}
启动项目,访问 http://localhost:8080/hello 地址发送一个邮件,可以发现目标邮箱可以成功收到邮件。