SpringBoot实现业务中常用的图形验证码
创始人
2025-05-28 18:50:55
0

图形验证码的必要性

图形验证码是验证码的一种,有防止黑客对某一特定注册用户用程序暴力破解私人信息、恶意破解密码、刷票、论坛灌水的作用。

图形验证码是一种区分用户是计算机还是人的公共全自动程序。验证码是现在很多网站通行的方式,由计算机生成并评判,但是只有人类才能解答。

在常用的网站业务中我们不难看出很多登录注册业务上都采用了图形验证码的方式。今天记录一个图形验证码以后端的方式实现的逻辑。

实现效果

在登录注册业务上集成图片中验证码后的是效果如下图所示:

工具说明

这里主要推荐Hutool工具中的captcha包中的图形验证码来实现。

验证码功能位于cn.hutool.captcha包中,核心接口为ICaptcha,此接口定义了以下方法:

  • createCode 创建验证码,实现类需同时生成随机验证码字符串和验证码图片

  • getCode 获取验证码的文字内容

  • verify 验证验证码是否正确,建议忽略大小写

  • write 将验证码写出到目标流中

其中write方法只有一个OutputStream,ICaptcha实现类可以根据这个方法封装写出到文件等方法。

AbstractCaptcha为一个ICaptcha抽象实现类,此类实现了验证码文本生成、非大小写敏感的验证、写出到流和文件等方法,通过继承此抽象类只需实现createImage方法定义图形生成规则即可。

生成方式可参考Hutool官网给定的方式:

LineCaptcha 线段干扰的验证码

生成效果大致如下:

//定义图形验证码的长和宽LineCaptcha lineCaptcha =CaptchaUtil.createLineCaptcha(200,100);//图形验证码写出,可以写出到文件,也可以写出到流
lineCaptcha.write("d:/line.png");//输出codeConsole.log(lineCaptcha.getCode());//验证图形验证码的有效性,返回boolean值
lineCaptcha.verify("1234");//重新生成验证码
lineCaptcha.createCode();
lineCaptcha.write("d:/line.png");//新的验证码Console.log(lineCaptcha.getCode());//验证图形验证码的有效性,返回boolean值
lineCaptcha.verify("1234");

可以看出,这种方式特别简便,大部分实现逻辑已经被封装在工具类内部,并不需要我们了解具体的实现。并且可以验证图形中的验证码信息,非常方便该功能在登陆注册等业务上的验证码校验。

但是需要注意的是,这种方式一般用于输出一个png图片,如果后端处理生成图片后怎么在前端界面上展示也是我们需要考虑的问题。

思路说明

不过Hutool也给出了另外的输入输出流的方式,因此我们可以在后端利用前端的请求,调用图形验证码生成逻辑相应的图形输出流,然后在前端通过指定的流解析,将图形验证码展示在前端界面上。另外在处理逻辑上,在生成图片输出流的同时去获取图心中的验证码并将验证码给信息存入Redis缓存中,当用户在登陆或注册模块中输入相应信息时,将前端界面的数据代入后端一起校验,如果某个值有错,将对应的错误信息反馈给用户。

实现方法

1,导入依赖

首先需要导入Hutool的工具包,至于项目构建的SpringBoot依赖并不在这里一一列举。这里主要是需要使用captcha的依赖,怕麻烦的也可以将Hutool所有的项目依赖hutool-all直接导入:

cn.hutoolhutool-all5.7.19

依赖加载完毕后,就可以使用CaptchaUtil这个工具类了。

2,构建业务接口

