diff --git a/pom.xml b/pom.xml
index cfc80c1..3f82268 100644
--- a/pom.xml
+++ b/pom.xml
@@ -4,7 +4,7 @@
4.0.0
cloud.tianai.captcha
tianai-captcha
- 1.1
+ 1.2
tianai-captcha
滑块验证码
diff --git a/readme.md b/readme.md
index d636c2e..f4cd59b 100644
--- a/readme.md
+++ b/readme.md
@@ -9,19 +9,21 @@
- java获取滑块验证码例子
+## 快速上手
+1. 导入xml
```xml
cloud.tianai.captcha
tianai-captcha
- 1.1
+ 1.2
```
-
-
+2. 使用 `SliderCaptchaTemplate`获取滑块验证码
```java
-public static void main(String[] args) {
- SliderCaptchaTemplate sliderCaptchaTemplate = new SliderCaptchaTemplate();
+public static void main(String[] args) throws InterruptedException {
+ SliderCaptchaResourceManager sliderCaptchaResourceManager = new DefaultSliderCaptchaResourceManager();
+ DefaultSliderCaptchaTemplate sliderCaptchaTemplate = new DefaultSliderCaptchaTemplate(sliderCaptchaResourceManager, true);
// 生成滑块图片
SliderCaptchaInfo slideImageInfo = sliderCaptchaTemplate.getSlideImageInfo();
// 获取背景图片的base64
@@ -30,18 +32,66 @@ public static void main(String[] args) {
slideImageInfo.getSliderImage();
// 获取滑块被背景图片的百分比, (校验图片使用)
Float xPercent = slideImageInfo.getXPercent();
+
+ System.out.println(slideImageInfo);
}
```
-- 添加自定义背景图片例子
+# 常用接口
+- 添加自定义图片资源
```java
-addResource(getClassLoader().getResource(DEFAULT_SLIDER_IMAGE_RESOURCE_PATH.concat("/1.jpg")));
+ ResourceStore resourceStore = sliderCaptchaResourceManager.getResourceStore();=
+ // 添加classpath目录下的 aa.jpg 图片
+ resourceStore.addResource(new Resource(ClassPathResourceProvider.NAME, "/aa.jpg"));
+ // 添加远程url图片资源
+ resourceStore.addResource(new Resource(URLResourceProvider.NAME, "http://www.xx.com/aa.jpg"));
+ // 内置了通过url 和 classpath读取图片资源,如果想扩展可实现 ResourceProvider 接口,进行自定义扩展
```
-- 添加自定义模板(滑块的颜色和形状)
+- 添加自定义模板资源
```java
-Map template1 = new HashMap<>(4);
-template1.put(ACTIVE_IMAGE_NAME, getClassLoader().getResource(DEFAULT_SLIDER_IMAGE_TEMPLATE_PATH.concat("/1/active.png")));
-template1.put(CUT_IMAGE_NAME, getClassLoader().getResource(DEFAULT_SLIDER_IMAGE_TEMPLATE_PATH.concat("/1/cut.png")));
-template1.put(FIXED_IMAGE_NAME, getClassLoader().getResource(DEFAULT_SLIDER_IMAGE_TEMPLATE_PATH.concat("/1/fixed.png")));
-template1.put(MATRIX_IMAGE_NAME, getClassLoader().getResource(DEFAULT_SLIDER_IMAGE_TEMPLATE_PATH.concat("/1/matrix.png")));
-addTemplate(template1);
-```
\ No newline at end of file
+ ResourceStore resourceStore = sliderCaptchaResourceManager.getResourceStore();=
+ Map template1 = new HashMap<>(4);
+ template1.put(SliderCaptchaConstant.TEMPLATE_ACTIVE_IMAGE_NAME, new Resource(ClassPathResourceProvider.NAME,"/active.png"));
+ template1.put(SliderCaptchaConstant.TEMPLATE_FIXED_IMAGE_NAME, new Resource(ClassPathResourceProvider.NAME, "/fixed.png"));
+ template1.put(SliderCaptchaConstant.TEMPLATE_MATRIX_IMAGE_NAME, new Resource(ClassPathResourceProvider.NAME, "/matrix.png"));
+ resourceStore.addTemplate(template1);
+
+ // 模板与三张图片组成 滑块、凹槽、背景图
+ // 同样默认支持 classpath 和 url 两种获取图片资源, 如果想扩展可实现 ResourceProvider 接口,进行自定义扩展
+```
+- 清除内置的图片资源和模板资源
+ ```java
+ //为方便快速上手 系统本身自带了一张图片和两套滑块模板,如果不想用系统自带的可以不让它加载系统自带的
+ // 第二个构造参数设置为false时将不加载默认的图片和模板
+ SliderCaptchaTemplate sliderCaptchaTemplate = new DefaultSliderCaptchaTemplate(sliderCaptchaResourceManager, false);
+```
+- 扩展,对`DefaultSliderCaptchaTemplate`增加了缓存模块
+```java
+public static void main(String[] args) throws InterruptedException {
+ // 使用 CacheSliderCaptchaTemplate 对滑块验证码进行缓存,使其提前生成滑块图片
+ // 参数一: 真正实现 滑块的 SliderCaptchaTemplate
+ // 参数二: 默认提前缓存多少个
+ // 参数三: 出错后 等待xx时间再进行生成
+ // 参数四: 检查时间间隔
+ SliderCaptchaResourceManager sliderCaptchaResourceManager = new DefaultSliderCaptchaResourceManager();
+ DefaultSliderCaptchaTemplate sliderCaptchaTemplate = new CacheSliderCaptchaTemplate(new DefaultSliderCaptchaTemplate(sliderCaptchaResourceManager, true), 10, 1000, 100);
+ // 生成滑块图片
+ SliderCaptchaInfo slideImageInfo = sliderCaptchaTemplate.getSlideImageInfo();
+ // 获取背景图片的base64
+ String backgroundImage = slideImageInfo.getBackgroundImage();
+ // 获取滑块图片
+ slideImageInfo.getSliderImage();
+ // 获取滑块被背景图片的百分比, (校验图片使用)
+ Float xPercent = slideImageInfo.getXPercent();
+
+ System.out.println(slideImageInfo);
+}
+```
+- 自定义 `ResourceProvider` 实现自定义文件读取策略, 比如 oss之类的
+
+```java
+ // 实现了 ResourceProvider 后
+ SliderCaptchaResourceManager sliderCaptchaResourceManager = new DefaultSliderCaptchaResourceManager();
+ DefaultSliderCaptchaTemplate sliderCaptchaTemplate = new DefaultSliderCaptchaTemplate(sliderCaptchaResourceManager, true);
+ // 注册
+ sliderCaptchaResourceManager.registerResourceProvider(new CustomResourceProvider());
+```
diff --git a/src/main/java/cloud/tianai/captcha/template/slider/CacheSliderCaptchaTemplate.java b/src/main/java/cloud/tianai/captcha/template/slider/CacheSliderCaptchaTemplate.java
index baa82eb..1319c3c 100644
--- a/src/main/java/cloud/tianai/captcha/template/slider/CacheSliderCaptchaTemplate.java
+++ b/src/main/java/cloud/tianai/captcha/template/slider/CacheSliderCaptchaTemplate.java
@@ -3,9 +3,6 @@ package cloud.tianai.captcha.template.slider;
import lombok.SneakyThrows;
import lombok.extern.slf4j.Slf4j;
-import java.net.URL;
-import java.util.List;
-import java.util.Map;
import java.util.concurrent.ConcurrentLinkedQueue;
import java.util.concurrent.ScheduledExecutorService;
import java.util.concurrent.ScheduledThreadPoolExecutor;
@@ -25,12 +22,23 @@ public class CacheSliderCaptchaTemplate implements SliderCaptchaTemplate {
private AtomicInteger pos = new AtomicInteger(0);
private SliderCaptchaTemplate target;
private int size;
+ /** 等待时间,一般报错或者拉取为空时会休眠一段时间再试. */
+ private int waitTime = 1000;
+ /** 调度器检查缓存的间隔时间. */
+ private int period = 100;
public CacheSliderCaptchaTemplate(SliderCaptchaTemplate target, int size) {
this.target = target;
this.size = size;
}
+ public CacheSliderCaptchaTemplate(SliderCaptchaTemplate target, int size, int waitTime, int period) {
+ this.target = target;
+ this.size = size;
+ this.waitTime = waitTime;
+ this.period = period;
+ }
+
/**
* 记的初始化调度器
*/
@@ -57,22 +65,26 @@ public class CacheSliderCaptchaTemplate implements SliderCaptchaTemplate {
pos.incrementAndGet();
}
} else {
- // 休眠500毫秒
- try {
- TimeUnit.MILLISECONDS.sleep(500);
- } catch (InterruptedException ignored) {
- }
+ sleep();
}
-
}
} catch (Exception e) {
// cache所有
log.error("缓存队列扫描时出错, ex", e);
+ // 休眠
+ sleep();
}
- }, 0, 100, TimeUnit.MILLISECONDS);
+ }, 0, period, TimeUnit.MILLISECONDS);
log.info("缓存滑块验证码调度器初始化完成: size:{}", size);
}
+ private void sleep() {
+ try {
+ TimeUnit.MILLISECONDS.sleep(waitTime);
+ } catch (InterruptedException ignored) {
+ }
+ }
+
@SneakyThrows
@Override
public SliderCaptchaInfo getSlideImageInfo() {
@@ -88,60 +100,21 @@ public class CacheSliderCaptchaTemplate implements SliderCaptchaTemplate {
}
@Override
- public void addResource(URL url) {
- target.addResource(url);
+ public SliderCaptchaInfo getSlideImageInfo(String targetFormatName, String matrixFormatName) {
+ return target.getSlideImageInfo(targetFormatName, matrixFormatName);
}
- @Override
- public void addTemplate(Map template) {
- target.addTemplate(template);
- }
-
- @Override
- public void setResource(List resources) {
- target.setResource(resources);
- }
-
- @Override
- public void setTemplates(List