Class AbstractCaptcha

java.lang.Object
com.sure.tool.captcha.AbstractCaptcha
All Implemented Interfaces:
Captcha
Direct Known Subclasses:
CircleCaptcha, LineCaptcha, ShearCaptcha

public abstract class AbstractCaptcha extends Object implements Captcha
图形验证码抽象基类:随机字符生成、背景与字符绘制,干扰由子类实现,参考 Hutool 的 AbstractCaptcha 设计。

基于 JDK AWT 绘制,兼容无头(headless)服务器环境。

Since:
0.1.0
Author:
suretool
  • Field Details

  • Constructor Details

    • AbstractCaptcha

      protected AbstractCaptcha(int width, int height, int codeCount, int interfereCount)
      创建验证码。
      Parameters:
      width - 图片宽度
      height - 图片高度
      codeCount - 字符个数
      interfereCount - 干扰数量
  • Method Details

    • getCode

      public String getCode()
      Description copied from interface: Captcha
      获取验证码文本。
      Specified by:
      getCode in interface Captcha
      Returns:
      验证码文本
    • verify

      public boolean verify(String userInputCode)
      Description copied from interface: Captcha
      校验用户输入(忽略大小写)。
      Specified by:
      verify in interface Captcha
      Parameters:
      userInputCode - 用户输入
      Returns:
      是否匹配
    • write

      public void write(OutputStream out) throws IOException
      Description copied from interface: Captcha
      输出验证码图片(PNG 格式)。
      Specified by:
      write in interface Captcha
      Parameters:
      out - 输出流
      Throws:
      IOException - 输出失败
    • getImageBytes

      public byte[] getImageBytes()
      Description copied from interface: Captcha
      获取验证码图片字节(PNG 格式)。
      Specified by:
      getImageBytes in interface Captcha
      Returns:
      图片字节
    • getImageBase64

      public String getImageBase64()
      Description copied from interface: Captcha
      获取 data URI(data:image/png;base64,...),便于直接嵌入页面。
      Specified by:
      getImageBase64 in interface Captcha
      Returns:
      data URI
    • randomCode

      protected String randomCode(int count)
      随机字符个数。
      Parameters:
      count - 个数
      Returns:
      随机字符串
    • drawInterfere

      protected abstract void drawInterfere(Graphics2D g)
      干扰绘制,由子类实现。
      Parameters:
      g - 画笔
    • applyShear

      protected void applyShear(Graphics2D g)
      错切变换钩子,默认不变换,ShearCaptcha 覆盖。
      Parameters:
      g - 画笔
    • randomColor

      protected Color randomColor(int from, int to)
      随机颜色。
      Parameters:
      from - 下限(含)
      to - 上限(不含)
      Returns:
      颜色
    • drawRandomLines

      protected void drawRandomLines(Graphics2D g)
      随机干扰线段。
      Parameters:
      g - 画笔
    • drawRandomCircles

      protected void drawRandomCircles(Graphics2D g)
      随机干扰圆圈。
      Parameters:
      g - 画笔
    • getInterfereCount

      protected int getInterfereCount()
      干扰数量。
      Returns:
      干扰数量
    • getHeight

      protected int getHeight()
      图片高度。
      Returns:
      高度
    • getWidth

      protected int getWidth()
      图片宽度。
      Returns:
      宽度
    • getCodeBase64

      public String getCodeBase64()
      获取验证码图片的 Data URI(可直接用于 <img src>)。
      Returns:
      data:image/png;base64,...
    • write

      public void write(File file) throws IOException
      将验证码图片写入文件。
      Parameters:
      file - 目标文件
      Throws:
      IOException - IO 异常