Springboot系列(十二):如何代码实现发送邮件提醒，你一定得会！(下篇)

2023-11-11 03:23:09

HTML 邮件与 Thymeleaf 模板引擎

在前面的文章中，我们已经学会了发送纯文本邮件。现在，让我们来看看如何发送 HTML 邮件。HTML 邮件允许您在邮件正文中使用 HTML 标签，从而可以创建更丰富的邮件内容，比如添加图片、表格、超链接等。

要发送 HTML 邮件，我们需要使用 Spring Boot 中的 Spring Mail 模块。Spring Mail 提供了 MimeMessageHelper 类，它可以帮助我们轻松地创建和发送 HTML 邮件。

MimeMessage message = mailSender.createMimeMessage();
MimeMessageHelper helper = new MimeMessageHelper(message, true);

helper.setFrom("your-email-address@example.com");
helper.setTo("recipient-email-address@example.com");
helper.setSubject("This is an HTML email");

String htmlContent = "<html><body><h1>Hello, World!</h1><p>This is an HTML email.</p></body></html>";
helper.setText(htmlContent, true);

mailSender.send(message);

在上面的代码中，我们首先创建了一个 MimeMessage 对象，然后使用 MimeMessageHelper 类来设置邮件的发件人、收件人、主题和正文。

setText() 方法的第二个参数指定了邮件正文是否为 HTML 格式。如果为 true，则邮件正文将被解析为 HTML，否则将被解析为纯文本。

使用 Thymeleaf 模板引擎创建动态邮件内容

Spring Boot 集成了 Thymeleaf 模板引擎，我们可以使用它来创建动态的邮件内容。Thymeleaf 模板引擎可以让我们在邮件正文中使用变量和表达式，从而可以根据不同的数据生成不同的邮件内容。

要使用 Thymeleaf 模板引擎，我们需要在 Spring Boot 应用中添加 Thymeleaf 的依赖：

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

添加依赖后，我们可以在邮件正文中使用 Thymeleaf 模板引擎的语法。例如，以下代码使用 Thymeleaf 模板引擎创建了一个动态邮件正文：

<html>
<body>
<h1>Hello, ${name}!</h1>
<p>This is an HTML email generated using Thymeleaf.</p>
</body>
</html>

在上面的代码中，我们使用 ${name} 变量来动态地插入收件人的姓名。

附件

Spring Boot 也支持发送附件。要发送附件，我们需要使用 MimeMessageHelper 类的 addAttachment() 方法。

MimeMessage message = mailSender.createMimeMessage();
MimeMessageHelper helper = new MimeMessageHelper(message, true);

helper.setFrom("your-email-address@example.com");
helper.setTo("recipient-email-address@example.com");
helper.setSubject("This is an email with an attachment");

String htmlContent = "<html><body><h1>Hello, World!</h1><p>This is an email with an attachment.</p></body></html>";
helper.setText(htmlContent, true);

// 添加附件
helper.addAttachment("attachment.txt", new File("path/to/attachment.txt"));

mailSender.send(message);

在上面的代码中，我们使用 addAttachment() 方法添加了一个名为 attachment.txt 的附件。

异常处理

在发送邮件的过程中，可能会发生各种各样的异常。为了确保邮件提醒功能稳定可靠，我们需要对这些异常进行处理。

Spring Boot 提供了 JavaMailSenderImpl 类来处理邮件发送过程中的异常。我们可以通过重写 JavaMailSenderImpl 类的 handleException() 方法来实现异常处理。

public class CustomJavaMailSenderImpl extends JavaMailSenderImpl {

    @Override
    protected void handleException(MailException ex) {
        // 处理邮件发送异常
        logger.error("Failed to send email", ex);
    }
}

在上面的代码中，我们重写了 handleException() 方法，并使用 logger 来记录邮件发送异常。