前端功能问题系列文章,点击上方合集↑
序言
大家好,我是大澈!
本文约3500+
字,整篇阅读大约需要5分钟。
本文主要内容分三部分,第一部分是需求分析,第二部分是实现步骤,第三部分是问题详解。
如果您只需要解决问题,请阅读第一、二部分即可。
如果您有更多时间,进一步学习问题相关知识点,请阅读至第三部分。
1. 需求分析
在登录页面,输入邮箱,点击发送验证码,此时会弹出拼图验证。
用户向右滑动滑块,到达指定缺口位置,就会验证成功。若验证失败,则会刷新拼图,需要重新滑动。
当拼图验证成功后,发送验证码按钮就会显示数字倒计时效果,然后此时会在对应邮箱收到验证码。
在正确输入邮箱验证码之后,点击登录按钮,正确认证并登录成功。
挺常用、也挺有趣的一个功能需求。
2. 实现步骤
2.1 实现前的一些说明
本次需求大致分为两
部分:点击发送验证码按钮时的拼图验证、常用的邮箱验证码发送。
实现的话,我们会从前端、后端两方面入手,然后给出具体代码实例。
拼图验证在前端实现,利用了vue3-slide-verify
库。
邮箱验证码发送在后端实现,利用了Spring
框架中的JavaMailSender
类,然后邮件发送服务使用的是QQ邮箱。
关于QQ邮箱,在编写后端接口前,一定要记得提前做一些配置
:
-
先在QQ邮箱首页-设置-账号-服务中,把服务全部开启。
-
然后再扫码登录,获取授权码,一定要把这个授权码
保存
好,不然后面后端接口没法写了。
话不多说,开搞朋友们!
2.2 编写前端代码
先安装功能依赖:
npm install --save vue3-slide-verify
再看模版代码,分为两部分
:一个是表单部分,一个是拼图弹框部分。
在表单部分中,给发送验证码按钮一个点击事件,点击让拼图弹框显示。然后禁用此按钮,同时countdown
变量开始倒计时递减变化。
在拼图弹框部分中,主要是定义了两个事件函数。fail
是操作失败的回调,success
是操作成功的回调。再就是slider-text
中,定义的是滑块中显示的文字提示。
模版代码:
<template><div class="box"><!--表单部分--><el-form :model="dataForm" label-width="120px"><el-form-item label="邮箱:"><el-input v-model="dataForm.email" /></el-form-item><el-form-item label="验证码:"><el-input v-model="dataForm.code" /><el-button type="warning" @click="visible = true" :disabled="isSendingCode || countdown > 0">{{ countdown > 0 ? `重新发送(${countdown})` : '发送验证码' }}</el-button></el-form-item><el-form-item><el-button type="primary" @click="onSubmit" >登录</el-button></el-form-item></el-form><!--拼图部分--><el-card v-if="visible"><slide-verifyref="slide"slider-text="向右滑动->":imgs="images"@success="onSuccess"@fail="onFail"style="margin: auto;"></slide-verify></el-card></div>
</template>
再看逻辑代码,主要分为两部分
:一个是拼图验证成功和失败的回调,一个是调用了发送邮箱验证码和认证登录这两个接口。
最先做的,是先引入拼图依赖的对象和样式。
拼图验证成功后,在里面去调用发送邮箱验证码的接口。
按钮倒计时效果,以及发送邮箱验证码、认证登录这两个接口的调用,此处不再赘述,可参考之前如何实现短信验证登录的那篇文章。
再就是,拼图的图片资源数组
,可为空。如果数组为空,则会自动下载使用随机网络图片。
逻辑代码:
<script setup>
import {reactive, ref} from 'vue'
import Axios from '../api/axios';
import {ElMessage} from "element-plus";
// 引入依赖对象
import SlideVerify from "vue3-slide-verify";
// 引入依赖样式
import "vue3-slide-verify/dist/style.css";const dataForm = reactive({// 863074625@qq.comemail: '863074625@qq.com',code: '',
})// 拼图显示标识
const visible = ref(false);
// 拼图的图片资源 可为空,此时会自动下载使用随机网络图片
const images = reactive(['https://t7.baidu.com/it/u=2609096218,1652764947&fm=193&f=GIF','https://t7.baidu.com/it/u=2541348729,1193227634&fm=193&f=GIF','https://t7.baidu.com/it/u=2673836711,2234057813&fm=193&f=GIF',
])// 拼图验证成功回调
const onSuccess = () => {ElMessage.success("验证成功!");// 隐藏拼图visible.value = false;// 拼图验证成功,发送邮箱验证码sendVerificationCode();
}// 拼图验证失败回调
const onFail=()=>{ElMessage.error("验证不通过!")
}// 发送验证码按钮禁用标识
let isSendingCode = ref(false);
// 倒计时变量
let countdown = ref(0);// 发送验证码,调验证码接口
const sendVerificationCode = () => {// 检查邮箱是否有效// ...// 调发送邮箱接口Axios.get('/admin/sendEmail', {params: {email: dataForm.email,}}).then(res => {ElMessage.success(res.data)}).catch(error => {console.error(error);});isSendingCode.value = true;// 设置倒计时时间,这里假设为10秒countdown.value = 10;// 倒计时效果const countdownInterval = setInterval(() => {countdown.value--;if (countdown.value <= 0) {clearInterval(countdownInterval);isSendingCode.value = false;}}, 1000);
}// 登录,调检验验证码和密码的登录接口
const onSubmit = () => {// 调发送邮箱接口Axios.post('/admin/checkEmailLogin', {email: dataForm.email,code: dataForm.code,}).then(res => {ElMessage.success(res.data)}).catch(error => {console.error(error);});
}
</script>
关于vue3-slide-verify
拼图库的属性和回调详细整理,如果朋友你有空余时间,可见文章第三
部分。
2.3 编写后端接口
对于后端实现,要先引入邮箱发送依赖,再做一些服务的配置,再编写两个接口,一个是发送邮箱验证码接口,一个是认证登录接口。
Pom.xml
中引入依赖代码:
<!--redis-->
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<!-- 邮件发送pom支持 -->
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-mail</artifactId>
</dependency>
application.yml
中写入QQ邮箱服务的配置,注意邮箱password
,用的就是之前保存的授权码
:
spring:datasource:url: jdbc:mysql://localhost:3306/mall_tiny?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghaiusername: rootpassword: 123456redis:host: localhost # Redis服务器地址database: 0 # Redis数据库索引(默认为0)port: 6379 # Redis服务器连接端口password: # Redis服务器连接密码(默认为空)timeout: 3000ms # 连接超时时间(毫秒)# 发送邮箱mail:username: 317994054@qq.com# 授权码password: axpaqqxaejiecaaghost: smtp.qq.com
再编写接口Controller
层代码:
/**
* 发送邮箱
*/
@ApiOperation(value = "发送邮箱")
@GetMapping("/sendEmail")
public CommonResult<String> toSendEmail(@RequestParam("email") String email){String message = adminService.toSendEmail(email);return CommonResult.success(message);
}/**
* 检验邮箱验证码,校验成功后登录
*/
@ApiOperation(value = "检验邮箱验证码,校验成功后登录")
@PostMapping("/checkEmailLogin")
public CommonResult<String> checkEmailLogin(@RequestBody ToCheckEmailLoginDTO toCheckEmailLoginDTO){String checkLogin = adminService.checkEmailLogin(toCheckEmailLoginDTO.getEmail(), toCheckEmailLoginDTO.getCode());// 省略用户密码加密校验// ...// 省略JWT认证// ...return CommonResult.success(checkLogin);
}
再编写接口Service
层代码:
在发送邮箱验证码接口业务层中,先生成一个随字符串Code
,再调用JavaMailSender
的send
方法发送验证码,并把验证码存入Redis
中。
在认证登录接口业务层中,将前端传过来的验证码与Redis
中存的验证码进行比较,校验成功执行下一步登录操作。
@Autowired
JavaMailSender javaMailSender;/**
* 发送邮箱
*/
@Override
public String toSendEmail(String email) {//1.判定验证码是否过期String code = redisTemplate.opsForValue().get(email);if (!StringUtils.isEmpty(code)){return email+":"+"验证码未过期";}//2.已过期/无验证码 生成验证码//随机生成字符串 做验证码int toCode = (int) (Math.random() * (50000 - 40000) + 40000);code=Integer.toString(toCode);// 发送邮箱SimpleMailMessage simpleMailMessage = new SimpleMailMessage();simpleMailMessage.setSubject("项目登录验证码");simpleMailMessage.setText("尊敬的:"+email+"您的注册校验验证码为:" + code + "有效期5分钟");simpleMailMessage.setTo(email);simpleMailMessage.setFrom("317994054@qq.com");javaMailSender.send(simpleMailMessage);String toSendMes = "OK";if (ComConstants.OK.equals(toSendMes)){//redis 中存放 5分钟过期redisTemplate.opsForValue().set(email,code,ComConstants.NUM_FIVE, TimeUnit.MINUTES);//3.发送短信return "邮箱发送成功";}return "邮箱发送异常";
}/**
* 检验邮箱验证码,校验成功后登录
*/
@Override
public String checkEmailLogin(String email, String code) {//1.redis 验证码校验String redisCode = redisTemplate.opsForValue().get(email);if (code.equals(redisCode)){return "登入成功";}return "登入失败";
}
3. 问题详解
3.1 拼图库的属性和回调详细整理
关于vue3-slide-verify
拼图库的属性
说明:
关于vue3-slide-verify
拼图库的回调
说明:
最后附上,vue3-slide-verify
拼图库官方文档地址:https://www.npmjs.com/package/vue3-slide-verify
。
3.2 关于实现各种验证登录功能的心得
在项目中我们做登录功能时,会用到各种验证码登录、各种机器验证。这些验证的作用都是为了安全,这些验证的实现也都是大同小异。
对于验证码登录,包括但不限于短信验证码、邮箱验证码、图形验证码登录,无论是前端还是后端,实现起来完全就可以是把代码复制粘贴。
所以,这些我都有写文章做整理,方便朋友们大家使用,也方便自己使用。
对于登录表单各种机器验证,包括但不限于拼图验证、选择验证等,前端实现起来更是五花八门。本来这些验证的实现我都想整理的,最后感觉没有必要,因为这些东西,真的是充满着共同点,熟悉了其中一种,其它的类型做起来也只会是得心应手了。
最后的最后,感谢朋友们的支持,感谢朋友们花时间的耐心阅读,谢谢!
结语
建立这个平台的初衷:
-
打造一个仅包含前端问题的问答平台,让大家高效搜索处理同样问题。
-
通过不断积累问题,一起练习逻辑思维,并顺便学习相关的知识点。
-
遇到难题,遇到有共鸣的问题,一起讨论,一起沉淀,一起成长。
感谢关注微信公众号:“程序员大澈”,然后加入问答群
,让我们一起解决实现所有BUG!