Spring Boot利用Thymeleaf发送Email的方法教程

前言

众所周知,现在在后台服务器中发送邮件已经是一个非常常用的功能了。通常来说虽然HTML并非是一个非常标准的信息格式,但是至少许多邮件客户端都至少支持一部分标记语言。 在这边教程中主要是关于教你如何在Spring Boot 应用中发送邮件以及使用非常简单强大的Thymeleaf模板引擎来制作邮件内容。

文章末尾附上源码,已经开源到Github上,是我公司做项目的时候处理邮件这一块用到的。 基本上覆盖了大部分邮件发送需求。稍微修改了一下,奉献给有需要的人。当你看完文章在看一下这封源码,你会对这一块更加的了解。而且你能掌握常用的邮件发送:

  • 纯文本邮件
  • 内联图片邮件
  • 带附件的邮件

纯文本邮件

添加依赖(Mail starter dependencies)

首先制作并且通过SMTP邮件服务器来发送一个纯文本邮件。

如果你之前有用过Spring Boot的话,那你宁该并不好奇在你建立一个新工程的时候,Spring Boot已经帮你继承了常用的依赖库。 通常你只需要在你的 pom.xml 中添加如下依赖即可:

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

邮件服务器属性配置(Properties configuration)

通常情况下,如果所需要的依赖在 class path 中都是可用的话,这时候Spring会自动帮你注册一个默认实现的邮件发送服务 (default mail sender service)。 spring.mail.host 属性已经被自动定义了, 所有我们所需要做的事情就是把这个属性添加到我们应用的 application.properties 配置文件中。

application.properties 在resource文件夹下

Spring Boot 提供的默认邮件发送服务 其实已经非常强大了,我们可以通过简单的配置它的属性就可以了。所谓的属性其实说白了就是配置它的邮件SMTP 服务器:

spring.mail.port=25 # SMTP server port
spring.mail.username= # Login used for authentication
spring.mail.password= # Password for the given login
spring.mail.protocol=smtp
spring.mail.defaultEncoding=UTF-8 # Default message encoding

这里附带一份 gmail 的SMTP服务器配置清单:

spring.mail.host = smtp.gmail.com
spring.mail.username = *****@gmail.com
spring.mail.password = ****
spring.mail.properties.mail.smtp.auth = true
spring.mail.properties.mail.smtp.socketFactory.port = 587
spring.mail.properties.mail.smtp.socketFactory.class = javax.net.ssl.SSLSocketFactory
spring.mail.properties.mail.smtp.socketFactory.fallback = false

邮件发送服务(Mail sending service)

在这里我们使用 Autowired 在注入我们的service, 它主要就是生成邮件的相关信息

@Service
public class MailClient {

 private JavaMailSender mailSender;

 @Autowired
 public MailService(JavaMailSender mailSender) {
 this.mailSender = mailSender;
 }

 public void prepareAndSend(String recipient, String message) {
 //TODO implement
 }

}

生成邮件内容

下面是一个简单的生成邮件内容的代码。

public void prepareAndSend(String recipient, String message) {
 MimeMessagePreparator messagePreparator = mimeMessage -> {
 MimeMessageHelper messageHelper = new MimeMessageHelper(mimeMessage);
 messageHelper.setFrom("sample@dolszewski.com");
 messageHelper.setTo(recipient);
 messageHelper.setSubject("Sample mail subject");
 messageHelper.setText(message);
 };
 try {
 mailSender.send(messagePreparator);
 } catch (MailException e) {
 // runtime exception; compiler will not force you to handle it
 }
}

send() 需要被重写以接受不同类型的参数变量:

  • SimpleMailMessage: 正如名字所示,这是一个最基本的邮件message的模块,我们可以给它设置常用的属性,它并不能够修改信息的头,只能发送纯文本的文件。
  • MimeMessage: 通过这个类我们可以构建出比较复杂的邮件内容
  • MimeMessagePreparator: 这是一个接口类,主要目的是提供一个构建模板方法用来构建 MimeMessage 以及当你生成一个实例的时候帮你处理异常信息。官方文档(也是常识:))建议将MimeMessagePreparator作为邮件构建的首选类型。

MimeMessageHelper类是MimeMessage的装饰类,它提供了更多的开发人员友好界面,并为类的许多属性添加了输入验证。你可以不用,但是别人肯定会用,而且你会后悔不用 XD。

send() 会抛出 **MailException ** 异常,这是个运行时异常,也就是通常所说的 RuntimeException。 在消息传递失败的情况下,很可能会重复发送操作,或者至少使用一些更复杂的解决方案处理这种情况,例如:使用相应的堆栈跟踪记录错误消息。

手动测试

