Package com.sankcrm.erp.auth.infrastructure.captcha

Class CaptchaImageRenderer

java.lang.Object

com.sankcrm.erp.auth.infrastructure.captcha.CaptchaImageRenderer

@Component
public class CaptchaImageRenderer
extends Object

适配开源 easy-captcha 库生成图形验证码；答案只返回给受信挑战编排层，不得记录日志。

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	CaptchaImageRenderer.RenderedCaptcha	渲染结果的内部载体，不得暴露；答案访问器从 JSON 序列化中排除，且 toString 已脱敏。

Constructor Summary

Constructors

Constructor	Description
CaptchaImageRenderer()

Method Summary

Modifier and Type	Method	Description
CaptchaImageRenderer.RenderedCaptcha	render(int level)	按策略难度生成新的答案及 PNG data URL。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

CaptchaImageRenderer

public CaptchaImageRenderer()

Method Details

render

public CaptchaImageRenderer.RenderedCaptcha render(int level)

按策略难度生成新的答案及 PNG data URL。

同一个短命实例先生成答案，再输出图片，确保两者对应同一挑战。

Parameters:

level - 验证码档位，取值 1 至 6

Returns:

配对的明文答案与展示图片；调用方必须只保存答案摘要

Throws:

com.sankcrm.erp.common.exception.CoreRuntimeException - 档位无效或图片生成失败时以验证码服务不可用异常抛出