EasyCaptcha/README.md

214 lines
5.0 KiB
Markdown
Raw Normal View History

2018-02-11 14:46:59 +08:00
# EasyCaptcha
2018-07-27 15:52:40 +08:00
2018-07-27 16:18:18 +08:00
![JitPack](https://img.shields.io/jitpack/v/whvcse/EasyCaptcha.svg?style=flat-square)
![Hex.pm](https://img.shields.io/hexpm/l/plug.svg?style=flat-square)
2018-07-27 15:52:40 +08:00
## 1.简介
2018-07-27 16:18:18 +08:00
  Java图形验证码支持gif验证码可用于Java Web、JavaSE项目。
2018-07-27 15:52:40 +08:00
## 2.效果展示
**gif效果**
![验证码](https://ws1.sinaimg.cn/large/006a7GCKgy1ftog813jz9g303m01cjrc.jpg)
  
![验证码](https://ws1.sinaimg.cn/large/006a7GCKgy1ftogh8z6hug303m01cdfs.jpg)
  
![验证码](https://ws1.sinaimg.cn/large/006a7GCKgy1ftoghsymykg303m01c3yg.jpg)
**png效果**
![验证码](https://ws1.sinaimg.cn/large/006a7GCKgy1ftogec24tbj303m01cmwx.jpg)
  
![验证码](https://ws1.sinaimg.cn/large/006a7GCKgy1ftogf2vvodj303m01cjr5.jpg)
  
![验证码](https://ws1.sinaimg.cn/large/006a7GCKgy1ftogfxh2rwj303m01cjr5.jpg)
## 3.导入项目
### 2.1.gradle方式的引入
2018-05-14 11:39:09 +08:00
需要先在project的build.gradle中添加
2018-07-27 15:52:40 +08:00
```text
2018-05-14 11:39:09 +08:00
allprojects {
repositories {
maven { url 'https://jitpack.io' }
}
}
```
在项目的build.gradle中添加
2018-07-27 15:52:40 +08:00
```text
2018-05-14 11:39:09 +08:00
dependencies {
2018-07-27 15:52:40 +08:00
compile 'com.github.whvcse:EasyCaptcha:1.2.0'
2018-05-14 11:39:09 +08:00
}
```
2018-07-27 15:52:40 +08:00
### 2.2.maven方式引入
在你的pom.xml中添加如下代码
2018-05-14 11:39:09 +08:00
```xml
2018-07-27 15:52:40 +08:00
<project>
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.github.whvcse</groupId>
<artifactId>EasyCaptcha</artifactId>
2018-07-27 15:53:02 +08:00
<version>1.2.0</version>
2018-07-27 15:52:40 +08:00
</dependency>
</dependencies>
</project>
2018-05-14 11:39:09 +08:00
```
2018-07-27 15:52:40 +08:00
### 2.3.jar包下载
[EasyCaptcha-1.2.0.jar](https://github.com/whvcse/EasyCaptcha/releases)
---
2018-05-14 11:39:09 +08:00
2018-07-27 15:52:40 +08:00
## 3.使用方法
### 3.1.快速使用
2018-05-14 11:39:09 +08:00
1.在web.xml里面加入如下配置
```xml
2018-07-27 15:52:40 +08:00
<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>/images/captcha</url-pattern>
</servlet-mapping>
</web-app>
2018-05-14 11:39:09 +08:00
```
2.前端代码
```html
2018-05-15 08:32:50 +08:00
<img src="/images/captcha" />
2018-05-14 11:39:09 +08:00
```
2018-07-27 15:52:40 +08:00
### 3.2.在SpringMVC中使用
也可以使用controller的形式输出验证码方法如下
2018-05-14 11:39:09 +08:00
```java
2018-07-27 15:52:40 +08:00
@Controller
public class MainController {
@RequestMapping("/images/captcha")
public void captcha(HttpServletRequest request, HttpServletResponse response) throws Exception {
CaptchaUtil.out(request, response);
2018-05-14 11:39:09 +08:00
}
}
```
前端代码:
```html
2018-05-15 08:32:50 +08:00
<img src="/images/captcha" />
2018-05-14 11:39:09 +08:00
```
2018-07-27 15:52:40 +08:00
### 3.3.判断验证码是否正确
2018-05-14 11:39:09 +08:00
```java
2018-07-27 15:52:40 +08:00
@Controller
public class LoginController {
@PostMapping("/login")
public JsonResult login(String username,String password,String code){
if (CaptchaUtil.ver(code, request)) {
return JsonResult.error("验证码不正确");
}
}
2018-05-14 11:39:09 +08:00
}
```
2018-07-27 15:52:40 +08:00
### 3.4.设置宽高和位数
2018-05-14 11:39:09 +08:00
```java
2018-07-27 15:52:40 +08:00
@Controller
public class MainController {
@RequestMapping("/images/captcha")
public void captcha(HttpServletRequest request, HttpServletResponse response) throws Exception {
// 设置位数
CaptchaUtil.out(5, request, response);
// 设置宽、高、位数
CaptchaUtil.out(130, 48, 5, request, response);
}
2018-05-14 11:39:09 +08:00
}
```
2018-07-27 15:52:40 +08:00
## 4.更多设置
2018-05-14 11:39:09 +08:00
2018-07-27 16:18:18 +08:00
### 4.1.使用Gif验证码
```java
public class Test {
public static void main(String[] args) {
OutputStream outputStream = new FileOutputStream(new File("D:/a/aa.gif"));
// 三个参数分别为宽、高、位数
GifCaptcha gifCaptcha = new GifCaptcha(130, 48, 5);
// 设置字体
gifCaptcha.setFont(new Font("Verdana", Font.PLAIN, 32)); // 有默认字体,可以不用设置
// 设置类型,纯数字、纯字母、字母数字混合
gifCaptcha.setCharType(Captcha.TYPE_ONLY_NUMBER);
2018-07-27 16:18:18 +08:00
// 生成的验证码
String code = gifCaptcha.text();
// 输出图片流
gifCaptcha.out(outputStream);
}
}
```
### 4.2.使用png验证码
```java
public class Test {
public static void main(String[] args) {
OutputStream outputStream = new FileOutputStream(new File("D:/a/aa.png"));
2018-07-27 16:18:18 +08:00
// 三个参数分别为宽、高、位数
SpecCaptcha specCaptcha = new SpecCaptcha(130, 48, 5);
// 设置字体
specCaptcha.setFont(new Font("Verdana", Font.PLAIN, 32)); // 有默认字体,可以不用设置
// 设置类型,纯数字、纯字母、字母数字混合
specCaptcha.setCharType(Captcha.TYPE_ONLY_NUMBER);
2018-07-27 16:18:18 +08:00
// 生成的验证码
String code = specCaptcha.text();
// 输出图片流
specCaptcha.out(outputStream);
}
}
```
### 4.3.验证码类型
类型 | 描述
:--- | :---
TYPE_DEFAULT | 数字和字母混合
TYPE_ONLY_NUMBER | 纯数字
TYPE_ONLY_CHAR | 纯字母