手把手教你通过SpringBoot实现邮箱注册码验证

一、前言

注册一个系统成为用户，一般会要求用户留下一个邮件地址作为联系方式，就象我们去银行开户时银行会让我们留个手机号码一样。为了证明注册的邮箱地址是本人的，系统会向邮箱发送一串验证码，用户收取该验证码后在注册页面上输入验证码连同其他信息发往后台进行验证。

二、创建SpringBoot工程项目

• 该工程项目主要实现步骤如下：

1. JWT认证
2. 集成mybatis-plus实现用户的增删改查
3. 编写Email工具类实现邮件的发送
4. 验证码邮件发送与验证码后台验证
5. 前端联调测试

2.1 JWT认证

• 前后端分离目前已成为互联网项目开发的业界标准，其核心思想就是前端（APP、小程序、H5页面等）通过调用后端的API接口，提交及返回JSON数据进行交互。
• 在前后端分离项目中，首先要解决的就是登录及授权的问题。微服务架构下，传统的session认证限制了应用的扩展能力，无状态的JWT认证方法应运而生，该认证机制特别适用于分布式站点的单点登录（SSO）场景

• 关于SpringBoot实现JWT的具体细节，请参考本人博文：
  《SpringBoot整合SpringSecurity实现JWT认证》

2.2 集成mybatis-plus实现用户的增删改查

1. 添加maven依赖

  <!-- mybatis-plus -->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.4.0</version>
        </dependency>

2. 在 application.yml 配置文件中添加 mysql 数据库的相关配置：

spring:
  datasource:
    druid:
      db-type: com.alibaba.druid.pool.DruidDataSource
      driverClassName: net.sf.log4jdbc.sql.jdbcapi.DriverSpy
      url: jdbc:log4jdbc:mysql://localhost:3306/startup_backend?serverTimezone=Asia/Shanghai&characterEncoding=utf8&useSSL=false&allowPublicKeyRetrieval=true
      username: root
      password: root

3. 编写用户表实体类：

/**
 * 用户表
 *
 * @author zhuhuix
 * @date 2020-04-03
 */
@ApiModel(value = "用户信息")
@Data
@SuperBuilder
@NoArgsConstructor
@AllArgsConstructor
@TableName("sys_user")
public class SysUser implements Serializable {
   

    @TableId(value = "id", type = IdType.AUTO)
    private Long id;

    private String userName;

    @JsonIgnore
    private String password;

    private String nickName;

    /**
     * 性别 0-未知 1-male,2-female
     */
    private Integer gender;

    /**
     * 头像地址
     */
    private String avatarUrl;

    private String country;

    private String province;

    private String city;


    @Email
    private String email;

    private String phone;

    private String remarks;

    private Boolean enabled;

    private Timestamp lastPasswordResetTime;

    @Builder.Default
    private Timestamp createTime = Timestamp.valueOf(LocalDateTime.now());

    @Builder.Default
    private Timestamp updateTime = Timestamp.valueOf(LocalDateTime.now());

}

4. 新增Mapper类 SysUserMapper.java：

• 直接继承 BaseMapper，这是 mybatis-plus 封装好的类，已经实现了基本的增删改查。

/**
 * 用户DAO接口
 *
 * @author zhuhuix
 * @date 2021-07-19
 */
@Mapper
public interface SysUserMapper extends BaseMapper<SysUser> {
   

}

5. 编写用户增删改查服务接口与实现类：

/**
 * 用户增删改查服务接口
 *
 * @author zhuhuix
 * @date 2020-04-03
 */
public interface SysUserService {
   

    /**
     * 增加用户
     *
     * @param user 待新增的用户
     * @return 增加成功的用户
     */
    SysUser create(SysUser user);

    /**
     * 删除用户
     *
     * @param user 待删除的用户
     * @return 删除成功的用户
     */
    Result<SysUser> delete(SysUser user);

    /**
     * 修改用户
     *
     * @param user 待修改的用户
     * @return 修改成功的用户
     */
    Result<SysUser> update(SysUser user);


    /**
     * 根据userName查找用户
     *
     * @param userName 用户帐号
     * @return 用户帐号对应的用户
     */
    SysUser findByUserName(String userName);

    /**
     * 判断注册使用的邮箱是否存在
     *
     * @param email 邮箱号
     * @return 是否找到
     */
    boolean registerEmailExist(String email);
}

/**
 * 用户增删改查实现类
 *
 * @author zhuhuix
 * @date 2020-04-03
 */
@Slf4j
@Service
@RequiredArgsConstructor
@Transactional(propagation = Propagation.SUPPORTS, readOnly = true, rollbackFor = Exception.class)
public class SysUserServiceImpl implements SysUserService {
   

    private final SysUserMapper sysUserMapper;

    @Override
    @Transactional(rollbackFor = Exception.class)
    public SysUser create(SysUser user) {
   
        return sysUserMapper.insert(user) > 0 ? user : null;
    }

    @Override
    @Transactional(rollbackFor = Exception.class)
    public Result<SysUser> delete(SysUser user) {
   
        QueryWrapper<SysUser> queryWrapper = new QueryWrapper<>();
        queryWrapper.lambda().eq(SysUser::getUserName, user.