苞米豆 — 谷歌验证码快速启动器 1.1.0 发布

小锅盖
 小锅盖
发布于 2018年07月20日
收藏 23

https://gitee.com/baomidou/kaptcha-spring-boot-starter

修复了一个重复校验引起的Np bug

支持了jdk 1.7

简介

kaptcha-spring-boot-starter 基于 springBoot 和 Google Kaptcha 验证码组件,支持jdk1.7+,kaptcha-spring-boot-starter可以很方便的集成验证码到你的系统中。

如何使用

  1. 引入 kaptcha-datasource-spring-boot-starter。

<dependency>
  <groupId>com.baomidou</groupId>
  <artifactId>kaptcha-spring-boot-starter</artifactId>
  <version>1.1.0</version>
</dependency>
  1. 在Controller使用Kaptcha

@RestController
@RequestMapping("/kaptcha")
public class KaptchaController {

  @Autowired
  private Kaptcha kaptcha;

  @GetMapping("/render")
  public void render() {
    kaptcha.render();
  }

  @PostMapping("/valid")
  public void validDefaultTime(@RequestParam String code) {
    //default timeout 900 seconds
    kaptcha.validate(code);
  }

  @PostMapping("/validTime")
  public void validWithTime(@RequestParam String code) {
    kaptcha.validate(code, 60);
  }

}
  1. 发生错误会抛出异常,建议使用全局异常来处理。

KaptchaException  //super Exception

KaptchaIncorrectException

KaptchaNotFoundException

KaptchaTimeoutException

KaptchaRenderException //If something is wrong then Image.write when render.
import com.baomidou.kaptcha.exception.KaptchaException;
import com.baomidou.kaptcha.exception.KaptchaIncorrectException;
import com.baomidou.kaptcha.exception.KaptchaNotFoundException;
import com.baomidou.kaptcha.exception.KaptchaTimeoutException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;

@RestControllerAdvice
public class GlobalExceptionHandler {

  @ExceptionHandler(value = KaptchaException.class)
  public String kaptchaExceptionHandler(KaptchaException kaptchaException) {
    if (kaptchaException instanceof KaptchaIncorrectException) {
      return "验证码不正确";
    } else if (kaptchaException instanceof KaptchaNotFoundException) {
      return "验证码未找到";
    } else if (kaptchaException instanceof KaptchaTimeoutException) {
      return "验证码过期";
    } else {
      return "验证码渲染失败";
    }

  }

}
  1. 自定义验证码参数,以下为默认配置。

kaptcha:
  height: 50
  width: 200
  content:
    length: 4
    source: abcdefghjklmnopqrstuvwxyz23456789
    space: 2
  font:
    color: black
    name: Arial
    size: 40
  background-color:
    from: lightGray
    to: white
  border:
    enabled: true
    color: black
    thickness: 1
本站文章除注明转载外,均为本站原创或编译。欢迎任何形式的转载,但请务必注明出处,尊重他人劳动共创开源社区。
转载请注明:文章转载自 开源中国社区 [http://www.oschina.net]
本文标题:苞米豆 — 谷歌验证码快速启动器 1.1.0 发布
加载中

最新评论(10

zcqshine
zcqshine
需要翻墙不
91porn
91porn
名字可以
小锅盖
小锅盖

引用来自“代码天下”的评论

需要引什么验证码组件?自己分分钟写一个不就好了。无聊
把你写的开源一下?
代码天下
代码天下
需要引什么验证码组件?自己分分钟写一个不就好了。无聊
kentxp
kentxp
这个不用写starter也很简单
爱吃猫的鱼0313
爱吃猫的鱼0313
没有效果图提不起兴趣
紫电清霜
紫电清霜
@小锅盖 @铁锅盖 @铜锅盖
小锅盖
小锅盖

引用来自“LarryKoo”的评论

效果图长什么样子啊
引入看一下吧,就是普通验证码。 下个版本带个效果图
LarryKoo
LarryKoo
效果图长什么样子啊
返回顶部
顶部