然后就通过工具类构建图形验证码构建接口

 /*** 获取验证码** @return*/@GetMapping("getCode")public Result> getCode() {LineCaptcha lineCaptcha = CaptchaUtil.createLineCaptcha(200, 100);String verify = IdUtil.simpleUUID();//图形验证码写出,可以写出到文件,也可以写出到流FastByteArrayOutputStream os = new FastByteArrayOutputStream();lineCaptcha.write(os);String code = lineCaptcha.getCode();
//        缓存一分钟的验证码redisTemplate.opsForValue().set(verify, code, Duration.ofMinutes(1));ConcurrentHashMap map = new ConcurrentHashMap<>(5);//验证码对应的redis上的uuidmap.put("uuid", verify);//图片上的验证码map.put("code", code);//将图片转换成输出流传到前端上map.put("img",Base64.encode(os.toByteArray()));return Result.ok(map);}

这里我们将图形验证码写入到输出流,并通过Base64进行编码转换,当前端获取后端请求后的数据后,将“img”对应的输出流以"data:image/gif;base64,"的方式解析出来,这样图片就能成功显示在界面上了。

为了方便校验,这里也为每个请求生成的图形验证码指定一个与之对应的随机id,并为其设置一定的缓存时间,以便在业务中校验。这样在前端界面我们每次点击以及验证码图片就相当于向后端请求一次。(所以这只是一种实现方式,但是并不太可取,毕竟大量请求会消耗服务器)。

3,后端登录功能上集成图形验证码

@ApiOperation(value = "管理员登录接口")@PostMapping("/login")@PassTokenpublic Result login(@RequestBody @Validated LoginDto loginDto, BindingResult result) {if (result.hasErrors()) {return Result.fail(null).message("信息输入不正确");}//获取uuidString uuid = loginDto.getUuid();//获取验证码String code = loginDto.getCode();
//        //验证验证码是否正确if (!Objects.equals(redisTemplate.opsForValue().get(uuid), code)) {log.info("判断结果{}",!Objects.equals(redisTemplate.opsForValue().get(uuid), code));//错误则返回前端并提示return Result.fail(null).message("验证码错误,请重新验证");}//验证成功则清除redis内的验证码缓存redisTemplate.delete(uuid);Admin admin = adminService.login(loginDto.getUsername(), loginDto.getPassword());if (!StringUtils.isEmpty(admin)) {return Result.ok(admin).message("欢迎管理员~!");}return Result.fail(customer).message("用户名或密码错误,请重新登录!");}

当用户登录时,需要在前端输入指定的登录信息,请求登录业务接口后,此时后端首先获取图形验证码的随机id和用户填写的验证码信息,并通过uuid去redis中找到存储缓存的后端生成的验证码信息,并与之对比。如果验证码信息不对,返回给前端提示信息-》"验证码错误,请重新验证",只有通过后即可验证用户的账号密码的准确性并反馈对应的提示信息。

4,部分前端参考

这里也给出前端登录页面的具体信息可供大家参考。

前端主要是采用vue框架搭配Axios使用实现前后端请求数据交互,界面利用ElementPlus搭建,这里不做详述。重点是处理请求后,将验证码的图形输出流在前端以字符拼接的形式进行处理。

request.get('/getCode').then(res => {if (res.code === 200) {//处理Base64编码后的图片输出流this.codeUrl = "data:image/gif;base64," + res.data.img;this.loginForm.uuid = res.data.uuid;this.code = res.data.code}});

至此,图形验证码功能就实现了。因为主要是通过后端实现的,因此可能存在一定的性能消耗,仅作为一个学习参考。

相关内容

热门资讯

前端-session、jwt 目录:   (1)session (2&#x...
linux入门---制作进度条 了解缓冲区 我们首先来看看下面的操作: 我们首先创建了一个文件并在这个文件里面添加了...
关于测试,我发现了哪些新大陆 关于测试 平常也只是听说过一些关于测试的术语,但并没有使用过测试工具。偶然看到编程老师...
前缀和与对数器与二分法 1. 前缀和 假设有一个数组,我们想大量频繁的去访问L到R这个区间的和,...
nodejs:本地安装nvm实... 一、背景-使用不同版本node的原因 vue3+ts、nuxt3版本,node...
JAVA集合知识整理 Java集合知识整理 HashMap相关 HashMap的底层数据结构:jdk1.8之...
无刷直流电机介绍及单片机控制实... 无刷直流电机介绍及单片机控制实例前言基本概念优势与劣势使用寿命基本结构使用单片机控制实例电子调速器&...
fwdiary(2) dp2 1.传纸条  AcWing 275. 传纸条 - AcWing 走两条路,走一条最大的...
常用的DOS命令 常用的DOS命令 DOS(Disk Operating System,磁...
<C++> 类和对象(下) 1.const成员函数将const修饰的“成员函数”称之为const成员函数,cons...