Spring Boot Mail发送邮件


邮件协议

示例引用于网易邮箱,不同邮箱服务器地址不同

IMAP和POP3区别

POP3 接收邮件服务器

POP3是Post Office Protocol 3的简称,即邮局协议的第3个版本,它规定怎样将个人计算机连接到Internet的邮件服务器和下载电子邮件的电子协议。它是因特网电子邮件的第一个离线协议标准,POP3允许用户从服务器上把邮件存储到本地主机(即自己的计算机)上,同时删除保存在邮件服务器上的邮件,而POP3服务器则是遵循POP3协议的接收邮件服务器,用来接收电子邮件的。

IMAP 接收邮件服务器

IMAP全称是Internet Mail Access Protocol,即交互式邮件存取协议,它是跟POP3类似邮件访问标准协议之一。不同的是,开启了IMAP后,您在电子邮件客户端收取的邮件仍然保留在服务器上,同时在客户端上的操作都会反馈到服务器上,如:删除邮件,标记已读等,服务器上的邮件也会做相应的动作。所以无论从浏览器登录邮箱或者客户端软件登录邮箱,看到的邮件以及状态都是一致的。

SMTP 发送邮件服务器

SMTP 的全称是“Simple Mail Transfer Protocol”,即简单邮件传输协议。它是一组用于从源地址到目的地址传输邮件的规范,通过它来控制邮件的中转方式。SMTP 协议属于 TCP/IP 协议簇,它帮助每台计算机在发送或中转信件时找到下一个目的地。SMTP 服务器就是遵循 SMTP 协议的发送邮件服务器。SMTP 认证,简单地说就是要求必须在提供了账户名和密码之后才可以登录 SMTP 服务器,这就使得那些垃圾邮件的散播者无可乘之机。增加 SMTP 认证的目的是为了使用户避免受到垃圾邮件的侵扰。   

项目依赖

1
2
3
4
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-mail</artifactId>
</dependency>

项目配置

aplication.yml

启用ssl

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
server:
port: 9010

spring:
mail:
# 发送邮件服务器地址
host: smtp.xxx.com
# 用户名
username: [email protected]
# 密码,对于QQ邮箱、163邮箱等填写授权码
password: 123456
# ssl 加密端口,无ssl加密为25端口
port: 465
# 采用协议
protocol: smtp
# ssl配置参数
properties:
mail:
smtp:
ssl:
enable: true
socketFactory:
fallback: false
class: javax.net.ssl.SSLSocketFactory
auth: true
starttls:
enable: true
required: true
# freemarker模板配置
freemarker:
# 指定文件后缀
suffix: .html

不启用ssl

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
server:
port: 9010

spring:
mail:
# 发送邮件服务器地址
host: smtp.xxx.com
# 用户名
username: [email protected]
# 密码,对于QQ邮箱、163邮箱等填写授权码
password: 123456
# ssl 加密端口,无ssl加密为25端口
port: 25
# 采用协议
protocol: smtp
# freemarker模板配置
freemarker:
# 指定文件后缀
suffix: .html

发送邮件

简易邮件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
    @Autowired
private JavaMailSender javaMailSender;

public void sendSimpleMail() {
// 创建消息体
SimpleMailMessage simpleMailMessage = new SimpleMailMessage();
simpleMailMessage.setFrom("[email protected]");//发件人
simpleMailMessage.setTo("[email protected]");//收件人
simpleMailMessage.setSubject("测试邮件");//主题
simpleMailMessage.setCc("[email protected]");//抄送,可添多个
simpleMailMessage.setText("邮件内容");//邮件内容(只能文本)
// simpleMailMessage.setBcc();//密送
javaMailSender.send(simpleMailMessage);
log.info("发送成功");
}

附件邮件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
    @Autowired
private JavaMailSender javaMailSender;
public void sendAttachmentMail() throws MessagingException {
// 创建消息体
MimeMessage mimeMessage = javaMailSender.createMimeMessage();
MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true);
helper.setFrom("[email protected]");//发件人
helper.setTo("[email protected]");//收件人
helper.setSubject("测试邮件");//主题
helper.setCc("[email protected]");//抄送,可添多个
helper.setText("<html><body><b>邮件内容</b></body></html>", true);//邮件内容(文本或者html)


File file = new File("C:\\home\\logs\\log.2019-08-01.log");
// 添加附件
helper.addAttachment("测试附加", file);
javaMailSender.send(mimeMessage);
}

模板邮件

添加freemarker依赖,也可以采用其他模板语言velocity、themeleaf等,用法类似

1
2
3
4
 <dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>

创建freemarker模板,新建vm.html模板文件

1
2
3
4
5
6
7
8
9
10
11
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>邮件模板</title>
</head>
<body>
${username}您好:
欢迎使用xxx系统
</body>
</html>

发送邮件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
    Autowired
private JavaMailSender javaMailSender;
public void sendTemplateMail() {
// 创建消息体
MimeMessage mimeMessage = javaMailSender.createMimeMessage();
MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true);
helper.setFrom("[email protected]");//发件人
helper.setTo("[email protected]");//收件人
helper.setSubject("测试邮件");//主题
helper.setCc("[email protected]");//抄送,可添多个

Map<String, Object> model = new HashMap<>();
model.put("username", "Joe");
// 获取模板文件
Template template = freeMarkerConfigurer.getConfiguration().getTemplate("vm.html");
// 根据模型转换模板内容
String text = FreeMarkerTemplateUtils.processTemplateIntoString(template, model);
helper.setText(text, true);//邮件内容

javaMailSender.send(mimeMessage);
}

文章作者: 苏叶新城
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 苏叶新城 !
  目录