通常如果你想邮件功能,你首先需要拥有一个SMTP服务器在你本机的电脑上处理你的请求。 如果你还没用过,下面给你们推荐一些常用的:

  • FakeSMTP – A simple server written in Java. Supported by any operating system with Java 1.6 or newer installed.
  • smtp4dev – A server with a plain and user friendly interface. For Windows only.
  • Papercut– Another simple server designed for Windows.

集成测试

你可能或许会感到好奇应该如果写一个自动化的Test来验证你客户端的功能。 如果你手动测试的话,你需要开启SMTP 服务器然后在运行你的Spring Boot客户端。 在这里给大家推荐一个神器 GreenMail, 因为他跟Junit单元测试高度集成,可以简化我们的测试。

添加依赖

GreenMail 已经在Maven仓库中了,所以我们唯一所需要做的就是将其依赖加入我们的 pom.xml 配置文件中:

<dependency>
 <groupId>com.icegreen</groupId>
 <artifactId>greenmail</artifactId>
 <version>1.5.0</version>
 <scope>test</scope>
</dependency>

SMTP服务器与Test模板

现在呢,说了这么多废话,我们终于可以创建我们的第一个集成测试类了。 它会启动Spring应用程序并同时运行邮件客户端。但是在我们编写实际测试之前呢,我们首先必须要确保SMTP服务器正确运行,同时在测试结束的时候能够正确关闭。

@RunWith(SpringJUnit4ClassRunner.class)
@SpringApplicationConfiguration(Application.class)
public class MailClientTest {

 private GreenMail smtpServer;

 @Before
 public void setUp() throws Exception {
 smtpServer = new GreenMail(new ServerSetup(25, null, "smtp"));
 smtpServer.start();
 }

 @After
 public void tearDown() throws Exception {
 smtpServer.stop();
 }

}

创建邮件客户端

首先,我们需要注入我们的邮件service在测试类中。之后,我们才能通过GrennMail来验证是否能够接受到邮件。

@Autowired
private MailClient mailClient;

@Test
public void shouldSendMail() throws Exception {
 //given
 String recipient = "name@hotmail.com";
 String message = "Test message content";
 //when
 mailClient.prepareAndSend(recipient, message);
 //then
 assertReceivedMessageContains(message);
}

private void assertReceivedMessageContains(String expected) throws IOException, MessagingException {
 MimeMessage[] receivedMessages = smtpServer.getReceivedMessages();
 assertEquals(1, receivedMessages.length);
 String content = (String) receivedMessages[0].getContent();
 assertTrue(content.contains(expected));
}

发送HTML邮件

在这里我们主要说一下如何构建HTML类型的邮件。

Thymeleaf 模板引擎

首先在你的 pom.xml 中添加依赖。Spring引导将使用其默认设置自动准备引擎

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

Thymeleaf的默认配置期望所有HTML文件都放在 **resources/templates ** 目录下,以.html扩展名结尾。 让我们创建一个名为mailTemplate.html的简单文件,我们将使用创建的邮件客户端类发送:

除了在生成过程中作为参数传递的消息的占位符,该模板几乎不包含任何内容。这不是废话么-,-

模板处理

创建一个服务类,它主要负责将写入的模板和外部模型组合在一起,这在我们的例子中是一个简单的短信。

@Service
public class MailContentBuilder {

 private TemplateEngine templateEngine;

 @Autowired
 public MailContentBuilder(TemplateEngine templateEngine) {
 this.templateEngine = templateEngine;
 }

 public String build(String message) {
 Context context = new Context();
 context.setVariable("message", message);
 return templateEngine.process("mailTemplate", context);
 }

}

注意:这里的 context。 这里主要使用的 键值对 的形式,类似map,将模板里面的需要的变量与值对应起来。 比如: <span th:text="${message}"></span> , 这里我们通过context就将message的内容赋值给了span。

TemplateEngine类的实例由Spring Boot Thymeleaf自动配置提供。我们所需要做的就是调用process()方法,该方法接受两个参数,也就是我们使用的模板的名称以及充当模型的容器的上下文对象对象。

将新创建的 MailContentBuilder 注入到MailService类中。我们需要在prepareAndSen() 方法中进行一个小的调整,以利用构建器将生成内容设置为mime消息。我们还使用 setText() 方法的重载变量将 Content-Type 头设置为text / html,而不是默认的 text / plain。

测试

需要更新的最后一件事是我们的测试,更确切地说,是接收到的消息的预期内容。只需对验证逻辑进行一个小的更改,运行测试并检查结果。

@Test
public void shouldSendMail() throws Exception {
 //given
 String recipient = "name@dolszewski.com";
 String message = "Test message content";
 //when
 mailService.prepareAndSend(recipient, message);
 //then
 String content = "<span>" + message + "</span>";
 assertReceivedMessageContains(content);
}

