依赖配置
在Springboot中,想要发送邮件,则需要添加spring-boot-starter-mail
启动器,坐标如下:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-mail</artifactId>
</dependency>
邮箱配置
在application.yml配置文件中添加如下配置:
spring:
mail:
#默认编码
default-encoding: UTF-8
# 发件服务器地址
# 此处填写的是QQ企业邮箱服务器地址,QQ邮箱请使用: smtp.mail.qq.com
host: smtp.exmail.qq.com
# 发件服务器端口(qq邮箱默认使用465)
port: 465
properties:
mail:
smtp:
ssl:
#开启SSL(QQ邮箱必须开启)
enable: true
# 发件人邮箱
username: xxxx@xxx.xx
# 发件人密码(QQ邮箱需使用授权码)
password: xxxxxx
QQ邮箱授权码的获取
- 进入QQ邮箱设置界面
- 进入账号设置界面
- 找到
POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务
点击生成授权码
发送邮件
在spring-boot-starter-mail
中发送邮件,首先需要注入org.springframework.mail.javamail.JavaMailSender
对象
@Resource
private JavaMailSender mailSender;
当然在发送邮件时我们需要拿到发件人邮箱,也可按照如下方式获取:
@Value("${spring.mail.username}")
private String emailFrom;
发送简单邮件
// 创建简单邮件消息对象
SimpleMailMessage message = new SimpleMailMessage();
// 设置发件人
message.setFrom(emailFrom);
// 设置收件人
message.setTo("xxxxx@qq.com");
// 设置邮件主题
message.setSubject("邮件测试");
// 设置邮件内容
message.setText("这个是Springboot发出的简单邮件");
// 发送邮件
mailSender.send(message);
效果如下
发送带附件的邮件
// 创建复杂邮件消息对象
MimeMessage mimeMessage = this.mailSender.createMimeMessage();
// 创建邮件消息助手类
MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true);
// 设置发件人
helper.setFrom(emailFrom);
// 设置收件人
helper.setTo("xxxxx@qq.com");
// 设置邮件主题
helper.setSubject("带附件的邮件");
// 设置邮件内容,并开启html支持
helper.setText("<html><body>这是一封带有附件图片的邮件<img src=\"cid:图片CID\" ></body></html>", true);
// 以行内的方式设置附件,该方式可将附件显示到邮件内容中,如图片
helper.addInline("图片CID", new FileSystemResource(new File("C:\\xxxx\\1.jpg")));
// 发送邮件
mailSender.send(mimeMessage);
注意: CID请不要使用中文,否则会无法识别
效果如下
发送模板邮件
模版邮件并未限定使用某一个模板,但在本文中,仅使用Springboot默认支持的
Thymeleaf
模板引擎实现
- 首先需要注入
Thymeleaf
模板引擎
@Resource
private TemplateEngine engine;
- 发送邮件
// 创建复杂邮件消息对象
MimeMessage mimeMessage = this.mailSender.createMimeMessage();
// 创建邮件消息助手类
MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true);
// 设置发件人
helper.setFrom(emailFrom);
// 设置收件人
helper.setTo("xxxx@qq.com");
// 设置邮件主题
helper.setSubject("Thymeleaf模板邮件");
Context context = new Context();
context.setVariable("title", "模板标题");
context.setVariable("content", "模板内容");
context.setVariable("image", "附件CID");
// 渲染模板
String text = engine.process("email", context);
// 将渲染后的模板代码设置为邮件内容,并开启html支持
helper.setText(text, true);
// 设置附件
helper.addInline("附件CID", new FileSystemResource(new File("C:\\xxxxx\\1.jpg")));
// 设置可供下载的附件
helper.addAttachment("a.txt", new FileSystemResource(new File("F:\\xxxx\\a.txt")));
// 发送邮件
mailSender.send(mimeMessage);
效果如下