199 lines
4.8 KiB
Markdown
199 lines
4.8 KiB
Markdown
# EasyCaptcha
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
## 1.简介
|
||
|
||
  Java图形验证码，支持gif验证码，可用于Java Web、JavaSE项目。
|
||
|
||
|
||
## 2.效果展示
|
||
|
||
**gif效果：**
|
||
|
||
|
||
  
|
||
|
||
  
|
||
|
||
|
||
**png效果：**
|
||
|
||
|
||
  
|
||
|
||
  
|
||
|
||
|
||
|
||
|
||
## 3.导入项目
|
||
|
||
### 2.1.gradle方式的引入
|
||
需要先在project的build.gradle中添加：
|
||
```text
|
||
allprojects {
|
||
repositories {
|
||
maven { url 'https://jitpack.io' }
|
||
}
|
||
}
|
||
```
|
||
在项目的build.gradle中添加
|
||
```text
|
||
dependencies {
|
||
compile 'com.github.whvcse:EasyCaptcha:1.2.0'
|
||
}
|
||
```
|
||
|
||
### 2.2.maven方式引入
|
||
在你的pom.xml中添加如下代码：
|
||
```xml
|
||
<project>
|
||
<repositories>
|
||
<repository>
|
||
<id>jitpack.io</id>
|
||
<url>https://jitpack.io</url>
|
||
</repository>
|
||
</repositories>
|
||
|
||
<dependencies>
|
||
<dependency>
|
||
<groupId>com.github.whvcse</groupId>
|
||
<artifactId>EasyCaptcha</artifactId>
|
||
<version>1.2.0</version>
|
||
</dependency>
|
||
</dependencies>
|
||
</project>
|
||
|
||
```
|
||
|
||
### 2.3.jar包下载
|
||
[EasyCaptcha-1.2.0.jar](https://github.com/whvcse/EasyCaptcha/releases)
|
||
|
||
|
||
---
|
||
|
||
|
||
## 3.使用方法
|
||
|
||
### 3.1.快速使用
|
||
1.在web.xml里面加入如下配置：
|
||
```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>/images/captcha</url-pattern>
|
||
</servlet-mapping>
|
||
</web-app>
|
||
|
||
```
|
||
2.前端代码
|
||
```html
|
||
<img src="/images/captcha" />
|
||
```
|
||
|
||
### 3.2.在SpringMVC中使用
|
||
也可以使用controller的形式输出验证码，方法如下：
|
||
```java
|
||
@Controller
|
||
public class MainController {
|
||
|
||
@RequestMapping("/images/captcha")
|
||
public void captcha(HttpServletRequest request, HttpServletResponse response) throws Exception {
|
||
CaptchaUtil.out(request, response);
|
||
}
|
||
}
|
||
```
|
||
前端代码：
|
||
```html
|
||
<img src="/images/captcha" />
|
||
```
|
||
|
||
### 3.3.判断验证码是否正确
|
||
|
||
```java
|
||
@Controller
|
||
public class LoginController {
|
||
|
||
@PostMapping("/login")
|
||
public JsonResult login(String username,String password,String code){
|
||
|
||
if (CaptchaUtil.ver(code, request)) {
|
||
return JsonResult.error("验证码不正确");
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### 3.4.设置宽高和位数
|
||
```java
|
||
@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);
|
||
}
|
||
}
|
||
```
|
||
|
||
## 4.更多设置
|
||
|
||
### 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)); // 有默认字体，可以不用设置
|
||
|
||
// 生成的验证码
|
||
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.gif"));
|
||
|
||
// 三个参数分别为宽、高、位数
|
||
SpecCaptcha specCaptcha = new SpecCaptcha(130, 48, 5);
|
||
|
||
// 设置字体
|
||
specCaptcha.setFont(new Font("Verdana", Font.PLAIN, 32)); // 有默认字体，可以不用设置
|
||
|
||
// 生成的验证码
|
||
String code = specCaptcha.text();
|
||
|
||
// 输出图片流
|
||
specCaptcha.out(outputStream);
|
||
}
|
||
}
|
||
``` |