文章目录提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档
- @[TOC](文章目录) Springboot 集成 AJ-Captcha 行为验证码实战
- 前言
- 一、引入依赖
- 二、yml 配置
- 三、将源码图片文件目录复制到自己项目
- 四、添加实现类
- 五、实现类指向
- 提示 注意项目有无拦截
Springboot 集成 AJ-Captcha 行为验证码实战 前言
提示：这里可以添加本文要记录的大概内容：
gitee 源码集成地址
https://gitee.com/anji-plus/captcha/tree/master/service/springboot
参考：
提示：以下是本篇文章正文内容，下面案例可供参考
一、引入依赖maven 依赖：
二、yml 配置com.anji-plus spring-boot-starter-captcha 1.3.0
aj:
captcha:
jigsaw: classpath:images/jigsaw
#滑动验证，底图路径，不配置将使用默认图片
##支持全路径
# 支持项目路径,以classpath:开头,取resource目录下路径,例：classpath:images/pic-click
pic-click: classpath:images/pic-click
# 对于分布式部署的应用，我们建议应用自己实现CaptchaCacheService，比如用Redis或者memcache，
# 参考CaptchaCacheServiceRedisImpl.java
# 如果应用是单点的，也没有使用redis，那默认使用内存。
# 内存缓存只适合单节点部署的应用，否则验证码生产与验证在节点之间信息不同步，导致失败。
# ！！！ 注意啦，如果应用有使用spring-boot-starter-data-redis，
# 请打开CaptchaCacheServiceRedisImpl.java注释。
# redis -----> SPI： 在resources目录新建META-INF.services文件夹(两层)，参考当前服务resources。
# 缓存local/redis...
cache-type: redis
# local缓存的阈值,达到这个值，清除缓存
cache-number: 1000
# local定时清除过期缓存(单位秒),设置为0代表不执行
timing-clear: 180
# 验证码类型default两种都实例化。
type: default
# 汉字统一使用Unicode,保证程序通过@value读取到是中文，可通过这个在线转换;yml格式不需要转换
# https://tool.chinaz.com/tools/unicode.aspx 中文转Unicode
# 右下角水印文字(我的水印)
water-mark: water-mark
# 右下角水印字体(不配置时，默认使用文泉驿正黑)
# 由于宋体等涉及到版权，我们jar中内置了开源字体【文泉驿正黑】
# 方式一：直接配置OS层的现有的字体名称，比如：宋体
# 方式二：自定义特定字体，请将字体放到工程resources下fonts文件夹，支持ttfttcotf字体
# aj.captcha.water-font=WenQuanZhengHei.ttf
# water-font: SourceHanSansCN-Normal.otf
# 点选文字验证码的文字字体(文泉驿正黑)
# aj.captcha.font-type=WenQuanZhengHei.ttf
# font-type: SourceHanSansCN-Normal.otf
# 校验滑动拼图允许误差偏移量(默认5像素)
slip-offset: 5
# aes加密坐标开启或者禁用(true|false)
aes-status: true
# 滑动干扰项(0/1/2)
interference-options: 1
history-data-clear-enable: true
# 接口请求次数一分钟限制是否开启 true|false
req-frequency-limit-enable: true
# 验证失败5次，get接口锁定
req-get-lock-limit: 5
# 验证失败后，锁定时间间隔,s
req-get-lock-seconds: 60
# get接口一分钟内请求数限制
req-get-minute-limit: 30
# check接口一分钟内请求数限制
req-check-minute-limit: 60
# verify接口一分钟内请求数限制
req-verify-minute-limit: 60
三、将源码图片文件目录复制到自己项目
添加背景图：
注意项目依赖redis
StringRedisTemplate 有注入
package com.abc.service.impl;
import com.anji.captcha.service.CaptchaCacheService;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.redis.core.StringRedisTemplate;
import org.springframework.stereotype.Service;
import java.util.concurrent.TimeUnit;
@Slf4j
@Service
@RequiredArgsConstructor
public class CaptchaCacheServiceRedisImpl implements CaptchaCacheService {
@Override
public String type() {
return "redis";
}
@Autowired
private StringRedisTemplate stringRedisTemplate;
@Override
public void set(String key, String value, long expiresInSeconds) {
stringRedisTemplate.opsForValue().set(key, value, expiresInSeconds, TimeUnit.SECONDS);
}
@Override
public boolean exists(String key) {
return stringRedisTemplate.hasKey(key);
}
@Override
public void delete(String key) {
stringRedisTemplate.delete(key);
}
@Override
public String get(String key) {
return stringRedisTemplate.opsForValue().get(key);
}
}
五、实现类指向
目录文件：META-INF/services/com.anji.captcha.service.CaptchaCacheService
文件里面指向自己实现类：
com.abc.service.impl.CaptchaCacheServiceRedisImpl
提示 注意项目有无拦截
默认调取，也可以自己重写Controller
1、获取验证码
/captcha/get
2、校验验证码
3、二次验签需要自己写
模仿源码：
https://gitee.com/anji-plus/captcha/blob/master/service/springboot/src/main/java/com/anji/captcha/demo/controller/LoginController.java
@PostMapping("/login")
public ResponseModel get(@RequestParam("captchaVerification") String captchaVerification) {
CaptchaVO captchaVO = new CaptchaVO();
captchaVO.setCaptchaVerification(captchaVerification);
ResponseModel response = captchaService.verification(captchaVO);
if(response.isSuccess() == false){
//验证码校验失败，返回信息告诉前端
//repCode 0000 无异常，代表成功
//repCode 9999 服务器内部异常
//repCode 0011 参数不能为空
//repCode 6110 验证码已失效，请重新获取
//repCode 6111 验证失败
//repCode 6112 获取验证码失败,请联系管理员
}else{
//自己代码
}
return response;
}
前台代码参考：
https://gitee.com/anji-plus/captcha/tree/master/view
