开源.NetCore通用工具库Xmtool使用连载 - 图形验证码篇

开源,netcore,通用,工具,xmtool,使用,连载,图形,验证码 · 浏览次数 : 516

小编点评

**图形验证码类库介绍** 该类库提供了一种抽象的图形验证码生成和验证方法，可以方便地将图形验证码功能嵌入到软件中。 **主要类：** * **ICaptcha**：支持字符和滑动图形验证码生成和验证。 * **CharacterCaptchaOption**：用于配置字符图形验证码的设置。 * **SlidingCaptchaOption**：用于配置滑动图形验证码的设置。 * **CharacterCaptchaData**：用于设置字符图形验证码的内容。 * **SlidingCaptchaData**：用于设置滑动图形验证码的规格。 * **CaptchaResult**：用于返回图形验证码生成的具体内容。 **使用示例：** ```python # 创建字符图形验证码对象 captcha = Xmtool.Captcha(CaptchaKind.Character) # 配置字符图形验证码 captcha.Config(CharacterCaptchaOption(BackColor=Color.Blue, BorderColor=Color.DarkBlue)) # 生成图形验证码图片 image_base64 = captcha.Generate() # 验证图形验证码 result = captcha.Validate(result.ValidationData, "用户输入数据") ``` **优点：** * 简化图形验证码生成和验证逻辑。 * 支持多种图形验证码类型。 * 提高开发效率。 **注意：** * 图形验证码的配置参数可能根据具体需求进行设置。 * 图形验证码的验证过程需要在软件中进行实现。

正文

【Github源码】

《上一篇》介绍了Xmtool工具库中的Web操作类库，今天我们继续为大家介绍其中的图形验证码类库。

图形验证码是为了抵御恶意攻击出现的一种设计；例如用户登录、修改密码等场景。在本类库中，将图形验证码的逻辑进行了抽象封装，能够通过同一套方法使用不同类型的图形验证码；让增加图形验证码逻辑变得更方便友好，且切换不同类型的图形验证码更简易。

使用时，需要先获取图形验证码类库对象：

ICaptcha captcha = Xmtool.Captcha(CaptchaKind.Character);	// 字符验证码
// 或者
ICaptcha captcha = Xmtool.Captcha(CaptchaKind.Sliding);	// 滑块验证码

ICaptcha接口提供了配置、生成和校验 3 个方法，通过这 3 个方法可以很方便的将图形验证码能力嵌入到自己的软件功能中。

1. Config方法

public ICaptcha Config(CaptchaOption option);

说明：配置图形验证码生成规则，根据图形验证码不同的类型，需传入不同的参数配置类。

参数：

option：生成参数配置；字符验证码使用CharacterCaptchaOption配置类，滑块验证码使用SlidingCaptchaOption配置类。

ICaptcha captcha = Xmtool.Captcha(CaptchaKind.Character);

CharacterCaptchaOption option = new CharacterCaptchaOption();
option.BackColor = Color.Blue;
option.BorderColor = Color.DarkBlue;
captcha.Config(option);

// TODO

2. Generate方法

public CaptchaResult Generate(CaptchaData data = null);

说明：根据参数配置生成图形验证码图片及相关数据。

参数：

data：生成数据设定，默认不设置将随机生成；字符验证码使用CharacterCaptchaData类，滑块验证码使用SlidingCaptchaData类。

将返回生成的图片数据（Base64格式）和相关校验性数据。

ICaptcha captcha = Xmtool.Captcha(CaptchaKind.Character);
CharacterCaptchaData data = new CharacterCaptchaData();
data.Code = "1234";
CaptchaResult result = captcha.Generate(data);
// TODO

3. Validate方法

public bool Validate(object source, object input);

说明：将用户输入信息和生成数据进行对比，判断图形验证码输入或操作是否正确。

ICaptcha captcha = Xmtool.Captcha(CaptchaKind.Character);
CaptchaResult result = captcha.Generate();
bool ok = captcha.Validate(result.ValidationData, "用户输入数据");
if (ok)
{
    // TODO
}

4. Type属性

说明：返回当前实例的验证码类型，CaptchaKind.Character（字符验证码）或CaptchaKind.Sliding（滑块验证码）。

附加说明

一、CharacterCaptchaOption类

该类用于为字符图形验证码设置生成过程的一些配置信息。