本文到此基本宣告结束。

再次献上一份我常用的html email模板:

<!DOCTYPE html>
<html lang="en"
 xmlns="http://www.w3.org/1999/xhtml"
 xmlns:th="http://www.thymeleaf.org">
<head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
 <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
 <title>Siemens Sinnovation</title>
 <style>
 .button {
  background-color: #4CAF50;
  border-radius: 12px;
  border: none;
  color: white;
  padding: 10px 25px;
  text-align: center;
  text-decoration: none;
  display: inline-block;
  font-size: 18px;
  margin: 4px 2px;
  cursor: pointer;
  box-shadow: 0 8px 16px 0 rgba(0, 0, 0, 0.2), 0 6px 20px 0 rgba(0, 0, 0, 0.19);
 }

 .button:hover {
  box-shadow: 0 12px 16px 0 rgba(0, 0, 0, 0.24), 0 17px 50px 0 rgba(0, 0, 0, 0.19);
 }
 </style>
</head>
<body style="margin: 0;padding: 0;">

<table align="center" border="1" cellpadding="0" cellspacing="0" width="600px">
 <tr>
 <td>
  <table align="center" border="0" cellpadding="0" cellspacing="0" width="600"
   style="border-collapse: collapse;">
  <tr>
   <td align="center" style="padding: 40px 0 30px 0;">
   <!--![](image/logo.png)-->
   ![](|cid:${imageResourceName}|)

   </td>
  </tr>

  <tr>
   <td bgcolor="#ffffff" style="padding: 20px 30px 20px 30px">
   <h4>The following message was created by <span th:text="${owner.getName()}"></span> in the
    Siemens DFFA group: </h4>

   <table border="0" cellpadding="0" cellspacing="0" width="100%">
    <tr>
    <td><span th:text="${title}">title</span></td>
    </tr>
    <tr>
    <td style="padding: 20px 0 30px 0">
     <span th:text="${description}">description</span>

    </td>

    </tr>

    <tr>
    <table border="0" cellpadding="0" cellspacing="0" width="100%">
     <tr>
     <!--<td align="center" style="padding: 5px 0 3px 0">Status:<span-->
      <!--th:text="${status}">status</span></td>-->
     <!--<td align="center" style="padding: 5px 0 3px 0">Date submitted: <span-->
      <!--th:text="${createDate}">createDate</span></td>-->
     <!--<td align="center" style="padding: 5px 0 3px 0">Days left to join:<span-->
      <!--th:text="${leftTime}">leftTime</span></td>-->

     <td align="center" style="padding: 5px 0 3px 0">Status:<span
      th:text="${status}"> OPEN FOR JOINING</span></td>
     <td align="center" style="padding: 5px 0 3px 0">Date submitted: 28/08/2017 <span
      th:text="${createDate}">createDate</span></td>
     <td align="center" style="padding: 5px 0 3px 0">Days left to join: 10h<span
      th:text="${leftTime}">leftTime</span></td>
     </tr>
    </table>
    </tr>
    <tr>
    <table border="0" cellpadding="0" cellspacing="0" width="100%">
     <tr>
     <td style="padding: 40px 0px 10px 0px">
      Team Member:
     </td>
     </tr>
     <tr th:each="member :${members}">
     <td style="padding: 5px 0px 5px 0px"><span
      th:text="${member.getName()}+', Email: '+${member.getEmail()}"></span>
     </td>
     </tr>
    </table>
    </tr>
    <tr>
    <td align="center" style="padding: 5px 40px 5px 40px">
     <button class="button">View Details</button>
    </td>
    </tr>
   </table>

   </td>
  </tr>
  </table>
 </td>
 </tr>

</table>
</body>
</html>

源码下载:

Github 源码:链接地址

本地下载:链接地址

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作能带来一定的帮助,如果有疑问大家可以留言交流,谢谢大家对我们的支持。

(0)

