pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>xyz.zhouxy.plusone</groupId>
     <artifactId>plusone-commons</artifactId>
-    <version>1.1.0-SNAPSHOT</version>
+    <version>1.0.0</version>
 
     <properties>
         <!-- Basic properties -->

src/main/java/xyz/zhouxy/plusone/commons/base/IWithCode.java

@@ -29,50 +29,21 @@ import javax.annotation.Nullable;
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 public interface IWithCode<T> {
-
-    /**
-     * 获取码值
-     * @return 码值
-     */
     @Nonnull
     T getCode();
 
-    /**
-     * 判断 {@code code} 与给定的值是否相等
-     *
-     * @param code 用于判断的值
-     * @return 判断结果
-     */
     default boolean isCodeEquals(@Nullable T code) {
         return Objects.equals(getCode(), code);
     }
 
-    /**
-     * 判断是否与给定的 {@link IWithCode} 有着相等的 {@code code}
-     *
-     * @param other 用于比较的对象
-     * @return 判断结果
-     */
     default boolean isSameCodeAs(@Nullable IWithCode<?> other) {
         return other != null && Objects.equals(getCode(), other.getCode());
     }
 
-    /**
-     * 判断是否与给定的 {@link IWithIntCode} 有着相等的 {@code code}
-     *
-     * @param other 用于比较的对象
-     * @return 判断结果
-     */
     default boolean isSameCodeAs(@Nullable IWithIntCode other) {
         return other != null && Objects.equals(getCode(), other.getCode());
     }
 
-    /**
-     * 判断是否与给定的 {@link IWithLongCode} 有着相等的 {@code code}
-     *
-     * @param other 用于比较的对象
-     * @return 判断结果
-     */
     default boolean isSameCodeAs(@Nullable IWithLongCode other) {
         return other != null && Objects.equals(getCode(), other.getCode());
     }

src/main/java/xyz/zhouxy/plusone/commons/base/IWithIntCode.java

@@ -28,49 +28,20 @@ import javax.annotation.Nullable;
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 public interface IWithIntCode {
-
-    /**
-     * 获取码值
-     * @return 码值
-     */
     int getCode();
 
-    /**
-     * 判断 {@code code} 与给定的值是否相等
-     *
-     * @param code 用于判断的值
-     * @return 判断结果
-     */
     default boolean isCodeEquals(int code) {
         return getCode() == code;
     }
 
-    /**
-     * 判断是否与给定的 {@link IWithCode} 有着相等的 {@code code}
-     *
-     * @param other 用于比较的对象
-     * @return 判断结果
-     */
     default boolean isSameCodeAs(@Nullable IWithCode<?> other) {
         return other != null && Objects.equals(getCode(), other.getCode());
     }
 
-    /**
-     * 判断是否与给定的 {@link IWithIntCode} 有着相等的 {@code code}
-     *
-     * @param other 用于比较的对象
-     * @return 判断结果
-     */
     default boolean isSameCodeAs(@Nullable IWithIntCode other) {
         return other != null && getCode() == other.getCode();
     }
 
-    /**
-     * 判断是否与给定的 {@link IWithLongCode} 有着相等的 {@code code}
-     *
-     * @param other 用于比较的对象
-     * @return 判断结果
-     */
     default boolean isSameCodeAs(@Nullable IWithLongCode other) {
         return other != null && getCode() == other.getCode();
     }

src/main/java/xyz/zhouxy/plusone/commons/base/IWithLongCode.java

@@ -28,49 +28,20 @@ import javax.annotation.Nullable;
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 public interface IWithLongCode {
-
-    /**
-     * 获取码值
-     * @return 码值
-     */
     long getCode();
 
-    /**
-     * 判断 {@code code} 与给定的值是否相等
-     *
-     * @param code 用于判断的值
-     * @return 判断结果
-     */
     default boolean isCodeEquals(long code) {
         return getCode() == code;
     }
 
-    /**
-     * 判断是否与给定的 {@link IWithCode} 有着相等的 {@code code}
-     *
-     * @param other 用于比较的对象
-     * @return 判断结果
-     */
     default boolean isSameCodeAs(@Nullable IWithCode<?> other) {
         return other != null && Objects.equals(getCode(), other.getCode());
     }
 
-    /**
-     * 判断是否与给定的 {@link IWithIntCode} 有着相等的 {@code code}
-     *
-     * @param other 用于比较的对象
-     * @return 判断结果
-     */
     default boolean isSameCodeAs(@Nullable IWithIntCode other) {
         return other != null && getCode() == other.getCode();
     }
 
-    /**
-     * 判断是否与给定的 {@link IWithLongCode} 有着相等的 {@code code}
-     *
-     * @param other 用于比较的对象
-     * @return 判断结果
-     */
     default boolean isSameCodeAs(@Nullable IWithLongCode other) {
         return other != null && getCode() == other.getCode();
     }

src/main/java/xyz/zhouxy/plusone/commons/base/Ref.java

@@ -79,100 +79,43 @@ public final class Ref<T> {
         this.value = value;
     }
 
-    /**
-     * 创建对象引用
-     *
-     * @param <T>   引用的类型
-     * @param value 引用的对象
-     * @return {@code Ref} 对象
-     */
     public static <T> Ref<T> of(@Nullable T value) {
         return new Ref<>(value);
     }
 
-    /**
-     * 创建空引用
-     *
-     * @param <T>   引用的类型
-     * @return 空引用
-     */
     public static <T> Ref<T> empty() {
         return new Ref<>(null);
     }
 
-    /**
-     * 获取引用的对象
-     *
-     * @return 引用的对象
-     */
     @Nullable
     public T getValue() {
         return value;
     }
 
-    /**
-     * 设置引用的对象
-     *
-     * @param value 要引用的对象
-     */
     public void setValue(@Nullable T value) {
         this.value = value;
     }
 
-    /**
-     * 使用 {@link UnaryOperator} 修改 {@code Ref} 内部引用的对象
-     *
-     * @param operator 修改逻辑
-     */
     public void transformValue(UnaryOperator<T> operator) {
         this.value = operator.apply(this.value);
     }
 
-    /**
-     * 使用 {@link Function} 修改所引用的对象，返回新的 {@code Ref}
-     *
-     * @param <R>      结果的引用类型
-     * @param function 修改逻辑
-     * @return 修改后的对象的引用
-     */
     public <R> Ref<R> transform(Function<? super T, R> function) {
         return Ref.of(function.apply(this.value));
     }
 
-    /**
-     * 使用 {@link Predicate} 检查引用的对象
-     *
-     * @param predicate 判断逻辑
-     * @return 判断结果
-     */
     public boolean checkValue(Predicate<? super T> predicate) {
         return predicate.test(this.value);
     }
 
-    /**
-     * 将引用的对象作为入参，执行 {@link Consumer} 的逻辑
-     *
-     * @param consumer 要执行的逻辑
-     */
     public void execute(Consumer<? super T> consumer) {
         consumer.accept(value);
     }
 
-    /**
-     * 判断所引用的对象是否为 {@code null}
-     *
-     * @return 是否为 {@code null}
-     */
     public boolean isNull() {
         return this.value == null;
     }
 
-
-    /**
-     * 判断所引用的对象是否不为 {@code null}
-     *
-     * @return 是否不为 {@code null}
-     */
     public boolean isNotNull() {
         return this.value != null;
     }

src/main/java/xyz/zhouxy/plusone/commons/collection/CollectionTools.java

@@ -42,62 +42,26 @@ public class CollectionTools {
     // #region - isEmpty
     // ================================
 
-    /**
-     * 判断集合是否为空
-     *
-     * @param collection 集合
-     * @return 是否为空
-     */
     public static boolean isEmpty(@Nullable Collection<?> collection) {
         return collection == null || collection.isEmpty();
     }
 
-    /**
-     * 判断集合是否为空
-     *
-     * @param map 集合
-     * @return 是否为空
-     */
     public static boolean isEmpty(@Nullable Map<?, ?> map) {
         return map == null || map.isEmpty();
     }
 
-    /**
-     * 判断集合是否为空
-     *
-     * @param table 集合
-     * @return 是否为空
-     */
     public static boolean isEmpty(@Nullable Table<?, ?, ?> table) {
         return table == null || table.isEmpty();
     }
 
-    /**
-     * 判断集合是否为空
-     *
-     * @param map 集合
-     * @return 是否为空
-     */
     public static boolean isEmpty(@Nullable Multimap<?, ?> map) {
         return map == null || map.isEmpty();
     }
 
-    /**
-     * 判断集合是否为空
-     *
-     * @param set 集合
-     * @return 是否为空
-     */
     public static boolean isEmpty(@Nullable Multiset<?> set) {
         return set == null || set.isEmpty();
     }
 
-    /**
-     * 判断集合是否为空
-     *
-     * @param set 集合
-     * @return 是否为空
-     */
     public static boolean isEmpty(@Nullable RangeSet<?> set) {
         return set == null || set.isEmpty();
     }
@@ -110,62 +74,26 @@ public class CollectionTools {
     // #region - isNotEmpty
     // ================================
 
-    /**
-     * 判断集合是否不为空
-     *
-     * @param collection 集合
-     * @return 是否不为空
-     */
     public static boolean isNotEmpty(@Nullable Collection<?> collection) {
         return collection != null && !collection.isEmpty();
     }
 
-    /**
-     * 判断集合是否不为空
-     *
-     * @param map 集合
-     * @return 是否不为空
-     */
     public static boolean isNotEmpty(@Nullable Map<?, ?> map) {
         return map != null && !map.isEmpty();
     }
 
-    /**
-     * 判断集合是否不为空
-     *
-     * @param table 集合
-     * @return 是否不为空
-     */
     public static boolean isNotEmpty(@Nullable Table<?, ?, ?> table) {
         return table != null && !table.isEmpty();
     }
 
-    /**
-     * 判断集合是否不为空
-     *
-     * @param map 集合
-     * @return 是否不为空
-     */
     public static boolean isNotEmpty(@Nullable Multimap<?, ?> map) {
         return map != null && !map.isEmpty();
     }
 
-    /**
-     * 判断集合是否不为空
-     *
-     * @param set 集合
-     * @return 是否不为空
-     */
     public static boolean isNotEmpty(@Nullable Multiset<?> set) {
         return set != null && !set.isEmpty();
     }
 
-    /**
-     * 判断集合是否不为空
-     *
-     * @param set 集合
-     * @return 是否不为空
-     */
     public static boolean isNotEmpty(@Nullable RangeSet<?> set) {
         return set != null && !set.isEmpty();
     }
@@ -178,41 +106,16 @@ public class CollectionTools {
     // #region - nullToEmpty
     // ================================
 
-    /**
-     * 将 {@code null} 转为空 {@code List}
-     *
-     * @param <T> List 元素的类型
-     * @param list list
-     * @return 如果 {@code list} 为 {@code null}，返回空列表；
-     *         如果 {@code list} 不为 {@code null}，返回 {@code list} 本身
-     */
     @Nonnull
     public static <T> List<T> nullToEmptyList(@Nullable List<T> list) {
         return list == null ? Collections.emptyList() : list;
     }
 
-    /**
-     * 将 {@code null} 转为空 {@code Set}
-     *
-     * @param <T> Set 元素的类型
-     * @param set set
-     * @return 如果 {@code set} 为 {@code null}，返回空集合；
-     *         如果 {@code set} 不为 {@code null}，返回 {@code set} 本身
-     */
     @Nonnull
     public static <T> Set<T> nullToEmptySet(@Nullable Set<T> set) {
         return set == null ? Collections.emptySet() : set;
     }
 
-    /**
-     * 将 {@code null} 转为空 {@code Map}
-     *
-     * @param <K> Map 的键的类型
-     * @param <V> Map 的值的类型
-     * @param map map
-     * @return 如果 {@code map} 为 {@code null}，返回空集合；
-     *         如果 {@code map} 不为 {@code null}，返回 {@code map} 本身
-     */
     @Nonnull
     public static <K, V> Map<K, V> nullToEmptyMap(@Nullable Map<K, V> map) {
         return map == null ? Collections.emptyMap() : map;

src/main/java/xyz/zhouxy/plusone/commons/exception/DataNotExistsException.java

@@ -26,40 +26,18 @@ public final class DataNotExistsException extends Exception {
 
     private static final long serialVersionUID = 6536955800679703111L;
 
-    /**
-     * 使用默认 message 构造新的 {@code DataNotExistsException}。
-     * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
-     */
     public DataNotExistsException() {
         super();
     }
 
-    /**
-     * 使用指定的 {@code message} 构造新的 {@code DataNotExistsException}。
-     * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
-     *
-     * @param message 异常信息
-     */
     public DataNotExistsException(String message) {
         super(message);
     }
 
-    /**
-     * 使用指定的 {@code cause} 构造新的 {@code DataNotExistsException}。
-     * {@code message} 为 (cause==null ? null : cause.toString())。
-     *
-     * @param cause 包装的异常
-     */
     public DataNotExistsException(Throwable cause) {
         super(cause);
     }
 
-    /**
-     * 使用指定的 {@code message} 和 {@code cause} 构造新的 {@code DataNotExistsException}。
-     *
-     * @param message 异常信息
-     * @param cause   包装的异常
-     */
     public DataNotExistsException(String message, Throwable cause) {
         super(message, cause);
     }

src/main/java/xyz/zhouxy/plusone/commons/exception/MultiTypesException.java

@@ -124,66 +124,26 @@ import xyz.zhouxy.plusone.commons.base.IWithCode;
  */
 public interface MultiTypesException<E extends Exception, T extends MultiTypesException.ExceptionType<E>> {
 
-    /**
-     * 异常类型
-     *
-     * @return 异常类型。通常是实现了 {@link ExceptionType} 的枚举。
-     */
     @Nonnull
     T getType();
 
-    /**
-     * 获取异常类型编码
-     *
-     * @return 异常类型编码
-     */
     default @Nonnull String getTypeCode() {
         return getType().getCode();
     }
 
-    /**
-     * 异常类型
-     */
     public static interface ExceptionType<E extends Exception> extends IWithCode<String> {
 
-        /**
-         * 默认异常信息
-         */
         String getDefaultMessage();
 
-        /**
-         * 创建异常
-         *
-         * @return 异常对象
-         */
         @Nonnull
         E create();
 
-        /**
-         * 使用指定 {@code message} 创建异常
-         *
-         * @param message 异常信息
-         * @return 异常对象
-         */
         @Nonnull
         E create(String message);
 
-        /**
-         * 使用指定 {@code cause} 创建异常
-         *
-         * @param cause 包装的异常
-         * @return 异常对象
-         */
         @Nonnull
         E create(Throwable cause);
 
-        /**
-         * 使用指定 {@code message} 和 {@code cause} 创建异常
-         *
-         * @param message 异常信息
-         * @param cause   包装的异常
-         * @return 异常对象
-         */
         @Nonnull
         E create(String message, Throwable cause);
 

src/main/java/xyz/zhouxy/plusone/commons/exception/ParsingFailureException.java

@@ -59,56 +59,22 @@ public final class ParsingFailureException
         this.type = type;
     }
 
-    /**
-     * 创建默认类型的 {@code ParsingFailureException}。
-     * {@code type} 为 {@link Type#DEFAULT}，
-     * {@code message} 为 {@link Type#DEFAULT} 的默认信息。
-     * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
-     */
     public ParsingFailureException() {
         this(Type.DEFAULT, Type.DEFAULT.getDefaultMessage());
     }
 
-    /**
-     * 使用指定 {@code message} 创建默认类型的 {@code ParsingFailureException}。
-     * {@code type} 为 {@link Type#DEFAULT}，
-     * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
-     *
-     * @param message 异常信息
-     */
     public ParsingFailureException(String message) {
         this(Type.DEFAULT, message);
     }
 
-    /**
-     * 使用指定的 {@code cause} 创建默认类型的 {@code ParsingFailureException}。
-     * {@code type} 为 {@link Type#DEFAULT}，
-     * {@code message} 为 (cause==null ? null : cause.toString())。
-     *
-     * @param cause 包装的异常
-     */
     public ParsingFailureException(Throwable cause) {
         this(Type.DEFAULT, cause);
     }
 
-    /**
-     * 使用指定的 {@code message} 和 {@code cause} 创建默认类型的 {@code ParsingFailureException}。
-     * {@code type} 为 {@link Type#DEFAULT}。
-     *
-     * @param message 异常信息
-     * @param cause   包装的异常
-     */
     public ParsingFailureException(String message, Throwable cause) {
         this(Type.DEFAULT, message, cause);
     }
 
-    /**
-     * 将 {@link DateTimeParseException} 包装为 {@link ParsingFailureException}。
-     * {@code type} 为 {@link Type#DATE_TIME_PARSING_FAILURE}。
-     *
-     * @param cause 包装的 {@code DateTimeParseException}
-     * @return ParsingFailureException
-     */
     public static ParsingFailureException of(DateTimeParseException cause) {
         if (cause == null) {
             return Type.DATE_TIME_PARSING_FAILURE.create();
@@ -116,25 +82,10 @@ public final class ParsingFailureException
         return Type.DATE_TIME_PARSING_FAILURE.create(cause.getMessage(), cause);
     }
 
-    /**
-     * 将 {@link DateTimeParseException} 包装为 {@link ParsingFailureException}。
-     * {@code type} 为 {@link Type#DATE_TIME_PARSING_FAILURE}。
-     *
-     * @param message 异常信息
-     * @param cause   包装的 {@code DateTimeParseException}
-     * @return ParsingFailureException
-     */
     public static ParsingFailureException of(String message, DateTimeParseException cause) {
         return Type.DATE_TIME_PARSING_FAILURE.create(message, cause);
     }
 
-    /**
-     * 将 {@link NumberFormatException} 包装为 {@link ParsingFailureException}。
-     * {@code type} 为 {@link Type#NUMBER_PARSING_FAILURE}。
-     *
-     * @param cause 包装的 {@code NumberFormatException}
-     * @return ParsingFailureException
-     */
     public static ParsingFailureException of(NumberFormatException cause) {
         if (cause == null) {
             return Type.NUMBER_PARSING_FAILURE.create();
@@ -142,14 +93,6 @@ public final class ParsingFailureException
         return Type.NUMBER_PARSING_FAILURE.create(cause.getMessage(), cause);
     }
 
-    /**
-     * 将 {@link NumberFormatException} 包装为 {@link ParsingFailureException}。
-     * {@code type} 为 {@link Type#NUMBER_PARSING_FAILURE}。
-     *
-     * @param message 异常信息
-     * @param cause   {@code NumberFormatException}
-     * @return ParsingFailureException
-     */
     public static ParsingFailureException of(String message, NumberFormatException cause) {
         return Type.NUMBER_PARSING_FAILURE.create(message, cause);
     }
@@ -160,15 +103,10 @@ public final class ParsingFailureException
         return type;
     }
 
-    /** 默认类型 */
     public static final Type DEFAULT = Type.DEFAULT;
-    /** 数字转换失败 */
     public static final Type NUMBER_PARSING_FAILURE = Type.NUMBER_PARSING_FAILURE;
-    /** 时间解析失败 */
     public static final Type DATE_TIME_PARSING_FAILURE = Type.DATE_TIME_PARSING_FAILURE;
-    /** JSON 解析失败 */
     public static final Type JSON_PARSING_FAILURE = Type.JSON_PARSING_FAILURE;
-    /** XML 解析失败 */
     public static final Type XML_PARSING_FAILURE = Type.XML_PARSING_FAILURE;
 
     public enum Type implements ExceptionType<ParsingFailureException> {

src/main/java/xyz/zhouxy/plusone/commons/exception/business/BizException.java

@@ -33,40 +33,18 @@ public class BizException extends RuntimeException {
 
     private static final String DEFAULT_MSG = "业务异常";
 
-    /**
-     * 使用默认 message 构造新的业务异常。
-     * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
-     */
     public BizException() {
         super(DEFAULT_MSG);
     }
 
-    /**
-     * 使用指定的 {@code message} 构造新的业务异常。
-     * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
-     *
-     * @param message 异常信息
-     */
     public BizException(String message) {
         super(message);
     }
 
-    /**
-     * 使用指定的 {@code cause} 构造新的业务异常。
-     * {@code message} 为 (cause==null ? null : cause.toString())。
-     *
-     * @param cause 包装的异常
-     */
     public BizException(Throwable cause) {
         super(cause);
     }
 
-    /**
-     * 使用指定的 {@code message} 和 {@code cause} 构造新的业务异常。
-     *
-     * @param message 异常信息
-     * @param cause   包装的异常
-     */
     public BizException(String message, Throwable cause) {
         super(message, cause);
     }

src/main/java/xyz/zhouxy/plusone/commons/exception/business/InvalidInputException.java

@@ -60,45 +60,18 @@ public final class InvalidInputException
         this.type = type;
     }
 
-    /**
-     * 创建默认类型的 {@code InvalidInputException}。
-     * {@code type} 为 {@link Type#DEFAULT}，
-     * {@code message} 为 {@link Type#DEFAULT} 的默认信息。
-     * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
-     */
     public InvalidInputException() {
         this(Type.DEFAULT);
     }
 
-    /**
-     * 使用指定 {@code message} 创建默认类型的 {@code InvalidInputException}。
-     * {@code type} 为 {@link Type#DEFAULT}，
-     * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
-     *
-     * @param message 异常信息
-     */
     public InvalidInputException(String message) {
         this(Type.DEFAULT, message);
     }
 
-    /**
-     * 使用指定的 {@code cause} 创建默认类型的 {@code InvalidInputException}。
-     * {@code type} 为 {@link Type#DEFAULT}，
-     * {@code message} 为 (cause==null ? null : cause.toString())。
-     *
-     * @param cause 包装的异常
-     */
     public InvalidInputException(Throwable cause) {
         this(Type.DEFAULT, cause);
     }
 
-    /**
-     * 使用指定的 {@code message} 和 {@code cause} 创建默认类型的 {@code InvalidInputException}。
-     * {@code type} 为 {@link Type#DEFAULT}。
-     *
-     * @param message 异常信息
-     * @param cause   包装的异常
-     */
     public InvalidInputException(String message, Throwable cause) {
         this(Type.DEFAULT, message, cause);
     }

src/main/java/xyz/zhouxy/plusone/commons/exception/business/RequestParamsException.java

@@ -30,40 +30,18 @@ public class RequestParamsException extends BizException {
 
     private static final String DEFAULT_MSG = "用户请求参数错误";
 
-    /**
-     * 使用默认 message 构造新的 {@code RequestParamsException}。
-     * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
-     */
     public RequestParamsException() {
         super(DEFAULT_MSG);
     }
 
-    /**
-     * 使用指定的 {@code message} 构造新的 {@code RequestParamsException}。
-     * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
-     *
-     * @param message 异常信息
-     */
     public RequestParamsException(String message) {
         super(message);
     }
 
-    /**
-     * 使用指定的 {@code cause} 构造新的 {@code RequestParamsException}。
-     * {@code message} 为 (cause==null ? null : cause.toString())。
-     *
-     * @param cause 包装的异常
-     */
     public RequestParamsException(Throwable cause) {
         super(cause);
     }
 
-    /**
-     * 使用指定的 {@code message} 和 {@code cause} 构造新的 {@code RequestParamsException}。
-     *
-     * @param message 异常信息
-     * @param cause   包装的异常
-     */
     public RequestParamsException(String message, Throwable cause) {
         super(message, cause);
     }

src/main/java/xyz/zhouxy/plusone/commons/exception/system/DataOperationResultException.java

@@ -35,40 +35,18 @@ public final class DataOperationResultException extends SysException {
 
     private static final String DEFAULT_MSG = "数据操作的结果不符合预期";
 
-    /**
-     * 使用默认 message 构造新的 {@code DataOperationResultException}。
-     * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
-     */
     public DataOperationResultException() {
         super(DEFAULT_MSG);
     }
 
-    /**
-     * 使用指定的 {@code message} 构造新的 {@code DataOperationResultException}。
-     * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
-     *
-     * @param message 异常信息
-     */
     public DataOperationResultException(String message) {
         super(message);
     }
 
-    /**
-     * 使用指定的 {@code cause} 构造新的 {@code DataOperationResultException}。
-     * {@code message} 为 (cause==null ? null : cause.toString())。
-     *
-     * @param cause 包装的异常
-     */
     public DataOperationResultException(Throwable cause) {
         super(cause);
     }
 
-    /**
-     * 使用指定的 {@code message} 和 {@code cause} 构造新的 {@code DataOperationResultException}。
-     *
-     * @param message 异常信息
-     * @param cause   包装的异常
-     */
     public DataOperationResultException(String message, Throwable cause) {
         super(message, cause);
     }

src/main/java/xyz/zhouxy/plusone/commons/exception/system/NoAvailableMacFoundException.java

@@ -29,40 +29,18 @@ package xyz.zhouxy.plusone.commons.exception.system;
 public class NoAvailableMacFoundException extends SysException {
     private static final long serialVersionUID = 152827098461071551L;
 
-    /**
-     * 使用默认 message 构造新的 {@code NoAvailableMacFoundException}。
-     * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
-     */
     public NoAvailableMacFoundException() {
         super();
     }
 
-    /**
-     * 使用指定的 {@code message} 构造新的 {@code NoAvailableMacFoundException}。
-     * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
-     *
-     * @param message 异常信息
-     */
     public NoAvailableMacFoundException(String message) {
         super(message);
     }
 
-    /**
-     * 使用指定的 {@code cause} 构造新的 {@code NoAvailableMacFoundException}。
-     * {@code message} 为 (cause==null ? null : cause.toString())。
-     *
-     * @param cause 包装的异常
-     */
     public NoAvailableMacFoundException(Throwable cause) {
         super(cause);
     }
 
-    /**
-     * 使用指定的 {@code message} 和 {@code cause} 构造新的 {@code NoAvailableMacFoundException}。
-     *
-     * @param message 异常信息
-     * @param cause   包装的异常
-     */
     public NoAvailableMacFoundException(String message, Throwable cause) {
         super(message, cause);
     }

src/main/java/xyz/zhouxy/plusone/commons/exception/system/SysException.java

@@ -30,40 +30,18 @@ public class SysException extends RuntimeException {
 
     private static final String DEFAULT_MSG = "系统异常";
 
-    /**
-     * 使用默认 message 构造新的系统异常。
-     * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
-     */
     public SysException() {
         super(DEFAULT_MSG);
     }
 
-    /**
-     * 使用指定的 {@code message} 构造新的系统异常。
-     * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
-     *
-     * @param message 异常信息
-     */
     public SysException(String message) {
         super(message);
     }
 
-    /**
-     * 使用指定的 {@code cause} 构造新的系统异常。
-     * {@code message} 为 (cause==null ? null : cause.toString())。
-     *
-     * @param cause 包装的异常
-     */
     public SysException(Throwable cause) {
         super(cause);
     }
 
-    /**
-     * 使用指定的 {@code message} 和 {@code cause} 构造新的系统异常。
-     *
-     * @param message 异常信息
-     * @param cause   包装的异常
-     */
     public SysException(String message, Throwable cause) {
         super(message, cause);
     }

src/main/java/xyz/zhouxy/plusone/commons/function/BoolUnaryOperator.java

@@ -18,35 +18,11 @@ package xyz.zhouxy.plusone.commons.function;
 
 import com.google.common.annotations.Beta;
 
-/**
- * BoolUnaryOperator
- *
- * <p>
- * 一个特殊的 {@link java.util.function.UnaryOperator}。
- * 表示对 {@code boolean} 值的一元操作。
- * </p>
- *
- * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 1.0.0
- * @see java.util.function.UnaryOperator
- */
 @Beta
 @FunctionalInterface
 public interface BoolUnaryOperator {
-
-    /**
-     * 将此函数应用于给定的 {@code boolean} 参数，返回一个 {@code boolean} 结果。
-     *
-     * @param operand 操作数
-     * @return 结果
-     */
     boolean applyAsBool(boolean operand);
 
-    /**
-     * 返回一个 {@code BoolUnaryOperator}，该操作符将给定的操作数取反。
-     *
-     * @return {@code BoolUnaryOperator}
-     */
     static BoolUnaryOperator not() {
         return b -> !b;
     }

src/main/java/xyz/zhouxy/plusone/commons/function/CharUnaryOperator.java

@@ -18,27 +18,8 @@ package xyz.zhouxy.plusone.commons.function;
 
 import com.google.common.annotations.Beta;
 
-/**
- * CharUnaryOperator
- *
- * <p>
- * 一个特殊的 {@link java.util.function.UnaryOperator}。
- * 表示对 {@code char} 的一元操作。
- * </p>
- *
- * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 1.0.0
- * @see java.util.function.UnaryOperator
- */
 @Beta
 @FunctionalInterface
 public interface CharUnaryOperator {
-
-    /**
-     * 将此函数应用于给定的 {@code char} 参数，返回一个 {@code char} 结果。
-     *
-     * @param operand 操作数
-     * @return 结果
-     */
     char applyAsChar(char operand);
 }

src/main/java/xyz/zhouxy/plusone/commons/function/Executable.java

@@ -16,26 +16,9 @@
 
 package xyz.zhouxy.plusone.commons.function;
 
-/**
- * Executable
- *
- * <p>
- * 表示一个无入参无返回值的操作，可抛出异常。
- * </p>
- *
- * @param <E> 可抛出的异常类型
- *
- * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 1.0.0
- */
 @FunctionalInterface
 public interface Executable<E extends Throwable> {
 
-    /**
-     * 执行
-     *
-     * @throws E 可抛出的异常
-     */
     void execute() throws E;
 
 }

src/main/java/xyz/zhouxy/plusone/commons/function/OptionalSupplier.java

@@ -24,7 +24,6 @@ import java.util.function.Supplier;
  *
  * <p>
  * 返回 {@code Optional&lt;T&gt;} 对象。
- * </p>
  *
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0

src/main/java/xyz/zhouxy/plusone/commons/function/ThrowingConsumer.java

@@ -16,24 +16,13 @@
 
 package xyz.zhouxy.plusone.commons.function;
 
-/**
- * ThrowingConsumer
- *
- * <p>
- * 允许抛出异常的消费操作。是一个特殊的 {@link java.util.function.Consumer}。
- * </p>
- *
- * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 1.0.0
- * @see java.util.function.Consumer
- */
 @FunctionalInterface
 public interface ThrowingConsumer<T, E extends Throwable> {
 
     /**
-     * 消费给定的参数，允许抛出异常
+     * Consume the supplied argument, potentially throwing an exception.
      *
-     * @param t 要消费的参数
+     * @param t the argument to consume
      */
     void accept(T t) throws E;
 

src/main/java/xyz/zhouxy/plusone/commons/function/ThrowingFunction.java

@@ -15,29 +15,14 @@
  */
 package xyz.zhouxy.plusone.commons.function;
 
-/**
- * ThrowingFunction
- *
- * <p>
- * 接收一个参数，并返回一个结果，可以抛出异常。
- * </p>
- *
- * @param <T> 入参类型
- * @param <R> 返回结果类型
- * @param <E> 异常类型
- *
- * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 1.0
- * @see java.util.function.Function
- */
 @FunctionalInterface
 public interface ThrowingFunction<T, R, E extends Throwable> {
 
     /**
-     * 接收一个参数，并返回一个结果，可以抛出异常。
+     * Applies this function to the given argument.
      *
-     * @param t 入参
+     * @param t the function argument
-     * @return 函数结果
+     * @return the function result
      */
     R apply(T t) throws E;
 

src/main/java/xyz/zhouxy/plusone/commons/function/ThrowingPredicate.java

@@ -16,25 +16,14 @@
 
 package xyz.zhouxy.plusone.commons.function;
 
-/**
- * ThrowingPredicate
- *
- * <p>
- * 接收一个参数，返回一个布尔值，可抛出异常。
- * </p>
- *
- * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 1.0.0
- * @see java.util.function.Predicate
- */
-@FunctionalInterface
 public interface ThrowingPredicate<T, E extends Throwable> {
 
     /**
-     * 对给定的参数进行评估
+     * Evaluates this predicate on the given argument.
      *
-     * @param t 入参
+     * @param t the input argument
-     * @return 入参符合条件时返回 {@code true}，否则返回 {@code false}
+     * @return {@code true} if the input argument matches the predicate,
+     * otherwise {@code false}
      */
     boolean test(T t) throws E;
 }

src/main/java/xyz/zhouxy/plusone/commons/function/ThrowingSupplier.java

@@ -16,27 +16,13 @@
 
 package xyz.zhouxy.plusone.commons.function;
 
-/**
- * ThrowingSupplier
- *
- * <p>
- * 允许抛出异常的 Supplier 接口。
- * </p>
- *
- * @param <T> 结果类型
- * @param <E> 异常类型
- *
- * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 1.0.0
- * @see java.util.function.Supplier
- */
 @FunctionalInterface
 public interface ThrowingSupplier<T, E extends Throwable> {
 
     /**
-     * 获取一个结果，允许抛出异常。
+     * Get a result, potentially throwing an exception.
      *
-     * @return 结果
+     * @return a result
      */
     T get() throws E;
 

src/main/java/xyz/zhouxy/plusone/commons/model/Chinese2ndGenIDCardNumber.java

@@ -16,15 +16,11 @@
 
 package xyz.zhouxy.plusone.commons.model;
 
-import java.io.Serializable;
 import java.time.LocalDate;
 import java.time.format.DateTimeFormatter;
 import java.util.Map;
-import java.util.Objects;
 import java.util.regex.Matcher;
 
-import javax.annotation.Nullable;
-
 import com.google.common.base.Strings;
 import com.google.common.collect.ImmutableMap;
 import com.google.errorprone.annotations.Immutable;
@@ -49,11 +45,8 @@ import xyz.zhouxy.plusone.commons.util.StringTools;
 @ValueObject
 @Immutable
 public class Chinese2ndGenIDCardNumber
-        implements IDCardNumber, Comparable<Chinese2ndGenIDCardNumber>, Serializable {
+        extends ValidatableStringRecord<Chinese2ndGenIDCardNumber>
-    private static final long serialVersionUID = 5655592250204184210L;
+        implements IDCardNumber {
-
-    /** 身份证号码 */
-    private final String value;
 
     /** 省份编码 */
     private final String provinceCode;
@@ -68,129 +61,79 @@ public class Chinese2ndGenIDCardNumber
 
     private static final DateTimeFormatter DATE_FORMATTER = DateTimeFormatter.ofPattern("yyyyMMdd");
 
-    private Chinese2ndGenIDCardNumber(String value,
+    private Chinese2ndGenIDCardNumber(String value) {
-            String provinceCode, String cityCode, String countyCode,
+        super(value.toUpperCase(),  PatternConsts.CHINESE_2ND_ID_CARD_NUMBER, () -> "二代居民身份证校验失败：" + value);
-            Gender gender, LocalDate birthDate) {
+
-        this.value = value;
+        final Matcher matcher = getMatcher();
-        this.provinceCode = provinceCode;
+
-        this.cityCode = cityCode;
+        final String provinceCodeValue = matcher.group("province");
-        this.countyCode = countyCode;
+        AssertTools.checkArgument(Chinese2ndGenIDCardNumber.PROVINCE_CODES.containsKey(provinceCodeValue));
-        this.gender = gender;
+
-        this.birthDate = birthDate;
+        final String cityCodeValue = matcher.group("city");
-    }
+        final String countyCodeValue = matcher.group("county");
+
+        final Gender genderValue;
+        final LocalDate birthDateValue;
 
-    /**
-     * 根据身份证号码创建 {@code Chinese2ndGenIDCardNumber} 对象
-     *
-     * @param idCardNumber 身份证号码值
-     * @return {@code Chinese2ndGenIDCardNumber} 对象
-     */
-    public static Chinese2ndGenIDCardNumber of(final String idCardNumber) {
         try {
-            AssertTools.checkArgument(StringTools.isNotBlank(idCardNumber), "二代居民身份证校验失败：号码为空");
-            final String value = idCardNumber.toUpperCase();
-            final Matcher matcher = PatternConsts.CHINESE_2ND_ID_CARD_NUMBER.matcher(value);
-            AssertTools.checkArgument(matcher.matches(), () -> "二代居民身份证校验失败：" + value);
-
-            final String provinceCode = matcher.group("province");
-            AssertTools.checkArgument(Chinese2ndGenIDCardNumber.PROVINCE_CODES.containsKey(provinceCode));
-
-            final String cityCode = matcher.group("city");
-            final String countyCode = matcher.group("county");
-
             // 出生日期
             final String birthDateStr = matcher.group("birthDate");
-            final LocalDate birthDate = LocalDate.parse(birthDateStr, DATE_FORMATTER);
+            birthDateValue = LocalDate.parse(birthDateStr, DATE_FORMATTER);
 
             // 性别
             final int genderCode = Integer.parseInt(matcher.group("gender"));
-            final Gender gender = genderCode % 2 == 0 ? Gender.FEMALE : Gender.MALE;
+            genderValue = genderCode % 2 == 0 ? Gender.FEMALE : Gender.MALE;
-
-            return new Chinese2ndGenIDCardNumber(value, provinceCode, cityCode, countyCode, gender, birthDate);
-        }
-        catch (IllegalArgumentException e) {
-            throw e;
         }
         catch (Exception e) {
             throw new IllegalArgumentException(e);
         }
+
+        this.provinceCode = provinceCodeValue;
+        this.cityCode = cityCodeValue;
+        this.countyCode = countyCodeValue;
+        this.gender = genderValue;
+        this.birthDate = birthDateValue;
+    }
+
+    public static Chinese2ndGenIDCardNumber of(final String value) {
+        AssertTools.checkArgument(StringTools.isNotBlank(value), "二代居民身份证校验失败：号码为空");
+        return new Chinese2ndGenIDCardNumber(value);
     }
 
     // ================================
     // #region - reader methods
     // ================================
 
-    @Override
-    @ReaderMethod
-    public String value() {
-        return value;
-    }
-
-    /**
-     * 所属省份代码
-     *
-     * @return 所属省份代码
-     */
     @ReaderMethod
     public String getProvinceCode() {
         return provinceCode;
     }
 
-    /**
-     * 所属省份名称
-     *
-     * @return 所属省份名称
-     */
     @ReaderMethod
     public String getProvinceName() {
         return PROVINCE_CODES.get(this.provinceCode);
     }
 
-    /**
-     * 所属省份完整行政区划代码
-     *
-     * @return 所属省份完整行政区划代码
-     */
     @ReaderMethod
     public String getFullProvinceCode() {
         return Strings.padEnd(this.provinceCode, 12, '0');
     }
 
-    /**
-     * 所属市级代码
-     *
-     * @return 所属市级代码
-     */
     @ReaderMethod
     public String getCityCode() {
         return cityCode;
     }
 
-    /**
-     * 所属市级完整行政区划代码
-     *
-     * @return 所属市级完整行政区划代码
-     */
     @ReaderMethod
     public String getFullCityCode() {
         return Strings.padEnd(this.cityCode, 12, '0');
     }
 
-    /**
-     * 所属县级代码
-     *
-     * @return 所属县级代码
-     */
     @ReaderMethod
     public String getCountyCode() {
         return countyCode;
     }
 
-    /**
-     * 所属县级完整行政区划代码
-     *
-     * @return 所属县级完整行政区划代码
-     */
     @ReaderMethod
     public String getFullCountyCode() {
         return Strings.padEnd(this.countyCode, 12, '0');
@@ -212,72 +155,59 @@ public class Chinese2ndGenIDCardNumber
     // #endregion - reader methods
     // ================================
 
-    /** 省份代码表 */
+    /**
-    public static final Map<String, String> PROVINCE_CODES = ImmutableMap.<String, String>builder()
+     * 省份代码表
-            .put("11", "北京")
+     */
-            .put("12", "天津")
+    public static final Map<String, String> PROVINCE_CODES;
-            .put("13", "河北")
-            .put("14", "山西")
-            .put("15", "内蒙古")
-            .put("21", "辽宁")
-            .put("22", "吉林")
-            .put("23", "黑龙江")
-            .put("31", "上海")
-            .put("32", "江苏")
-            .put("33", "浙江")
-            .put("34", "安徽")
-            .put("35", "福建")
-            .put("36", "江西")
-            .put("37", "山东")
-            .put("41", "河南")
-            .put("42", "湖北")
-            .put("43", "湖南")
-            .put("44", "广东")
-            .put("45", "广西")
-            .put("46", "海南")
-            .put("50", "重庆")
-            .put("51", "四川")
-            .put("52", "贵州")
-            .put("53", "云南")
-            .put("54", "西藏")
-            .put("61", "陕西")
-            .put("62", "甘肃")
-            .put("63", "青海")
-            .put("64", "宁夏")
-            .put("65", "新疆")
-            .put("71", "台湾")
-            .put("81", "香港")
-            .put("82", "澳门")
-            .put("83", "台湾") // 台湾身份证号码以83开头，但是行政区划为71
-            .put("91", "国外")
-            .build();
 
-    @SuppressWarnings("null")
+    static {
-    @Override
+        PROVINCE_CODES = ImmutableMap.<String, String>builder()
-    public int compareTo(Chinese2ndGenIDCardNumber o) {
+                .put("11", "北京")
-        return value.compareTo(o.value);
+                .put("12", "天津")
+                .put("13", "河北")
+                .put("14", "山西")
+                .put("15", "内蒙古")
+                .put("21", "辽宁")
+                .put("22", "吉林")
+                .put("23", "黑龙江")
+                .put("31", "上海")
+                .put("32", "江苏")
+                .put("33", "浙江")
+                .put("34", "安徽")
+                .put("35", "福建")
+                .put("36", "江西")
+                .put("37", "山东")
+                .put("41", "河南")
+                .put("42", "湖北")
+                .put("43", "湖南")
+                .put("44", "广东")
+                .put("45", "广西")
+                .put("46", "海南")
+                .put("50", "重庆")
+                .put("51", "四川")
+                .put("52", "贵州")
+                .put("53", "云南")
+                .put("54", "西藏")
+                .put("61", "陕西")
+                .put("62", "甘肃")
+                .put("63", "青海")
+                .put("64", "宁夏")
+                .put("65", "新疆")
+                .put("71", "台湾")
+                .put("81", "香港")
+                .put("82", "澳门")
+                .put("83", "台湾") // 台湾身份证号码以83开头，但是行政区划为71
+                .put("91", "国外")
+                .build();
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(value);
+        return super.hashCode();
     }
 
     @Override
-    public boolean equals(@Nullable Object obj) {
+    public boolean equals(Object obj) {
-        if (this == obj) {
+        return super.equals(obj);
-            return true;
-        }
-        if (!(obj instanceof Chinese2ndGenIDCardNumber)) {
-            return false;
-        }
-        Chinese2ndGenIDCardNumber other = (Chinese2ndGenIDCardNumber) obj;
-        return Objects.equals(value, other.value);
     }
-
-    @Override
-    public String toString() {
-        return value();
-    }
-
 }

src/main/java/xyz/zhouxy/plusone/commons/model/Gender.java

@@ -43,41 +43,20 @@ public enum Gender implements IWithIntCode {
         this.displayNameZh = displayNameZh;
     }
 
-    /**
-     * 根据码值获取对应枚举
-     *
-     * @param value 码值
-     * @return 枚举值
-     */
     public static Gender of(int value) {
         AssertTools.checkCondition(0 <= value && value < VALUES.length,
                 () -> new EnumConstantNotPresentException(Gender.class, String.valueOf(value)));
         return VALUES[value];
     }
 
-    /**
-     * 获取枚举码值
-     *
-     * @return 码值
-     */
     public int getValue() {
         return value;
     }
 
-    /**
-     * 枚举名称
-     *
-     * @return 枚举名称
-     */
     public String getDisplayName() {
         return displayName;
     }
 
-    /**
-     * 枚举中文名称
-     *
-     * @return 枚举中文名称
-     */
     public String getDisplayNameZh() {
         return displayNameZh;
     }

src/main/java/xyz/zhouxy/plusone/commons/model/IDCardNumber.java

@@ -19,7 +19,7 @@ package xyz.zhouxy.plusone.commons.model;
 import java.time.LocalDate;
 import java.time.Period;
 
-import xyz.zhouxy.plusone.commons.util.StringTools;
+import xyz.zhouxy.plusone.commons.util.AssertTools;
 
 /**
  * 身份证号
@@ -30,32 +30,19 @@ public interface IDCardNumber {
     static final int DEFAULT_DISPLAY_FRONT = 1;
     static final int DEFAULT_DISPLAY_END = 2;
 
-    /**
-     * 身份证号
-     *
-     * @return 身份证号
-     */
     String value();
 
     /**
      * 根据身份证号判断性别
-     *
-     * @return {@link Gender} 对象
      */
     Gender getGender();
 
     /**
      * 获取出生日期
-     *
-     * @return 出生日期
      */
     LocalDate getBirthDate();
 
-    /**
+    /** 计算年龄 */
-     * 计算年龄
-     *
-     * @return 年龄
-     */
     default int getAge() {
         LocalDate now = LocalDate.now();
         return Period.between(getBirthDate(), now).getYears();
@@ -65,36 +52,23 @@ public interface IDCardNumber {
     // #region - toString
     // ================================
 
-    /**
-     * 脱敏字符串（前面留 1 位，后面留 2 位）
-     *
-     * @return 脱敏字符串
-     */
     default String toDesensitizedString() {
-        return StringTools.desensitize(value(), DEFAULT_REPLACED_CHAR, DEFAULT_DISPLAY_FRONT, DEFAULT_DISPLAY_END);
+        return toDesensitizedString(DEFAULT_REPLACED_CHAR, DEFAULT_DISPLAY_FRONT, DEFAULT_DISPLAY_END);
     }
 
-    /**
-     * 脱敏字符串
-     *
-     * @param front 前面保留的字符数
-     * @param end   后面保留的字符数
-     * @return 脱敏字符串
-     */
     default String toDesensitizedString(int front, int end) {
-        return StringTools.desensitize(value(), DEFAULT_REPLACED_CHAR, front, end);
+        return toDesensitizedString(DEFAULT_REPLACED_CHAR, front, end);
     }
 
-    /**
-     * 脱敏字符串
-     *
-     * @param replacedChar 替换字符
-     * @param front        前面保留的字符数
-     * @param end          后面保留的字符数
-     * @return 脱敏字符串
-     */
     default String toDesensitizedString(char replacedChar, int front, int end) {
-        return StringTools.desensitize(value(), replacedChar, front, end);
+        final String value = value();
+        AssertTools.checkArgument(front >= 0 && end >= 0);
+        AssertTools.checkArgument((front + end) <= value.length(), "需要截取的长度不能大于身份证号长度");
+        final char[] charArray = value.toCharArray();
+        for (int i = front; i < charArray.length - end; i++) {
+            charArray[i] = replacedChar;
+        }
+        return String.valueOf(charArray);
     }
 
     // ================================

src/main/java/xyz/zhouxy/plusone/commons/model/ValidatableStringRecord.java

@@ -22,7 +22,6 @@ import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 
 import javax.annotation.Nonnull;
-import javax.annotation.Nullable;
 
 import xyz.zhouxy.plusone.commons.annotation.ReaderMethod;
 import xyz.zhouxy.plusone.commons.util.AssertTools;
@@ -32,11 +31,8 @@ import xyz.zhouxy.plusone.commons.util.AssertTools;
  *
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
- *
- * @deprecated 弃用。使用工厂方法创建对象，并在其中进行校验即可。
  */
-@Deprecated
+public abstract class ValidatableStringRecord<T extends ValidatableStringRecord<T>>
-public abstract class ValidatableStringRecord<T extends ValidatableStringRecord<T>> // NOSONAR 暂不删除
         implements Comparable<T> {
 
     @Nonnull
@@ -44,36 +40,17 @@ public abstract class ValidatableStringRecord<T extends ValidatableStringRecord<
 
     private final Matcher matcher;
 
-    /**
+    protected ValidatableStringRecord(@Nonnull String value, @Nonnull Pattern pattern) {
-     * 构造字符串值对象
-     *
-     * @param value   字符串值
-     * @param pattern 正则
-     */
-    protected ValidatableStringRecord(String value, Pattern pattern) {
         this(value, pattern, "Invalid value");
     }
 
-    /**
+    protected ValidatableStringRecord(@Nonnull String value, @Nonnull Pattern pattern,
-     * 构造字符串值对象
+            @Nonnull Supplier<String> errorMessageSupplier) {
-     *
-     * @param value                字符串值
-     * @param pattern              正则
-     * @param errorMessageSupplier 正则不匹配时的错误信息
-     */
-    protected ValidatableStringRecord(String value, Pattern pattern,
-            Supplier<String> errorMessageSupplier) {
         this(value, pattern, errorMessageSupplier.get());
     }
 
-    /**
+    protected ValidatableStringRecord(@Nonnull String value, @Nonnull Pattern pattern,
-     * 构造字符串值对象
+            @Nonnull String errorMessage) {
-     *
-     * @param value        字符串值
-     * @param pattern      正则
-     * @param errorMessage 正则不匹配时的错误信息
-     */
-    protected ValidatableStringRecord(String value, Pattern pattern, String errorMessage) {
         AssertTools.checkArgument(Objects.nonNull(value), "The value cannot be null.");
         AssertTools.checkArgument(Objects.nonNull(pattern), "The pattern cannot be null.");
         this.matcher = pattern.matcher(value);
@@ -92,7 +69,7 @@ public abstract class ValidatableStringRecord<T extends ValidatableStringRecord<
     }
 
     @Override
-    public int compareTo(@SuppressWarnings("null") T o) {
+    public int compareTo(T o) {
         return this.value.compareTo(o.value());
     }
 
@@ -102,7 +79,7 @@ public abstract class ValidatableStringRecord<T extends ValidatableStringRecord<
     }
 
     @Override
-    public boolean equals(@Nullable Object obj) {
+    public boolean equals(Object obj) {
         if (this == obj)
             return true;
         if (obj == null)
@@ -119,11 +96,6 @@ public abstract class ValidatableStringRecord<T extends ValidatableStringRecord<
         return this.value();
     }
 
-    /**
-     * 获取正则匹配结果
-     *
-     * @return {@code Matcher} 对象
-     */
     protected final Matcher getMatcher() {
         return matcher;
     }

src/main/java/xyz/zhouxy/plusone/commons/model/dto/PageResult.java

@@ -19,8 +19,6 @@ package xyz.zhouxy.plusone.commons.model.dto;
 import java.util.Collections;
 import java.util.List;
 
-import javax.annotation.Nullable;
-
 import xyz.zhouxy.plusone.commons.annotation.StaticFactoryMethod;
 import xyz.zhouxy.plusone.commons.collection.CollectionTools;
 
@@ -38,49 +36,25 @@ public class PageResult<T> {
 
     private final List<T> content;
 
-    private PageResult(@Nullable final List<T> content, final long total) {
+    private PageResult(List<T> content, long total) {
         this.content = CollectionTools.nullToEmptyList(content);
         this.total = total;
     }
 
-    /**
-     * 创建一个分页查询的结果
-     *
-     * @param <T>     内容类型
-     * @param content 一页数据
-     * @param total   总数据量
-     * @return 分页查询的结果
-     */
     @StaticFactoryMethod(PageResult.class)
-    public static <T> PageResult<T> of(@Nullable final List<T> content, final long total) {
+    public static <T> PageResult<T> of(List<T> content, long total) {
         return new PageResult<>(content, total);
     }
 
-    /**
-     * 创建一个空的分页查询的结果
-     *
-     * @param <T> 内容类型
-     * @return 空结果
-     */
     @StaticFactoryMethod(PageResult.class)
     public static <T> PageResult<T> empty() {
         return new PageResult<>(Collections.emptyList(), 0L);
     }
 
-    /**
-     * 总数据量
-     *
-     * @return 总数据量
-     */
     public long getTotal() {
         return total;
     }
 
-    /**
-     * 一页数据
-     *
-     * @return 一页数据
-     */
     public List<T> getContent() {
         return content;
     }

src/main/java/xyz/zhouxy/plusone/commons/model/dto/PagingAndSortingQueryParams.java

@@ -21,6 +21,7 @@ import java.util.Map;
 import java.util.regex.Pattern;
 import java.util.stream.Collectors;
 
+import javax.annotation.Nonnull;
 import javax.annotation.Nullable;
 
 import com.google.common.collect.ImmutableMap;
@@ -50,16 +51,11 @@ public class PagingAndSortingQueryParams {
     private Long pageNum;
     private List<String> orderBy;
 
-    private static final Pattern SORT_STR_PATTERN = Pattern.compile("^[a-zA-Z][\\w-]{0,63}-(desc|asc|DESC|ASC)$");
+    private static final Pattern SORT_STR_PATTERN = Pattern.compile("^[a-zA-Z]\\w+-(desc|asc|DESC|ASC)$");
 
     private final Map<String, String> sortableProperties;
 
-    /**
+    public PagingAndSortingQueryParams(@Nonnull Map<String, String> sortableProperties) {
-     * 构造分页排序查询参数
-     *
-     * @param sortableProperties 可排序的属性。不可为空。
-     */
-    public PagingAndSortingQueryParams(Map<String, String> sortableProperties) {
         AssertTools.checkArgument(CollectionTools.isNotEmpty(sortableProperties),
                 "Sortable properties can not be empty.");
         sortableProperties.forEach((k, v) ->
@@ -70,58 +66,28 @@ public class PagingAndSortingQueryParams {
 
     // Setters
 
-    /**
+    public final void setOrderBy(@Nullable List<String> orderBy) {
-     * 设置排序规则
-     *
-     * @param orderBy 排序规则，不能为空
-     */
-    public final void setOrderBy(List<String> orderBy) {
         this.orderBy = orderBy;
     }
 
-    /**
-     * 设置每页大小
-     *
-     * @param size 每页大小
-     */
     public final void setSize(@Nullable Integer size) {
         this.size = size;
     }
 
-    /**
-     * 设置页码
-     *
-     * @param pageNum 页码
-     */
     public final void setPageNum(@Nullable Long pageNum) {
         this.pageNum = pageNum;
     }
 
     // Setters end
 
-    /**
-     * 构建分页参数
-     *
-     * @return {@code PagingParams} 对象
-     */
     public final PagingParams buildPagingParams() {
         final int sizeValue = this.size != null ? this.size : defaultSizeInternal();
         final long pageNumValue = this.pageNum != null ? this.pageNum : 1L;
-        AssertTools.checkArgument(CollectionTools.isNotEmpty(this.orderBy),
+        final List<SortableProperty> propertiesToSort = this.orderBy.stream().map(this::generateSortableProperty)
-                "The 'orderBy' cannot be empty");
-        final List<SortableProperty> propertiesToSort = this.orderBy.stream()
-                .map(this::generateSortableProperty)
                 .collect(Collectors.toList());
         return new PagingParams(sizeValue, pageNumValue, propertiesToSort);
     }
 
-    /**
-     * 默认每页大小
-     *
-     * <p>NOTE: 可覆写此方法</p>
-     *
-     * @return 默认每页大小
-     */
     @Virtual
     protected int defaultSizeInternal() {
         return DEFAULT_PAGE_SIZE;
@@ -138,7 +104,6 @@ public class PagingAndSortingQueryParams {
     }
 
     private SortableProperty generateSortableProperty(String orderByStr) {
-        AssertTools.checkArgument(StringTools.isNotBlank(orderByStr));
         AssertTools.checkArgument(RegexTools.matches(orderByStr, SORT_STR_PATTERN));
         String[] propertyNameAndOrderType = orderByStr.split("-");
         AssertTools.checkArgument(propertyNameAndOrderType.length == 2);
@@ -151,9 +116,6 @@ public class PagingAndSortingQueryParams {
         return new SortableProperty(propertyName, columnName, orderType);
     }
 
-    /**
-     * 可排序属性
-     */
     public static final class SortableProperty {
         private final String propertyName;
         private final String columnName;
@@ -170,38 +132,18 @@ public class PagingAndSortingQueryParams {
             this.sqlSnippet = this.propertyName + " " + this.orderType;
         }
 
-        /**
-         * 属性名
-         *
-         * @return 属性名
-         */
         public String getPropertyName() {
             return propertyName;
         }
 
-        /**
-         * 对应数据库中列名称
-         *
-         * @return 列名称
-         */
         public String getColumnName() {
             return columnName;
         }
 
-        /**
-         * 排序方式
-         *
-         * @return 排序方式
-         */
         public String getOrderType() {
             return orderType;
         }
 
-        /**
-         * SQL 片段
-         *
-         * @return SQL 片段
-         */
         public String getSqlSnippet() {
             return sqlSnippet;
         }

src/main/java/xyz/zhouxy/plusone/commons/model/dto/PagingParams.java

@@ -23,13 +23,9 @@ import xyz.zhouxy.plusone.commons.model.dto.PagingAndSortingQueryParams.Sortable
 
 public class PagingParams {
 
-    /** 每页大小 */
     private final int size;
-    /** 当前页码 */
     private final long pageNum;
-    /** 偏移量 */
     private final long offset;
-    /** 排序 */
     private final List<SortableProperty> orderBy;
 
     PagingParams(int size, long pageNum, List<SortableProperty> orderBy) {
@@ -41,38 +37,18 @@ public class PagingParams {
 
     // Getters
 
-    /**
-     * 排序规则
-     *
-     * @return 排序规则
-     */
     public final List<SortableProperty> getOrderBy() {
         return Collections.unmodifiableList(this.orderBy);
     }
 
-    /**
-     * 每页大小
-     *
-     * @return 每页大小
-     */
     public final int getSize() {
         return this.size;
     }
 
-    /**
-     * 当前页码
-     *
-     * @return 当前页码
-     */
     public final long getPageNum() {
         return this.pageNum;
     }
 
-    /**
-     * 偏移量
-     *
-     * @return 偏移量
-     */
     public final long getOffset() {
         return this.offset;
     }

src/main/java/xyz/zhouxy/plusone/commons/model/dto/UnifiedResponse.java

@@ -35,23 +35,10 @@ public class UnifiedResponse<T> {
     // #region - Constructors
     // ================================
 
-    /**
-     * 构造 {@code UnifiedResponse}
-     *
-     * @param code    状态码
-     * @param message 响应信息
-     */
     UnifiedResponse(String code, @Nullable String message) {
         this(code, message, null);
     }
 
-    /**
-     * 构造 {@code UnifiedResponse}
-     *
-     * @param code    状态码
-     * @param message 响应信息
-     * @param data    响应数据
-     */
     UnifiedResponse(String code, @Nullable String message, @Nullable T data) {
         this.code = Objects.requireNonNull(code);
         this.message = message == null ? "" : message;
@@ -66,29 +53,14 @@ public class UnifiedResponse<T> {
     // #region - Getters
     // ================================
 
-    /**
-     * 状态码
-     *
-     * @return 状态码
-     */
     public String getCode() {
         return code;
     }
 
-    /**
-     * 响应信息
-     *
-     * @return 响应信息
-     */
     public String getMessage() {
         return message;
     }
 
-    /**
-     * 响应数据
-     *
-     * @return 响应数据
-     */
     @Nullable
     public T getData() {
         return data;
@@ -104,7 +76,7 @@ public class UnifiedResponse<T> {
                 this.code, this.message, transValue(this.data));
     }
 
-    private static String transValue(@Nullable Object value) {
+    private static String transValue(Object value) {
         if (value == null) {
             return null;
         }

src/main/java/xyz/zhouxy/plusone/commons/model/dto/UnifiedResponses.java

@@ -34,36 +34,14 @@ public class UnifiedResponses {
     // #region - success
     // ================================
 
-    /**
-     * 默认成功响应结果
-     *
-     * @return {@code UnifiedResponse} 对象。
-     *         {@code code} = "2000000", {@code message} = "SUCCESS", {@code data} = null
-     */
     public static UnifiedResponse<Void> success() {
         return new UnifiedResponse<>(SUCCESS_CODE, DEFAULT_SUCCESS_MSG);
     }
 
-    /**
-     * 使用指定 {@code message} 创建成功响应结果
-     *
-     * @param message 成功信息
-     * @return {@code UnifiedResponse} 对象。
-     *         {@code code} = "2000000", {@code data} = null
-     */
     public static UnifiedResponse<Void> success(@Nullable String message) {
         return new UnifiedResponse<>(SUCCESS_CODE, message);
     }
 
-    /**
-     * 使用指定 {@code message} 和 {@code data} 创建成功响应结果
-     *
-     * @param <T>     data 类型
-     * @param message 成功信息
-     * @param data    携带数据
-     * @return {@code UnifiedResponse} 对象。
-     *         {@code code} = "2000000"
-     */
     public static <T> UnifiedResponse<T> success(@Nullable String message, @Nullable T data) {
         return new UnifiedResponse<>(SUCCESS_CODE, message, data);
     }
@@ -76,39 +54,14 @@ public class UnifiedResponses {
     // #region - error
     // ================================
 
-    /**
-     * 创建错误响应结果
-     *
-     * @param code    错误码
-     * @param message 错误信息
-     * @return {@code UnifiedResponse} 对象（{@code data} 为 {@code null}）
-     */
     public static UnifiedResponse<Void> error(String code, @Nullable String message) {
         return new UnifiedResponse<>(code, message);
     }
 
-    /**
-     * 创建错误响应结果
-     *
-     * @param <T>     data 类型
-     * @param code    错误码
-     * @param message 错误信息
-     * @param data    携带数据
-     * @return {@code UnifiedResponse} 对象
-     */
     public static <T> UnifiedResponse<T> error(String code, @Nullable String message, @Nullable T data) {
         return new UnifiedResponse<>(code, message, data);
     }
 
-    /**
-     * 创建错误响应结果
-     *
-     * @param code 错误码
-     * @param e    异常
-     * @return {@code UnifiedResponse} 对象。
-     *         {@code message} 为异常的 {@code message}，
-     *         {@code data} 为 {@code null}。
-     */
     public static UnifiedResponse<Void> error(String code, Throwable e) {
         return new UnifiedResponse<>(code, e.getMessage());
     }
@@ -121,26 +74,10 @@ public class UnifiedResponses {
     // #region - of
     // ================================
 
-    /**
-     * 创建响应结果
-     *
-     * @param code    状态码
-     * @param message 响应信息
-     * @return {@code UnifiedResponse} 对象（{@code data} 为 {@code null}）
-     */
     public static UnifiedResponse<Void> of(String code, @Nullable String message) {
         return new UnifiedResponse<>(code, message);
     }
 
-    /**
-     * 创建响应结果
-     *
-     * @param <T>     data 类型
-     * @param code    状态码
-     * @param message 响应信息
-     * @param data    携带数据
-     * @return {@code UnifiedResponse} 对象
-     */
     public static <T> UnifiedResponse<T> of(String code, @Nullable String message, @Nullable T data) {
         return new UnifiedResponse<>(code, message, data);
     }

src/main/java/xyz/zhouxy/plusone/commons/model/dto/package-info.java

@@ -64,7 +64,4 @@
  *
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
-@ParametersAreNonnullByDefault
 package xyz.zhouxy.plusone.commons.model.dto;
-
-import javax.annotation.ParametersAreNonnullByDefault;

src/main/java/xyz/zhouxy/plusone/commons/model/package-info.java

@@ -22,7 +22,4 @@
  *
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
-@ParametersAreNonnullByDefault
 package xyz.zhouxy.plusone.commons.model;
-
-import javax.annotation.ParametersAreNonnullByDefault;

src/main/java/xyz/zhouxy/plusone/commons/time/Quarter.java

@@ -46,7 +46,6 @@ public enum Quarter implements IWithIntCode {
     /** 季度值 (1/2/3/4) */
     private final int value;
 
-    /** 月份范围 */
     private final Range<Integer> monthRange;
 
     /** 常量值 */
@@ -64,9 +63,7 @@ public enum Quarter implements IWithIntCode {
         this.monthRange = Range.closed(firstMonth, lastMonth);
     }
 
-    // ================================
+    // StaticFactoryMethods
-    // #region - StaticFactoryMethods
-    // ================================
 
     /**
      * 根据给定的月份值返回对应的季度
@@ -117,48 +114,23 @@ public enum Quarter implements IWithIntCode {
         return ENUMS[checkValidIntValue(value) - 1];
     }
 
-    // ================================
+    // StaticFactoryMethods end
-    // #endregion - StaticFactoryMethods
-    // ================================
 
-    // ================================
+    // computes
-    // #region - computes
-    // ================================
 
-    /**
-     * 加上指定数量的季度
-     *
-     * @param quarters 所添加的季度数量
-     * @return 计算结果
-     */
     public Quarter plus(long quarters) {
         final int amount = (int) ((quarters % 4) + 4);
         return ENUMS[(ordinal() + amount) % 4];
     }
 
-    /**
-     * 减去指定数量的季度
-     *
-     * @param quarters 所减去的季度数量
-     * @return 计算结果
-     */
     public Quarter minus(long quarters) {
         return plus(-(quarters % 4));
     }
 
-    // ================================
+    // computes end
-    // #endregion - computes
-    // ================================
 
-    // ================================
+    // Getters
-    // #region - Getters
-    // ================================
 
-    /**
-     * 获取季度值
-     *
-     * @return 季度值
-     */
     public int getValue() {
         return value;
     }
@@ -168,92 +140,45 @@ public enum Quarter implements IWithIntCode {
         return getValue();
     }
 
-    /**
-     * 该季度的第一个月
-     *
-     * @return {@code Month} 对象
-     */
     public Month firstMonth() {
         return Month.of(firstMonthValue());
     }
 
-    /**
-     * 该季度的第一个月
-     *
-     * @return 月份值从 1 开始，1 表示 1月，以此类推。
-     */
     public int firstMonthValue() {
         return this.monthRange.lowerEndpoint();
     }
 
-    /**
-     * 该季度的最后一个月
-     *
-     * @return {@code Month} 对象
-     */
     public Month lastMonth() {
         return Month.of(lastMonthValue());
     }
 
-    /**
-     * 该季度的最后一个月
-     *
-     * @return 月份值从 1 开始，1 表示 1月，以此类推。
-     */
     public int lastMonthValue() {
         return this.monthRange.upperEndpoint();
     }
 
-    /**
-     * 该季度的第一天
-     *
-     * @return {@code MonthDay} 对象
-     */
     public MonthDay firstMonthDay() {
         return MonthDay.of(firstMonth(), 1);
     }
 
-    /**
-     * 该季度的最后一天
-     *
-     * @return {@code MonthDay} 对象
-     */
     public MonthDay lastMonthDay() {
         // 季度的最后一个月不可能是 2 月
         final Month month = lastMonth();
         return MonthDay.of(month, month.maxLength());
     }
 
-    /**
-     * 计算该季度的第一天为当年的第几天
-     *
-     * @param leapYear 是否为闰年
-     * @return day of year
-     */
     public int firstDayOfYear(boolean leapYear) {
         return firstMonth().firstDayOfYear(leapYear);
     }
 
-    // ================================
+    // Getters end
-    // #endregion - Getters
-    // ================================
 
-    /**
-     * 检查给定的季度值是否有效
-     *
-     * @param value 季度值
-     * @return 如果给定的季度值有效则返回该值
-     * @throws DateTimeException 如果给定的季度值不在有效范围内（1到4），将抛出异常
-     */
     public static int checkValidIntValue(int value) {
         AssertTools.checkCondition(value >= 1 && value <= 4,
                 () -> new DateTimeException("Invalid value for Quarter: " + value));
         return value;
     }
 
-    // ================================
+    // Internal
-    // #region - Internal
-    // ================================
 
     /**
      * 计算给定月份对应的季度值
@@ -264,8 +189,4 @@ public enum Quarter implements IWithIntCode {
     private static int computeQuarterValueInternal(int monthValue) {
         return (monthValue - 1) / 3 + 1;
     }
-
-    // ================================
-    // #endregion - Internal
-    // ================================
 }

src/main/java/xyz/zhouxy/plusone/commons/time/YearQuarter.java

@@ -139,11 +139,6 @@ public final class YearQuarter implements Comparable<YearQuarter>, Serializable
         return of(yearMonth.getYear(), Quarter.fromMonth(yearMonth.getMonth()));
     }
 
-    /**
-     * 根据现在的日期，判断所在的年份与季度，创建 {@link YearQuarter} 实例
-     *
-     * @return {@link YearQuarter} 实例
-     */
     @StaticFactoryMethod(YearQuarter.class)
     public static YearQuarter now() {
         return of(LocalDate.now());
@@ -153,101 +148,46 @@ public final class YearQuarter implements Comparable<YearQuarter>, Serializable
 
     // #region - Getters
 
-    /**
-     * 年份
-     *
-     * @return 年份
-     */
     public int getYear() {
         return this.year;
     }
 
-    /**
-     * 季度
-     *
-     * @return 季度
-     */
     public Quarter getQuarter() {
         return this.quarter;
     }
 
-    /**
-     * 季度值。从 1 开始。
-     *
-     * @return 季度值
-     */
     public int getQuarterValue() {
         return this.quarter.getValue();
     }
 
-    /**
-     * 该季度第一个月
-     *
-     * @return {@link YearMonth} 对象
-     */
     public YearMonth firstYearMonth() {
         return YearMonth.of(this.year, this.quarter.firstMonth());
     }
 
-    /**
-     * 该季度第一个月
-     *
-     * @return {@link Month} 对象
-     */
     public Month firstMonth() {
         return this.quarter.firstMonth();
     }
 
-    /**
-     * 该季度的第一个月
-     *
-     * @return 结果。月份值从 1 开始，1 表示 1月，以此类推。
-     */
     public int firstMonthValue() {
         return this.quarter.firstMonthValue();
     }
 
-    /**
-     * 该季度的最后一个月
-     *
-     * @return {@link YearMonth} 对象
-     */
     public YearMonth lastYearMonth() {
         return YearMonth.of(this.year, this.quarter.lastMonth());
     }
 
-    /**
-     * 该季度的最后一个月
-     *
-     * @return {@link Month} 对象
-     */
     public Month lastMonth() {
         return this.quarter.lastMonth();
     }
 
-    /**
-     * 该季度的最后一个月
-     *
-     * @return 结果。月份值从 1 开始，1 表示 1月，以此类推。
-     */
     public int lastMonthValue() {
         return this.quarter.lastMonthValue();
     }
 
-    /**
-     * 该季度的第一天
-     *
-     * @return {@link LocalDate} 对象
-     */
     public LocalDate firstDate() {
         return firstDate;
     }
 
-    /**
-     * 该季度的最后一天
-     *
-     * @return {@link LocalDate} 对象
-     */
     public LocalDate lastDate() {
         return lastDate;
     }
@@ -283,7 +223,7 @@ public final class YearQuarter implements Comparable<YearQuarter>, Serializable
         if (yearsToAdd == 0L) {
             return this;
         }
-        int newYear = YEAR.checkValidIntValue(this.year + yearsToAdd); // safe overflow
+        int newYear = YEAR.checkValidIntValue(this.year + yearsToAdd);  // safe overflow
         return new YearQuarter(newYear, this.quarter);
     }
 

src/main/java/xyz/zhouxy/plusone/commons/util/ArrayTools.java

@@ -470,24 +470,10 @@ public class ArrayTools {
 
     // repeat - char
 
-    /**
-     * 重复数组中的元素
-     *
-     * @param arr   重复内容
-     * @param times 重复次数
-     * @return 重复后的数组
-     */
     public static char[] repeat(char[] arr, int times) {
         return repeat(arr, times, Integer.MAX_VALUE);
     }
 
-    /**
-     * 重复数组中的元素
-     * @param arr       重复内容
-     * @param times     重复次数
-     * @param maxLength 最大长度
-     * @return 重复后的数组
-     */
     public static char[] repeat(char[] arr, int times, int maxLength) {
         AssertTools.checkArgument(Objects.nonNull(arr));
         AssertTools.checkArgument(times >= 0,
@@ -505,24 +491,10 @@ public class ArrayTools {
 
     // repeat - byte
 
-    /**
-     * 重复数组中的元素
-     *
-     * @param arr   重复内容
-     * @param times 重复次数
-     * @return 重复后的数组
-     */
     public static byte[] repeat(byte[] arr, int times) {
         return repeat(arr, times, Integer.MAX_VALUE);
     }
 
-    /**
-     * 重复数组中的元素
-     * @param arr       重复内容
-     * @param times     重复次数
-     * @param maxLength 最大长度
-     * @return 重复后的数组
-     */
     public static byte[] repeat(byte[] arr, int times, int maxLength) {
         AssertTools.checkArgument(Objects.nonNull(arr));
         AssertTools.checkArgument(times >= 0,
@@ -540,24 +512,10 @@ public class ArrayTools {
 
     // repeat - short
 
-    /**
-     * 重复数组中的元素
-     *
-     * @param arr   重复内容
-     * @param times 重复次数
-     * @return 重复后的数组
-     */
     public static short[] repeat(short[] arr, int times) {
         return repeat(arr, times, Integer.MAX_VALUE);
     }
 
-    /**
-     * 重复数组中的元素
-     * @param arr       重复内容
-     * @param times     重复次数
-     * @param maxLength 最大长度
-     * @return 重复后的数组
-     */
     public static short[] repeat(short[] arr, int times, int maxLength) {
         AssertTools.checkArgument(Objects.nonNull(arr));
         AssertTools.checkArgument(times >= 0,
@@ -575,24 +533,10 @@ public class ArrayTools {
 
     // repeat - int
 
-    /**
-     * 重复数组中的元素
-     *
-     * @param arr   重复内容
-     * @param times 重复次数
-     * @return 重复后的数组
-     */
     public static int[] repeat(int[] arr, int times) {
         return repeat(arr, times, Integer.MAX_VALUE);
     }
 
-    /**
-     * 重复数组中的元素
-     * @param arr       重复内容
-     * @param times     重复次数
-     * @param maxLength 最大长度
-     * @return 重复后的数组
-     */
     public static int[] repeat(int[] arr, int times, int maxLength) {
         AssertTools.checkArgument(Objects.nonNull(arr));
         AssertTools.checkArgument(times >= 0,
@@ -610,24 +554,10 @@ public class ArrayTools {
 
     // repeat - long
 
-    /**
-     * 重复数组中的元素
-     *
-     * @param arr   重复内容
-     * @param times 重复次数
-     * @return 重复后的数组
-     */
     public static long[] repeat(long[] arr, int times) {
         return repeat(arr, times, Integer.MAX_VALUE);
     }
 
-    /**
-     * 重复数组中的元素
-     * @param arr       重复内容
-     * @param times     重复次数
-     * @param maxLength 最大长度
-     * @return 重复后的数组
-     */
     public static long[] repeat(long[] arr, int times, int maxLength) {
         AssertTools.checkArgument(Objects.nonNull(arr));
         AssertTools.checkArgument(times >= 0,
@@ -645,24 +575,10 @@ public class ArrayTools {
 
     // repeat - float
 
-    /**
-     * 重复数组中的元素
-     *
-     * @param arr   重复内容
-     * @param times 重复次数
-     * @return 重复后的数组
-     */
     public static float[] repeat(float[] arr, int times) {
         return repeat(arr, times, Integer.MAX_VALUE);
     }
 
-    /**
-     * 重复数组中的元素
-     * @param arr       重复内容
-     * @param times     重复次数
-     * @param maxLength 最大长度
-     * @return 重复后的数组
-     */
     public static float[] repeat(float[] arr, int times, int maxLength) {
         AssertTools.checkArgument(Objects.nonNull(arr));
         AssertTools.checkArgument(times >= 0,
@@ -680,24 +596,10 @@ public class ArrayTools {
 
     // repeat - double
 
-    /**
-     * 重复数组中的元素
-     *
-     * @param arr   重复内容
-     * @param times 重复次数
-     * @return 重复后的数组
-     */
     public static double[] repeat(double[] arr, int times) {
         return repeat(arr, times, Integer.MAX_VALUE);
     }
 
-    /**
-     * 重复数组中的元素
-     * @param arr       重复内容
-     * @param times     重复次数
-     * @param maxLength 最大长度
-     * @return 重复后的数组
-     */
     public static double[] repeat(double[] arr, int times, int maxLength) {
         AssertTools.checkArgument(Objects.nonNull(arr));
         AssertTools.checkArgument(times >= 0,
@@ -719,34 +621,14 @@ public class ArrayTools {
 
     // fill - char
 
-    /**
-     * 填充数组
-     *
-     * @param a      要填充的数组
-     * @param values 填充内容
-     */
     public static void fill(char[] a, @Nullable char[] values) {
         fill(a, 0, a.length, values);
     }
 
-    /**
-     * 填充数组
-     *
-     * @param a      要填充的数组
-     * @param values 填充内容
-     */
     public static void fill(char[] a, @Nullable String values) {
         fill(a, 0, a.length, values != null ? values.toCharArray() : EMPTY_CHAR_ARRAY);
     }
 
-    /**
-     * 填充数组
-     *
-     * @param a         要填充的数组
-     * @param fromIndex 开始位置
-     * @param toIndex   结束位置
-     * @param values    填充内容
-     */
     public static void fill(char[] a, int fromIndex, int toIndex, @Nullable char[] values) {
         AssertTools.checkArgument(Objects.nonNull(a));
         if (values == null || values.length == 0) {
@@ -772,24 +654,10 @@ public class ArrayTools {
 
     // fill - byte
 
-    /**
-     * 填充数组
-     *
-     * @param a      要填充的数组
-     * @param values 填充内容
-     */
     public static void fill(byte[] a, @Nullable byte[] values) {
         fill(a, 0, a.length, values);
     }
 
-    /**
-     * 填充数组
-     *
-     * @param a         要填充的数组
-     * @param fromIndex 开始位置
-     * @param toIndex   结束位置
-     * @param values    填充内容
-     */
     public static void fill(byte[] a, int fromIndex, int toIndex, @Nullable byte[] values) {
         AssertTools.checkArgument(Objects.nonNull(a));
         if (values == null || values.length == 0) {
@@ -815,24 +683,10 @@ public class ArrayTools {
 
     // fill - short
 
-    /**
-     * 填充数组
-     *
-     * @param a      要填充的数组
-     * @param values 填充内容
-     */
     public static void fill(short[] a, @Nullable short[] values) {
         fill(a, 0, a.length, values);
     }
 
-    /**
-     * 填充数组
-     *
-     * @param a         要填充的数组
-     * @param fromIndex 开始位置
-     * @param toIndex   结束位置
-     * @param values    填充内容
-     */
     public static void fill(short[] a, int fromIndex, int toIndex, @Nullable short[] values) {
         AssertTools.checkArgument(Objects.nonNull(a));
         if (values == null || values.length == 0) {
@@ -858,24 +712,10 @@ public class ArrayTools {
 
     // fill - int
 
-    /**
-     * 填充数组
-     *
-     * @param a      要填充的数组
-     * @param values 填充内容
-     */
     public static void fill(int[] a, @Nullable int[] values) {
         fill(a, 0, a.length, values);
     }
 
-    /**
-     * 填充数组
-     *
-     * @param a         要填充的数组
-     * @param fromIndex 开始位置
-     * @param toIndex   结束位置
-     * @param values    填充内容
-     */
     public static void fill(int[] a, int fromIndex, int toIndex, @Nullable int[] values) {
         AssertTools.checkArgument(Objects.nonNull(a));
         if (values == null || values.length == 0) {
@@ -901,24 +741,10 @@ public class ArrayTools {
 
     // fill - long
 
-    /**
-     * 填充数组
-     *
-     * @param a      要填充的数组
-     * @param values 填充内容
-     */
     public static void fill(long[] a, @Nullable long[] values) {
         fill(a, 0, a.length, values);
     }
 
-    /**
-     * 填充数组
-     *
-     * @param a         要填充的数组
-     * @param fromIndex 开始位置
-     * @param toIndex   结束位置
-     * @param values    填充内容
-     */
     public static void fill(long[] a, int fromIndex, int toIndex, @Nullable long[] values) {
         AssertTools.checkArgument(Objects.nonNull(a));
         if (values == null || values.length == 0) {
@@ -944,24 +770,10 @@ public class ArrayTools {
 
     // fill - float
 
-    /**
-     * 填充数组
-     *
-     * @param a      要填充的数组
-     * @param values 填充内容
-     */
     public static void fill(float[] a, @Nullable float[] values) {
         fill(a, 0, a.length, values);
     }
 
-    /**
-     * 填充数组
-     *
-     * @param a         要填充的数组
-     * @param fromIndex 开始位置
-     * @param toIndex   结束位置
-     * @param values    填充内容
-     */
     public static void fill(float[] a, int fromIndex, int toIndex, @Nullable float[] values) {
         AssertTools.checkArgument(Objects.nonNull(a));
         if (values == null || values.length == 0) {
@@ -987,24 +799,10 @@ public class ArrayTools {
 
     // fill - double
 
-    /**
-     * 填充数组
-     *
-     * @param a      要填充的数组
-     * @param values 填充内容
-     */
     public static void fill(double[] a, @Nullable double[] values) {
         fill(a, 0, a.length, values);
     }
 
-    /**
-     * 填充数组
-     *
-     * @param a         要填充的数组
-     * @param fromIndex 开始位置
-     * @param toIndex   结束位置
-     * @param values    填充内容
-     */
     public static void fill(double[] a, int fromIndex, int toIndex, @Nullable double[] values) {
         AssertTools.checkArgument(Objects.nonNull(a));
         if (values == null || values.length == 0) {
@@ -1030,36 +828,14 @@ public class ArrayTools {
 
     // fill - T
 
-    /**
-     * 填充数组
-     *
-     * @param a      要填充的数组
-     * @param values 填充内容
-     */
     public static <T> void fill(T[] a, @Nullable T[] values) {
         fillInternal(a, 0, a.length, values);
     }
 
-    /**
-     * 填充数组
-     *
-     * @param a         要填充的数组
-     * @param fromIndex 开始位置
-     * @param toIndex   结束位置
-     * @param values    填充内容
-     */
     public static <T> void fill(T[] a, int fromIndex, int toIndex, @Nullable T[] values) {
         fillInternal(a, fromIndex, toIndex, values);
     }
 
-    /**
-     * 填充数组
-     *
-     * @param a         要填充的数组
-     * @param fromIndex 开始位置
-     * @param toIndex   结束位置
-     * @param values    填充内容
-     */
     private static <T> void fillInternal(T[] a, int fromIndex, int toIndex, @Nullable T[] values) {
         AssertTools.checkArgument(Objects.nonNull(a));
         if (values == null || values.length == 0) {
@@ -1087,7 +863,7 @@ public class ArrayTools {
 
     // #region - indexOf
 
-    public static <T> int indexOf(@Nullable T[] arr, Predicate<? super T> predicate) {
+    public static <T> int indexOfWithPredicate(@Nullable T[] arr, Predicate<? super T> predicate) {
         AssertTools.checkNotNull(predicate);
         if (arr == null || arr.length == 0) {
             return NOT_FOUND_INDEX;
@@ -1101,7 +877,7 @@ public class ArrayTools {
     }
 
     public static <T> int indexOf(@Nullable T[] arr, @Nullable T obj) {
-        return indexOf(arr, item -> Objects.equals(item, obj));
+        return indexOfWithPredicate(arr, item -> Objects.equals(item, obj));
     }
 
     public static int indexOf(@Nullable char[] arr, char value) {
@@ -1192,7 +968,7 @@ public class ArrayTools {
 
     // #region - lastIndexOf
 
-    public static <T> int lastIndexOf(@Nullable T[] arr, Predicate<? super T> predicate) {
+    public static <T> int lastIndexOfWithPredicate(@Nullable T[] arr, Predicate<? super T> predicate) {
         AssertTools.checkNotNull(predicate);
         if (arr == null || arr.length == 0) {
             return NOT_FOUND_INDEX;
@@ -1206,7 +982,7 @@ public class ArrayTools {
     }
 
     public static <T> int lastIndexOf(T[] arr, T obj) {
-        return lastIndexOf(arr, item -> Objects.equals(item, obj));
+        return lastIndexOfWithPredicate(arr, item -> Objects.equals(item, obj));
     }
 
     public static int lastIndexOf(@Nullable char[] arr, char value) {
@@ -1330,7 +1106,7 @@ public class ArrayTools {
     }
 
     public static boolean containsValue(@Nullable BigDecimal[] arr, @Nullable BigDecimal obj) {
-        return indexOf(arr, item -> BigDecimals.equalsValue(item, obj)) > NOT_FOUND_INDEX;
+        return indexOfWithPredicate(arr, item -> BigDecimals.equalsValue(item, obj)) > NOT_FOUND_INDEX;
     }
 
     // #endregion

src/main/java/xyz/zhouxy/plusone/commons/util/AssertTools.java

@@ -49,46 +49,22 @@ public class AssertTools {
     // #region - Argument
     // ================================
 
-    /**
+    /** Throw {@link IllegalArgumentException} if the {@code condition} is false. */
-     * 检查实参
-     *
-     * @param condition 判断参数是否符合条件的结果
-     * @throws IllegalArgumentException 当条件不满足时抛出
-     */
     public static void checkArgument(boolean condition) {
         checkCondition(condition, IllegalArgumentException::new);
     }
 
-    /**
+    /** Throw {@link IllegalArgumentException} if the {@code condition} is false. */
-     * 检查实参
-     *
-     * @param condition 判断参数是否符合条件的结果
-     * @param errMsg    异常信息
-     * @throws IllegalArgumentException 当条件不满足时抛出
-     */
     public static void checkArgument(boolean condition, @Nullable String errMsg) {
         checkCondition(condition, () -> new IllegalArgumentException(errMsg));
     }
 
-    /**
+    /** Throw {@link IllegalArgumentException} if the {@code condition} is false. */
-     * 检查实参
-     *
-     * @param condition       判断参数是否符合条件的结果
-     * @param messageSupplier 异常信息
-     * @throws IllegalArgumentException 当条件不满足时抛出
-     */
     public static void checkArgument(boolean condition, Supplier<String> messageSupplier) {
         checkCondition(condition, () -> new IllegalArgumentException(messageSupplier.get()));
     }
 
-    /**
+    /** Throw {@link IllegalArgumentException} if the {@code condition} is false. */
-     * 检查实参
-     *
-     * @param condition 判断参数是否符合条件的结果
-     * @param format    异常信息模板
-     * @param args      异常信息参数
-     * @throws IllegalArgumentException 当条件不满足时抛出
-     */
     public static void checkArgument(boolean condition, String format, Object... args) {
         checkCondition(condition, () -> new IllegalArgumentException(String.format(format, args)));
     }
@@ -101,46 +77,22 @@ public class AssertTools {
     // #region - State
     // ================================
 
-    /**
+    /** Throw {@link IllegalStateException} if the {@code condition} is false. */
-     * 检查状态
-     *
-     * @param condition 判断状态是否符合条件的结果
-     * @throws IllegalStateException 当条件不满足时抛出
-     */
     public static void checkState(boolean condition) {
         checkCondition(condition, IllegalStateException::new);
     }
 
-    /**
+    /** Throw {@link IllegalStateException} if the {@code condition} is false. */
-     * 检查状态
-     *
-     * @param condition 判断状态是否符合条件的结果
-     * @param errMsg    异常信息
-     * @throws IllegalStateException 当条件不满足时抛出
-     */
     public static void checkState(boolean condition, @Nullable String errMsg) {
         checkCondition(condition, () -> new IllegalStateException(errMsg));
     }
 
-    /**
+    /** Throw {@link IllegalStateException} if the {@code condition} is false. */
-     * 检查状态
-     *
-     * @param condition       判断状态是否符合条件的结果
-     * @param messageSupplier 异常信息
-     * @throws IllegalStateException 当条件不满足时抛出
-     */
     public static void checkState(boolean condition, Supplier<String> messageSupplier) {
         checkCondition(condition, () -> new IllegalStateException(messageSupplier.get()));
     }
 
-    /**
+    /** Throw {@link IllegalStateException} if the {@code condition} is false. */
-     * 检查状态
-     *
-     * @param condition 判断状态是否符合条件的结果
-     * @param format    异常信息模板
-     * @param args      异常信息参数
-     * @throws IllegalStateException 当条件不满足时抛出
-     */
     public static void checkState(boolean condition, String format, Object... args) {
         checkCondition(condition, () -> new IllegalStateException(String.format(format, args)));
     }
@@ -153,50 +105,22 @@ public class AssertTools {
     // #region - NotNull
     // ================================
 
-    /**
+    /** Throw {@link NullPointerException} if the {@code obj} is null. */
-     * 判空
-     *
-     * @param <T> 入参类型
-     * @param obj 入参     *
-     * @throws NullPointerException 当 {@code obj} 为 {@code null} 时抛出
-     */
     public static <T> void checkNotNull(@Nullable T obj) {
         checkCondition(obj != null, NullPointerException::new);
     }
 
-    /**
+    /** Throw {@link NullPointerException} if the {@code obj} is null. */
-     * 判空
-     *
-     * @param <T>    入参类型
-     * @param obj    入参
-     * @param errMsg 异常信息     *
-     * @throws NullPointerException 当 {@code obj} 为 {@code null} 时抛出
-     */
     public static <T> void checkNotNull(@Nullable T obj, String errMsg) {
         checkCondition(obj != null, () -> new NullPointerException(errMsg));
     }
 
-    /**
+    /** Throw {@link NullPointerException} if the {@code obj} is null. */
-     * 判空
-     *
-     * @param <T>             入参类型
-     * @param obj             入参
-     * @param messageSupplier 异常信息     *
-     * @throws NullPointerException 当 {@code obj} 为 {@code null} 时抛出
-     */
     public static <T> void checkNotNull(@Nullable T obj, Supplier<String> messageSupplier) {
         checkCondition(obj != null, () -> new NullPointerException(messageSupplier.get()));
     }
 
-    /**
+    /** Throw {@link NullPointerException} if the {@code obj} is null. */
-     * 判空
-     *
-     * @param <T>    入参类型
-     * @param obj    入参
-     * @param format 异常信息模板
-     * @param args   异常信息参数
-     * @throws NullPointerException 当 {@code obj} 为 {@code null} 时抛出
-     */
     public static <T> void checkNotNull(@Nullable T obj, String format, Object... args) {
         checkCondition(obj != null, () -> new NullPointerException(String.format(format, args)));
     }
@@ -209,120 +133,56 @@ public class AssertTools {
     // #region - Exists
     // ================================
 
-    /**
+    /** Throw {@link DataNotExistsException} if the {@code obj} is null. */
-     * 检查数据是否存在
-     *
-     * @param <T> 入参类型
-     * @param obj 入参
-     * @return 如果 {@code obj} 存在，返回 {@code obj} 本身
-     * @throws DataNotExistsException 当 {@code obj} 不存在时抛出
-     */
     public static <T> T checkExists(@Nullable T obj)
             throws DataNotExistsException {
         checkCondition(Objects.nonNull(obj), DataNotExistsException::new);
         return obj;
     }
 
-    /**
+    /** Throw {@link DataNotExistsException} if the {@code obj} is null. */
-     * 检查数据是否存在
-     *
-     * @param <T> 入参类型
-     * @param obj 入参
-     * @param message 异常信息
-     * @return 如果 {@code obj} 存在，返回 {@code obj} 本身
-     * @throws DataNotExistsException 当 {@code obj} 不存在时抛出
-     */
     public static <T> T checkExists(@Nullable T obj, String message)
             throws DataNotExistsException {
         checkCondition(Objects.nonNull(obj), () -> new DataNotExistsException(message));
         return obj;
     }
 
-    /**
+    /** Throw {@link DataNotExistsException} if the {@code obj} is null. */
-     * 检查数据是否存在
-     *
-     * @param <T>             入参类型
-     * @param obj             入参
-     * @param messageSupplier 异常信息
-     * @return 如果 {@code obj} 存在，返回 {@code obj} 本身
-     * @throws DataNotExistsException 当 {@code obj} 不存在时抛出
-     */
     public static <T> T checkExists(@Nullable T obj, Supplier<String> messageSupplier)
             throws DataNotExistsException {
         checkCondition(Objects.nonNull(obj), () -> new DataNotExistsException(messageSupplier.get()));
         return obj;
     }
 
-    /**
+    /** Throw {@link DataNotExistsException} if the {@code obj} is null. */
-     * 检查数据是否存在
-     *
-     * @param <T>    入参类型
-     * @param obj    入参
-     * @param format 异常信息模板
-     * @param args   异常信息参数
-     * @return 如果 {@code obj} 存在，返回 {@code obj} 本身
-     * @throws DataNotExistsException 当 {@code obj} 不存在时抛出
-     */
     public static <T> T checkExists(@Nullable T obj, String format, Object... args)
             throws DataNotExistsException {
         checkCondition(Objects.nonNull(obj), () -> new DataNotExistsException(String.format(format, args)));
         return obj;
     }
 
-    /**
+    /** Throw {@link DataNotExistsException} if the {@code optional} is present. */
-     * 检查数据是否存在
-     *
-     * @param <T>      入参类型
-     * @param optional 入参
-     * @return 如果 {@code optional} 存在，返回 {@code optional} 包含的值
-     * @throws DataNotExistsException 当 {@code optional} 的值不存在时抛出
-     */
     public static <T> T checkExists(Optional<T> optional)
             throws DataNotExistsException {
         checkCondition(optional.isPresent(), DataNotExistsException::new);
         return optional.get();
     }
 
-    /**
+    /** Throw {@link DataNotExistsException} if the {@code optional} is present. */
-     * 检查数据是否存在
-     *
-     * @param <T>      入参类型
-     * @param optional 入参
-     * @param message  异常信息
-     * @return 如果 {@code optional} 存在，返回 {@code optional} 包含的值
-     * @throws DataNotExistsException 当 {@code optional} 的值不存在时抛出
-     */
     public static <T> T checkExists(Optional<T> optional, String message)
             throws DataNotExistsException {
         checkCondition(optional.isPresent(), () -> new DataNotExistsException(message));
         return optional.get();
     }
 
-    /**
+    /** Throw {@link DataNotExistsException} if the {@code optional} is present. */
-     * 检查数据是否存在
-     *
-     * @param <T>             入参类型
-     * @param optional        入参
-     * @param messageSupplier 异常信息
-     * @return 如果 {@code optional} 存在，返回 {@code optional} 包含的值
-     * @throws DataNotExistsException 当 {@code optional} 的值不存在时抛出
-     */
     public static <T> T checkExists(Optional<T> optional, Supplier<String> messageSupplier)
             throws DataNotExistsException {
         checkCondition(optional.isPresent(), () -> new DataNotExistsException(messageSupplier.get()));
         return optional.get();
     }
 
-    /**
+    /** Throw {@link DataNotExistsException} if the {@code optional} is present. */
-     * 检查数据是否存在
-     *
-     * @param <T>      入参类型
-     * @param optional 入参
-     * @param format   异常信息模板
-     * @param args     异常信息参数
-     * @return 如果 {@code optional} 存在，返回 {@code optional} 包含的值
-     * @throws DataNotExistsException 当 {@code optional} 的值不存在时抛出
-     */
     public static <T> T checkExists(Optional<T> optional, String format, Object... args)
             throws DataNotExistsException {
         checkCondition(optional.isPresent(), () -> new DataNotExistsException(String.format(format, args)));
@@ -337,182 +197,78 @@ public class AssertTools {
     // #region - AffectedRows
     // ================================
 
-    /**
-     * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
-     *
-     * @param expectedValue 预计的数量
-     * @param result        实际影响的数据量
-     */
     public static void checkAffectedRows(int expectedValue, int result) {
         checkAffectedRows(expectedValue, result,
                 "The number of rows affected is expected to be %d, but is: %d", expectedValue, result);
     }
 
-    /**
-     * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
-     *
-     * @param expectedValue 预计的数量
-     * @param result        实际影响的数据量
-     * @param message       异常信息
-     */
     public static void checkAffectedRows(int expectedValue, int result, @Nullable String message) {
         checkCondition(expectedValue == result, () -> new DataOperationResultException(message));
     }
 
-    /**
-     * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
-     *
-     * @param expectedValue   预计的数量
-     * @param result          实际影响的数据量
-     * @param messageSupplier 异常信息
-     */
     public static void checkAffectedRows(int expectedValue, int result,
             Supplier<String> messageSupplier) {
         checkCondition(expectedValue == result,
                 () -> new DataOperationResultException(messageSupplier.get()));
     }
 
-    /**
-     * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
-     *
-     * @param expectedValue 预计的数量
-     * @param result        实际影响的数据量
-     * @param format        异常信息模板
-     * @param args          异常信息参数
-     */
     public static void checkAffectedRows(int expectedValue, int result,
             String format, Object... args) {
         checkCondition(expectedValue == result,
                 () -> new DataOperationResultException(String.format(format, args)));
     }
 
-    /**
-     * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
-     *
-     * @param expectedValue 预计的数量
-     * @param result        实际影响的数据量
-     */
     public static void checkAffectedRows(long expectedValue, long result) {
         checkAffectedRows(expectedValue, result,
                 "The number of rows affected is expected to be %d, but is: %d", expectedValue, result);
     }
 
-    /**
-     * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
-     *
-     * @param expectedValue 预计的数量
-     * @param result        实际影响的数据量
-     * @param message       异常信息
-     */
     public static void checkAffectedRows(long expectedValue, long result, @Nullable String message) {
         checkCondition(expectedValue == result, () -> new DataOperationResultException(message));
     }
 
-    /**
-     * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
-     *
-     * @param expectedValue   预计的数量
-     * @param result          实际影响的数据量
-     * @param messageSupplier 异常信息
-     */
     public static void checkAffectedRows(long expectedValue, long result,
             Supplier<String> messageSupplier) {
         checkCondition(expectedValue == result,
                 () -> new DataOperationResultException(messageSupplier.get()));
     }
 
-    /**
-     * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
-     *
-     * @param expectedValue 预计的数量
-     * @param result        实际影响的数据量
-     * @param format        异常信息模板
-     * @param args          异常信息参数
-     */
     public static void checkAffectedRows(long expectedValue, long result,
             String format, Object... args) {
         checkCondition(expectedValue == result,
                 () -> new DataOperationResultException(String.format(format, args)));
     }
 
-    /**
-     * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
-     *
-     * @param result 实际影响的数据量
-     */
     public static void checkAffectedOneRow(int result) {
         checkAffectedRows(1, result,
                 () -> "The number of rows affected is expected to be 1, but is: " + result);
     }
 
-    /**
-     * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
-     *
-     * @param result  实际影响的数据量
-     * @param message 异常信息
-     */
     public static void checkAffectedOneRow(int result, String message) {
         checkAffectedRows(1, result, message);
     }
 
-    /**
-     * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
-     *
-     * @param result          实际影响的数据量
-     * @param messageSupplier 异常信息
-     */
     public static void checkAffectedOneRow(int result, Supplier<String> messageSupplier) {
         checkAffectedRows(1, result, messageSupplier);
     }
 
-    /**
-     * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
-     *
-     * @param result 实际影响的数据量
-     * @param format 异常信息模板
-     * @param args   异常信息参数
-     */
     public static void checkAffectedOneRow(int result, String format, Object... args) {
         checkAffectedRows(1, result, format, args);
     }
 
-    /**
-     * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
-     *
-     * @param result 实际影响的数据量
-     */
     public static void checkAffectedOneRow(long result) {
         checkAffectedRows(1L, result,
                 () -> "The number of rows affected is expected to be 1, but is: " + result);
     }
 
-    /**
-     * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
-     *
-     * @param result  实际影响的数据量
-     * @param message 异常信息
-     */
     public static void checkAffectedOneRow(long result, String message) {
         checkAffectedRows(1L, result, message);
     }
 
-    /**
-     * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
-     *
-     * @param result          实际影响的数据量
-     * @param messageSupplier 异常信息
-     */
     public static void checkAffectedOneRow(long result, Supplier<String> messageSupplier) {
         checkAffectedRows(1L, result, messageSupplier);
     }
 
-    /**
-     * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
-     *
-     * @param result 实际影响的数据量
-     * @param format 异常信息模板
-     * @param args   异常信息参数
-     */
     public static void checkAffectedOneRow(long result,
             String format, Object... args) {
         checkAffectedRows(1L, result, format, args);
@@ -526,14 +282,6 @@ public class AssertTools {
     // #region - Condition
     // ================================
 
-    /**
-     * 当条件不满足时抛出异常。
-     *
-     * @param <T>       异常类型
-     * @param condition 条件
-     * @param e         异常
-     * @throws T 当条件不满足时抛出异常
-     */
     public static <T extends Exception> void checkCondition(boolean condition, Supplier<T> e)
             throws T {
         if (!condition) {

src/main/java/xyz/zhouxy/plusone/commons/util/BigDecimals.java

@@ -35,75 +35,34 @@ import xyz.zhouxy.plusone.commons.annotation.StaticFactoryMethod;
  */
 public class BigDecimals {
 
-    /**
-     * 判断两个 {@code BigDecimal} 的值是否相等
-     *
-     * @param a 第一个 {@code BigDecimal}
-     * @param b 第二个 {@code BigDecimal}
-     * @return 当两个 {@code BigDecimal} 的值相等时返回 {@code true}
-     */
     public static boolean equalsValue(@Nullable BigDecimal a, @Nullable BigDecimal b) {
         return (a == b) || (a != null && b != null && a.compareTo(b) == 0);
     }
 
-    /**
-     * 判断两个 {@code BigDecimal} 的值 - 大于
-     *
-     * @param a 第一个 {@code BigDecimal}
-     * @param b 第二个 {@code BigDecimal}
-     * @return 当 {@code a} 大于 {@code b} 时返回 {@code true}
-     */
     public static boolean gt(BigDecimal a, BigDecimal b) {
         AssertTools.checkNotNull(a, "Parameter could not be null.");
         AssertTools.checkNotNull(b, "Parameter could not be null.");
         return (a != b) && (a.compareTo(b) > 0);
     }
 
-    /**
-     * 判断两个 {@code BigDecimal} 的值 - 大于等于
-     *
-     * @param a 第一个 {@code BigDecimal}
-     * @param b 第二个 {@code BigDecimal}
-     * @return 当 {@code a} 大于等于 {@code b} 时返回 {@code true}
-     */
     public static boolean ge(BigDecimal a, BigDecimal b) {
         AssertTools.checkNotNull(a, "Parameter could not be null.");
         AssertTools.checkNotNull(b, "Parameter could not be null.");
         return (a == b) || (a.compareTo(b) >= 0);
     }
 
-    /**
-     * 判断两个 {@code BigDecimal} 的值 - 小于
-     *
-     * @param a 第一个 {@code BigDecimal}
-     * @param b 第二个 {@code BigDecimal}
-     * @return 当 {@code a} 小于 {@code b} 时返回 {@code true}
-     */
     public static boolean lt(BigDecimal a, BigDecimal b) {
         AssertTools.checkNotNull(a, "Parameter could not be null.");
         AssertTools.checkNotNull(b, "Parameter could not be null.");
         return (a != b) && (a.compareTo(b) < 0);
     }
 
-    /**
-     * 判断两个 {@code BigDecimal} 的值 - 小于等于
-     *
-     * @param a 第一个 {@code BigDecimal}
-     * @param b 第二个 {@code BigDecimal}
-     * @return 当 {@code a} 小于等于 {@code b} 时返回 {@code true}
-     */
     public static boolean le(BigDecimal a, BigDecimal b) {
         AssertTools.checkNotNull(a, "Parameter could not be null.");
         AssertTools.checkNotNull(b, "Parameter could not be null.");
         return (a == b) || (a.compareTo(b) <= 0);
     }
 
-    /**
-     * 求和
-     *
-     * @param numbers {@code BigDecimal} 数组
-     * @return 求和结果
-     */
     public static BigDecimal sum(final BigDecimal... numbers) {
         if (ArrayTools.isNullOrEmpty(numbers)) {
             return BigDecimal.ZERO;
@@ -118,23 +77,11 @@ public class BigDecimals {
         return result;
     }
 
-    /**
-     * 将 {@code null} 转换为 {@link BigDecimal#ZERO}
-     *
-     * @param val BigDecimal 对象
-     * @return 如果 {@code val} 为 {@code null}，则返回 {@link BigDecimal#ZERO}，否则返回 {@code val}
-     */
     @Nonnull
     public static BigDecimal nullToZero(@Nullable final BigDecimal val) {
         return val != null ? val : BigDecimal.ZERO;
     }
 
-    /**
-     * 获取字符串所表示的数值转换为 {@code BigDecimal}
-     *
-     * @param val 表示数值的字符串
-     * @return {@code BigDecimal} 对象
-     */
     @StaticFactoryMethod(BigDecimal.class)
     public static BigDecimal of(@Nullable final String val) {
         return (StringTools.isNotBlank(val)) ? new BigDecimal(val) : BigDecimal.ZERO;

src/main/java/xyz/zhouxy/plusone/commons/util/DateTimeTools.java

@@ -702,43 +702,18 @@ public class DateTimeTools {
     // #region - start & end
     // ================================
 
-    /**
-     * 获取指定年份的开始日期
-     *
-     * @param year 年份
-     * @return 指定年份的开始日期
-     */
     public static LocalDate startDateOfYear(int year) {
         return LocalDate.ofYearDay(year, 1);
     }
 
-    /**
-     * 获取指定年份的结束日期
-     *
-     * @param year 年份
-     * @return 指定年份的结束日期
-     */
     public static LocalDate endDateOfYear(int year) {
         return LocalDate.of(year, 12, 31);
     }
 
-    /**
-     * 获取指定日期的第二天的开始时间
-     *
-     * @param date 日期
-     * @return 指定日期的第二天的开始时间
-     */
     public static LocalDateTime startOfNextDate(LocalDate date) {
         return date.plusDays(1L).atStartOfDay();
     }
 
-    /**
-     * 获取指定日期的第二天的开始时间
-     *
-     * @param date 日期
-     * @param zone 时区
-     * @return 指定日期的第二天的开始时间
-     */
     public static ZonedDateTime startOfNextDate(LocalDate date, ZoneId zone) {
         return date.plusDays(1L).atStartOfDay(zone);
     }
@@ -751,72 +726,30 @@ public class DateTimeTools {
     // #region - isFuture
     // ================================
 
-    /**
-     * 判断指定日期时间是否在将来
-     *
-     * @param date 日期时间
-     * @return 指定日期时间是否在将来
-     */
     public static boolean isFuture(Date date) {
         return date.after(new Date());
     }
 
-    /**
+    public static boolean isFuture(Calendar date) {
-     * 判断指定日期时间是否在将来
+        return date.after(Calendar.getInstance());
-     *
-     * @param calendar 日期时间
-     * @return 指定日期时间是否在将来
-     */
-    public static boolean isFuture(Calendar calendar) {
-        return calendar.after(Calendar.getInstance());
     }
 
-    /**
-     * 判断指定时刻是否在将来
-     *
-     * @param instant 时刻
-     * @return 指定时刻是否在将来
-     */
     public static boolean isFuture(Instant instant) {
         return instant.isAfter(Instant.now());
     }
 
-    /**
-     * 判断指定时间戳是否在将来
-     *
-     * @param timeMillis 时间戳
-     * @return 指定时间戳是否在将来
-     */
     public static boolean isFuture(long timeMillis) {
         return timeMillis > System.currentTimeMillis();
     }
 
-    /**
-     * 判断指定日期是否在将来
-     *
-     * @param date 日期
-     * @return 指定日期是否在将来
-     */
     public static boolean isFuture(LocalDate date) {
         return date.isAfter(LocalDate.now());
     }
 
-    /**
-     * 判断指定日期时间是否在将来
-     *
-     * @param dateTime 日期时间
-     * @return 指定日期时间是否在将来
-     */
     public static boolean isFuture(LocalDateTime dateTime) {
         return dateTime.isAfter(LocalDateTime.now());
     }
 
-    /**
-     * 判断指定日期时间是否在将来
-     *
-     * @param dateTime 日期时间
-     * @return 指定日期时间是否在将来
-     */
     public static boolean isFuture(ZonedDateTime dateTime) {
         return dateTime.isAfter(ZonedDateTime.now());
     }
@@ -829,72 +762,30 @@ public class DateTimeTools {
     // #region - isPast
     // ================================
 
-    /**
-     * 判断指定日期时间是否在过去
-     *
-     * @param date 日期时间
-     * @return 指定日期时间是否在过去
-     */
     public static boolean isPast(Date date) {
         return date.before(new Date());
     }
 
-    /**
+    public static boolean isPast(Calendar date) {
-     * 判断指定日期时间是否在过去
+        return date.before(Calendar.getInstance());
-     *
-     * @param calendar 日期时间
-     * @return 指定日期时间是否在过去
-     */
-    public static boolean isPast(Calendar calendar) {
-        return calendar.before(Calendar.getInstance());
     }
 
-    /**
-     * 判断指定时刻是否在过去
-     *
-     * @param instant 时刻
-     * @return 指定时刻是否在过去
-     */
     public static boolean isPast(Instant instant) {
         return instant.isBefore(Instant.now());
     }
 
-    /**
-     * 判断指定时间戳是否在过去
-     *
-     * @param timeMillis 时间戳
-     * @return 指定时间戳是否在过去
-     */
     public static boolean isPast(long timeMillis) {
         return timeMillis < System.currentTimeMillis();
     }
 
-    /**
-     * 判断指定日期是否在过去
-     *
-     * @param date 日期
-     * @return 指定日期是否在过去
-     */
     public static boolean isPast(LocalDate date) {
         return date.isBefore(LocalDate.now());
     }
 
-    /**
-     * 判断指定日期时间是否在过去
-     *
-     * @param dateTime 日期时间
-     * @return 指定日期时间是否在过去
-     */
     public static boolean isPast(LocalDateTime dateTime) {
         return dateTime.isBefore(LocalDateTime.now());
     }
 
-    /**
-     * 判断指定日期时间是否在过去
-     *
-     * @param dateTime 日期时间
-     * @return 指定日期时间是否在过去
-     */
     public static boolean isPast(ZonedDateTime dateTime) {
         return dateTime.isBefore(ZonedDateTime.now());
     }
@@ -907,33 +798,14 @@ public class DateTimeTools {
     // #region - others
     // ================================
 
-    /**
-     * 获取指定日期的时间范围
-     *
-     * @param date 日期
-     * @return 指定日期的时间范围
-     */
     public static Range<LocalDateTime> toDateTimeRange(LocalDate date) {
         return Range.closedOpen(date.atStartOfDay(), startOfNextDate(date));
     }
 
-    /**
-     * 获取指定日期的时间范围
-     *
-     * @param date 日期
-     * @param zone 时区
-     * @return 指定日期的时间范围
-     */
     public static Range<ZonedDateTime> toDateTimeRange(LocalDate date, ZoneId zone) {
         return Range.closedOpen(date.atStartOfDay(zone), startOfNextDate(date, zone));
     }
 
-    /**
-     * 判断指定年份是否为闰年
-     *
-     * @param year 年份
-     * @return 指定年份是否为闰年
-     */
     public static boolean isLeapYear(int year) {
         return IsoChronology.INSTANCE.isLeapYear(year);
     }
@@ -943,7 +815,7 @@ public class DateTimeTools {
     // ================================
 
     /**
-     * 私有构造方法
+     * 私有构造方法，明确标识该常量类的作用。
      */
     private DateTimeTools() {
         throw new IllegalStateException("Utility class");

src/main/java/xyz/zhouxy/plusone/commons/util/Enumeration.java

@@ -48,20 +48,10 @@ public abstract class Enumeration<T extends Enumeration<T>> // NOSONAR 暂不移
         this.name = name;
     }
 
-    /**
-     * 枚举整数码值
-     *
-     * @return 整数码值
-     */
     public final int getId() {
         return id;
     }
 
-    /**
-     * 枚举名称
-     *
-     * @return 枚举名称
-     */
     public final String getName() {
         return name;
     }
@@ -94,9 +84,6 @@ public abstract class Enumeration<T extends Enumeration<T>> // NOSONAR 暂不移
         return getClass().getSimpleName() + '(' + id + ":" + name + ')';
     }
 
-    /**
-     * 枚举值集合
-     */
     protected static final class ValueSet<T extends Enumeration<T>> {
         private final Map<Integer, T> valueMap;
 
@@ -104,13 +91,6 @@ public abstract class Enumeration<T extends Enumeration<T>> // NOSONAR 暂不移
             this.valueMap = valueMap;
         }
 
-        /**
-         * 创建枚举值集合
-         *
-         * @param <T>    枚举类型
-         * @param values 枚举值
-         * @return 枚举值集合
-         */
         @StaticFactoryMethod(ValueSet.class)
         public static <T extends Enumeration<T>> ValueSet<T> of(T[] values) {
             Map<Integer, T> temp = Arrays.stream(values)
@@ -118,22 +98,11 @@ public abstract class Enumeration<T extends Enumeration<T>> // NOSONAR 暂不移
             return new ValueSet<>(Collections.unmodifiableMap(temp));
         }
 
-        /**
-         * 根据整数码值获取枚举对象
-         *
-         * @param id 整数码
-         * @return 枚举对象
-         */
         public T get(int id) {
             AssertTools.checkArgument(this.valueMap.containsKey(id), "[%s] 对应的值不存在", id);
             return this.valueMap.get(id);
         }
 
-        /**
-         * 获取所有枚举对象
-         *
-         * @return 所有枚举对象
-         */
         public Collection<T> getValues() {
             return this.valueMap.values();
         }

src/main/java/xyz/zhouxy/plusone/commons/util/IdGenerator.java

@@ -36,39 +36,18 @@ public class IdGenerator {
 
     // ===== UUID =====
 
-    /**
-     * 生成 UUID
-     *
-     * @return UUID
-     */
     public static UUID newUuid() {
         return UUID.randomUUID();
     }
 
-    /**
-     * 生成 UUID 字符串
-     *
-     * @return UUID 字符串
-     */
     public static String uuidString() {
         return UUID.randomUUID().toString();
     }
 
-    /**
-     * 生成 UUID 字符串（无分隔符）
-     *
-     * @return UUID 字符串
-     */
     public static String simpleUuidString() {
         return toSimpleString(UUID.randomUUID());
     }
 
-    /**
-     * 生成 UUID 字符串（无分隔符）
-     *
-     * @param uuid UUID
-     * @return UUID 字符串
-     */
     public static String toSimpleString(UUID uuid) {
         AssertTools.checkArgument(Objects.nonNull(uuid));
         return (uuidDigits(uuid.getMostSignificantBits() >> 32, 8) +
@@ -88,23 +67,11 @@ public class IdGenerator {
 
     private static final Map<Long, IdWorker> snowflakePool = new ConcurrentHashMap<>();
 
-    /**
-     * 生成雪花ID
-     *
-     * @param workerId 工作机器ID
-     * @return 雪花ID
-     */
     public static long nextSnowflakeId(long workerId) {
         IdWorker generator = getSnowflakeIdGenerator(workerId);
         return generator.nextId();
     }
 
-    /**
-     * 获取雪花ID生成器
-     *
-     * @param workerId 工作机器ID
-     * @return {@code IdWorker} 对象。来自 Seata 的修改版雪花ID生成器。
-     */
     public static IdWorker getSnowflakeIdGenerator(long workerId) {
         return snowflakePool.computeIfAbsent(workerId, wid -> new IdWorker(workerId));
     }

src/main/java/xyz/zhouxy/plusone/commons/util/Numbers.java

@@ -23,7 +23,7 @@ import javax.annotation.Nonnull;
 import javax.annotation.Nullable;
 
 /**
- * 数字工具类
+ * Numbers
  *
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
@@ -31,12 +31,6 @@ public class Numbers {
 
     // #region - sum
 
-    /**
-     * 求和
-     *
-     * @param numbers 数据数组
-     * @return 求和结果
-     */
     public static int sum(final short... numbers) {
         int result = 0;
         for (short number : numbers) {
@@ -45,12 +39,6 @@ public class Numbers {
         return result;
     }
 
-    /**
-     * 求和
-     *
-     * @param numbers 数据数组
-     * @return 求和结果
-     */
     public static long sum(final int... numbers) {
         long result = 0L;
         for (int number : numbers) {
@@ -59,12 +47,6 @@ public class Numbers {
         return result;
     }
 
-    /**
-     * 求和
-     *
-     * @param numbers 数据数组
-     * @return 求和结果
-     */
     public static long sum(final long... numbers) {
         long result = 0L;
         for (long number : numbers) {
@@ -73,12 +55,6 @@ public class Numbers {
         return result;
     }
 
-    /**
-     * 求和
-     *
-     * @param numbers 数据数组
-     * @return 求和结果
-     */
     public static double sum(final float... numbers) {
         double result = 0.00;
         for (float number : numbers) {
@@ -87,12 +63,6 @@ public class Numbers {
         return result;
     }
 
-    /**
-     * 求和
-     *
-     * @param numbers 数据数组
-     * @return 求和结果
-     */
     public static double sum(final double... numbers) {
         double result = 0.00;
         for (double number : numbers) {
@@ -101,12 +71,6 @@ public class Numbers {
         return result;
     }
 
-    /**
-     * 求和
-     *
-     * @param numbers 数据数组
-     * @return 求和结果
-     */
     public static BigInteger sum(final BigInteger... numbers) {
         if (ArrayTools.isNullOrEmpty(numbers)) {
             return BigInteger.ZERO;
@@ -121,12 +85,6 @@ public class Numbers {
         return result;
     }
 
-    /**
-     * 求和
-     *
-     * @param numbers 数据数组
-     * @return 求和结果
-     */
     public static BigDecimal sum(final BigDecimal... numbers) {
         return BigDecimals.sum(numbers);
     }
@@ -135,83 +93,35 @@ public class Numbers {
 
     // #region - nullToZero
 
-    /**
-     * 将 {@code null} 转换为 {@code 0}
-     *
-     * @param val 待转换的值
-     * @return 如果 {@code val} 不为 {@code null}，则返回该值；如果值为 {@code null}，则返回 {@code 0}
-     */
     public static byte nullToZero(@Nullable final Byte val) {
         return val != null ? val : 0;
     }
 
-    /**
-     * 将 {@code null} 转换为 {@code 0}
-     *
-     * @param val 待转换的值
-     * @return 如果 {@code val} 不为 {@code null}，则返回该值；如果值为 {@code null}，则返回 {@code 0}
-     */
     public static short nullToZero(@Nullable final Short val) {
         return val != null ? val : 0;
     }
 
-    /**
-     * 将 {@code null} 转换为 {@code 0}
-     *
-     * @param val 待转换的值
-     * @return 如果 {@code val} 不为 {@code null}，则返回该值；如果值为 {@code null}，则返回 {@code 0}
-     */
     public static int nullToZero(@Nullable final Integer val) {
         return val != null ? val : 0;
     }
 
-    /**
-     * 将 {@code null} 转换为 {@code 0}
-     *
-     * @param val 待转换的值
-     * @return 如果 {@code val} 不为 {@code null}，则返回该值；如果值为 {@code null}，则返回 {@code 0}
-     */
     public static long nullToZero(@Nullable final Long val) {
         return val != null ? val : 0L;
     }
 
-    /**
-     * 将 {@code null} 转换为 {@code 0}
-     *
-     * @param val 待转换的值
-     * @return 如果 {@code val} 不为 {@code null}，则返回该值；如果值为 {@code null}，则返回 {@code 0}
-     */
     public static float nullToZero(@Nullable final Float val) {
         return val != null ? val : 0.0F;
     }
 
-    /**
-     * 将 {@code null} 转换为 {@code 0}
-     *
-     * @param val 待转换的值
-     * @return 如果 {@code val} 不为 {@code null}，则返回该值；如果值为 {@code null}，则返回 {@code 0}
-     */
     public static double nullToZero(@Nullable final Double val) {
         return val != null ? val : 0.0;
     }
 
-    /**
-     * 将 {@code null} 转换为 {@code 0}
-     *
-     * @param val 待转换的值
-     * @return 如果 {@code val} 不为 {@code null}，则返回该值；如果值为 {@code null}，则返回 {@code 0}
-     */
     @Nonnull
     public static BigInteger nullToZero(@Nullable final BigInteger val) {
         return val != null ? val : BigInteger.ZERO;
     }
 
-    /**
-     * 将 {@code null} 转换为 {@code 0}
-     *
-     * @param val 待转换的值
-     * @return 如果 {@code val} 不为 {@code null}，则返回该值；如果值为 {@code null}，则返回 {@code 0}
-     */
     @Nonnull
     public static BigDecimal nullToZero(@Nullable final BigDecimal val) {
         return BigDecimals.nullToZero(val);

src/main/java/xyz/zhouxy/plusone/commons/util/OptionalTools.java

@@ -134,34 +134,16 @@ public class OptionalTools {
         return optionalObj.orElse(null);
     }
 
-    /**
-     * 将 {@link OptionalInt} 转为 {@link Integer}
-     *
-     * @param optionalObj optional 对象
-     * @return {@link Integer} 对象。如果 {@code OptionalInt} 的值缺失，返回 {@code null}。
-     */
     @Beta
     public static Integer toInteger(OptionalInt optionalObj) {
         return optionalObj.isPresent() ? optionalObj.getAsInt() : null;
     }
 
-    /**
-     * 将 {@link OptionalLong} 转为 {@link Long}
-     *
-     * @param optionalObj optional 对象
-     * @return {@link Long} 对象。如果 {@code OptionalLong} 的值缺失，返回 {@code null}。
-     */
     @Beta
     public static Long toLong(OptionalLong optionalObj) {
         return optionalObj.isPresent() ? optionalObj.getAsLong() : null;
     }
 
-    /**
-     * 将 {@link OptionalDouble} 转为 {@link Double}
-     *
-     * @param optionalObj optional 对象
-     * @return {@link Double} 对象。如果 {@code OptionalDouble} 的值缺失，返回 {@code null}。
-     */
     @Beta
     public static Double toDouble(OptionalDouble optionalObj) {
         return optionalObj.isPresent() ? optionalObj.getAsDouble() : null;

src/main/java/xyz/zhouxy/plusone/commons/util/RegexTools.java

@@ -18,6 +18,7 @@ package xyz.zhouxy.plusone.commons.util;
 
 import java.util.Arrays;
 import java.util.Map;
+import java.util.Objects;
 import java.util.concurrent.ConcurrentHashMap;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
@@ -69,7 +70,8 @@ public final class RegexTools {
      * @return {@link Pattern} 实例数组
      */
     public static Pattern[] getPatterns(final String[] patterns, final boolean cachePattern) {
-        AssertTools.checkArgument(ArrayTools.isAllElementsNotNull(patterns));
+        AssertTools.checkNotNull(patterns);
+        AssertTools.checkArgument(allNotNull(patterns));
         return cachePattern
                 ? cacheAndGetPatternsInternal(patterns)
                 : getPatternsInternal(patterns);
@@ -82,7 +84,8 @@ public final class RegexTools {
      * @return {@link Pattern} 实例数组
      */
     public static Pattern[] getPatterns(final String[] patterns) {
-        AssertTools.checkArgument(ArrayTools.isAllElementsNotNull(patterns));
+        AssertTools.checkNotNull(patterns);
+        AssertTools.checkArgument(allNotNull(patterns));
         return getPatternsInternal(patterns);
     }
 
@@ -106,7 +109,8 @@ public final class RegexTools {
      * @return 判断结果
      */
     public static boolean matchesOne(@Nullable final CharSequence input, final Pattern[] patterns) {
-        AssertTools.checkArgument(ArrayTools.isAllElementsNotNull(patterns));
+        AssertTools.checkNotNull(patterns);
+        AssertTools.checkArgument(allNotNull(patterns));
         return matchesOneInternal(input, patterns);
     }
 
@@ -118,7 +122,8 @@ public final class RegexTools {
      * @return 判断结果
      */
     public static boolean matchesAll(@Nullable final CharSequence input, final Pattern[] patterns) {
-        AssertTools.checkArgument(ArrayTools.isAllElementsNotNull(patterns));
+        AssertTools.checkNotNull(patterns);
+        AssertTools.checkArgument(allNotNull(patterns));
         return matchesAllInternal(input, patterns);
     }
 
@@ -161,7 +166,8 @@ public final class RegexTools {
      */
     public static boolean matchesOne(@Nullable final CharSequence input, final String[] patterns,
             final boolean cachePattern) {
-        AssertTools.checkArgument(ArrayTools.isAllElementsNotNull(patterns));
+        AssertTools.checkNotNull(patterns);
+        AssertTools.checkArgument(allNotNull(patterns));
         final Pattern[] patternSet = cachePattern
                 ? cacheAndGetPatternsInternal(patterns)
                 : getPatternsInternal(patterns);
@@ -176,7 +182,8 @@ public final class RegexTools {
      * @return 判断结果
      */
     public static boolean matchesOne(@Nullable final CharSequence input, final String[] patterns) {
-        AssertTools.checkArgument(ArrayTools.isAllElementsNotNull(patterns));
+        AssertTools.checkNotNull(patterns);
+        AssertTools.checkArgument(allNotNull(patterns));
         final Pattern[] patternSet = getPatternsInternal(patterns);
         return matchesOneInternal(input, patternSet);
     }
@@ -191,7 +198,8 @@ public final class RegexTools {
      */
     public static boolean matchesAll(@Nullable final CharSequence input, final String[] patterns,
             final boolean cachePattern) {
-        AssertTools.checkArgument(ArrayTools.isAllElementsNotNull(patterns));
+        AssertTools.checkNotNull(patterns);
+        AssertTools.checkArgument(allNotNull(patterns));
         final Pattern[] patternSet = cachePattern
                 ? cacheAndGetPatternsInternal(patterns)
                 : getPatternsInternal(patterns);
@@ -206,7 +214,8 @@ public final class RegexTools {
      * @return 判断结果
      */
     public static boolean matchesAll(@Nullable final CharSequence input, final String[] patterns) {
-        AssertTools.checkArgument(ArrayTools.isAllElementsNotNull(patterns));
+        AssertTools.checkNotNull(patterns);
+        AssertTools.checkArgument(allNotNull(patterns));
         final Pattern[] patternSet = getPatternsInternal(patterns);
         return matchesAllInternal(input, patternSet);
     }
@@ -326,32 +335,22 @@ public final class RegexTools {
         return input != null && pattern.matcher(input).matches();
     }
 
-    /**
-     * 判断 {@code input} 是否匹配至少一个正则。
-     *
-     * @param input    输入
-     * @param patterns 正则表达式
-     * @return 判断结果
-     */
     private static boolean matchesOneInternal(@Nullable final CharSequence input, final Pattern[] patterns) {
         return input != null
                 && Arrays.stream(patterns)
                         .anyMatch(pattern -> pattern.matcher(input).matches());
     }
 
-    /**
-     * 判断 {@code input} 是否匹配全部正则。
-     *
-     * @param input    输入
-     * @param patterns 正则表达式
-     * @return 判断结果
-     */
     private static boolean matchesAllInternal(@Nullable final CharSequence input, final Pattern[] patterns) {
         return input != null
                 && Arrays.stream(patterns)
                         .allMatch(pattern -> pattern.matcher(input).matches());
     }
 
+    private static <T> boolean allNotNull(T[] array) {
+        return Arrays.stream(array).allMatch(Objects::nonNull);
+    }
+
     private RegexTools() {
         // 不允许实例化
         throw new IllegalStateException("Utility class");

src/main/java/xyz/zhouxy/plusone/commons/util/StringTools.java

@@ -34,25 +34,11 @@ import xyz.zhouxy.plusone.commons.constant.PatternConsts;
  * </p>
  *
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 1.0.0
  */
 public class StringTools {
 
     public static final String EMPTY_STRING = "";
 
-    /**
-     * 判断字符串是否非空白
-     *
-     * <pre>
-     * StringTools.isNotBlank(null);    // false
-     * StringTools.isNotBlank("");      // false
-     * StringTools.isNotBlank("   ");   // false
-     * StringTools.isNotBlank("Hello"); // true
-     * </pre>
-     *
-     * @param cs 检查的字符串
-     * @return 是否非空白
-     */
     public static boolean isNotBlank(@Nullable final String cs) {
         if (cs == null || cs.isEmpty()) {
             return false;
@@ -65,20 +51,6 @@ public class StringTools {
         return false;
     }
 
-    /**
-     * 判断是否空白字符串
-     *
-     * <pre>
-     * StringTools.isBlank(null);    // true
-     * StringTools.isBlank("");      // true
-     * StringTools.isBlank("   ");   // true
-     * StringTools.isBlank("Hello"); // false
-     * </pre>
-     *
-     * @param cs 检查的字符串
-     * @return 是否空白
-     * @since 1.1.0
-     */
     public static boolean isBlank(@Nullable String cs) {
         if (cs == null || cs.isEmpty()) {
             return true;
@@ -91,89 +63,28 @@ public class StringTools {
         return true;
     }
 
-    /**
-     * 重复字符串
-     *
-     * @param str   要重复的字符串
-     * @param times 重复次数
-     * @return 结果
-     */
     public static String repeat(String str, int times) {
         return repeat(str, times, Integer.MAX_VALUE);
     }
 
-    /**
-     * 重复字符串
-     *
-     * @param str       要重复的字符串
-     * @param times     重复次数
-     * @param maxLength 最大长度
-     * @return 结果
-     */
     public static String repeat(final String str, int times, int maxLength) {
         AssertTools.checkArgument(Objects.nonNull(str));
         return String.valueOf(ArrayTools.repeat(str.toCharArray(), times, maxLength));
     }
 
-    /**
-     * 判断字符串是否非空
-     *
-     * <pre>
-     * StringTools.isNotEmpty(null);    // false
-     * StringTools.isNotEmpty("");      // false
-     * StringTools.isNotEmpty("   ");   // true
-     * StringTools.isNotEmpty("Hello"); // true
-     * </pre>
-     *
-     * @param cs 检查的字符串
-     * @return 是否非空
-     * @since 1.1.0
-     */
     public static boolean isNotEmpty(@Nullable final String cs) {
         return cs != null && !cs.isEmpty();
     }
 
-    /**
-     * 判断字符串是否为空字符串
-     *
-     * <pre>
-     * StringTools.isEmpty(null);    // true
-     * StringTools.isEmpty("");      // true
-     * StringTools.isEmpty("   ");   // false
-     * StringTools.isEmpty("Hello"); // false
-     * </pre>
-     *
-     * @param cs 检查的字符串
-     * @return 是否空字符串
-     * @since 1.1.0
-     */
     public static boolean isEmpty(@Nullable final String cs) {
         return cs == null || cs.isEmpty();
     }
 
-    /**
-     * 判断字符串是否为邮箱地址
-     *
-     * @param cs 检查的字符串
-     * @return 是否是邮箱地址
-     * @since 1.1.0
-     *
-     * @see PatternConsts#EMAIL
-     */
     @Beta
     public static boolean isEmail(@Nullable final String cs) {
         return RegexTools.matches(cs, PatternConsts.EMAIL);
     }
 
-    /**
-     * 判断字符串是否为 URL 地址
-     *
-     * @param cs 检查的字符串
-     * @return 是否是 URL
-     * @since 1.1.0
-     *
-     * @see URL
-     */
     @Beta
     public static boolean isURL(@Nullable final String cs) {
         try {
@@ -184,42 +95,6 @@ public class StringTools {
         return true;
     }
 
-    /**
-     * 脱敏
-     *
-     * @param src          原字符串
-     * @param front        前面保留的字符数
-     * @param end          后面保留的字符数
-     * @return 脱敏结果
-     * @since 1.1.0
-     */
-    public static String desensitize(@Nullable final String src, int front, int end) {
-        return desensitize(src, '*', front, end);
-    }
-
-    /**
-     * 脱敏
-     *
-     * @param src          原字符串
-     * @param replacedChar 用于替换的字符
-     * @param front        前面保留的字符数
-     * @param end          后面保留的字符数
-     * @return 脱敏结果
-     * @since 1.1.0
-     */
-    public static String desensitize(@Nullable final String src, char replacedChar, int front, int end) {
-        if (src == null || src.isEmpty()) {
-            return EMPTY_STRING;
-        }
-        AssertTools.checkArgument(front >= 0 && end >= 0);
-        AssertTools.checkArgument((front + end) <= src.length(), "需要截取的长度不能大于原字符串长度");
-        final char[] charArray = src.toCharArray();
-        for (int i = front; i < charArray.length - end; i++) {
-            charArray[i] = replacedChar;
-        }
-        return String.valueOf(charArray);
-    }
-
     private StringTools() {
         throw new IllegalStateException("Utility class");
     }

src/main/java/xyz/zhouxy/plusone/commons/util/TreeBuilder.java

@@ -39,26 +39,11 @@ public class TreeBuilder<T, TSubTree extends T, TIdentity> {
     private final BiConsumer<TSubTree, T> addChildMethod;
     private final Comparator<? super T> defaultComparator;
 
-    /**
-     * 构造一个 {@code TreeBuilder}。不指定用于排序的 {@code Comparator}。
-     *
-     * @param identityGetter       从节点中获取其标识的逻辑
-     * @param parentIdentityGetter 获取父节点标识的逻辑
-     * @param addChild             添加子节点的逻辑
-     */
     public TreeBuilder(Function<T, TIdentity> identityGetter, Function<T, Optional<TIdentity>> parentIdentityGetter,
             BiConsumer<TSubTree, T> addChild) {
         this(identityGetter, parentIdentityGetter, addChild, null);
     }
 
-    /**
-     * 构造一个 {@code TreeBuilder}。
-     *
-     * @param identityGetter       从节点中获取其标识的逻辑
-     * @param parentIdentityGetter 获取父节点标识的逻辑
-     * @param addChild             添加子节点的逻辑
-     * @param defaultComparator    默认的 {@code Comparator}，用于排序
-     */
     public TreeBuilder(Function<T, TIdentity> identityGetter, Function<T, Optional<TIdentity>> parentIdentityGetter,
             BiConsumer<TSubTree, T> addChild, @Nullable Comparator<? super T> defaultComparator) {
         this.identityGetter = identityGetter;

src/test/java/xyz/zhouxy/plusone/commons/model/ValidatableStringRecordTests.java

@@ -39,7 +39,6 @@ import java.util.Comparator;
 import java.util.List;
 import java.util.function.Function;
 
-@SuppressWarnings("deprecation")
 class ValidatableStringRecordTests {
 
     private static final Logger log = LoggerFactory.getLogger(ValidatableStringRecordTests.class);
@@ -84,7 +83,6 @@ class User {
     }
 }
 
-@SuppressWarnings("deprecation")
 @ValueObject
 class Email extends ValidatableStringRecord<Email> {
     private Email(String value) {
@@ -97,7 +95,6 @@ class Email extends ValidatableStringRecord<Email> {
     }
 }
 
-@SuppressWarnings("deprecation")
 @ValueObject
 class Username extends ValidatableStringRecord<Username> {
     private Username(String username) {

src/test/java/xyz/zhouxy/plusone/commons/model/dto/CustomUnifiedResponseFactoryTests.java

@@ -34,7 +34,6 @@ import lombok.extern.slf4j.Slf4j;
 import xyz.zhouxy.plusone.commons.exception.business.BizException;
 
 @Slf4j
-@SuppressWarnings("null")
 public
 class CustomUnifiedResponseFactoryTests {
 

src/test/java/xyz/zhouxy/plusone/commons/model/dto/UnifiedResponseTests.java

@@ -32,7 +32,6 @@ import lombok.extern.slf4j.Slf4j;
 import xyz.zhouxy.plusone.commons.exception.business.BizException;
 
 @Slf4j
-@SuppressWarnings("null")
 public
 class UnifiedResponseTests {
 

src/test/java/xyz/zhouxy/plusone/commons/util/ArrayToolsTests.java

@@ -730,37 +730,37 @@ public class ArrayToolsTests {
     // ================================
 
     @Test
-    void indexOf_NullPredicate_ThrowsNullPointerException() {
+    void indexOfWithPredicate_NullPredicate_ThrowsNullPointerException() {
-        assertThrows(NullPointerException.class, () -> ArrayTools.indexOf(new String[] {}, null));
+        assertThrows(NullPointerException.class, () -> ArrayTools.indexOfWithPredicate(new String[] {}, null));
     }
 
     @Test
-    void indexOf_NullArray_ReturnsNotFoundIndex() {
+    void indexOfWithPredicate_NullArray_ReturnsNotFoundIndex() {
         Predicate<String> predicate = s -> s.equals("test");
-        int result = ArrayTools.indexOf(null, predicate);
+        int result = ArrayTools.indexOfWithPredicate(null, predicate);
         assertEquals(ArrayTools.NOT_FOUND_INDEX, result);
     }
 
     @Test
-    void indexOf_EmptyArray_ReturnsNotFoundIndex() {
+    void indexOfWithPredicate_EmptyArray_ReturnsNotFoundIndex() {
         Predicate<String> predicate = s -> s.equals("test");
-        int result = ArrayTools.indexOf(new String[] {}, predicate);
+        int result = ArrayTools.indexOfWithPredicate(new String[] {}, predicate);
         assertEquals(ArrayTools.NOT_FOUND_INDEX, result);
     }
 
     @Test
-    void indexOf_ArrayContainsMatchingElement_ReturnsIndex() {
+    void indexOfWithPredicate_ArrayContainsMatchingElement_ReturnsIndex() {
         String[] array = { "apple", "banana", "cherry" };
         Predicate<String> predicate = s -> s.equals("banana");
-        int result = ArrayTools.indexOf(array, predicate);
+        int result = ArrayTools.indexOfWithPredicate(array, predicate);
         assertEquals(1, result);
     }
 
     @Test
-    void indexOf_ArrayDoesNotContainMatchingElement_ReturnsNotFoundIndex() {
+    void indexOfWithPredicate_ArrayDoesNotContainMatchingElement_ReturnsNotFoundIndex() {
         String[] array = { "apple", "banana", "cherry" };
         Predicate<String> predicate = s -> s.equals("orange");
-        int result = ArrayTools.indexOf(array, predicate);
+        int result = ArrayTools.indexOfWithPredicate(array, predicate);
         assertEquals(ArrayTools.NOT_FOUND_INDEX, result);
     }
 
@@ -847,12 +847,12 @@ public class ArrayToolsTests {
 
     @Test
     void indexOf_NullObject_ReturnsNotFound() {
-        assertEquals(ArrayTools.NOT_FOUND_INDEX, ArrayTools.indexOf(new String[] { "a", "b", "c" }, (String) null));
+        assertEquals(ArrayTools.NOT_FOUND_INDEX, ArrayTools.indexOf(new String[] { "a", "b", "c" }, null));
     }
 
     @Test
     void indexOf_ArrayContainsNull_ReturnsIndex() {
-        assertEquals(1, ArrayTools.indexOf(new String[] { "a", null, "c" }, (String) null));
+        assertEquals(1, ArrayTools.indexOf(new String[] { "a", null, "c" }, null));
     }
 
     // ================================
@@ -864,37 +864,37 @@ public class ArrayToolsTests {
     // ================================
 
     @Test
-    void lastIndexOf_NullPredicate_ThrowsNullPointerException() {
+    void lastIndexOfWithPredicate_NullPredicate_ThrowsNullPointerException() {
-        assertThrows(NullPointerException.class, () -> ArrayTools.lastIndexOf(new String[] {}, null));
+        assertThrows(NullPointerException.class, () -> ArrayTools.lastIndexOfWithPredicate(new String[] {}, null));
     }
 
     @Test
-    void lastIndexOf_NullArray_ReturnsNotFoundIndex() {
+    void lastIndexOfWithPredicate_NullArray_ReturnsNotFoundIndex() {
         Predicate<String> predicate = s -> s.equals("test");
-        int result = ArrayTools.lastIndexOf(null, predicate);
+        int result = ArrayTools.lastIndexOfWithPredicate(null, predicate);
         assertEquals(ArrayTools.NOT_FOUND_INDEX, result);
     }
 
     @Test
-    void lastIndexOf_EmptyArray_ReturnsNotFoundIndex() {
+    void lastIndexOfWithPredicate_EmptyArray_ReturnsNotFoundIndex() {
         Predicate<String> predicate = s -> s.equals("test");
-        int result = ArrayTools.lastIndexOf(new String[] {}, predicate);
+        int result = ArrayTools.lastIndexOfWithPredicate(new String[] {}, predicate);
         assertEquals(ArrayTools.NOT_FOUND_INDEX, result);
     }
 
     @Test
-    void lastIndexOf_ArrayContainsMatchingElement_ReturnsIndex() {
+    void lastIndexOfWithPredicate_ArrayContainsMatchingElement_ReturnsIndex() {
         String[] array = { "apple", "banana", "banana", "cherry" };
         Predicate<String> predicate = s -> s.equals("banana");
-        int result = ArrayTools.lastIndexOf(array, predicate);
+        int result = ArrayTools.lastIndexOfWithPredicate(array, predicate);
         assertEquals(2, result);
     }
 
     @Test
-    void lastIndexOf_ArrayDoesNotContainMatchingElement_ReturnsNotFoundIndex() {
+    void lastIndexOfWithPredicate_ArrayDoesNotContainMatchingElement_ReturnsNotFoundIndex() {
         String[] array = { "apple", "banana", "cherry" };
         Predicate<String> predicate = s -> s.equals("orange");
-        int result = ArrayTools.lastIndexOf(array, predicate);
+        int result = ArrayTools.lastIndexOfWithPredicate(array, predicate);
         assertEquals(ArrayTools.NOT_FOUND_INDEX, result);
     }
 
@@ -982,12 +982,12 @@ public class ArrayToolsTests {
 
     @Test
     void lastIndexOf_NullObject_ReturnsNotFound() {
-        assertEquals(ArrayTools.NOT_FOUND_INDEX, ArrayTools.lastIndexOf(new String[] { "a", "b", "c" }, (String) null));
+        assertEquals(ArrayTools.NOT_FOUND_INDEX, ArrayTools.lastIndexOf(new String[] { "a", "b", "c" }, null));
     }
 
     @Test
     void lastIndexOf_ArrayContainsNull_ReturnsIndex() {
-        assertEquals(3, ArrayTools.lastIndexOf(new String[] { "a", null, "c", null, "e" }, (String) null));
+        assertEquals(3, ArrayTools.lastIndexOf(new String[] { "a", null, "c", null, "e" }, null));
     }
 
     // ================================

src/test/java/xyz/zhouxy/plusone/commons/util/RegexToolsTests.java

@@ -75,7 +75,7 @@ class RegexToolsTests {
 
     @Test
     void getPatterns_NullPatterns_ThrowsException() {
-        assertThrows(IllegalArgumentException.class, () -> {
+        assertThrows(NullPointerException.class, () -> {
             RegexTools.getPatterns(null, true);
         });
     }

src/test/java/xyz/zhouxy/plusone/commons/util/StringToolsTests.java

@@ -26,7 +26,6 @@ import static org.junit.jupiter.api.Assertions.assertTrue;
 import java.lang.reflect.Constructor;
 import java.util.Arrays;
 
-import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
 
 @SuppressWarnings("null")
@@ -185,7 +184,7 @@ class StringToolsTests {
     // #region - isURL
     // ================================
 
-    /**
+        /**
      * TC1: 验证标准HTTP协议URL
      */
     @Test
@@ -299,77 +298,6 @@ class StringToolsTests {
     // #endregion - repeat
     // ================================
 
-    // ================================
-    // #region - desensitize
-    // ================================
-
-    @Test
-    public void desensitize_NullInput_ReturnsEmptyString() {
-        String result = StringTools.desensitize(null, '#', 2, 2);
-        Assertions.assertEquals("", result);
-    }
-
-    @Test
-    public void desensitize_EmptyString_ReturnsEmptyString() {
-        String result = StringTools.desensitize("", '#', 2, 2);
-        Assertions.assertEquals("", result);
-    }
-
-    @Test
-    public void desensitize_NegativeFront_ThrowsException() {
-        Assertions.assertThrows(IllegalArgumentException.class, () -> {
-            StringTools.desensitize("123456", '#', -1, 2);
-        });
-    }
-
-    @Test
-    public void desensitize_NegativeEnd_ThrowsException() {
-        Assertions.assertThrows(IllegalArgumentException.class, () -> {
-            StringTools.desensitize("123456", '#', 2, -1);
-        });
-    }
-
-    @Test
-    public void desensitize_FrontPlusEndExceedsLength_ThrowsException() {
-        Assertions.assertThrows(IllegalArgumentException.class, () -> {
-            StringTools.desensitize("123456", '#', 3, 4);
-        });
-    }
-
-    @Test
-    public void desensitize_ValidInput_ReturnsDesensitizedString() {
-        String result = StringTools.desensitize("123456", '#', 2, 2);
-        Assertions.assertEquals("12##56", result);
-    }
-
-    @Test
-    public void desensitize_FrontZero_ReturnsDesensitizedString() {
-        String result = StringTools.desensitize("123456", '#', 0, 2);
-        Assertions.assertEquals("####56", result);
-    }
-
-    @Test
-    public void desensitize_EndZero_ReturnsDesensitizedString() {
-        String result = StringTools.desensitize("123456", '#', 2, 0);
-        Assertions.assertEquals("12####", result);
-    }
-
-    @Test
-    public void desensitize_FrontAndEndZero_ReturnsDesensitizedString() {
-        String result = StringTools.desensitize("123456", '#', 0, 0);
-        Assertions.assertEquals("######", result);
-    }
-
-    @Test
-    public void desensitize_ValidInput_DefaultReplacedChar_ReturnsDesensitizedString() {
-        String result = StringTools.desensitize("123456", 2, 2);
-        Assertions.assertEquals("12**56", result);
-    }
-
-    // ================================
-    // #endregion - desensitize
-    // ================================
-
     @Test
     void test_constructor_isNotAccessible_ThrowsIllegalStateException() {
         Constructor<?>[] constructors = StringTools.class.getDeclaredConstructors();