Kaptcha 生成引擎使用教程

原创于 2025-04-20 07:01:56 发布 · 654 阅读

16 ·

CC 4.0 BY-SA版权

Kaptcha 生成引擎使用教程

kaptcha kaptcha - A kaptcha generation engine. 项目地址: https://gitcode.com/gh_mirrors/ka/kaptcha

1. 项目介绍

Kaptcha 是一个基于 Java 的验证码生成库，它能够帮助开发者快速地在其应用程序中集成验证码功能。Kaptcha 提供了多种配置选项，允许自定义验证码的样式、字符集和复杂度，以确保应用程序的安全性。

2. 项目快速启动

以下是一个快速启动 Kaptcha 的示例：

首先，您需要在项目中添加 Kaptcha 的依赖项。如果您使用 Maven，可以在 pom.xml 文件中添加如下依赖：

<dependency>
    <groupId>com.github.penggle</groupId>
    <artifactId>kaptcha</artifactId>
    <version>2.3.2</version>
</dependency>

接着，配置 Kaptcha 的参数。在您的 Servlet 中，您可以设置如下参数来配置 Kaptcha 的行为：

import com.google.code.kaptcha.impl.DefaultKaptcha;
import com.google.code.kaptcha.util.Config;

public class KaptchaConfig extends DefaultKaptcha {
    @Override
    public void initProps() {
        Properties properties = new Properties();
        // 设置验证码的宽度
        properties.setProperty("kaptcha.image.width", "150");
        // 设置验证码的高度
        properties.setProperty("kaptcha.image.height", "50");
        // 设置验证码的字体大小
        properties.setProperty("kaptcha.textproducer.font.size", "45");
        // 设置验证码的字体颜色
        properties.setProperty("kaptcha.textproducer.font.color", "black");
        // 设置验证码的文字字符集
        properties.setProperty("kaptcha.textproducer.char.string", "abcde123456789");
        // 设置验证码的干扰线颜色
        properties.setProperty("kaptcha.noise.color", "black");
        // 设置验证码的干扰线数量
        properties.setProperty("kaptcha.noise.impl", "com.google.code.kaptcha.impl.DefaultNoise");

        Config config = new Config(properties);
        setConfig(config);
    }
}

最后，在您的 Controller 中使用 Kaptcha 验证码：

import com.google.code.kaptcha.servlet.KaptchaExtend;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class KaptchaController {

    private KaptchaConfig kaptchaConfig = new KaptchaConfig();

    public void createKaptchaImage(HttpServletRequest request, HttpServletResponse response) throws Exception {
        response.setDateHeader("Expires", 0);
        response.setHeader("Cache-Control", "no-store, no-cache, must-revalidate");
        response.setHeader("Cache-Control", "post-check=0, pre-check=0");
        response.setHeader("Cache-Control", "max-age=0");
        response.setHeader("Content-Type", "image/jpeg");

        KaptchaExtend kaptchaExtend = new KaptchaExtend(kaptchaConfig);
        kaptchaExtend.createImage(request, response);
    }
}