相关推荐

  • 详解SpringBoot+Thymeleaf 基于HTML5的现代模板引擎

    序言: Thymeleaf 是Java服务端的模板引擎,与传统的JSP不同,前者可以使用浏览器直接打开,因为可以忽略掉拓展属性,相当于打开原生页面,给前端人员也带来一定的便利.如果你已经厌倦了JSP+JSTL的组合,Thymeleaf或许是个不错的选择!本工程传送门:SpringBoot-Web-Thymeleaf 开始使用 1.引入依赖 SpringBoot默认提供了Thymeleaf的Starter,只需简单引入依赖即可. <dependency> <groupId>org.s

  • 详解spring Boot 集成 Thymeleaf模板引擎实例

    今天学习了spring boot 集成Thymeleaf模板引擎.发现Thymeleaf功能确实很强大.记录于此,供自己以后使用. Thymeleaf: Thymeleaf是一个java类库,他是一个xml/xhtml/html5的模板引擎,可以作为mvc的web应用的view层. Thymeleaf还提供了额外的模块与Spring MVC集成,所以我们可以使用Thymeleaf完全替代jsp. spring Boot 通过org.springframework.boot.autoconfigu

  • spring boot使用thymeleaf模板的方法详解

    前言 Thymeleaf 是一个跟 Velocity.FreeMarker 类似的模板引擎,它可以完全替代 JSP .相较与其他的模板引擎,它有如下三个极吸引人的特点: 1.Thymeleaf 在有网络和无网络的环境下皆可运行,即它可以让美工在浏览器查看页面的静态效果,也可以让程序员在服务器查看带数据的动态页面效果.这是由于它支持 html 原型,然后在 html 标签里增加额外的属性来达到模板+数据的展示方式.浏览器解释 html 时会忽略未定义的标签属性,所以 thymeleaf 的模板可以

  • Spring Data + Thymeleaf 3 + Bootstrap 4 实现分页器实例代码

    实际上分页器或者分页组件在现实中都有广泛着的应用,照理来说老卫没有必要单独撰文来提这茬.事实是,我近期刚好在写一门关于Spring Data.Thymeleaf 3.Bootstrap 4 的应用课程,所以用了Bootstrap 4的样式,结果之前很多例如 Bootstrap 3 的表格.分页器啊之类的插件都不能很好的兼容,百度谷歌无果,而且 Bootstrap 4 还没有出稳定版本,官网的示例也是少的可怜,最终下决心要自己写个分页器了,所用到的技术就是 Spring Data.Thymelea

  • spring boot(四)之thymeleaf使用详解

    在上篇文章springboot(二):web综合开发中简单介绍了一下thymeleaf,这篇文章将更加全面详细的介绍thymeleaf的使用.thymeleaf 是新一代的模板引擎,在spring4.0中推荐使用thymeleaf来做前端模版引擎. thymeleaf介绍 简单说, Thymeleaf 是一个跟 Velocity.FreeMarker 类似的模板引擎,它可以完全替代 JSP .相较与其他的模板引擎,它有如下三个极吸引人的特点: 1.Thymeleaf 在有网络和无网络的环境下皆可

  • springboot用thymeleaf模板的paginate分页完整代码

    本文根据一个简单的user表为例,展示 springboot集成mybatis,再到前端分页完整代码(新手自学,不足之处欢迎纠正): 先看java部分 pom.xml 加入 <!--支持 Web 应用开发,包含 Tomcat 和 spring-mvc. --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web&l

  • springboot中thymeleaf模板使用详解

    这篇文章将更加全面详细的介绍thymeleaf的使用.thymeleaf 是新一代的模板引擎,在spring4.0中推荐使用thymeleaf来做前端模版引擎. thymeleaf介绍 简单说, Thymeleaf 是一个跟 Velocity.FreeMarker 类似的模板引擎,它可以完全替代 JSP .相较与其他的模板引擎,它有如下三个极吸引人的特点: 1.Thymeleaf 在有网络和无网络的环境下皆可运行,即它可以让美工在浏览器查看页面的静态效果,也可以让程序员在服务器查看带数据的动态页

  • spring boot使用thymeleaf跳转页面实例代码

    前言 在学习springboot 之后想结合着html做个小demo,无奈一直没掌握窍门,在多番的搜索和尝试下终于找到了配置的方法,使用thymeleaf做事前端页面模板,不能使用纯html. thymeleaf介绍 Thymeleaf是面向Web和独立环境的现代服务器端Java模板引擎. Thymeleaf的主要目标是为您的开发工作流程带来优雅的自然模板 - 可以在浏览器中正确显示HTML,还可以作为静态原型工作,从而在开发团队中进行更强大的协作. 使用Spring Framework的模块,

  • SpringBoot中的Thymeleaf用法

    Thymeleaf Thymeleaf是最近SpringBoot推荐支持的模板框架,官网在thymeleaf.org这里. 我们为什么要用Thymeleaf来作为模板引擎呢?官网给了我们一个非常令人信服的解释: Thymeleaf is a modern server-side Java template engine for both web and standalone environments.> 基本写法就像下面这样: <table> <thead> <tr&g

  • Spring boot + thymeleaf 后端直接给onclick函数赋值的实现代码

    这里是控制器里返回的 /** * @param pageUtil 分页工具类 * @param cliCorpQuery 查询类 * @param model model * @return String */ @RequestMapping(value = {"/list"}, method = RequestMethod.GET) public String list(PageUtil<CliCorp> pageUtil, CliCorpQuery cliCorpQue

随机推荐