同步操作将从 有理想的鱼/ymate-module-captcha 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
验证码模块;
- 支持图片、邮件和短信三种验证类型;
- 支持多作用域验证生成;
- 支持
debug
模式,该模式下短信不会被发送;- 支持根据限定条件判断是否启用验证码,如:请求n次后需要填写验证码;
- 采用
@VCaptcha
注解验证,配置简单、灵活,可自定义扩展;
基础模块包:
<dependency>
<groupId>net.ymate.module</groupId>
<artifactId>ymate-module-captcha</artifactId>
<version>1.0.0</version>
</dependency>
默认Web实现包:
<dependency>
<groupId>net.ymate.module</groupId>
<artifactId>ymate-module-captcha-web</artifactId>
<version>1.0.0</version>
</dependency>
首先,你需要创建一个基于YMPv2框架的JavaWeb工程项目;(如何快速搭建工程?)
YMP框架扫描包路径要包含net.ymate.module.captcha
, 调整配置如下:
# 框架自动扫描的包路径集合,多个包名之间用'|'分隔,默认已包含net.ymate.platform包,其子包也将被扫描
ymp.autoscan_packages=net.ymate
获取验证码图片
http://<你的域名>/captcha?scope=<SCOPE>&type=<TYPE>
scope:作用域标识,用于区分不同客户端及数据存储范围,可选参数;
type:仅当type=data时采用Base64编码输出图片,可选参数;
发送短信验证码
http://<你的域名>/captcha/sms_code?scope=<SCOPE>&mobile=<MOBILE>
scope:作用域标识,用于区分不同客户端及数据存储范围,可选参数;
mobile:手机号码,必选参数;
返回值说明:
{ret: 0}
ret=0
表示发送成功ret=-1
表示参数验证错误ret=-6
表示发送频率过快或其它消息ret=-50
表示发送异常
发送邮件验证码
http://<你的域名>/captcha/mail_code?scope=<SCOPE>&email=<EMAIL>
scope:作用域标识,用于区分不同客户端及数据存储范围,可选参数;
email:邮件地址,必选参数;
返回值说明:
{ret: 0}
ret=0
表示发送成功ret=-1
表示参数验证错误ret=-6
表示发送频率过快或其它消息ret=-50
表示发送异常
检查验证码是否合法
http://<你的域名>/captcha/match?scope=<SCOPE>&token=<TOKEN>&target=<TARGET>
scope:作用域标识,用于区分不同客户端及数据存储范围,可选参数;
token:预验证的令牌值,必选参数;
target:当验证手机或邮件时必须指定对应的手机号或邮箱地址
返回值:
{ret: 0, matched: true|false}
验证码注解@VCaptcha
的使用
@RequestMapping(value = "/login", method = Type.HttpMethod.POST)
public IView __doLogin(@VCaptcha(invalid = true)
@RequestParam String captcha, // 验证码
@VRequired
@VMobile
@RequestParam String mobile, // 手机号码
@VRequired
@VCaptcha(type = ICaptcha.Type.MAIL, scope = "login", targetName="mobile")
@RequestParam String smscode, // 短信验证码
@VRequired
@RequestParam String passwd, // 登录密码
@RequestParam(Optional.REDIRECT_URL) String redirectUrl) throws Exception {
// ...... 省略
return WebResult.SUCCESS().toJSON();
}
验证码相关方法调用
// 生成作用域为user.login的验证码
String _code = Captcha.get().generate("user.login");
// 销毁作用域为user.login的验证码
Captcha.get().invalidate("user.login");
// 判断是否开启错误记数,开启后将支持跳过参数验证
Captcha.get().isWrongTimesEnabled();
// 判断作用域为user.login的验证码是否允许忽略
Captcha.get().isValidationNeedSkip(ICaptcha.Type.DEFAULT, "user.login");
// 重置作用域为user.login的验证码错误计数器
Captcha.get().resetWrongTimes(ICaptcha.Type.DEFAULT, "user.login");
// 验证作用域为user.login的验证码是否匹配以及验证后是否使其失效
Captcha.get().validate("user.login", _code, true);
#-------------------------------------
# module.captcha 模块初始化参数
#-------------------------------------
# 验证码模块是否已被禁用(禁用后将忽略所有验证码相关参数验证), 默认值: false
ymp.configs.module.captcha.disabled=
# 是否开启调试模式(调试模式下控制台将输出生成的验证码, 同时短信验证码也不会被真正发送), 默认值: false
ymp.configs.module.captcha.dev_mode=
# 验证码服务提供者类, 默认值: net.ymate.module.captcha.impl.DefaultCaptchaProvider
ymp.configs.module.captcha.provider_class=
# 自定义验证码生成器类, 默认值: 空
ymp.configs.module.captcha.token_generator_class=
# 验证码存储适配器类, 必须, 默认值: 空
ymp.configs.module.captcha.storage_adapter_class=
# 作用域标识扩展处理器, 开启错误记数时为必须, 默认值: 空
ymp.configs.module.captcha.scope_processor_class=
# 手机短信或邮件验证码发送服务提供者类, 默认值: 空
ymp.configs.module.captcha.send_provider_class=
# 设置在达到指定错误次数上限后开启验证码, 默认值: 0, 表示不开启错误记数特性
ymp.configs.module.captcha.need_captcha_wrong_times=
# 缓存名称前缀, 默认值: ""
ymp.configs.module.captcha.cache_name_prefix=
# 验证码最小字符长度, 默认值: 4
ymp.configs.module.captcha.token_length_min=
# 验证码超时时间, 单位: 秒, 默认: 空, 空或小于等于0均表示不限制
ymp.configs.module.captcha.token_timeout=
# 高度, 默认: 70px
ymp.configs.module.captcha.height=
# 宽度, 默认: 200px
ymp.configs.module.captcha.width=
# 前景色, RGB值, 如: 0,0,0|1,2,3, 多个颜色用'|'分隔, 默认: 随机
ymp.configs.module.captcha.foregrounds=
# 背景色, RBG值, 默认: 255,255,255
ymp.configs.module.captcha.background=
# 质量, 可选值: min|default|max, 默认: max
ymp.configs.module.captcha.quality=
# 压缩比, 0-1之间, 默认: 空
ymp.configs.module.captcha.compress_ratio=
# 图片格式, 可选值: png|jpeg, 默认: jpeg
ymp.configs.module.captcha.format=
# 自定义字体, 可选参数, 如: SansSerif,plain|Serif,bold|Monospaced,plain, 多个字体用'|'分隔, 默认: 随机
ymp.configs.module.captcha.fonts=
# 图片生成效果参数设置: 缩放, 取值范围: [0-1, 0-1], 默认: 1,1
ymp.configs.module.captcha.effect.scale=
# 图片生成效果参数设置: 波浪, 默认值: true
ymp.configs.module.captcha.effect.ripple=
# 图片生成效果参数设置: 模糊, 默认值: true
ymp.configs.module.captcha.effect.blur=
# 图片生成效果参数设置: 轮廓, 默认值: false
ymp.configs.module.captcha.effect.outline=
# 图片生成效果参数设置: 旋转, 默认值: true
ymp.configs.module.captcha.effect.ratale=
YMP不仅提供便捷的Web及其它Java项目的快速开发体验,也将不断提供更多丰富的项目实践经验。
感兴趣的小伙伴儿们可以加入 官方QQ群480374360,一起交流学习,帮助YMP成长!
了解更多有关YMP框架的内容,请访问官网:http://www.ymate.net/
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。