使用 Java Spring Boot 发送邮件

随着互联网的发展，邮件已成为重要的消息传递工具。无论是用户注册确认、密码重置还是系统通知，发送邮件的功能越来越普遍。在 Java 的生态系统中，Spring Boot 提供了简便的邮件发送功能。本文将介绍如何在 Spring Boot 中实现发送邮件的功能，并提供相关代码示例，帮助你快速上手。

1. 项目设置

首先，你需要一个 Spring Boot 项目。如果还没有，可以使用 Spring Initializr 来快速创建一个。选择 Spring Web 和 Spring Boot Starter Mail 依赖。

在 pom.xml 文件中，确保包含了以下依赖：

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

2. 配置邮件发送服务

在 application.properties 文件中，配置邮件发送所需的属性。这里以 Gmail 为例：

spring.mail.host=smtp.gmail.com
spring.mail.port=587
spring.mail.username=your-email@gmail.com
spring.mail.password=your-email-password
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true

请确保将 your-email@gmail.com 和 your-email-password 替换为你的实际 Gmail 邮箱和密码。

注意: 若使用 Gmail，可能需要开启 "允许低级别应用" 设置或使用 OAuth2 进行身份验证，具体请参考 Gmail 的文档。

3. 创建邮件服务类

接下来，创建一个邮件服务类，用于构建并发送邮件。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.mail.SimpleMailMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.stereotype.Service;

@Service
public class EmailService {

    @Autowired
    private JavaMailSender mailSender;

    public void sendSimpleEmail(String to, String subject, String body) {
        SimpleMailMessage message = new SimpleMailMessage();
        message.setTo(to);
        message.setSubject(subject);
        message.setText(body);

        mailSender.send(message);
    }
}

4. 创建控制器

然后，我们需要创建一个控制器，以便用户可以通过 HTTP 请求来发送邮件。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class EmailController {

    @Autowired
    private EmailService emailService;

    @PostMapping("/send-email")
    public String sendEmail(@RequestBody EmailRequest emailRequest) {
        emailService.sendSimpleEmail(emailRequest.getTo(), emailRequest.getSubject(), emailRequest.getBody());
        return "Email sent successfully!";
    }
}

EmailRequest 类的代码如下：

public class EmailRequest {
    private String to;
    private String subject;
    private String body;

    // Getters and Setters
}

5. 测试邮件发送功能

在实现了邮件发送功能后，你可以使用工具如 Postman 测试发送邮件。发送一个 POST 请求到 http://localhost:8080/send-email，请求体可以如下所示：

{
    "to": "recipient@example.com",
    "subject": "Test Email",
    "body": "This is a test email from Spring Boot!"
}

6. 关系图和状态图

为了更好地理解邮件发送过程，我们可以绘制关系图和状态图。

6.1 关系图 (ER Diagram)

erDiagram
    USER {
        string email
        string name
    }

    EMAIL {
        string subject
        string body
        string status
    }

    USER ||--o{ EMAIL : sends

6.2 状态图 (State Diagram)

stateDiagram
    [*] --> Created
    Created --> Sending
    Sending --> Sent
    Sending --> Failed
    Sent --> [*]
    Failed --> [*]

结尾

在本文中，我们探讨了如何使用 Spring Boot 发送邮件的基本步骤。从项目配置到邮件发送逻辑的实现，我们提供了完整的代码示例，方便开发者快速上手。随着应用的不断需求，邮件功能的增强也是必然趋势，接下来你可以尝试实现更复杂的邮件发送功能，比如HTML邮件、附件邮件等。同时，确保安全的邮件发送策略，保护用户隐私，提升用户体验。希望本文对你的项目开发有所帮助！