Spring Boot 整合 spring-boot-starter-mail 实现邮件发送和账户激活

在这里插入图片描述

😄 19年之后由于某些原因断更了三年，23年重新扬帆起航，推出更多优质博文，希望大家多多支持～
🌷 古之立大事者，不惟有超世之才，亦必有坚忍不拔之志
🎐 个人CSND主页——Micro麦可乐的博客
🐥《Docker实操教程》专栏以最新的Centos版本为基础进行Docker实操教程，入门到实战
🌺《RabbitMQ》本专栏主要介绍使用JAVA开发RabbitMQ的系列教程，从基础知识到项目实战
🌸《设计模式》专栏以实际的生活场景为案例进行讲解，让大家对设计模式有一个更清晰的理解
💕《Jenkins实战》专栏主要介绍Jenkins+Docker+Git+Maven的实战教程，让你快速掌握项目CI/CD，是2024年最新的实战教程
如果文章能够给大家带来一定的帮助！欢迎关注、评论互动～

Spring Boot 整合 spring-boot-starter-mail 实现邮件发送和账户激活

前言
申请SMTP服务
项目初始化
配置邮件服务
定义操作邮件Service
定义用户相关
开始测试
结语

前言

在我们日常开发中，用户注册后需要对用户进行一个激活，通过邮件激活账户是一种常见的用户验证机制。这里博主将详细介绍如何使用 Spring Boot 实现邮件发送和账户激活功能，并构建一个简单的Spring Boot项目实现代码示例和关键技术点。

申请SMTP服务

这里以QQ邮箱为例，登陆QQ邮箱「设置」 - 「账户」找到SMTP选项，选择开启服务，生成授权码。博主已经开通过见下图：
在这里插入图片描述

官方温馨提醒：为了帐户安全，更改QQ密码以及独立密码会触发授权码过期，需要重新获取新的授权码。

项目初始化

首先，我们需要创建一个具备整合redis、mysql、mail的 Spring Boot 项目。整体 pom.xml 如下：

<dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <!-- mail -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-mail</artifactId>
        </dependency>
        <!-- redis -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-redis</artifactId>
        </dependency>
        <!-- mybatis -->
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>2.3.1</version>
        </dependency>
        <!-- 阿里数据库连接池 -->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid-spring-boot-starter</artifactId>
            <version>1.2.16</version>
        </dependency>
        <!-- mysql -->
        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
            <scope>runtime</scope>
        </dependency>
        <!-- lombok -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>

配置邮件服务

Spring Boot的starter模块提供了自动化配置，在完成了 spring-boot-starter-mail 依赖引入之后，只需要在application.yml中配置相应的属性内容

spring:
    #mail
    mail:
        host: smtp.qq.com
        # 端口号
        port: 587
        # 发送邮件的邮箱地址
        username: xxxxxxxx
        # QQ邮箱获得的授权码
        password: xxxxxxxx

定义操作邮件Service

Spring Boot的starter模块提供了自动化配置，所以在引入了 spring-boot-starter-mail 依赖之后，会根据配置文件中的内容去创建JavaMailSender实例，我们只需要在使用的地方直接@Autowired来引入邮件发送对象

import cn.hutool.core.util.StrUtil;
import lombok.SneakyThrows;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.core.io.FileSystemResource;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.stereotype.Service;

import javax.mail.internet.MimeMessage;
import java.io.File;

@Service
public class EmailService {

    @Autowired
    private JavaMailSender mailSender;

    @Value("${spring.mail.username}")
    private String sendFrom;

    /**
     * 不带附件邮件
     * @param subject 主题
     * @param content 内容
     * @param sendTo 定义可变参数 实现邮件发送多个邮箱
     */
    @SneakyThrows(Exception.class)
    public void sendSimpleMail(String subject, String content,String... sendTo) {

        MimeMessage message = mailSender.createMimeMessage();
        MimeMessageHelper messageHelper = new MimeMessageHelper(message, true);
        messageHelper.setFrom(sendFrom);
        messageHelper.setTo(sendTo);
        messageHelper.setSubject(subject);
        messageHelper.setText(content,true);
        mailSender.send(message);
    }

    /**
     * 带附件邮件
     * @param subject 主题
     * @param content 内容
     *
     * @param filePath 附件路径
     * @param sendTo 定义可变参数 实现邮件发送多个邮箱
     */
    @SneakyThrows(Exception.class)
    public void sendAttachmentsMail(String subject, String content,String attachmentName, String filePath, String... sendTo){

        MimeMessage message = mailSender.createMimeMessage();
        MimeMessageHelper messageHelper = new MimeMessageHelper(message, true);
        messageHelper.setFrom(sendFrom);
        messageHelper.setTo(sendTo);
        messageHelper.setSubject(subject);
        messageHelper.setText(content,true);
        //判断附件
        if(StrUtil.isNotBlank(filePath)){
            FileSystemResource file = new FileSystemResource(new File(filePath));
            //没有传递附件名称则默认使用文件名
            attachmentName = StrUtil.isNotBlank(filePath)?attachmentName:filePath.substring(filePath.lastIndexOf(File.separator));
            messageHelper.addAttachment(attachmentName, file);
        }
        mailSender.send(message);
    }
}

定义用户相关

创建一个 User 实体来表示用户信息，并包括一个用于账户激活的字段 code 以及账户激活状态 enabled

// 根据User类，大家自行创建mysql数据库user表
@Data
public class User {
    private Long id;
    //注册邮箱
    private String email;
    //密码
    private String password;
    //用户激活状态
    private boolean enabled;
    //激活code
    private String code;
}

为了快速实现用户注册和激活，博主就怎么方便怎么来，不写service接口和实现了，直接调用UserMapper

import com.toher.dockertestproject.domain.User;
import org.apache.ibatis.annotations.Insert;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;

@Mapper
public interface UserMapper {
    @Select("select * from user where id = #{id}")
    public User getById(@Param("id") Long id);

    @Select("select * from user where code = #{code}")
    public User getByActivationCode(@Param("code") String code);

    @Insert("insert into user(id, email, password, code)values(#{id}, #{email}, #{password} , #{code})")
    public int insert(User user);

    @Insert("update user set enabled = 1 where id = #{id}")
    public int update(@Param("id") Long id);

}

创建一个控制器处理用户注册和账户激活请求

注册接口会插入用户（生成UUID作为激活code）至数据库
激活接口更新用户激活状态

@RestController
public class UserController {

    @Resource
    private UserMapper userMapper;
    @Resource
    private EmailService emailService;

    @PostMapping("/register")
    public String registerUser(@RequestBody User user) {
        user.setCode(UUID.randomUUID().toString());
        userMapper.insert(user);
        String content = "点击连接激活: " +
                "<a href='http://localhost:9090/activate?code=" + user.getCode()+"'>http://localhost:9090/activate?code=" + user.getCode()+"</a>";
        emailService.sendSimpleMail("注册验证" , content, user.getEmail());

        return "注册成功! 请前往邮箱进行激活账户";
    }

    @GetMapping("/activate")
    public String activateUser(@RequestParam String code) {
        User user = userMapper.getByActivationCode(code);
        if (user != null) {
            //更新用户激活状态
            userMapper.update(user.getId());
            return "账户激活成功！";
        } else {
            return "无效的激活码!";
        }
    }
}