参考: https://blog.csdn.net/qq_42524288/article/details/110749086
之前发过springboot的三层架构和发送邮件的博客,所以这次来一个实质性的项目。
springboot实现邮件发送、异步功能
Spring boot 三层框架dao层、service层、controller层+实体model层
1、整体思路
本次采用qq邮箱。
用springboot实现自制邮箱注册和登录验证的项目,并用postman测试,还有前端页面化。
1.1、思路
注册:通过输入的邮箱发送验证码,检验前端传来的验证码是否和后台生成的一致,若一致,将数据写入数据库,完成注册;
登录:通过输入的邮箱查询密码,然后比较密码是否一致,一致就是登录成功。
1.2、项目文件结构图
2、准备
2.1、开启邮箱POP3/SMTP服务
登录qq邮箱后,点击左上方的设置,选择账户,如下图。
然后一直往下滑,看到如下图的POP3/SMTP服务,点击开启,应该会让绑定的手机号发个短信,然后会收到一个授权码,在appliction.properties配置中会用到。
2.2、创建一个Springboot项目
依赖可以选择web、mybatis、jdbc、mysql等等,请自行选择。
2.3、配置application.properties文件
打开application.properties文件,输入以下代码:
# 邮箱配置
# 平台地址,这里用qq邮箱
spring.mail.host = smtp.qq.com
# 填自己邮箱
spring.mail.username = xxxxxx@qq.com
# 之前手机获取的授权码
spring.mail.password = xxxxxx
# 开启加密验证
spring.mail.properties.mail.smtp.ssl.enable=true
##编码格式
spring.mail.default-encoding=UTF-8
# 数据库配置
# 服务器的ip,这里填了localhost
spring.datasource.url=jdbc:mysql://localhost:3306/email?useSSL=true&characterEncoding=utf-8&serverTimezone=UTC
# 账号
spring.datasource.username=root
# 密码
spring.datasource.password=password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
2.4、创建数据库
数据库结构如下:
创建一个数据库mail
CREATE DATABASE email;
在mail库里创建一个User表
CREATE TABLE `user` (
`id` int(20) NOT NULL AUTO_INCREMENT,
`username` varchar(255) NOT NULL,
`password` varchar(255) NOT NULL,
`email` varchar(255) NOT NULL,
PRIMARY KEY (`id`)
)
3、三层架构
主要展示一下每个文件是如何编写的。
如最上边的项目结构图。controller包是和前端对接的,mapper包中是接口,pojo是实体类,service层是逻辑代码,vo包是前端发送数据暂时保存。
执行流程: 使用postman发送请求,controller中会接受,然后调用service中的逻辑代码,service会调用的mapper中接口,mapper的对应的xml实现对数据库的各种操作。
3.1、pojo
实体层
User.java
用lombok简化了代码。
package com.example.demo.pojo;
import lombok.Data;
@Data
public class User {
private String username;
private String password;
private String email;
}
3.2、mapper层
数据持久层
3.2.1、UserMapper.java
package com.example.demo.mapper;
import com.example.demo.pojo.User;
import org.apache.ibatis.annotations.Mapper;
import org.springframework.stereotype.Repository;
@Mapper
@Repository
public interface UserMapper {
/**
* 注册,插入数据
* @param user
*/
void insertUser(User user);
/**
* 根据邮箱查询
* @param email
* @return
*/
User GetByEmail(String email);
}
3.2.2、UserMapper.xml
在resources包下创建mapper包,用来放xml,然后再这个包中创建UserMapper.xml,内容如下。
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
<mapper namespace="com.example.demo.mapper.UserMapper">
<!--插入数据-->
<insert id="insertUser" parameterType="com.example.demo.pojo.User">
insert into user (username, password, email) values (#{username}, #{password}, #{email})
</insert>
<!--查询-->
<select id="GetByEmail" parameterType="com.example.demo.pojo.User">
select * from user where email = #{email}
</select>
</mapper>
3.3、service层
业务逻辑层
3.3.1、UserVo.java
package com.example.demo.service.vo;
import lombok.Data;
@Data
public class UserVo {
private String username;
private String password;
private String email;
// 验证码
private String code;
}
3.3.2、UserVoToUser.jaca
package com.example.demo.service.vo;
import com.example.demo.pojo.User;
public class UserVoToUser {
/**
* 将表单中的对象转化为数据库中存储的用户对象(剔除表单中的code)
* @param userVo
* @return
*/
public static User toUser(UserVo userVo) {
//创建一个数据库中存储的对象
User user = new User();
//传值
user.setUsername(userVo.getUsername());
user.setPassword(userVo.getPassword());
user.setEmail(userVo.getEmail());
// 返回包装后的对象
return user;
}
}
3.3.3、MailService.java
服务层接口
package com.example.demo.service;
import com.example.demo.service.vo.UserVo;
import org.springframework.beans.factory.annotation.Autowired;
import javax.servlet.http.HttpSession;
public interface MailService {
public boolean sendMimeMail( String email, HttpSession session);
public String randomCode();
public boolean registered(UserVo userVo, HttpSession session);
public boolean loginIn(String email, String password);
}
3.3.4、MailServiceImpl.java
服务层接口实现类
package com.example.demo.service;
import com.example.demo.mapper.UserMapper;
import com.example.demo.pojo.User;
import com.example.demo.service.vo.UserVo;
import com.example.demo.service.vo.UserVoToUser;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.mail.*;
import org.springframework.mail.javamail.*;
import org.springframework.stereotype.Service;
import javax.servlet.http.HttpSession;
import java.util.Random;
@Service
public class MailServiceImpl implements MailService {
@Autowired
private UserMapper userMapper;
@Autowired
private JavaMailSenderImpl mailSender;
// application.properties配置的值
@Value("${spring.mail.username}")
private String from;
/**
* 给前端输入的邮箱,发送验证码
* @param email
* @param session
* @return
*/
@Override
public boolean sendMineMail(String email, HttpSession session) {
try {
SimpleMailMessage simpleMailMessage = new SimpleMailMessage();
// 生成随机数
String code = randomCode();
// 将随机数放置到session中
session.setAttribute("email", email);
session.setAttribute("code", code);
simpleMailMessage.setSubject("验证码邮件"); // 主题
simpleMailMessage.setText("您收到的验证码是:"+code); // 内容
simpleMailMessage.setFrom("fzt3058852685@qq.com"); // 发件人
simpleMailMessage.setTo("fzt3058852685@qq.com"); // 收件人
mailSender.send(simpleMailMessage); // 发送
return true;
} catch (Exception e) {
e.printStackTrace();
return false;
}
}
/**
* 随机生成6位数的验证码
* @return String code
*/
@Override
public String randomCode() {
StringBuilder str = new StringBuilder();
Random random = new Random();
for(int i = 0;i < 6; i++) {
str.append(random.nextInt(10));
}
return str.toString();
}
/**
* 检验验证码
* @param userVo
* @param session
* @return
*/
@Override
public boolean registered(UserVo userVo, HttpSession session) {
// 获取session中的验证信息
String email = (String) session.getAttribute("email");
String code = (String) session.getAttribute("code");
// 获取表单中的提交的验证信息
String voCode = userVo.getCode();
//如果emial数据为空或者不一致都失败
if(email == null || email.isEmpty()) {
//return "error,请重新注册";
return false;
}else if (!code.equals(voCode)){
//return "error,请重新注册";
return false;
}
// 保存数据
User user = UserVoToUser.toUser(userVo);
// 将数据写进数据库
userMapper.insertUser(user);
// 跳转成功页面
return true;
}
/**
* 通过输入email查询password,然后比较两个password,如果一样,登录成功
* @param email
* @param password
* @return
*/
@Override
public boolean loginIn(String email, String password) {
User user = userMapper.GetByEmail(email);
if(!user.getPassword().equals(password)) {
return false;
}
System.out.println("登录成功:数据库密码是:" + user.getPassword());
return true;
}
}
3.4、controller层
控制器层
3.4.1、UserController.java
package com.example.demo.controller;
import com.example.demo.service.MailService;
import com.example.demo.service.vo.UserVo;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import javax.servlet.http.HttpSession;
@Controller
public class UserController {
@Autowired
private MailService mailService;
@PostMapping(value = "/sendEmail")
@ResponseBody
public String sendEmail(String email, HttpSession httpSession) {
mailService.sendMineMail(email, httpSession);
return "sucess";
}
@PostMapping(value = "/regist")
@ResponseBody
public String regist(UserVo userVo, HttpSession httpSession) {
mailService.registered(userVo, httpSession);
return "sucess";
}
@PostMapping(value = "/login")
@ResponseBody
public String login(String email, String password) {
mailService.loginIn(email, password);
return "sucess";
}
}
4、postman测试
在测试之前,要先启动项目。
4.1、测试发送邮件
请求url:
http://localhost:8080/sendEmail?email=******@qq.com
ip改成自己填的ip,邮箱改成自己的邮箱,请求方式填POST,点击send。