Java图形验证码，支持gif、中文、算术等类型，可用于Java Web、JavaSE等项目。.zip

# EasyCaptcha   ## 1.简介 &emsp;Java图形验证码，支持gif、中文、算术等类型，可用于Java Web、JavaSE等项目。 --- ## 2.效果展示  &emsp;&emsp;  &emsp;&emsp;  <br/>  &emsp;&emsp;  &emsp;&emsp;  **算术类型：**  &emsp;&emsp;  &emsp;&emsp;  **中文类型：**  &emsp;&emsp;  &emsp;&emsp;  **内置字体：**  &emsp;&emsp;  &emsp;&emsp;  --- ## 3.导入项目 ### 3.1.gradle方式的引入 ```text dependencies { compile 'com.github.whvcse:easy-captcha:1.6.2' } ``` ### 3.2.maven方式引入 ```xml <dependencies> <dependency> <groupId>com.github.whvcse</groupId> <artifactId>easy-captcha</artifactId> <version>1.6.2</version> </dependency> </dependencies> ``` ### 3.3.jar包下载 [easy-captcha-1.6.2.jar](https://gitee.com/whvse/EasyCaptcha/releases) maven导入jar包，在项目根目录创建`libs`文件夹，然后pom.xml添加如下： ``` <dependency> <groupId>com.github.whvcse</groupId> <artifactId>easy-captcha</artifactId> <version>1.6.1</version> <systemPath>${basedir}/libs/easy-captcha-1.6.2.jar</systemPath> </dependency> ``` --- ## 4.使用方法 ### 4.1.在SpringMVC中使用 ```java @Controller public class CaptchaController { @RequestMapping("/captcha") public void captcha(HttpServletRequest request, HttpServletResponse response) throws Exception { CaptchaUtil.out(request, response); } } ``` 前端html代码： ```html <img src="/captcha" width="130px" height="48px" /> ``` > 不要忘了把`/captcha`路径排除登录拦截，比如shiro的拦截。 ### 4.2.在servlet中使用 web.xml中配置servlet： ```xml <web-app> <!-- 图形验证码servlet --> <servlet> <servlet-name>CaptchaServlet</servlet-name> <servlet-class>com.wf.captcha.servlet.CaptchaServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>CaptchaServlet</servlet-name>    <url-pattern>/captcha</url-pattern> </servlet-mapping> </web-app> ``` 前端html代码： ```html <img src="/captcha" width="130px" height="48px" /> ``` ### 4.3.判断验证码是否正确 ```java @Controller public class LoginController { @PostMapping("/login") public JsonResult login(String username,String password,String verCode){ if (!CaptchaUtil.ver(verCode, request)) { CaptchaUtil.clear(request); // 清除session中的验证码 return JsonResult.error("验证码不正确"); } } } ``` ### 4.4.设置宽高和位数 ```java @Controller public class CaptchaController { @RequestMapping("/captcha") public void captcha(HttpServletRequest request, HttpServletResponse response) throws Exception { // 设置位数 CaptchaUtil.out(5, request, response); // 设置宽、高、位数 CaptchaUtil.out(130, 48, 5, request, response); // 使用gif验证码 GifCaptcha gifCaptcha = new GifCaptcha(130,48,4); CaptchaUtil.out(gifCaptcha, request, response); } } ``` ### 4.5.不使用工具类 &emsp;CaptchaUtil封装了输出验证码、存session、判断验证码等功能，也可以不使用此工具类： ```java @Controller public class CaptchaController { @RequestMapping("/captcha") public void captcha(HttpServletRequest request, HttpServletResponse response) throws Exception { // 设置请求头为输出图片类型 response.setContentType("image/gif"); response.setHeader("Pragma", "No-cache"); response.setHeader("Cache-Control", "no-cache"); response.setDateHeader("Expires", 0); // 三个参数分别为宽、高、位数 SpecCaptcha specCaptcha = new SpecCaptcha(130, 48, 5); // 设置字体 specCaptcha.setFont(new Font("Verdana", Font.PLAIN, 32)); // 有默认字体，可以不用设置 // 设置类型，纯数字、纯字母、字母数字混合 specCaptcha.setCharType(Captcha.TYPE_ONLY_NUMBER); // 验证码存入session request.getSession().setAttribute("captcha", specCaptcha.text().toLowerCase()); // 输出图片流 specCaptcha.out(response.getOutputStream()); } @PostMapping("/login") public JsonResult login(String username,String password,String verCode){ // 获取session中的验证码 String sessionCode = request.getSession().getAttribute("captcha"); // 判断验证码 if (verCode==null || !sessionCode.equals(verCode.trim().toLowerCase())) { return JsonResult.error("验证码不正确"); } } } ``` ## 5.更多设置 ### 5.1.验证码类型 ```java public class Test { public static void main(String[] args) { // png类型 SpecCaptcha captcha = new SpecCaptcha(130, 48); captcha.text(); // 获取验证码的字符 captcha.textChar(); // 获取验证码的字符数组 // gif类型 GifCaptcha captcha = new GifCaptcha(130, 48); // 中文类型 ChineseCaptcha captcha = new ChineseCaptcha(130, 48); // 中文gif类型 ChineseGifCaptcha captcha = new ChineseGifCaptcha(130, 48); // 算术类型 ArithmeticCaptcha captcha = new ArithmeticCaptcha(130, 48); captcha.setLen(3); // 几位数运算，默认是两位 captcha.getArithmeticString(); // 获取运算的公式：3+2=? captcha.text(); // 获取运算的结果：5 captcha.out(outputStream); // 输出验证码 } } ``` > 注意：<br/> > &emsp;算术验证码的len表示是几位数运算，而其他验证码的len表示验证码的位数，算术验证码的text()表示的是公式的结果， > 对于算术验证码，你应该把公式的结果存储session，而不是公式。 ### 5.2.验证码字符类型 类型 | 描述 :--- | :--- TYPE_DEFAULT | 数字和字母混合 TYPE_ONLY_NUMBER | 纯数字 TYPE_ONLY_CHAR | 纯字母 TYPE_ONLY_UPPER | 纯大写字母 TYPE_ONLY_LOWER | 纯小写字母 TYPE_NUM_AND_UPPER | 数字和大写字母 使用方法： ``` SpecCaptcha captcha = new SpecCaptcha(130, 48, 5); captcha.setCharType(Captcha.TYPE_ONLY_NUMBER); ``` > 只有`SpecCaptcha`和`GifCaptcha`设置才有效果。 ### 5.3.字体设置 内置字体： 字体 | 效果 :--- | :--- Captcha.FONT_1 |  Captcha.FONT_2 |  Captcha.FONT_3 |  Captcha.FONT_4 |  Captcha.FONT_5 |  Captcha.FONT_6 |  Captcha.FONT_7 |  Captcha.FONT_8 |  Captcha.FONT_9 | ![](https://s2.ax1x.com/2019/08/2