最近有童鞋问到笔者如何用Spring Boot发送邮件,故而整理下Spring Boot发送邮件的各种姿势。
说到邮件放松,相信大家对Spring Framework提供的接口 JavaMailSender
都不陌生。那么Spring Boot是否有开箱即用的邮件发送呢?答案是肯定的。Spring Boot为发送邮件提供了starter:spring-boot-starter-mail
。
本文详细探讨如何用Spring Boot发送邮件。
一、邮箱配置
以126邮箱为例:
1 开启SMTP服务
2 设置/重置客户端授权密码
二、编码
2.1 准备工作
1 加依赖
<dependency>
<groupId>org.;/groupId>
<artifactId>spring-boot-starter-mail</artifactId>
</dependency>
2 写配置
spring:
mail:
host:
username: eacdy0000@126.com
password: 上面设置的授权码
2.2 发送简单邮件
public String simple {
SimpleMailmessage message = new SimpleMailMessage;
// 发件人邮箱
me);
// 收信人邮箱
me("511932633@qq.com");
// 邮件主题
me("简单邮件测试");
// 邮件内容
me("简单邮件测试");
(message);
return "success";
}
结果类似下图:
2.3 发送html邮件
简单邮件是没有样式的,很多时候,我们希望发送的邮件内容带有样式,此时可发送HTML邮件。
public String html throws MessagingException {
MimeMessage message = javaMailSender.createMimeMessage;
MimeMessageHelper messageHelper = new MimeMessageHelper(message);
me);
me("511932633@qq.com");
me("HTML内容邮件测试");
// 第二个参数表示是否html,设为true
me("<h1>HTML内容..</h1>", true);
(message);
return "success";
}
结果类似下图:
2.4 发送带附件的邮件
很多场景下,需要为邮件插入附件,此时该怎么办呢?继续上代码——
@GetMapping("/attach")
public String attach throws MessagingException {
MimeMessage message = ;
// 第二个参数表示是否开启multipart模式
MimeMessageHelper messageHelper = new MimeMessageHelper(message, true);
me);
me("511932633@qq.com");
me("带附件的邮件测试");
// 第二个参数表示是否html,设为true
me("<h1>HTML内容..</h1>", true);
me("附件名称",
new ClassPathResource("wx.jpg"));
(message);
return "success";
}
结果类似下图:
2.5 发送带内联附件的邮件
附件 + HTML基本能满足日常工作中多数需求。但如果能将附件内联在邮件内容中,那么体验就更好啦!如何实现附件的内联呢?
@GetMapping("/inline-attach")
public String inlineAttach throws MessagingException {
MimeMessage message = ;
// 第二个参数表示是否开启multipart模式
MimeMessageHelper messageHelper = new MimeMessageHelper(message, true);
me);
me("511932633@qq.com");
me("内联附件的邮件测试");
// 第二个参数表示是否html,设为true
me("<h1>HTML内容..<img src=\"cid:attach\"/></h1>", true);
me("attach", new ClassPathResource("wx.jpg"));
(message);
return "success";
}
由代码可知,只需在想要内联的地方使用 cid:xx
引用内联附件,然后用addInline(xx, file)
指定附件即可。两处的xx
必须一致。
结果类似下图:
2.6 发送基于freemarker模板的邮件
上面的例子中,邮件内容是直接以字符串体现的,这通常不适合生产,因为实际项目中邮件往往带有变量。此时,可考虑使用Freemarker模板(或者其他模板,Spring Boot 2.x默认支持Freemarker、Groovy、Thymeleaf、Mustache四种模板引擎,也可根据需求使用其他模板引擎)。
创建Freemarker模板文件mail.ftl
,并将其存放在resources/templates/
目录中
<h1>亲爱的${username}, 欢迎关注${event}</h1>
编码:
@GetMapping("/freemarker")
public String freemarker throws MessagingException, IOException, TemplateException {
MimeMessage message = ;
// 第二个参数表示是否开启multipart模式
MimeMessageHelper messageHelper = new MimeMessageHelper(message, true);
me);
me("511932633@qq.com");
me("基于freemarker模板的邮件测试");
Map<String, Object> model = new HashMap<>;
model.put("username", "itmuch");
model.put("event", "IT牧场大事件");
String content = FreeMarkerTem(
("mail.ftl"), model);
// 第二个参数表示是否html,设为true
me(content, true);
(message);
return "success";
}
此时,结果类似下图:
References
[1]
GitHub:[2]
Gitee: