diff --git a/hutool-captcha/src/main/java/cn/hutool/captcha/AbstractCaptcha.java b/hutool-captcha/src/main/java/cn/hutool/captcha/AbstractCaptcha.java
index 010e4d23a..fca78ba19 100644
--- a/hutool-captcha/src/main/java/cn/hutool/captcha/AbstractCaptcha.java
+++ b/hutool-captcha/src/main/java/cn/hutool/captcha/AbstractCaptcha.java
@@ -1,5 +1,13 @@
package cn.hutool.captcha;
+import cn.hutool.captcha.generator.CodeGenerator;
+import cn.hutool.captcha.generator.RandomGenerator;
+import cn.hutool.core.codec.Base64;
+import cn.hutool.core.img.ImgUtil;
+import cn.hutool.core.io.FileUtil;
+import cn.hutool.core.io.IORuntimeException;
+import cn.hutool.core.io.IoUtil;
+
import java.awt.AlphaComposite;
import java.awt.Color;
import java.awt.Font;
@@ -10,50 +18,59 @@ import java.io.File;
import java.io.IOException;
import java.io.OutputStream;
-import cn.hutool.captcha.generator.CodeGenerator;
-import cn.hutool.captcha.generator.RandomGenerator;
-import cn.hutool.core.codec.Base64;
-import cn.hutool.core.img.ImgUtil;
-import cn.hutool.core.io.FileUtil;
-import cn.hutool.core.io.IORuntimeException;
-import cn.hutool.core.io.IoUtil;
-
/**
* 抽象验证码
* 抽象验证码实现了验证码字符串的生成、验证,验证码图片的写出
* 实现类通过实现{@link #createImage(String)} 方法生成图片对象
- *
- * @author looly
*
+ * @author looly
*/
public abstract class AbstractCaptcha implements ICaptcha {
private static final long serialVersionUID = 3180820918087507254L;
- /** 图片的宽度 */
+ /**
+ * 图片的宽度
+ */
protected int width;
- /** 图片的高度 */
+ /**
+ * 图片的高度
+ */
protected int height;
- /** 验证码干扰元素个数 */
+ /**
+ * 验证码干扰元素个数
+ */
protected int interfereCount;
- /** 字体 */
+ /**
+ * 字体
+ */
protected Font font;
- /** 验证码 */
+ /**
+ * 验证码
+ */
protected String code;
- /** 验证码图片 */
+ /**
+ * 验证码图片
+ */
protected byte[] imageBytes;
- /** 验证码生成器 */
+ /**
+ * 验证码生成器
+ */
protected CodeGenerator generator;
- /** 背景色 */
+ /**
+ * 背景色
+ */
protected Color background;
- /** 文字透明度 */
+ /**
+ * 文字透明度
+ */
protected AlphaComposite textAlpha;
/**
* 构造,使用随机验证码生成器生成验证码
- *
- * @param width 图片宽
- * @param height 图片高
- * @param codeCount 字符个数
+ *
+ * @param width 图片宽
+ * @param height 图片高
+ * @param codeCount 字符个数
* @param interfereCount 验证码干扰元素个数
*/
public AbstractCaptcha(int width, int height, int codeCount, int interfereCount) {
@@ -62,10 +79,10 @@ public abstract class AbstractCaptcha implements ICaptcha {
/**
* 构造
- *
- * @param width 图片宽
- * @param height 图片高
- * @param generator 验证码生成器
+ *
+ * @param width 图片宽
+ * @param height 图片高
+ * @param generator 验证码生成器
* @param interfereCount 验证码干扰元素个数
*/
public AbstractCaptcha(int width, int height, CodeGenerator generator, int interfereCount) {
@@ -88,7 +105,7 @@ public abstract class AbstractCaptcha implements ICaptcha {
/**
* 生成验证码字符串
- *
+ *
* @since 3.3.0
*/
protected void generateCode() {
@@ -97,14 +114,15 @@ public abstract class AbstractCaptcha implements ICaptcha {
/**
* 根据生成的code创建验证码图片
- *
+ *
* @param code 验证码
+ * @return Image
*/
protected abstract Image createImage(String code);
@Override
public String getCode() {
- if(null == this.code) {
+ if (null == this.code) {
createCode();
}
return this.code;
@@ -117,7 +135,7 @@ public abstract class AbstractCaptcha implements ICaptcha {
/**
* 验证码写出到文件
- *
+ *
* @param path 文件路径
* @throws IORuntimeException IO异常
*/
@@ -127,7 +145,7 @@ public abstract class AbstractCaptcha implements ICaptcha {
/**
* 验证码写出到文件
- *
+ *
* @param file 文件
* @throws IORuntimeException IO异常
*/
@@ -143,10 +161,10 @@ public abstract class AbstractCaptcha implements ICaptcha {
public void write(OutputStream out) {
IoUtil.write(out, false, getImageBytes());
}
-
+
/**
* 获取图形验证码图片bytes
- *
+ *
* @return 图形验证码图片bytes
* @since 4.5.17
*/
@@ -159,7 +177,7 @@ public abstract class AbstractCaptcha implements ICaptcha {
/**
* 获取验证码图
- *
+ *
* @return 验证码图
*/
public BufferedImage getImage() {
@@ -168,7 +186,7 @@ public abstract class AbstractCaptcha implements ICaptcha {
/**
* 获得图片的Base64形式
- *
+ *
* @return 图片的Base64
* @since 3.3.0
*/
@@ -178,7 +196,7 @@ public abstract class AbstractCaptcha implements ICaptcha {
/**
* 自定义字体
- *
+ *
* @param font 字体
*/
public void setFont(Font font) {
@@ -187,7 +205,7 @@ public abstract class AbstractCaptcha implements ICaptcha {
/**
* 获取验证码生成器
- *
+ *
* @return 验证码生成器
*/
public CodeGenerator getGenerator() {
@@ -196,7 +214,7 @@ public abstract class AbstractCaptcha implements ICaptcha {
/**
* 设置验证码生成器
- *
+ *
* @param generator 验证码生成器
*/
public void setGenerator(CodeGenerator generator) {
@@ -205,7 +223,7 @@ public abstract class AbstractCaptcha implements ICaptcha {
/**
* 设置背景色
- *
+ *
* @param background 背景色
* @since 4.1.22
*/
@@ -215,7 +233,7 @@ public abstract class AbstractCaptcha implements ICaptcha {
/**
* 设置文字透明度
- *
+ *
* @param textAlpha 文字透明度,取值0~1,1表示不透明
* @since 4.5.17
*/
diff --git a/hutool-cron/src/main/java/cn/hutool/cron/Scheduler.java b/hutool-cron/src/main/java/cn/hutool/cron/Scheduler.java
index bbdc70826..3d7b644ad 100644
--- a/hutool-cron/src/main/java/cn/hutool/cron/Scheduler.java
+++ b/hutool-cron/src/main/java/cn/hutool/cron/Scheduler.java
@@ -414,7 +414,8 @@ public class Scheduler implements Serializable {
/**
* 停止定时任务
* 此方法调用后会将定时器进程立即结束,如果为守护线程模式,则正在执行的作业也会自动结束,否则作业线程将在执行完成后结束。
- *
+ *
+ * @param clearTasks 是否清除说有任务
* @return this
* @since 4.1.17
*/
diff --git a/hutool-extra/src/main/java/cn/hutool/extra/servlet/multipart/MultipartRequestInputStream.java b/hutool-extra/src/main/java/cn/hutool/extra/servlet/multipart/MultipartRequestInputStream.java
index 4351e8d0f..65b35b648 100644
--- a/hutool-extra/src/main/java/cn/hutool/extra/servlet/multipart/MultipartRequestInputStream.java
+++ b/hutool-extra/src/main/java/cn/hutool/extra/servlet/multipart/MultipartRequestInputStream.java
@@ -180,6 +180,7 @@ public class MultipartRequestInputStream extends BufferedInputStream {
* 跳过边界表示
*
* @return 跳过的字节数
+ * @throws IOException 读取异常
*/
public int skipToBoundary() throws IOException {
int count = 0;