SpringBoot 之集成邮件服务.

时间 2019-11-06

原文原文链接

1、前言html

Spring Email 抽象的核心是 MailSender 接口，MailSender 的实现可以把 Email 发送给邮件服务器，由邮件服务器实现邮件发送的功能。java

Spring 自带了一个 MailSender 的实现 JavaMailSenderImpl，它会使用 JavaMail API 来发送 Email。Spring 或 SpringBoot 应用在发送 Email 以前，咱们必需要 JavaMailSenderImpl 装配为 Spring应用上下文的一个 bean。spring

回到顶部服务器

2、配置app

一、pom.xml分布式

<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-mail</artifactId> </dependency>

二、application.ymlspring-boot

若是想学习Java工程化、高性能及分布式、深刻浅出。微服务、Spring，MyBatis，Netty源码分析的朋友能够加个人Java高级交流：854630135，群里有阿里大牛直播讲解技术，以及Java大型互联网技术的视频免费分享给你们。微服务

spring: mail: host: smtp.163.com port: 25 username: 159****2662@163.com password: ***********

host 属性默认是 JavaMail 会话的主机；port 端口默认监听标准的 SMTP 端口25；若是邮件服务器须要认证的，还须要设置 userrname 和 password。源码分析

这里我用的是 163 的邮件服务器，须要在 163 邮箱中开启客户端受权密码，不然会报 550 认证错误。性能

三、EmailConfig.java

在这里，咱们把 JavaMailSenderImpl 装配为 Spring 应用上下文的一个 Bean。同时须要注意的是，这里使用了@ConfigurationProperties 注解，该注解须要属性有 setter 方法并在启动类中使用 @EnableConfigurationProperties 注解使之生效。

@Configuration @ConfigurationProperties(prefix = "spring.mail") public class EmailConfig { private String host; private Integer port; private String username; private String password; @Bean public MailSender javaMailSender() { JavaMailSenderImpl javaMailSender = new JavaMailSenderImpl(); javaMailSender.setHost(host); javaMailSender.setPort(port); javaMailSender.setUsername(username); javaMailSender.setPassword(password); return javaMailSender; } public void setHost(String host) { this.host = host; } public void setPort(Integer port) { this.port = port; } public void setUsername(String username) { this.username = username; } public void setPassword(String password) { this.password = password; } }

若是想学习Java工程化、高性能及分布式、深刻浅出。微服务、Spring，MyBatis，Netty源码分析的朋友能够加个人Java高级交流：854630135，群里有阿里大牛直播讲解技术，以及Java大型互联网技术的视频免费分享给你们。

回到顶部

3、发送

有了 javaMailSender，那么邮件发送就是一件再简单不过的事情了。咱们只须要将 javaMailSender 的 Bean 注入到咱们本身的实现类中，而后使用 JavaMail API 来发送 Email。

一、文本邮件发送

public void sendSimpleEmail() { // 构造Email消息 SimpleMailMessage message = new SimpleMailMessage(); message.setFrom("159****2662@163.com"); message.setTo("****@qianxx.com"); message.setSubject("邮件主题"); message.setText("邮件内容"); javaMailSender.send(message); }

纯文本的 Email 在于构造 SimpleMailMessage 实例，这个对象能够很便捷地发送Email消息。

二、附件邮件发送

Spring 的 Email 功能并不局限于纯文本的 Email。咱们还能够添加附件。若是要发送带有附件的 Email，关键技巧是建立 multipart 类型的消息 ———— Email由多个部分组成，其中一部分是 Email 体，其余部分是附件。为了发送 multipart 类型的 Email，你须要建立一个MIME（Multipurpose Internet Mail Extensions）的消息。

public void mimeEmail() throws MessagingException { // MimeMessage 自己的 API 有些笨重，咱们可使用 MimeMessageHelper MimeMessage mimeMessage = javaMailSender.createMimeMessage(); // 第二个参数是 true ，代表这个消息是 multipart类型的/ MimeMessageHelper mimeMessageHelper = new MimeMessageHelper(mimeMessage, true); mimeMessageHelper.setFrom("159****2662@163.com"); mimeMessageHelper.setTo("****@qianxx.com"); mimeMessageHelper.setSubject("附件邮件主题"); mimeMessageHelper.setText("附件邮件内容"); //添加附件,第一个参数表示添加到 Email 中附件的名称，第二个参数是图片资源 mimeMessageHelper.addAttachment("boot.png", new ClassPathResource("public/images/boot.png")); javaMailSender.send(mimeMessage); }

三、富文本邮件发送

Spring 的 Email 功能除了能够添加附件外，甚至可使用 HTML 来美化消息体的内容。发送富文本的 Email 与发送简单文本的 Email 并无太大区别，关键是将setText() 方法的消息文本设置为 HTML，并将第二个参数设置为 true，表示这是 HTML 的富文本。

public void htmlEmail() throws MessagingException { MimeMessage mimeMessage = javaMailSender.createMimeMessage(); MimeMessageHelper mimeMessageHelper = new MimeMessageHelper(mimeMessage, true); mimeMessageHelper.setFrom("159****2662@163.com"); mimeMessageHelper.setTo("****@qianxx.com"); mimeMessageHelper.setSubject("富文本邮件主题"); String html = "<html><body><h4>Hello,SpringBoot</h4><img src='cid:boot' /></body></html>"; mimeMessageHelper.setText(html, true); // 设置内嵌元素 cid，第一个参数表示内联图片的标识符，第二个参数标识资源引用 mimeMessageHelper.addInline("boot", new ClassPathResource("public/images/boot.png")); javaMailSender.send(mimeMessage); }

回到顶部

4、使用 Thymeleaf 模板

HTML 标签的字符串拼接是一件很棘手的事。由于在你的大脑中解析HTML标签并想象它在渲染时会是什么样子是挺困难的。而将HTML混合在Java代码中又会使得这个问题更加复杂。

所以 Spring 给出的解决方案是：使用模板生成 HTML 文本，有多种模板方案可供选择，包括Apache Velocity和Thymeleaf。这里仅介绍 Thymeleaf 模板的用法（假设读者已经熟悉了 Thymeleaf 模板并知道如何在 SpringBoot 中使用它们）。

一、Thymeleaf 模板 — email.html

<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>Email</title> </head> <body> <img src='cid:boot'> <h4><span th:text="${title}">Craig Walls</span> says... </h4> <i><span th:text="${content}">Hello Boot!</span></i> </body> </html>

二、邮件发送

@RunWith(SpringRunner.class) @SpringBootTest public class ThymeleafApplicationTests { @Autowired private JavaMailSender javaMailSender; @Autowired private SpringTemplateEngine templateEngine; @Test public void contextLoads() throws MessagingException { MimeMessage mimeMessage = javaMailSender.createMimeMessage(); MimeMessageHelper mimeMessageHelper = new MimeMessageHelper(mimeMessage, true); mimeMessageHelper.setFrom("159****2662@163.com"); mimeMessageHelper.setTo("****@qianxx.com"); mimeMessageHelper.setSubject("ThymeLeaf 模板邮件"); // 利用 Thymeleaf 模板构建 html 文本 Context ctx = new Context(); ctx.setVariable("title", "Craig Walls"); ctx.setVariable("content", "Hello Boot!"); String emailText = templateEngine.process("email/email", ctx); mimeMessageHelper.setText(emailText, true); // 设置内嵌元素 cid，第一个参数表示内联图片的标识符，第二个参数标识资源引用 mimeMessageHelper.addInline("boot", new ClassPathResource("/static/img/boot.png")); javaMailSender.send(mimeMessage); } }