refactor!: 重构正则表达式相关代码

- 将正则相关根据移至 regex 包下
- 新增 PatternInfos 记录不同 pattern 的信息
- 新增 Chinese2ndIdCardNumberMatcher 和 LocalDateMatcher 作为日期和二代居民身份证的匹配结果，方便从中获取对应的 group

NOTICE

@@ -1,60 +0,0 @@
-Plusone Commons
-Copyright 2022-present ZhouXY108
-
-This product includes software developed at
-Plusone Commons (http://gitea.zhouxy.xyz/plusone/plusone-commons).
-
-===========================================================================
-Third-party components and their licenses:
-===========================================================================
-
-This software contains code from the following third-party projects:
-
-1. Apache Seata
-   - Component: IdWorker class implementation
-   - Source: org.apache.seata.common.util.IdWorker
-   - Origin: https://github.com/apache/incubator-seata/blob/2.x/common/src/main/java/org/apache/seata/common/util/IdWorker.java
-   - License: Apache License 2.0
-   - License URL: https://www.apache.org/licenses/LICENSE-2.0.txt
-   - Copyright: The Apache Software Foundation
-
-===========================================================================
-Dependencies and their licenses:
-===========================================================================
-
-The following dependencies are used in this project:
-
-Required Dependencies:
-- guava: Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0.txt)
-
-Optional Dependencies:
-- gson: Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0.txt)
-- jsr305: Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0.txt)
-- joda-time: Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0.txt)
-
-Test Dependencies:
-- commons-lang3: Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0.txt)
-- Logback: Eclipse Public License 1.0 (https://www.eclipse.org/org/documents/epl-1.0/EPL-1.0.txt) / LGPL 2.1 (https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html)
-- Slf4j: MIT License (https://mit-license.org/)
-- JUnit: Eclipse Public License 2.0 (https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.txt)
-- lombok: MIT License (https://mit-license.org/)
-- hutool: MulanPSL-2.0 (http://license.coscl.org.cn/MulanPSL2)
-- MyBatis: Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0.txt)
-- h2: MPL 2.0 (https://www.mozilla.org/en-US/MPL/2.0/) / EPL 1.0 (https://www.eclipse.org/org/documents/epl-1.0/EPL-1.0.txt)
-- Jackson: Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0.txt)
-
-===========================================================================
-Apache License 2.0 Notice:
-===========================================================================
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.

README.md

@@ -68,16 +68,16 @@ System.out.println(result); // Output: Return string
 `RegexConsts` 包含常见正则表达式；`PatternConsts` 包含对应的 `Pattern` 对象
 
 ## 五、exception - 异常
-### 1. IMultiTypesException - 多类型异常
+### 1. MultiTypesException - 多类型异常
 异常在不同场景下被抛出，可以用不同的枚举值，表示不同的场景类型。
 
-异常实现 `IMultiTypesException` 的 `IMultiTypesException#getType` 方法，返回对应的场景类型。
+异常实现 `MultiTypesException` 的 `MultiTypesException#getType` 方法，返回对应的场景类型。
 
-表示场景类型的枚举实现 `IMultiTypesException.IExceptionType`，其中的工厂方法用于创建对应类型的异常。
+表示场景类型的枚举实现 `MultiTypesException.ExceptionType`，其中的工厂方法用于创建对应类型的异常。
 ```java
 public final class LoginException
         extends RuntimeException
-        implements IMultiTypesException<LoginException.Type> {
+        implements MultiTypesException<LoginException, LoginException.Type> {
     private static final long serialVersionUID = 881293090625085616L;
     private final Type type;
     private LoginException(@Nonnull Type type, @Nonnull String message) {
@@ -104,7 +104,7 @@ public final class LoginException
 
     // ...
 
-    public enum Type implements IExceptionType<String>, IExceptionFactory<LoginException> {
+    public enum Type implements ExceptionType {
         DEFAULT("00", "当前会话未登录"),
         NOT_TOKEN("10", "未提供token"),
         INVALID_TOKEN("20", "token无效"),
@@ -209,34 +209,9 @@ throw LoginException.Type.TOKEN_TIMEOUT.create();
 分页结果可以存放到 `PageResult` 中，作为出参。
 
 #### 2. UnifiedResponse
+UnifiedResponse 对返回给前端的数据进行封装，包含 `code`、`message`、`data。`
 
-`UnifiedResponse` 对返回给前端的数据进行封装，包含 `code`、`message`、`data。`
-
-`UnifiedResponses` 是 `UnifiedResponse` 的工厂类。用于快速构建 `UnifiedResponse` 对象，默认的成功代码为 `2000000`。
-
-用户可以继承 `UnifiedResponses` 实现自己的工厂类，自定义 SUCCESS_CODE 和 DEFAULT_SUCCESS_MSG，以及工厂方法。如下所示：
-```java
-// 自定义工厂类
-public static class CustomUnifiedResponses extends UnifiedResponses {
-    public static final String SUCCESS_CODE = "000";
-    public static final String DEFAULT_SUCCESS_MSG = "成功";
-    public static <T> UnifiedResponse<T> success() {
-        return of(SUCCESS_CODE, DEFAULT_SUCCESS_MSG);
-    }
-    public static <T> UnifiedResponse<T> success(@Nullable String message) {
-        return of(SUCCESS_CODE, message);
-    }
-    public static <T> UnifiedResponse<T> success(@Nullable String message, @Nullable T data) {
-        return of(SUCCESS_CODE, message, data);
-    }
-    private CustomUnifiedResponses() {
-        super();
-    }
-}
-// 使用自定义工厂类
-CustomUnifiedResponses.success("查询成功", userList); // 状态码为 000
-```
-见 [issue#22 @Gitea](http://gitea.zhouxy.xyz/plusone/plusone-commons/issues/22)
+可使用 `UnifiedResponses` 快速构建 `UnifiedResponse` 对象。 `UnifiedResponses` 默认的成功代码为 "2000000"， 用户按测试类 `CustomUnifiedResponseFactoryTests` 中所示范的，继承 `UnifiedResponses` 实现自己的工厂类， 自定义 `SUCCESS_CODE` 和 `DEFAULT_SUCCESS_MSG` 和工厂方法。 见 [issue#22](http://zhouxy.xyz:3000/plusone/plusone-commons/issues/22)。
 
 ## 八、time - 时间 API
 ### 1. 季度

cspell.json

@@ -5,11 +5,11 @@
     ],
     "dictionaryDefinitions": [],
     "dictionaries": [],
-    "words": [
+    "words": [],
+    "ignoreWords": [
         "aliyun",
         "baomidou",
         "Batis",
-        "buildmetadata",
         "Consolas",
         "cspell",
         "databind",
@@ -33,7 +33,6 @@
         "Nonnull",
         "NOSONAR",
         "okhttp",
-        "okio",
         "ooxml",
         "overriden",
         "plusone",

plusone-commons/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>xyz.zhouxy.plusone</groupId>
         <artifactId>plusone-parent</artifactId>
-        <version>1.1.0-SNAPSHOT</version>
+        <version>1.1.0-RC1</version>
     </parent>
 
     <artifactId>plusone-commons</artifactId>
@@ -17,6 +17,7 @@
     </description>
 
     <properties>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <java.version>1.8</java.version>
         <maven.compiler.source>1.8</maven.compiler.source>
         <maven.compiler.target>1.8</maven.compiler.target>

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/annotation/ReaderMethod.java

@@ -27,7 +27,7 @@ import java.lang.annotation.Target;
  * <p>
  * 标识方法是读方法，如 getter。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  * @see WriterMethod
  */

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/annotation/StaticFactoryMethod.java

@@ -26,7 +26,7 @@ import java.lang.annotation.Target;
  *
  * <p>标识方法为静态工厂方法
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  */
 @Target(ElementType.METHOD)

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/annotation/UnsupportedOperation.java

@@ -27,7 +27,7 @@ import java.lang.annotation.Documented;
  *
  * <p>标识方法为不支持的操作。该方法将抛出 {@link UnsupportedOperationException}。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @version 1.0
  * @since 1.0.0
  * @see UnsupportedOperationException

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/annotation/ValueObject.java

@@ -25,7 +25,7 @@ import java.lang.annotation.Target;
 /**
  * ValueObject - 值对象
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  */
 @Inherited

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/annotation/Virtual.java

@@ -25,7 +25,7 @@ import java.lang.annotation.Target;
  * 标识该方法是虚方法。
  * <p>该注解用于提醒、强调父类虽然有默认实现，但子类可以根据自己的需要覆写。</p>
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  */
 @Target(ElementType.METHOD)

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/annotation/WriterMethod.java

@@ -27,7 +27,7 @@ import java.lang.annotation.Target;
  * <p>
  * 标识方法是写方法，如 setter。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  * @see ReaderMethod
  */

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

@@ -54,6 +54,6 @@
  * <p>
  * 标记一个类，表示其作为值对象，区别于 Entity。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 package xyz.zhouxy.plusone.commons.annotation;

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

@@ -26,7 +26,7 @@ import javax.annotation.Nullable;
  * 用于像自定义异常等需要带有 {@code code} 字段的类，
  * 方便其它地方的程序判断该类的是否实现了此接口，以此获取其实例的 {@code code} 字段的值。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 public interface IWithCode<T> {
 

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

@@ -25,7 +25,7 @@ import javax.annotation.Nullable;
  * 用于像自定义异常等需要带有 {@code code} 字段的类，
  * 方便其它地方的程序判断该类的是否实现了此接口，以此获取其实例的 {@code code} 字段的值。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 public interface IWithIntCode {
 

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

@@ -25,7 +25,7 @@ import javax.annotation.Nullable;
  * 用于像自定义异常等需要带有 {@code code} 字段的类，
  * 方便其它地方的程序判断该类的是否实现了此接口，以此获取其实例的 {@code code} 字段的值。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 public interface IWithLongCode {
 

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

@@ -67,7 +67,7 @@ import javax.annotation.Nullable;
  * System.out.println(result); // Output: Return string
  * </pre>
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  */
 public final class Ref<T> {

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

@@ -66,7 +66,7 @@
  * 类似于枚举这样的类型，通常需要设置固定的码值表示对应的含义。
  * 可实现 {@link IWithCode}、{@link IWithIntCode}、{@link IWithLongCode}，便于在需要的地方对这些接口的实现进行处理。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 @CheckReturnValue
 @ParametersAreNonnullByDefault

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

@@ -33,7 +33,7 @@ import com.google.common.collect.Table;
 /**
  * 集合工具类
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  */
 public class CollectionTools {

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/collection/MapModifier.java

@@ -1,254 +0,0 @@
-/*
- * Copyright 2025 the original author or authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      https://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package xyz.zhouxy.plusone.commons.collection;
-
-import static xyz.zhouxy.plusone.commons.util.AssertTools.checkArgumentNotNull;
-
-import java.util.Collections;
-import java.util.HashMap;
-import java.util.Map;
-import java.util.function.BiFunction;
-import java.util.function.Consumer;
-import java.util.function.Function;
-import java.util.function.Supplier;
-
-import javax.annotation.CheckForNull;
-import javax.annotation.Nonnull;
-import javax.annotation.Nullable;
-
-import com.google.common.annotations.Beta;
-
-/**
- * Map 修改器
- *
- * <p>
- * 封装一系列对 Map 数据的修改操作，修改 Map 的数据。可以用于 Map 的数据初始化等操作。
- *
- * <pre>
- * // MapModifier
- * MapModifier&lt;String, Object&gt; modifier = new MapModifier&lt;String, Object&gt;()
- *     .putAll(commonProperties)
- *     .put("username", "Ben")
- *     .put("accountStatus", LOCKED);
- *
- * // 从 Supplier 中获取 Map，并修改数据
- * Map&lt;String, Object&gt; map = modifier.getAndModify(HashMap::new);
- *
- * // 可以灵活使用不同 Map 类型的不同构造器
- * Map&lt;String, Object&gt; map = modifier.getAndModify(() -&gt; new HashMap&lt;&gt;(8));
- * Map&lt;String, Object&gt; map = modifier.getAndModify(() -&gt; new HashMap&lt;&gt;(anotherMap));
- * Map&lt;String, Object&gt; map = modifier.getAndModify(TreeMap::new);
- * Map&lt;String, Object&gt; map = modifier.getAndModify(ConcurrentHashMap::new);
- *
- * // 修改已有的 Map
- * modifier.modify(map);
- *
- * // 创建一个有初始化数据的不可变的 Map
- * Map&lt;String, Object&gt; map = modifier.getUnmodifiableMap();
- *
- * // 链式调用创建并初始化数据
- * Map&lt;String, Object&gt; map = new MapModifier&lt;String, Object&gt;()
- *     .putAll(commonProperties)
- *     .put("username", "Ben")
- *     .put("accountStatus", LOCKED)
- *     .getAndModify(HashMap::new);
- * </pre>
- *
- * @author ZhouXY108 <luquanlion@outlook.com>
- * @since 1.1.0
- */
-@Beta
-public class MapModifier<K, V> {
-
-    @Nonnull
-    private Consumer<Map<K, V>> operators;
-
-    /**
-     * 创建一个空的 MapModifier
-     */
-    public MapModifier() {
-        this.operators = m -> {
-            // do nothing
-        };
-    }
-
-    /**
-     * 添加一个键值对。
-     *
-     * <p>
-     * <b>注意：键值对是否允许为 {@code null}，由最终作用的 {@link Map} 类型决定。</b>
-     *
-     * @param key 要添加的 {@code key}
-     * @param value 要添加的 {@code value}
-     * @return MapModifier
-     */
-    public MapModifier<K, V> put(@Nullable K key, @Nullable V value) {
-        return addOperationInternal(map -> map.put(key, value));
-    }
-
-    /**
-     * 添加一个键值对，如果 key 已经存在，则不添加。
-     *
-     * <p>
-     * <b>注意：键值对是否允许为 {@code null}，由最终作用的 {@link Map} 类型决定。</b>
-     *
-     * @param key 要添加的 {@code key}
-     * @param value 要添加的 {@code value}
-     * @return MapModifier
-     */
-    public MapModifier<K, V> putIfAbsent(@Nullable K key, @Nullable V value) {
-        return addOperationInternal(map -> map.putIfAbsent(key, value));
-    }
-
-    /**
-     * 添加多个键值对。
-     *
-     * <p>
-     * <b>注意：键值对是否允许为 {@code null}，由最终作用的 {@link Map} 类型决定。</b>
-     *
-     * @param otherMap 要添加的键值对集合。
-     *                 如果为 {@code null}，则什么都不做。
-     *
-     * @return MapModifier
-     */
-    public MapModifier<K, V> putAll(@Nullable Map<? extends K, ? extends V> otherMap) {
-        if (otherMap == null || otherMap.isEmpty()) {
-            return this;
-        }
-        return addOperationInternal(map -> map.putAll(otherMap));
-    }
-
-    /**
-     * 添加多个键值对。
-     *
-     * <p>
-     * <b>注意：键值对是否允许为 {@code null}，由最终作用的 {@link Map} 类型决定。</b>
-     *
-     * @param entries 要添加的键值对集合
-     * @return MapModifier
-     */
-    @SafeVarargs
-    public final MapModifier<K, V> putAll(Map.Entry<? extends K, ? extends V>... entries) {
-        if (entries.length == 0) {
-            return this;
-        }
-        return addOperationInternal(map -> {
-            for (Map.Entry<? extends K, ? extends V> entry : entries) {
-                map.put(entry.getKey(), entry.getValue());
-            }
-        });
-    }
-
-    /**
-     * 当 {@code key} 不存在时，计算对应的值，并添加到 {@code map} 中。
-     *
-     * <p>
-     * 调用 {@link Map#computeIfAbsent(Object, Function)}。
-     *
-     * <p>
-     * <b>注意：键值对是否允许为 {@code null}，由最终作用的 {@link Map} 类型决定。</b>
-     *
-     * @param key 要添加的 {@code key}
-     * @param mappingFunction 计算 {@code key} 对应的值
-     * @return MapModifier
-     */
-    public MapModifier<K, V> computeIfAbsent(K key,
-            Function<? super K, ? extends V> mappingFunction) {
-        return addOperationInternal(map -> map.computeIfAbsent(key, mappingFunction));
-    }
-
-    /**
-     * 当 {@code key} 存在时，计算对应的值，并添加到 {@code map} 中。
-     *
-     * <p>
-     * 调用 {@link Map#computeIfPresent(Object, BiFunction)}。
-     *
-     * <p>
-     * <b>注意：键值对是否允许为 {@code null}，由最终作用的 {@link Map} 类型决定。</b>
-     *
-     * @param key 要添加的 {@code key}
-     * @param remappingFunction 计算 {@code key} 对应的值
-     * @return MapModifier
-     */
-    public MapModifier<K, V> computeIfPresent(K key,
-            BiFunction<? super K, ? super V, ? extends V> remappingFunction) {
-        return addOperationInternal(map -> map.computeIfPresent(key, remappingFunction));
-    }
-
-    /**
-     * 删除 {@code key}。
-     *
-     * <p>
-     * <b>注意：key 是否允许为 {@code null}，由最终作用的 {@link Map} 类型决定。</b>
-     *
-     * @param key 要删除的 {@code key}
-     * @return MapModifier
-     */
-    public MapModifier<K, V> remove(K key) {
-        return addOperationInternal(map -> map.remove(key));
-    }
-
-    /**
-     * 清空 {@code map}
-     *
-     * @return MapModifier
-     */
-    public MapModifier<K, V> clear() {
-        return addOperationInternal(Map::clear);
-    }
-
-    /**
-     * 修改 {@code map}
-     *
-     * @param map 要修改的 {@code map}
-     * @return 修改后的 {@code map}。当入参是 {@code null} 时，返回 {@code null}。
-     */
-    public <T extends Map<K, V>> void modify(@Nullable T map) {
-        if (map != null) {
-            this.operators.accept(map);
-        }
-    }
-
-    /**
-     * 修改 {@code map}
-     *
-     * @param mapSupplier {@code map} 的 {@link Supplier}
-     * @return 修改后的 {@code map}。
-     *         当从 {@code mapSupplier} 获取的 {@code map} 为 {@code null} 时，返回 {@code null}。
-     */
-    @CheckForNull
-    public <T extends Map<K, V>> T getAndModify(Supplier<T> mapSupplier) {
-        checkArgumentNotNull(mapSupplier, "The map supplier cannot be null.");
-        T map = mapSupplier.get();
-        modify(map);
-        return map;
-    }
-
-    /**
-     * 创建一个有初始化数据的不可变的 {@code Map}
-     *
-     * @return 不可变的 {@code Map}
-     */
-    public Map<K, V> getUnmodifiableMap() {
-        return Collections.unmodifiableMap(getAndModify(HashMap::new));
-    }
-
-    private MapModifier<K, V> addOperationInternal(Consumer<Map<K, V>> operator) {
-        this.operators = this.operators.andThen(operator);
-        return this;
-    }
-}

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

@@ -22,7 +22,7 @@
  * </h3>
  * 集合工具类
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 @ParametersAreNonnullByDefault
 package xyz.zhouxy.plusone.commons.collection;

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

@@ -19,7 +19,7 @@ package xyz.zhouxy.plusone.commons.exception;
 /**
  * 数据不存在异常
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  */
 public final class DataNotExistsException extends Exception {

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/IExceptionFactory.java

@@ -1,62 +0,0 @@
-/*
- * Copyright 2025 the original author or authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      https://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-package xyz.zhouxy.plusone.commons.exception;
-
-import javax.annotation.Nonnull;
-
-/**
- * 异常工厂
- *
- * @param <X> 异常类型
- * @author ZhouXY108 <luquanlion@outlook.com>
- */
-public interface IExceptionFactory<X extends Exception> {
-    /**
-    * 创建异常
-    *
-    * @return 异常对象
-    */
-    @Nonnull
-    X create();
-
-    /**
-     * 使用指定 {@code message} 创建异常
-     *
-     * @param message 异常信息
-     * @return 异常对象
-     */
-    @Nonnull
-    X create(String message);
-
-    /**
-     * 使用指定 {@code cause} 创建异常
-     *
-     * @param cause 包装的异常
-     * @return 异常对象
-     */
-    @Nonnull
-    X create(Throwable cause);
-
-    /**
-     * 使用指定 {@code message} 和 {@code cause} 创建异常
-     *
-     * @param message 异常信息
-     * @param cause   包装的异常
-     * @return 异常对象
-     */
-    @Nonnull
-    X create(String message, Throwable cause);
-}

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

@@ -17,23 +17,24 @@ package xyz.zhouxy.plusone.commons.exception;
 
 import javax.annotation.Nonnull;
 
+import xyz.zhouxy.plusone.commons.base.IWithCode;
+
 /**
- * IMultiTypesException
+ * MultiTypesException
  *
  * <p>
  * 异常在不同场景下被抛出，可以用不同的枚举值，表示不同的场景类型。
  *
  * <p>
- * 异常实现 {@link IMultiTypesException} 的 {@link #getType} 方法，返回对应的场景类型。
+ * 异常实现 {@link MultiTypesException} 的 {@link #getType} 方法，返回对应的场景类型。
  *
  * <p>
- * 表示场景类型的枚举实现 {@link IExceptionType}，各个枚举值本身就是该场景的异常的工厂实例，
- * 使用其中的工厂方法用于创建对应类型的异常。
+ * 表示场景类型的枚举实现 {@link ExceptionType}，其中的工厂方法用于创建对应类型的异常。
  *
  * <pre>
  * public final class LoginException
  *         extends RuntimeException
- *         implements IMultiTypesException&lt;LoginException.Type&gt; {
+ *         implements MultiTypesException&lt;LoginException, LoginException.Type&gt; {
  *     private static final long serialVersionUID = 881293090625085616L;
  *     private final Type type;
  *     private LoginException(&#64;Nonnull Type type, &#64;Nonnull String message) {
@@ -60,7 +61,7 @@ import javax.annotation.Nonnull;
  *
  *     // ...
  *
- *     public enum Type implements IExceptionType&lt;String&gt;, IExceptionFactory&lt;LoginException&gt; {
+ *     public enum Type implements ExceptionType&lt;LoginException&gt; {
  *         DEFAULT("00", "当前会话未登录"),
  *         NOT_TOKEN("10", "未提供token"),
  *         INVALID_TOKEN("20", "token无效"),
@@ -117,17 +118,73 @@ import javax.annotation.Nonnull;
  * throw LoginException.Type.TOKEN_TIMEOUT.create();
  * </pre>
  *
- * @param <T> 异常场景
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  */
-public interface IMultiTypesException<T extends IExceptionType<?>> {
+public interface MultiTypesException<E extends Exception, T extends MultiTypesException.ExceptionType<E>> {
 
     /**
      * 异常类型
      *
-     * @return 异常类型。通常是实现了 {@link IExceptionType} 的枚举。
+     * @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);
+
+    }
 }

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

@@ -21,6 +21,7 @@ import java.time.format.DateTimeParseException;
 import javax.annotation.Nonnull;
 
 import xyz.zhouxy.plusone.commons.exception.business.RequestParamsException;
+import xyz.zhouxy.plusone.commons.exception.MultiTypesException.ExceptionType;
 
 /**
  * 解析失败异常
@@ -33,12 +34,12 @@ import xyz.zhouxy.plusone.commons.exception.business.RequestParamsException;
  * throw new RequestParamsException(ParsingFailureException.Type.NUMBER_PARSING_FAILURE.create());
  * </pre>
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  */
 public final class ParsingFailureException
         extends Exception
-        implements IMultiTypesException<ParsingFailureException.Type> {
+        implements MultiTypesException<ParsingFailureException, ParsingFailureException.Type> {
     private static final long serialVersionUID = 795996090625132616L;
 
     private final Type type;
@@ -170,7 +171,7 @@ public final class ParsingFailureException
     /** XML 解析失败 */
     public static final Type XML_PARSING_FAILURE = Type.XML_PARSING_FAILURE;
 
-    public enum Type implements IExceptionType<String>, IExceptionFactory<ParsingFailureException> {
+    public enum Type implements ExceptionType<ParsingFailureException> {
         DEFAULT("00", "解析失败"),
         NUMBER_PARSING_FAILURE("10", "数字转换失败"),
         DATE_TIME_PARSING_FAILURE("20", "时间解析失败"),

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

@@ -25,7 +25,7 @@ package xyz.zhouxy.plusone.commons.exception.business;
  * <p>
  * <b>NOTE: 通常表示业务中的意外情况。如：用户错误输入、缺失必填字段、用户余额不足等。</b>
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  */
 public class BizException extends RuntimeException {
@@ -33,13 +33,21 @@ 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 异常信息
      */
-    protected BizException(String message) {
+    public BizException(String message) {
         super(message);
     }
 
@@ -49,7 +57,7 @@ public class BizException extends RuntimeException {
      *
      * @param cause 包装的异常
      */
-    protected BizException(Throwable cause) {
+    public BizException(Throwable cause) {
         super(cause);
     }
 
@@ -59,27 +67,8 @@ public class BizException extends RuntimeException {
      * @param message 异常信息
      * @param cause   包装的异常
      */
-    protected BizException(String message, Throwable cause) {
+    public BizException(String message, Throwable cause) {
         super(message, cause);
     }
 
-    public static BizException of() {
-        return new BizException(DEFAULT_MSG);
-    }
-
-    public static BizException of(String message) {
-        return new BizException(message);
-    }
-
-    public static BizException of(String errorMessageFormat, Object... errorMessageArgs) {
-        return new BizException(String.format(errorMessageFormat, errorMessageArgs));
-    }
-
-    public static BizException of(Throwable cause) {
-        return new BizException(cause);
-    }
-
-    public static BizException of(String message, Throwable cause) {
-        return new BizException(message, cause);
-    }
 }

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

@@ -18,9 +18,8 @@ package xyz.zhouxy.plusone.commons.exception.business;
 
 import javax.annotation.Nonnull;
 
-import xyz.zhouxy.plusone.commons.exception.IExceptionFactory;
-import xyz.zhouxy.plusone.commons.exception.IExceptionType;
-import xyz.zhouxy.plusone.commons.exception.IMultiTypesException;
+import xyz.zhouxy.plusone.commons.exception.MultiTypesException.ExceptionType;
+import xyz.zhouxy.plusone.commons.exception.MultiTypesException;
 
 /**
  * InvalidInputException
@@ -31,12 +30,12 @@ import xyz.zhouxy.plusone.commons.exception.IMultiTypesException;
  * <p>
  * <b>NOTE: 属业务异常</b>
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  */
 public final class InvalidInputException
         extends RequestParamsException
-        implements IMultiTypesException<InvalidInputException.Type> {
+        implements MultiTypesException<InvalidInputException, InvalidInputException.Type> {
     private static final long serialVersionUID = -28994090625082516L;
 
     private final Type type;
@@ -110,7 +109,7 @@ public final class InvalidInputException
         return this.type;
     }
 
-    public enum Type implements IExceptionType<String>, IExceptionFactory<InvalidInputException> {
+    public enum Type implements ExceptionType<InvalidInputException> {
         DEFAULT("00", "用户输入内容非法"),
         CONTAINS_ILLEGAL_AND_MALICIOUS_LINKS("01", "包含非法恶意跳转链接"),
         CONTAINS_ILLEGAL_WORDS("02", "包含违禁敏感词"),

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

@@ -22,7 +22,7 @@ package xyz.zhouxy.plusone.commons.exception.business;
  * <p>
  * 用户请求参数错误
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  */
 public class RequestParamsException extends BizException {

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

@@ -17,6 +17,6 @@
 /**
  * 业务异常
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 package xyz.zhouxy.plusone.commons.exception.business;

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

@@ -17,21 +17,20 @@
 /**
  * <h2>异常</h2>
  *
- * <h3>1. {@link IMultiTypesException} - 多类型异常</h3>
+ * <h3>1. {@link MultiTypesException} - 多类型异常</h3>
  * <p>
  * 异常在不同场景下被抛出，可以用不同的枚举值，表示不同的场景类型。
  *
  * <p>
- * 异常实现 {@link IMultiTypesException} 的 {@link IMultiTypesException#getType} 方法，返回对应的场景类型。
+ * 异常实现 {@link MultiTypesException} 的 {@link MultiTypesException#getType} 方法，返回对应的场景类型。
  *
  * <p>
- * 表示场景类型的枚举实现 {@link IMultiTypesException.IExceptionType}，各个枚举值本身就是该场景的异常的工厂实例，
- * 使用其中的工厂方法用于创建对应类型的异常。
+ * 表示场景类型的枚举实现 {@link MultiTypesException.ExceptionType}，其中的工厂方法用于创建对应类型的异常。
  *
  * <pre>
  * public final class LoginException
  *         extends RuntimeException
- *         implements IMultiTypesException&lt;LoginException, LoginException.Type, String&gt; {
+ *         implements MultiTypesException&lt;LoginException, LoginException.Type&gt; {
  *     private static final long serialVersionUID = 881293090625085616L;
  *     private final Type type;
  *     private LoginException(&#64;Nonnull Type type, &#64;Nonnull String message) {
@@ -58,7 +57,7 @@
  *
  *     // ...
  *
- *     public enum Type implements IExceptionType&lt;LoginException, String&gt; {
+ *     public enum Type implements ExceptionType&lt;LoginException&gt; {
  *         DEFAULT("00", "当前会话未登录"),
  *         NOT_TOKEN("10", "未提供token"),
  *         INVALID_TOKEN("20", "token无效"),
@@ -121,7 +120,7 @@
  * <h3>3. 系统异常</h3>
  * 预设常见的系统异常。可继承 {@link SysException} 自定义系统异常。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 package xyz.zhouxy.plusone.commons.exception;
 

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

@@ -27,7 +27,7 @@ package xyz.zhouxy.plusone.commons.exception.system;
  * 当出现这种始料未及的诡异情况时，抛出 {@link DataOperationResultException} 并回滚事务。
  * 后续需要排查原因。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  */
 public final class DataOperationResultException extends SysException {

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

@@ -22,7 +22,7 @@ package xyz.zhouxy.plusone.commons.exception.system;
  * <p>
  * 在无法找到可访问的 Mac 地址时抛出
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  */
 public class NoAvailableMacFoundException extends SysException {
@@ -33,7 +33,7 @@ public class NoAvailableMacFoundException extends SysException {
      * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
      */
     public NoAvailableMacFoundException() {
-        super("无法找到可访问的 Mac 地址");
+        super();
     }
 
     /**

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

@@ -22,7 +22,7 @@ package xyz.zhouxy.plusone.commons.exception.system;
  * <p>
  * 通常表示应用代码存在问题，或因环境问题，引发异常。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  */
 public class SysException extends RuntimeException {
@@ -30,13 +30,21 @@ 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 异常信息
      */
-    protected SysException(String message) {
+    public SysException(String message) {
         super(message);
     }
 
@@ -46,7 +54,7 @@ public class SysException extends RuntimeException {
      *
      * @param cause 包装的异常
      */
-    protected SysException(Throwable cause) {
+    public SysException(Throwable cause) {
         super(cause);
     }
 
@@ -56,27 +64,7 @@ public class SysException extends RuntimeException {
      * @param message 异常信息
      * @param cause   包装的异常
      */
-    protected SysException(String message, Throwable cause) {
+    public SysException(String message, Throwable cause) {
         super(message, cause);
     }
-
-    public static SysException of() {
-        return new SysException(DEFAULT_MSG);
-    }
-
-    public static SysException of(String message) {
-        return new SysException(message);
-    }
-
-    public static SysException of(String errorMessageFormat, Object... errorMessageArgs) {
-        return new SysException(String.format(errorMessageFormat, errorMessageArgs));
-    }
-
-    public static SysException of(Throwable cause) {
-        return new SysException(cause);
-    }
-
-    public static SysException of(String message, Throwable cause) {
-        return new SysException(message, cause);
-    }
 }

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

@@ -17,6 +17,6 @@
 /**
  * 系统异常
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 package xyz.zhouxy.plusone.commons.exception.system;

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

@@ -25,7 +25,7 @@ import com.google.common.annotations.Beta;
  * 一个特殊的 {@link java.util.function.UnaryOperator}。
  * 表示对 {@code boolean} 值的一元操作。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  * @see java.util.function.UnaryOperator
  */

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

@@ -25,7 +25,7 @@ import com.google.common.annotations.Beta;
  * 一个特殊的 {@link java.util.function.UnaryOperator}。
  * 表示对 {@code char} 的一元操作。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  * @see java.util.function.UnaryOperator
  */

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

@@ -24,7 +24,7 @@ package xyz.zhouxy.plusone.commons.function;
  *
  * @param <E> 可抛出的异常类型
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  */
 @FunctionalInterface

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

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

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/PredicateTools.java

@@ -24,7 +24,7 @@ import java.util.function.Predicate;
  * <p>
  * {@link Predicate} 相关操作。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  * @see Predicate
  */

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

@@ -22,7 +22,7 @@ package xyz.zhouxy.plusone.commons.function;
  * <p>
  * 允许抛出异常的消费操作。是一个特殊的 {@link java.util.function.Consumer}。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  * @see java.util.function.Consumer
  */

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

@@ -25,7 +25,7 @@ package xyz.zhouxy.plusone.commons.function;
  * @param <R> 返回结果类型
  * @param <E> 异常类型
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0
  * @see java.util.function.Function
  */

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

@@ -22,7 +22,7 @@ package xyz.zhouxy.plusone.commons.function;
  * <p>
  * 接收一个参数，返回一个布尔值，可抛出异常。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  * @see java.util.function.Predicate
  */

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

@@ -25,7 +25,7 @@ package xyz.zhouxy.plusone.commons.function;
  * @param <T> 结果类型
  * @param <E> 异常类型
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  * @see java.util.function.Supplier
  */

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/ToOptionalBiFunction.java

@@ -25,7 +25,7 @@ import java.util.function.BiFunction;
  * <p>
  * 接受类型为 T 和 U 的两个参数，返回 {@code Optional&lt;R&gt;} 对象。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  * @see Optional
  * @see BiFunction

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/ToOptionalFunction.java

@@ -25,7 +25,7 @@ import java.util.function.Function;
  * <p>
  * 接受类型为 T 的参数，返回 {@code Optional&lt;R&gt;} 对象。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  * @see Optional
  * @see Function

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

@@ -39,6 +39,6 @@
  * | Optional      | ToOptionalFunction   | Optional<R> apply(T)             |
  * </pre>
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 package xyz.zhouxy.plusone.commons.function;

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/gson/adapter/JSR310TypeAdapters.java

@@ -33,7 +33,7 @@ import com.google.gson.stream.JsonWriter;
 /**
  * 包含 JSR-310 相关数据类型的 {@code TypeAdapter}
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.1.0
  * @see TypeAdapter
  * @see com.google.gson.GsonBuilder

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

@@ -33,7 +33,7 @@ import com.google.errorprone.annotations.Immutable;
 
 import xyz.zhouxy.plusone.commons.annotation.ReaderMethod;
 import xyz.zhouxy.plusone.commons.annotation.ValueObject;
-import xyz.zhouxy.plusone.commons.constant.PatternConsts;
+import xyz.zhouxy.plusone.commons.regex.PatternConsts;
 import xyz.zhouxy.plusone.commons.util.StringTools;
 
 /**
@@ -42,9 +42,9 @@ import xyz.zhouxy.plusone.commons.util.StringTools;
  * <p>
  * 中国第二代居民身份证号
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
- * @see xyz.zhouxy.plusone.commons.constant.PatternConsts#CHINESE_2ND_ID_CARD_NUMBER
+ * @see xyz.zhouxy.plusone.commons.regex.PatternConsts#CHINESE_2ND_ID_CARD_NUMBER
  */
 @ValueObject
 @Immutable

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

@@ -23,7 +23,7 @@ import xyz.zhouxy.plusone.commons.base.IWithIntCode;
 /**
  * 性别
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 public enum Gender implements IWithIntCode {
     UNKNOWN(0, "Unknown", "未知"),

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

@@ -24,7 +24,7 @@ import xyz.zhouxy.plusone.commons.util.StringTools;
 /**
  * 身份证号
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 public interface IDCardNumber {
 

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/SemVer.java

@@ -1,275 +0,0 @@
-/*
- * Copyright 2025 the original author or authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      https://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-package xyz.zhouxy.plusone.commons.model;
-
-
-import static xyz.zhouxy.plusone.commons.util.AssertTools.checkArgument;
-
-import java.io.Serializable;
-import java.util.Objects;
-import java.util.regex.Matcher;
-import java.util.regex.Pattern;
-
-import javax.annotation.Nullable;
-
-import com.google.common.base.Splitter;
-
-import xyz.zhouxy.plusone.commons.util.StringTools;
-
-/**
- * SemVer 语义版本号
- *
- * @author ZhouXY108 <luquanlion@outlook.com>
- * @since 1.1.0
- *
- * @see <a href="https://semver.org/">Semantic Versioning 2.0.0</a>
- */
-public class SemVer implements Comparable<SemVer>, Serializable {
-    private static final long serialVersionUID = 458265121025514002L;
-
-    private final String value;
-
-    private final int[] versionNumbers;
-    @Nullable
-    private final String preReleaseVersion;
-    @Nullable
-    private final String buildMetadata;
-
-    private static final String VERSION_NUMBERS = "(?<numbers>(?<major>0|[1-9]\\d*)\\.(?<minor>0|[1-9]\\d*)\\.(?<patch>0|[1-9]\\d*)(\\.(0|[1-9]\\d*)){0,2})";
-    private static final String PRE_RELEASE_VERSION = "(?:-(?<prerelease>(?:0|[1-9]\\d{0,41}|\\d{0,18}[a-zA-Z-][0-9a-zA-Z-]{0,18})(?:\\.(?:0|[1-9]\\d{0,41}|\\d{0,18}[a-zA-Z-][0-9a-zA-Z-]{0,18})){0,18}))?";
-    private static final String BUILD_METADATA = "(?:\\+(?<buildmetadata>[0-9a-zA-Z-]{1,18}(?:\\.[0-9a-zA-Z-]{1,18}){0,18}))?";
-
-    private static final Pattern PATTERN = Pattern.compile(
-            "^" + VERSION_NUMBERS + PRE_RELEASE_VERSION + BUILD_METADATA + "$");
-
-    /**
-     * 创建语义化版本号的值对象
-     *
-     * @param value 字符串值
-     * @param versionNumbers 主版本号、次版本号、修订号
-     * @param preReleaseVersion 先行版本号
-     * @param buildMetadata 版本编译信息
-     */
-    private SemVer(String value,
-            int[] versionNumbers,
-            @Nullable String preReleaseVersion,
-            @Nullable String buildMetadata) {
-        this.value = value;
-        this.versionNumbers = versionNumbers;
-        this.preReleaseVersion = preReleaseVersion;
-        this.buildMetadata = buildMetadata;
-    }
-
-    /**
-     * 创建 SemVer 对象
-     *
-     * @param value 语义化版本号
-     * @return SemVer 对象
-     */
-    public static SemVer of(final String value) {
-        checkArgument(StringTools.isNotBlank(value), "版本号不能为空");
-        final Matcher matcher = PATTERN.matcher(value);
-        checkArgument(matcher.matches(), "版本号格式错误");
-        // 数字版本部分
-        final String versionNumbersPart = matcher.group("numbers");
-        // 先行版本号部分
-        final String preReleaseVersionPart = matcher.group("prerelease");
-        // 版本编译信息部分
-        final String buildMetadataPart = matcher.group("buildmetadata");
-
-        final int[] versionNumbers = Splitter.on('.')
-                .splitToStream(versionNumbersPart)
-                // 必须都是数字
-                .mapToInt(Integer::parseInt)
-                .toArray();
-        return new SemVer(value, versionNumbers, preReleaseVersionPart, buildMetadataPart);
-    }
-
-    /**
-     * 获取主版本号
-     *
-     * @return 主版本号
-     */
-    public int getMajor() {
-        return this.versionNumbers[0];
-    }
-
-    /**
-     * 获取次版本号
-     *
-     * @return 次版本号
-     */
-    public int getMinor() {
-        return this.versionNumbers[1];
-    }
-
-    /**
-     * 获取修订号
-     *
-     * @return 修订号
-     */
-    public int getPatch() {
-        return this.versionNumbers[2];
-    }
-
-    /**
-     * 获取先行版本号
-     *
-     * @return 先行版本号
-     */
-    @Nullable
-    public String getPreReleaseVersion() {
-        return this.preReleaseVersion;
-    }
-
-    /**
-     * 获取版本编译信息
-     *
-     * @return 版本编译信息
-     */
-    @Nullable
-    public String getBuildMetadata() {
-        return buildMetadata;
-    }
-
-    /** {@inheritDoc} */
-    @Override
-    public int compareTo(@SuppressWarnings("null") SemVer that) {
-        if (this == that) {
-            return 0;
-        }
-        int result = compareVersionNumbers(that);
-        if (result != 0) {
-            return result;
-        }
-        return comparePreReleaseVersion(that);
-    }
-
-    /**
-     * 获取字符串值
-     *
-     * @return 版本字符串
-     */
-    public String getValue() {
-        return value;
-    }
-
-    /** {@inheritDoc} */
-    @Override
-    public int hashCode() {
-        return Objects.hash(value);
-    }
-
-    /** {@inheritDoc} */
-    @Override
-    public boolean equals(@Nullable Object obj) {
-        if (this == obj)
-            return true;
-        if (!(obj instanceof SemVer))
-            return false;
-        SemVer other = (SemVer) obj;
-        return Objects.equals(value, other.value);
-    }
-
-    /**
-     * 获取 SemVer 的字符串表示。如 {@code v1.2.3-alpha.1+build.1234}
-     */
-    @Override
-    public String toString() {
-        return 'v' + value;
-    }
-
-    /**
-     * 比较主版本号、次版本号、修订号
-     */
-    private int compareVersionNumbers(SemVer that) {
-        final int minLength = Integer.min(this.versionNumbers.length, that.versionNumbers.length);
-
-        for (int i = 0; i < minLength; i++) {
-            final int currentVersionNumberOfThis = this.versionNumbers[i];
-            final int currentVersionNumberOfThat = that.versionNumbers[i];
-            if (currentVersionNumberOfThis != currentVersionNumberOfThat) {
-                return currentVersionNumberOfThis - currentVersionNumberOfThat;
-            }
-        }
-        return this.versionNumbers.length - that.versionNumbers.length;
-    }
-
-    /**
-     * 比较先行版本号
-     */
-    private int comparePreReleaseVersion(SemVer that) {
-        int thisWithoutPreReleaseVersionFlag = bool2Int(this.preReleaseVersion == null);
-        int thatWithoutPreReleaseVersionFlag = bool2Int(that.preReleaseVersion == null);
-        if (isTrue(thisWithoutPreReleaseVersionFlag | thatWithoutPreReleaseVersionFlag)) {
-            return thisWithoutPreReleaseVersionFlag - thatWithoutPreReleaseVersionFlag;
-        }
-
-        Splitter splitter = Splitter.on('.');
-
-        final String[] preReleaseVersionOfThis = splitter
-                .splitToStream(this.preReleaseVersion) // NOSONAR
-                .toArray(String[]::new);
-        final String[] preReleaseVersionOfThat = splitter
-                .splitToStream(that.preReleaseVersion) // NOSONAR
-                .toArray(String[]::new);
-        final int minLength = Integer.min(preReleaseVersionOfThis.length, preReleaseVersionOfThat.length);
-        for (int i = 0; i < minLength; i++) {
-            int r = comparePartOfPreReleaseVersion(preReleaseVersionOfThis[i], preReleaseVersionOfThat[i]);
-            if (r != 0) {
-                return r;
-            }
-        }
-        return preReleaseVersionOfThis.length - preReleaseVersionOfThat.length;
-    }
-
-    /**
-     * 比较先行版本号的组成部分
-     */
-    private static int comparePartOfPreReleaseVersion(String p1, String p2) {
-        boolean p1IsNumber = isAllDigits(p1);
-        boolean p2IsNumber = isAllDigits(p2);
-
-        if (p1IsNumber) {
-            return p2IsNumber
-                    ? Integer.parseInt(p1) - Integer.parseInt(p2) // 都是数字
-                    : -1; // p1 是数字，p2 是字符串
-        }
-        // 如果 p1 是字符串，p2 是数字，则返回 1（字符串优先于纯数字）
-        return p2IsNumber ? 1 : p1.compareTo(p2);
-    }
-
-    /**
-     * 判断字符串是否全为数字
-     */
-    private static boolean isAllDigits(String str) {
-        for (int i = 0; i < str.length(); i++) {
-            char c = str.charAt(i);
-            if (c < '0' || c > '9') {
-                return false;
-            }
-        }
-        return true;
-    }
-
-    private static int bool2Int(boolean expression) {
-        return expression ? 1 : 0;
-    }
-
-    private static boolean isTrue(int b) {
-        return b != 0;
-    }
-}

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

@@ -17,7 +17,6 @@
 package xyz.zhouxy.plusone.commons.model;
 
 import static xyz.zhouxy.plusone.commons.util.AssertTools.checkArgument;
-import static xyz.zhouxy.plusone.commons.util.AssertTools.checkArgumentNotNull;
 
 import java.util.Objects;
 import java.util.function.Supplier;
@@ -32,7 +31,7 @@ import xyz.zhouxy.plusone.commons.annotation.ReaderMethod;
 /**
  * 带校验的字符串值对象
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  *
  * @deprecated 弃用。使用工厂方法创建对象，并在其中进行校验即可。
@@ -76,8 +75,8 @@ public abstract class ValidatableStringRecord<T extends ValidatableStringRecord<
      * @param errorMessage 正则不匹配时的错误信息
      */
     protected ValidatableStringRecord(String value, Pattern pattern, String errorMessage) {
-        checkArgumentNotNull(value, "The value cannot be null.");
-        checkArgumentNotNull(pattern, "The pattern cannot be null.");
+        checkArgument(Objects.nonNull(value), "The value cannot be null.");
+        checkArgument(Objects.nonNull(pattern), "The pattern cannot be null.");
         this.matcher = pattern.matcher(value);
         checkArgument(this.matcher.matches(), errorMessage);
         this.value = value;

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

@@ -29,7 +29,7 @@ import xyz.zhouxy.plusone.commons.collection.CollectionTools;
  *
  * @param <T> 内容列表的元素类型
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @see PagingAndSortingQueryParams
  */
 public class PageResult<T> {

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

@@ -27,6 +27,7 @@ import javax.annotation.Nullable;
 
 import com.google.common.collect.ImmutableMap;
 
+import xyz.zhouxy.plusone.commons.annotation.Virtual;
 import xyz.zhouxy.plusone.commons.collection.CollectionTools;
 import xyz.zhouxy.plusone.commons.util.RegexTools;
 import xyz.zhouxy.plusone.commons.util.StringTools;
@@ -38,16 +39,36 @@ import xyz.zhouxy.plusone.commons.util.StringTools;
  * 根据传入的 {@code size} 和 {@code pageNum}，
  * 提供 {@code getOffset} 方法计算 SQL 语句中 {@code offset} 的值。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @see PagingParams
  * @see PageResult
  */
 public class PagingAndSortingQueryParams {
 
+    private static final int DEFAULT_PAGE_SIZE = 15;
+
     private Integer size;
     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 final Map<String, String> sortableProperties;
+
+    /**
+     * 构造分页排序查询参数
+     *
+     * @param sortableProperties 可排序的属性。不可为空。
+     */
+    public PagingAndSortingQueryParams(Map<String, String> sortableProperties) {
+        checkArgument(CollectionTools.isNotEmpty(sortableProperties),
+                "Sortable properties can not be empty.");
+        sortableProperties.forEach((k, v) ->
+                checkArgument(StringTools.isNotBlank(k) && StringTools.isNotBlank(v),
+                "Property name must not be blank."));
+        this.sortableProperties = ImmutableMap.copyOf(sortableProperties);
+    }
+
     // Setters
 
     /**
@@ -79,18 +100,56 @@ public class PagingAndSortingQueryParams {
 
     // 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;
+        checkArgument(CollectionTools.isNotEmpty(this.orderBy),
+                "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;
+    }
+
     @Override
     public String toString() {
         return "PagingAndSortingQueryParams ["
                 + "size=" + size
                 + ", pageNum=" + pageNum
                 + ", orderBy=" + orderBy
+                + ", sortableProperties=" + sortableProperties
                 + "]";
     }
 
-    protected static PagingParamsBuilder pagingParamsBuilder(
-            int defaultSize, int maxSize, Map<String, String> sortableProperties) {
-        return new PagingParamsBuilder(defaultSize, maxSize, sortableProperties);
+    private SortableProperty generateSortableProperty(String orderByStr) {
+        checkArgument(StringTools.isNotBlank(orderByStr));
+        checkArgument(RegexTools.matches(orderByStr, SORT_STR_PATTERN));
+        String[] propertyNameAndOrderType = orderByStr.split("-");
+        checkArgument(propertyNameAndOrderType.length == 2);
+
+        String propertyName = propertyNameAndOrderType[0];
+        checkArgument(sortableProperties.containsKey(propertyName),
+                "The property name must be in the set of sortable properties.");
+        String columnName = sortableProperties.get(propertyName);
+        String orderType = propertyNameAndOrderType[1];
+        return new SortableProperty(propertyName, columnName, orderType);
     }
 
     /**
@@ -158,47 +217,4 @@ public class PagingAndSortingQueryParams {
         }
     }
 
-    protected static final class PagingParamsBuilder {
-        private static final Pattern SORT_STR_PATTERN = Pattern.compile("^[a-zA-Z][\\w-]{0,63}-(desc|asc|DESC|ASC)$");
-
-        private final Map<String, String> sortableProperties;
-        protected final int defaultSize;
-        protected final int maxSize;
-
-        private PagingParamsBuilder(int defaultSize, int maxSize, Map<String, String> sortableProperties) {
-            this.defaultSize = defaultSize;
-            this.maxSize = maxSize;
-            checkArgument(CollectionTools.isNotEmpty(sortableProperties),
-                    "Sortable properties can not be empty.");
-            sortableProperties.forEach((k, v) ->
-                    checkArgument(StringTools.isNotBlank(k) && StringTools.isNotBlank(v),
-                    "Property name must not be blank."));
-            this.sortableProperties = ImmutableMap.copyOf(sortableProperties);
-        }
-
-        public PagingParams buildPagingParams(PagingAndSortingQueryParams params) {
-            final int sizeValue = params.size != null ? params.size : this.defaultSize;
-            final long pageNumValue = params.pageNum != null ? params.pageNum : 1L;
-            checkArgument(CollectionTools.isNotEmpty(params.orderBy),
-                    "The 'orderBy' cannot be empty");
-            final List<SortableProperty> propertiesToSort = params.orderBy.stream()
-                    .map(this::generateSortableProperty)
-                    .collect(Collectors.toList());
-            return new PagingParams(sizeValue, pageNumValue, propertiesToSort);
-        }
-
-        private SortableProperty generateSortableProperty(String orderByStr) {
-            checkArgument(StringTools.isNotBlank(orderByStr));
-            checkArgument(RegexTools.matches(orderByStr, SORT_STR_PATTERN));
-            String[] propertyNameAndOrderType = orderByStr.split("-");
-            checkArgument(propertyNameAndOrderType.length == 2);
-
-            String propertyName = propertyNameAndOrderType[0];
-            checkArgument(sortableProperties.containsKey(propertyName),
-                    "The property name must be in the set of sortable properties.");
-            String columnName = sortableProperties.get(propertyName);
-            String orderType = propertyNameAndOrderType[1];
-            return new SortableProperty(propertyName, columnName, orderType);
-        }
-    }
 }

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

@@ -24,7 +24,7 @@ import xyz.zhouxy.plusone.commons.model.dto.PagingAndSortingQueryParams.Sortable
 /**
  * 分页参数
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @see PagingAndSortingQueryParams
  */
 public class PagingParams {

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

@@ -22,7 +22,7 @@ import javax.annotation.Nullable;
 /**
  * 统一结果，对返回给前端的数据进行封装。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 public class UnifiedResponse<T> {
 

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

@@ -19,42 +19,9 @@ package xyz.zhouxy.plusone.commons.model.dto;
 import javax.annotation.Nullable;
 
 /**
- * {@link UnifiedResponse} 工厂类。
- * 用于快速构建 {@link UnifiedResponse} 对象，默认的成功代码为 {@code 2000000}。
+ * UnifiedResponse 工厂
  *
- * <p>
- * 用户可以继承 {@link UnifiedResponses} 实现自己的工厂类，
- * 自定义 SUCCESS_CODE 和 DEFAULT_SUCCESS_MSG，以及工厂方法。
- * 如下所示：
- * <pre>
- * // 自定义工厂类
- * public static class CustomUnifiedResponses extends UnifiedResponses {
- *
- *     public static final String SUCCESS_CODE = "000";
- *     public static final String DEFAULT_SUCCESS_MSG = "成功";
- *
- *     public static <T> UnifiedResponse<T> success() {
- *         return of(SUCCESS_CODE, DEFAULT_SUCCESS_MSG);
- *     }
- *
- *     public static <T> UnifiedResponse<T> success(@Nullable String message) {
- *         return of(SUCCESS_CODE, message);
- *     }
- *
- *     public static <T> UnifiedResponse<T> success(@Nullable String message, @Nullable T data) {
- *         return of(SUCCESS_CODE, message, data);
- *     }
- *
- *     private CustomUnifiedResponses() {
- *         super();
- *     }
- * }
- * // 使用自定义工厂类
- * CustomUnifiedResponses.success("查询成功", userList); // 状态码为 000
- * </pre>
- * 见 <a href="http://zhouxy.xyz:3000/plusone/plusone-commons/issues/22">issue#22</a>。
- *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  * @see UnifiedResponse
  */

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

@@ -52,13 +52,15 @@
  * {@link UnifiedResponse} 对返回给前端的数据进行封装，包含 code、message、data。
  *
  * <p>
- * {@link UnifiedResponses} 用于快速构建 {@link UnifiedResponse} 对象，默认的成功代码为 {@code 2000000}。
+ * 可使用 {@link UnifiedResponses} 快速构建 {@link UnifiedResponse} 对象。
+ * {@link UnifiedResponses} 默认的成功代码为 "2000000"，
+ * 用户按测试类
+ * <a href="http://zhouxy.xyz:3000/plusone/plusone-commons/src/branch/main/src/test/java/xyz/zhouxy/plusone/commons/model/dto/CustomUnifiedResponseFactoryTests.java">CustomUnifiedResponseFactoryTests</a>
+ * 中所示范的，继承 {@link UnifiedResponses} 实现自己的工厂类，
+ * 自定义 SUCCESS_CODE 和 DEFAULT_SUCCESS_MSG 和工厂方法。
+ * 见 <a href="http://zhouxy.xyz:3000/plusone/plusone-commons/issues/22">issue#22</a>。
  *
- * <p>
- * 用户可以继承 {@link UnifiedResponses} 实现自己的工厂类，
- * 自定义 SUCCESS_CODE 和 DEFAULT_SUCCESS_MSG，以及工厂方法。
- *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 @ParametersAreNonnullByDefault
 package xyz.zhouxy.plusone.commons.model.dto;

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

@@ -19,7 +19,7 @@
  * <p>
  * 包含业务建模可能用到的性别、身份证等元素，也包含 DTO 相关类，如分页查询参数，响应结果，分页结果等。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 @ParametersAreNonnullByDefault
 package xyz.zhouxy.plusone.commons.model;

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/regex/AbstractMatcher.java

@@ -0,0 +1,38 @@
+/*
+ * Copyright 2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package xyz.zhouxy.plusone.commons.regex;
+
+import java.util.regex.Matcher;
+
+public abstract class AbstractMatcher {
+    private final Matcher matcher;
+
+    AbstractMatcher(Matcher matcher) {
+        this.matcher = matcher;
+    }
+
+    public final Matcher matcher() {
+        return this.matcher;
+    }
+
+    public final boolean matches() {
+        return this.matcher.matches();
+    }
+
+    public final String getGroupValue(String groupName) {
+        return this.matcher.group(groupName);
+    }
+}

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/regex/Chinese2ndIdCardNumberMatcher.java

@@ -0,0 +1,60 @@
+/*
+ * Copyright 2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package xyz.zhouxy.plusone.commons.regex;
+
+import java.util.regex.Matcher;
+
+import xyz.zhouxy.plusone.commons.model.Gender;
+
+public final class Chinese2ndIdCardNumberMatcher extends AbstractMatcher {
+
+    Chinese2ndIdCardNumberMatcher(Matcher matcher) {
+        super(matcher);
+    }
+
+    public final String getProvince() {
+        return getGroupValue("province");
+    }
+
+    public final String getCity() {
+        return getGroupValue("city");
+    }
+
+    public final String getCounty() {
+        return getGroupValue("county");
+    }
+
+    public final String getBirthDate() {
+        return getGroupValue("birthDate");
+    }
+
+    public final String getOrderCode() {
+        return getGroupValue("orderCode");
+    }
+
+    public final String getGenderCode() {
+        return getGroupValue("gender");
+    }
+
+    public final Gender getGender() {
+        final int genderCode = Integer.parseInt(getGenderCode());
+        return genderCode % 2 == 0 ? Gender.FEMALE : Gender.MALE;
+    }
+
+    public final String getCheckDigit() {
+        return getGroupValue("checkDigit");
+    }
+}

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/regex/LocalDateMatcher.java

@@ -13,27 +13,25 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-package xyz.zhouxy.plusone.commons.exception;
+package xyz.zhouxy.plusone.commons.regex;
 
-import xyz.zhouxy.plusone.commons.annotation.Virtual;
-import xyz.zhouxy.plusone.commons.base.IWithCode;
+import java.util.regex.Matcher;
 
-/**
- * 异常场景
- *
- * @param <TCode> 场景编码
- * @author ZhouXY108 <luquanlion@outlook.com>
- */
-public interface IExceptionType<TCode> extends IWithCode<TCode> {
+public final class LocalDateMatcher extends AbstractMatcher {
 
-    /**
-     * 默认异常信息
-     */
-    String getDefaultMessage();
-
-    @Virtual
-    default String getDescription() {
-        return getDefaultMessage();
+    LocalDateMatcher(Matcher matcher) {
+        super(matcher);
     }
 
+    public String getYear() {
+        return getGroupValue("yyyy");
+    }
+
+    public String getMonth() {
+        return getGroupValue("MM");
+    }
+
+    public String getDay() {
+        return getGroupValue("dd");
+    }
 }

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/regex/PatternConsts.java

@@ -14,14 +14,14 @@
  * limitations under the License.
  */
 
-package xyz.zhouxy.plusone.commons.constant;
+package xyz.zhouxy.plusone.commons.regex;
 
 import java.util.regex.Pattern;
 
 /**
  * 正则表达式常量
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @see RegexConsts
  * @see xyz.zhouxy.plusone.commons.util.RegexTools
  */

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/regex/PatternInfo.java

@@ -0,0 +1,38 @@
+/*
+ * Copyright 2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package xyz.zhouxy.plusone.commons.regex;
+
+import java.util.regex.Pattern;
+
+public abstract class PatternInfo<T> {
+    private final String regex;
+    private final Pattern pattern;
+
+    PatternInfo(String regex, Pattern pattern) {
+        this.regex = regex;
+        this.pattern = pattern;
+    }
+
+    public final String regex() {
+        return this.regex;
+    }
+
+    public final Pattern pattern() {
+        return this.pattern;
+    }
+
+    public abstract T matcher(String input);
+}

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/regex/PatternInfos.java

@@ -0,0 +1,114 @@
+/*
+ * Copyright 2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package xyz.zhouxy.plusone.commons.regex;
+
+import java.util.regex.Matcher;
+
+public final class PatternInfos {
+
+    // @see RegexConsts#BASIC_ISO_DATE
+    public static final PatternInfo<LocalDateMatcher> BASIC_ISO_DATE = new PatternInfo<LocalDateMatcher>(
+            RegexConsts.BASIC_ISO_DATE,
+            PatternConsts.BASIC_ISO_DATE) {
+        @Override
+        public LocalDateMatcher matcher(String input) {
+            Matcher matcher = pattern().matcher(input);
+            return new LocalDateMatcher(matcher);
+        }
+    };
+
+    // @see RegexConsts#ISO_LOCAL_DATE
+    public static final PatternInfo<LocalDateMatcher> ISO_LOCAL_DATE = new PatternInfo<LocalDateMatcher>(
+            RegexConsts.ISO_LOCAL_DATE,
+            PatternConsts.ISO_LOCAL_DATE) {
+        @Override
+        public LocalDateMatcher matcher(String input) {
+            Matcher matcher = pattern().matcher(input);
+            return new LocalDateMatcher(matcher);
+        }
+    };
+
+    // @see RegexConsts#PASSWORD
+    public static final PatternInfo<Matcher> PASSWORD = new PatternInfo<Matcher>(
+            RegexConsts.PASSWORD,
+            PatternConsts.PASSWORD) {
+        @Override
+        public Matcher matcher(String input) {
+            return pattern().matcher(input);
+        }
+    };
+
+    // @see RegexConsts#CAPTCHA
+    public static final PatternInfo<Matcher> CAPTCHA = new PatternInfo<Matcher>(
+            RegexConsts.CAPTCHA,
+            PatternConsts.CAPTCHA) {
+        @Override
+        public Matcher matcher(String input) {
+            return pattern().matcher(input);
+        }
+    };
+
+    // @see RegexConsts#EMAIL
+    public static final PatternInfo<Matcher> EMAIL = new PatternInfo<Matcher>(
+            RegexConsts.EMAIL,
+            PatternConsts.EMAIL) {
+        @Override
+        public Matcher matcher(String input) {
+            return pattern().matcher(input);
+        }
+    };
+
+    public static final PatternInfo<Matcher> MOBILE_PHONE = new PatternInfo<Matcher>(
+            RegexConsts.MOBILE_PHONE,
+            PatternConsts.MOBILE_PHONE) {
+        @Override
+        public Matcher matcher(String input) {
+            return pattern().matcher(input);
+        }
+    };
+
+    public static final PatternInfo<Matcher> USERNAME = new PatternInfo<Matcher>(
+            RegexConsts.USERNAME,
+            PatternConsts.USERNAME) {
+        @Override
+        public Matcher matcher(String input) {
+            return pattern().matcher(input);
+        }
+    };
+
+    public static final PatternInfo<Matcher> NICKNAME = new PatternInfo<Matcher>(
+            RegexConsts.NICKNAME,
+            PatternConsts.NICKNAME) {
+        @Override
+        public Matcher matcher(String input) {
+            return pattern().matcher(input);
+        }
+    };
+
+    public static final PatternInfo<Chinese2ndIdCardNumberMatcher> CHINESE_2ND_ID_CARD_NUMBER = new PatternInfo<Chinese2ndIdCardNumberMatcher>(
+            RegexConsts.CHINESE_2ND_ID_CARD_NUMBER,
+            PatternConsts.CHINESE_2ND_ID_CARD_NUMBER) {
+        @Override
+        public Chinese2ndIdCardNumberMatcher matcher(String input) {
+            Matcher matcher = pattern().matcher(input);
+            return new Chinese2ndIdCardNumberMatcher(matcher);
+        }
+    };
+
+    private PatternInfos() {
+        throw new IllegalStateException("Utility class");
+    }
+}

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/regex/RegexConsts.java

@@ -14,12 +14,12 @@
  * limitations under the License.
  */
 
-package xyz.zhouxy.plusone.commons.constant;
+package xyz.zhouxy.plusone.commons.regex;
 
 /**
  * 正则表达式常量
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @see PatternConsts
  */
 public final class RegexConsts {
@@ -41,12 +41,15 @@ public final class RegexConsts {
 
     public static final String MOBILE_PHONE = "^(13[0-9]|14[01456879]|15[0-35-9]|16[2567]|17[0-8]|18[0-9]|19[0-35-9])\\d{8}$";
 
-    public static final String USERNAME = "^[\\w-_.@]{4,36}$";
+    public static final String USERNAME = "^[\\w-_]{4,36}$";
 
     public static final String NICKNAME = "^[\\w-_.@]{4,36}$";
 
     public static final String CHINESE_2ND_ID_CARD_NUMBER
-            = "^(?<county>(?<city>(?<province>\\d{2})\\d{2})\\d{2})(?<birthDate>\\d{8})\\d{2}(?<gender>\\d)([\\dX])$";
+            = "^(?<county>(?<city>(?<province>\\d{2})\\d{2})\\d{2})"
+            + "(?<birthDate>\\d{8})"
+            + "(?<orderCode>\\d{2}(?<gender>\\d))"
+            + "(?<checkDigit>[\\dX])$";
 
     private RegexConsts() {
         throw new IllegalStateException("Utility class");

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

@@ -14,16 +14,4 @@
  * limitations under the License.
  */
 
-/**
- * <h2>常量</h2>
- *
- * <h3>
- * 1. 正则常量
- * </h3>
- * {@link RegexConsts} 包含常见正则表达式；{@link PatternConsts} 包含对应的 {@link Pattern} 对象。
- *
- * @author ZhouXY108 <luquanlion@outlook.com>
- */
-package xyz.zhouxy.plusone.commons.constant;
-
-import java.util.regex.Pattern;
+package xyz.zhouxy.plusone.commons.regex;

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

@@ -32,7 +32,7 @@ import xyz.zhouxy.plusone.commons.base.IWithIntCode;
 /**
  * 季度
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 public enum Quarter implements IWithIntCode {
     /** 第一季度 */

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

@@ -37,7 +37,7 @@ import xyz.zhouxy.plusone.commons.annotation.StaticFactoryMethod;
 /**
  * 表示年份与季度
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 @Immutable
 public final class YearQuarter implements Comparable<YearQuarter>, Serializable {

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

@@ -22,7 +22,7 @@
  * 模仿 JDK 的 {@link java.time.Month} 和 {@link java.time.YearMonth}，
  * 实现 {@link Quarter}，{@link YearQuarter}，对季度进行建模。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 @ParametersAreNonnullByDefault
 package xyz.zhouxy.plusone.commons.time;

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

@@ -17,7 +17,6 @@
 package xyz.zhouxy.plusone.commons.util;
 
 import static xyz.zhouxy.plusone.commons.util.AssertTools.checkArgument;
-import static xyz.zhouxy.plusone.commons.util.AssertTools.checkArgumentNotNull;
 import static xyz.zhouxy.plusone.commons.util.AssertTools.checkNotNull;
 
 import java.math.BigDecimal;
@@ -38,7 +37,7 @@ import javax.annotation.Nullable;
  * <p>
  * 数组工具类
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  */
 public class ArrayTools {
@@ -492,7 +491,7 @@ public class ArrayTools {
      * @return 重复后的数组
      */
     public static char[] repeat(char[] arr, int times, int maxLength) {
-        checkArgumentNotNull(arr);
+        checkArgument(Objects.nonNull(arr));
         checkArgument(times >= 0,
                 "The number of times must be greater than or equal to zero");
         checkArgument(maxLength >= 0,
@@ -527,7 +526,7 @@ public class ArrayTools {
      * @return 重复后的数组
      */
     public static byte[] repeat(byte[] arr, int times, int maxLength) {
-        checkArgumentNotNull(arr);
+        checkArgument(Objects.nonNull(arr));
         checkArgument(times >= 0,
                 "The number of times must be greater than or equal to zero");
         checkArgument(maxLength >= 0,
@@ -562,7 +561,7 @@ public class ArrayTools {
      * @return 重复后的数组
      */
     public static short[] repeat(short[] arr, int times, int maxLength) {
-        checkArgumentNotNull(arr);
+        checkArgument(Objects.nonNull(arr));
         checkArgument(times >= 0,
                 "The number of times must be greater than or equal to zero");
         checkArgument(maxLength >= 0,
@@ -597,7 +596,7 @@ public class ArrayTools {
      * @return 重复后的数组
      */
     public static int[] repeat(int[] arr, int times, int maxLength) {
-        checkArgumentNotNull(arr);
+        checkArgument(Objects.nonNull(arr));
         checkArgument(times >= 0,
                 "The number of times must be greater than or equal to zero");
         checkArgument(maxLength >= 0,
@@ -632,7 +631,7 @@ public class ArrayTools {
      * @return 重复后的数组
      */
     public static long[] repeat(long[] arr, int times, int maxLength) {
-        checkArgumentNotNull(arr);
+        checkArgument(Objects.nonNull(arr));
         checkArgument(times >= 0,
                 "The number of times must be greater than or equal to zero");
         checkArgument(maxLength >= 0,
@@ -667,7 +666,7 @@ public class ArrayTools {
      * @return 重复后的数组
      */
     public static float[] repeat(float[] arr, int times, int maxLength) {
-        checkArgumentNotNull(arr);
+        checkArgument(Objects.nonNull(arr));
         checkArgument(times >= 0,
                 "The number of times must be greater than or equal to zero");
         checkArgument(maxLength >= 0,
@@ -702,7 +701,7 @@ public class ArrayTools {
      * @return 重复后的数组
      */
     public static double[] repeat(double[] arr, int times, int maxLength) {
-        checkArgumentNotNull(arr);
+        checkArgument(Objects.nonNull(arr));
         checkArgument(times >= 0,
                 "The number of times must be greater than or equal to zero");
         checkArgument(maxLength >= 0,
@@ -751,7 +750,7 @@ public class ArrayTools {
      * @param values    填充内容
      */
     public static void fill(char[] a, int fromIndex, int toIndex, @Nullable char[] values) {
-        checkArgumentNotNull(a);
+        checkArgument(Objects.nonNull(a));
         if (values == null || values.length == 0) {
             return;
         }
@@ -794,7 +793,7 @@ public class ArrayTools {
      * @param values    填充内容
      */
     public static void fill(byte[] a, int fromIndex, int toIndex, @Nullable byte[] values) {
-        checkArgumentNotNull(a);
+        checkArgument(Objects.nonNull(a));
         if (values == null || values.length == 0) {
             return;
         }
@@ -837,7 +836,7 @@ public class ArrayTools {
      * @param values    填充内容
      */
     public static void fill(short[] a, int fromIndex, int toIndex, @Nullable short[] values) {
-        checkArgumentNotNull(a);
+        checkArgument(Objects.nonNull(a));
         if (values == null || values.length == 0) {
             return;
         }
@@ -880,7 +879,7 @@ public class ArrayTools {
      * @param values    填充内容
      */
     public static void fill(int[] a, int fromIndex, int toIndex, @Nullable int[] values) {
-        checkArgumentNotNull(a);
+        checkArgument(Objects.nonNull(a));
         if (values == null || values.length == 0) {
             return;
         }
@@ -923,7 +922,7 @@ public class ArrayTools {
      * @param values    填充内容
      */
     public static void fill(long[] a, int fromIndex, int toIndex, @Nullable long[] values) {
-        checkArgumentNotNull(a);
+        checkArgument(Objects.nonNull(a));
         if (values == null || values.length == 0) {
             return;
         }
@@ -966,7 +965,7 @@ public class ArrayTools {
      * @param values    填充内容
      */
     public static void fill(float[] a, int fromIndex, int toIndex, @Nullable float[] values) {
-        checkArgumentNotNull(a);
+        checkArgument(Objects.nonNull(a));
         if (values == null || values.length == 0) {
             return;
         }
@@ -1009,7 +1008,7 @@ public class ArrayTools {
      * @param values    填充内容
      */
     public static void fill(double[] a, int fromIndex, int toIndex, @Nullable double[] values) {
-        checkArgumentNotNull(a);
+        checkArgument(Objects.nonNull(a));
         if (values == null || values.length == 0) {
             return;
         }
@@ -1064,7 +1063,7 @@ public class ArrayTools {
      * @param values    填充内容
      */
     private static <T> void fillInternal(T[] a, int fromIndex, int toIndex, @Nullable T[] values) {
-        checkArgumentNotNull(a);
+        checkArgument(Objects.nonNull(a));
         if (values == null || values.length == 0) {
             return;
         }

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

@@ -39,7 +39,7 @@ import xyz.zhouxy.plusone.commons.exception.system.DataOperationResultException;
  *     "must be a well-formed email address");
  * </pre>
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 public class AssertTools {
 
@@ -54,9 +54,7 @@ public class AssertTools {
      * @throws IllegalArgumentException 当条件不满足时抛出
      */
     public static void checkArgument(boolean condition) {
-        if (!condition) {
-            throw new IllegalArgumentException();
-        }
+        checkCondition(condition, IllegalArgumentException::new);
     }
 
     /**
@@ -67,9 +65,7 @@ public class AssertTools {
      * @throws IllegalArgumentException 当条件不满足时抛出
      */
     public static void checkArgument(boolean condition, @Nullable String errorMessage) {
-        if (!condition) {
-            throw new IllegalArgumentException(errorMessage);
-        }
+        checkCondition(condition, () -> new IllegalArgumentException(errorMessage));
     }
 
     /**
@@ -80,9 +76,7 @@ public class AssertTools {
      * @throws IllegalArgumentException 当条件不满足时抛出
      */
     public static void checkArgument(boolean condition, Supplier<String> errorMessageSupplier) {
-        if (!condition) {
-            throw new IllegalArgumentException(errorMessageSupplier.get());
-        }
+        checkCondition(condition, () -> new IllegalArgumentException(errorMessageSupplier.get()));
     }
 
     /**
@@ -95,9 +89,8 @@ public class AssertTools {
      */
     public static void checkArgument(boolean condition,
             String errorMessageTemplate, Object... errorMessageArgs) {
-        if (!condition) {
-            throw new IllegalArgumentException(String.format(errorMessageTemplate, errorMessageArgs));
-        }
+        checkCondition(condition,
+                () -> new IllegalArgumentException(String.format(errorMessageTemplate, errorMessageArgs)));
     }
 
     // ================================
@@ -116,9 +109,7 @@ public class AssertTools {
      * @throws IllegalArgumentException 当 {@code obj} 为 {@code null} 时抛出
      */
     public static <T> T checkArgumentNotNull(@Nullable T obj) {
-        if (obj == null) {
-            throw new IllegalArgumentException();
-        }
+        checkCondition(obj != null, IllegalArgumentException::new);
         return obj;
     }
 
@@ -131,9 +122,7 @@ public class AssertTools {
      * @throws IllegalArgumentException 当 {@code obj} 为 {@code null} 时抛出
      */
     public static <T> T checkArgumentNotNull(@Nullable T obj, String errorMessage) {
-        if (obj == null) {
-            throw new IllegalArgumentException(errorMessage);
-        }
+        checkCondition(obj != null, () -> new IllegalArgumentException(errorMessage));
         return obj;
     }
 
@@ -146,9 +135,7 @@ public class AssertTools {
      * @throws IllegalArgumentException 当 {@code obj} 为 {@code null} 时抛出
      */
     public static <T> T checkArgumentNotNull(@Nullable T obj, Supplier<String> errorMessageSupplier) {
-        if (obj == null) {
-            throw new IllegalArgumentException(errorMessageSupplier.get());
-        }
+        checkCondition(obj != null, () -> new IllegalArgumentException(errorMessageSupplier.get()));
         return obj;
     }
 
@@ -163,9 +150,8 @@ public class AssertTools {
      */
     public static <T> T checkArgumentNotNull(@Nullable T obj,
             String errorMessageTemplate, Object... errorMessageArgs) {
-        if (obj == null) {
-            throw new IllegalArgumentException(String.format(errorMessageTemplate, errorMessageArgs));
-        }
+        checkCondition(obj != null,
+                () -> new IllegalArgumentException(String.format(errorMessageTemplate, errorMessageArgs)));
         return obj;
     }
 
@@ -184,9 +170,7 @@ public class AssertTools {
      * @throws IllegalStateException 当条件不满足时抛出
      */
     public static void checkState(boolean condition) {
-        if (!condition) {
-            throw new IllegalStateException();
-        }
+        checkCondition(condition, IllegalStateException::new);
     }
 
     /**
@@ -197,9 +181,7 @@ public class AssertTools {
      * @throws IllegalStateException 当条件不满足时抛出
      */
     public static void checkState(boolean condition, @Nullable String errorMessage) {
-        if (!condition) {
-            throw new IllegalStateException(errorMessage);
-        }
+        checkCondition(condition, () -> new IllegalStateException(errorMessage));
     }
 
     /**
@@ -210,9 +192,7 @@ public class AssertTools {
      * @throws IllegalStateException 当条件不满足时抛出
      */
     public static void checkState(boolean condition, Supplier<String> errorMessageSupplier) {
-        if (!condition) {
-            throw new IllegalStateException(errorMessageSupplier.get());
-        }
+        checkCondition(condition, () -> new IllegalStateException(errorMessageSupplier.get()));
     }
 
     /**
@@ -225,9 +205,8 @@ public class AssertTools {
      */
     public static void checkState(boolean condition,
             String errorMessageTemplate, Object... errorMessageArgs) {
-        if (!condition) {
-            throw new IllegalStateException(String.format(errorMessageTemplate, errorMessageArgs));
-        }
+        checkCondition(condition,
+                () -> new IllegalStateException(String.format(errorMessageTemplate, errorMessageArgs)));
     }
 
     // ================================
@@ -246,9 +225,7 @@ public class AssertTools {
      * @throws NullPointerException 当 {@code obj} 为 {@code null} 时抛出
      */
     public static <T> void checkNotNull(@Nullable T obj) {
-        if (obj == null) {
-            throw new NullPointerException();
-        }
+        checkCondition(obj != null, NullPointerException::new);
     }
 
     /**
@@ -260,9 +237,7 @@ public class AssertTools {
      * @throws NullPointerException 当 {@code obj} 为 {@code null} 时抛出
      */
     public static <T> void checkNotNull(@Nullable T obj, String errorMessage) {
-        if (obj == null) {
-            throw new NullPointerException(errorMessage);
-        }
+        checkCondition(obj != null, () -> new NullPointerException(errorMessage));
     }
 
     /**
@@ -274,9 +249,7 @@ public class AssertTools {
      * @throws NullPointerException 当 {@code obj} 为 {@code null} 时抛出
      */
     public static <T> void checkNotNull(@Nullable T obj, Supplier<String> errorMessageSupplier) {
-        if (obj == null) {
-            throw new NullPointerException(errorMessageSupplier.get());
-        }
+        checkCondition(obj != null, () -> new NullPointerException(errorMessageSupplier.get()));
     }
 
     /**
@@ -290,9 +263,8 @@ public class AssertTools {
      */
     public static <T> void checkNotNull(@Nullable T obj,
             String errorMessageTemplate, Object... errorMessageArgs) {
-        if (obj == null) {
-            throw new NullPointerException(String.format(errorMessageTemplate, errorMessageArgs));
-        }
+        checkCondition(obj != null,
+                () -> new NullPointerException(String.format(errorMessageTemplate, errorMessageArgs)));
     }
 
     // ================================
@@ -313,9 +285,7 @@ public class AssertTools {
      */
     public static <T> T checkExists(@Nullable T obj)
             throws DataNotExistsException {
-        if (obj == null) {
-            throw new DataNotExistsException();
-        }
+        checkCondition(obj != null, DataNotExistsException::new);
         return obj;
     }
 
@@ -330,9 +300,7 @@ public class AssertTools {
      */
     public static <T> T checkExists(@Nullable T obj, String errorMessage)
             throws DataNotExistsException {
-        if (obj == null) {
-            throw new DataNotExistsException(errorMessage);
-        }
+        checkCondition(obj != null, () -> new DataNotExistsException(errorMessage));
         return obj;
     }
 
@@ -347,9 +315,7 @@ public class AssertTools {
      */
     public static <T> T checkExists(@Nullable T obj, Supplier<String> errorMessageSupplier)
             throws DataNotExistsException {
-        if (obj == null) {
-            throw new DataNotExistsException(errorMessageSupplier.get());
-        }
+        checkCondition(obj != null, () -> new DataNotExistsException(errorMessageSupplier.get()));
         return obj;
     }
 
@@ -366,9 +332,8 @@ public class AssertTools {
     public static <T> T checkExists(@Nullable T obj,
             String errorMessageTemplate, Object... errorMessageArgs)
             throws DataNotExistsException {
-        if (obj == null) {
-            throw new DataNotExistsException(String.format(errorMessageTemplate, errorMessageArgs));
-        }
+        checkCondition(obj != null,
+                () -> new DataNotExistsException(String.format(errorMessageTemplate, errorMessageArgs)));
         return obj;
     }
 
@@ -382,9 +347,7 @@ public class AssertTools {
      */
     public static <T> T checkExists(Optional<T> optional)
             throws DataNotExistsException {
-        if (!optional.isPresent()) {
-            throw new DataNotExistsException();
-        }
+        checkCondition(optional.isPresent(), DataNotExistsException::new);
         return optional.get();
     }
 
@@ -399,9 +362,7 @@ public class AssertTools {
      */
     public static <T> T checkExists(Optional<T> optional, String errorMessage)
             throws DataNotExistsException {
-        if (!optional.isPresent()) {
-            throw new DataNotExistsException(errorMessage);
-        }
+        checkCondition(optional.isPresent(), () -> new DataNotExistsException(errorMessage));
         return optional.get();
     }
 
@@ -416,9 +377,7 @@ public class AssertTools {
      */
     public static <T> T checkExists(Optional<T> optional, Supplier<String> errorMessageSupplier)
             throws DataNotExistsException {
-        if (!optional.isPresent()) {
-            throw new DataNotExistsException(errorMessageSupplier.get());
-        }
+        checkCondition(optional.isPresent(), () -> new DataNotExistsException(errorMessageSupplier.get()));
         return optional.get();
     }
 
@@ -435,9 +394,8 @@ public class AssertTools {
     public static <T> T checkExists(Optional<T> optional,
             String errorMessageTemplate, Object... errorMessageArgs)
             throws DataNotExistsException {
-        if (!optional.isPresent()) {
-            throw new DataNotExistsException(String.format(errorMessageTemplate, errorMessageArgs));
-        }
+        checkCondition(optional.isPresent(),
+                () -> new DataNotExistsException(String.format(errorMessageTemplate, errorMessageArgs)));
         return optional.get();
     }
 

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

@@ -31,7 +31,7 @@ import xyz.zhouxy.plusone.commons.annotation.StaticFactoryMethod;
  * <p>
  * BigDecimal 工具类
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  */
 public class BigDecimals {

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

@@ -27,11 +27,11 @@ import java.time.Year;
 import java.time.YearMonth;
 import java.time.ZoneId;
 import java.time.ZonedDateTime;
+import java.time.chrono.IsoChronology;
 import java.util.Calendar;
 import java.util.Date;
 import java.util.TimeZone;
 
-import com.google.common.collect.BoundType;
 import com.google.common.collect.Range;
 
 import xyz.zhouxy.plusone.commons.time.Quarter;
@@ -40,7 +40,7 @@ import xyz.zhouxy.plusone.commons.time.YearQuarter;
 /**
  * 日期时间工具类
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 public class DateTimeTools {
 
@@ -649,7 +649,7 @@ public class DateTimeTools {
     // ================================
 
     // ================================
-    // #region - range
+    // #region - others
     // ================================
 
     /**
@@ -673,52 +673,6 @@ public class DateTimeTools {
         return Range.closedOpen(date.atStartOfDay(zone), startOfNextDate(date, zone));
     }
 
-    /**
-     * 将指定日期范围转为日期时间范围
-     *
-     * @param dateRange 日期范围
-     * @return 对应的日期时间范围
-     */
-    public static Range<LocalDateTime> toDateTimeRange(Range<LocalDate> dateRange) {
-        BoundType lowerBoundType = dateRange.lowerBoundType();
-        LocalDateTime lowerEndpoint = lowerBoundType == BoundType.CLOSED
-                ? dateRange.lowerEndpoint().atStartOfDay()
-                : dateRange.lowerEndpoint().plusDays(1).atStartOfDay();
-        BoundType upperBoundType = dateRange.upperBoundType();
-        LocalDateTime upperEndpoint = upperBoundType == BoundType.CLOSED
-                ? dateRange.upperEndpoint().plusDays(1).atStartOfDay()
-                : dateRange.upperEndpoint().atStartOfDay();
-
-        return Range.closedOpen(lowerEndpoint, upperEndpoint);
-    }
-
-    /**
-     * 将指定日期范围转为日期时间范围
-     *
-     * @param dateRange 日期范围
-     * @return 对应的日期时间范围
-     */
-    public static Range<ZonedDateTime> toDateTimeRange(Range<LocalDate> dateRange, ZoneId zone) {
-        BoundType lowerBoundType = dateRange.lowerBoundType();
-        ZonedDateTime lowerEndpoint = lowerBoundType == BoundType.CLOSED
-                ? dateRange.lowerEndpoint().atStartOfDay(zone)
-                : dateRange.lowerEndpoint().plusDays(1).atStartOfDay(zone);
-        BoundType upperBoundType = dateRange.upperBoundType();
-        ZonedDateTime upperEndpoint = upperBoundType == BoundType.CLOSED
-                ? dateRange.upperEndpoint().plusDays(1).atStartOfDay(zone)
-                : dateRange.upperEndpoint().atStartOfDay(zone);
-
-        return Range.closedOpen(lowerEndpoint, upperEndpoint);
-    }
-
-    // ================================
-    // #endregion - range
-    // ================================
-
-    // ================================
-    // #region - others
-    // ================================
-
     /**
      * 判断指定年份是否为闰年
      *
@@ -726,7 +680,7 @@ public class DateTimeTools {
      * @return 指定年份是否为闰年
      */
     public static boolean isLeapYear(int year) {
-        return Year.isLeap(year);
+        return IsoChronology.INSTANCE.isLeapYear(year);
     }
 
     // ================================

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/EnumTools.java

@@ -26,7 +26,7 @@ import javax.annotation.Nullable;
 /**
  * 枚举工具类
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 public final class EnumTools {
 
@@ -154,7 +154,7 @@ public final class EnumTools {
      */
     @Nullable
     public static <E extends Enum<?>> Integer checkOrdinalNullable(Class<E> enumType, @Nullable Integer ordinal) {
-        return checkOrdinalOrDefault(enumType, ordinal, null);
+        return checkOrdinalOrDefault(enumType, ordinal, (Integer) null);
     }
 
     /**

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

@@ -33,10 +33,9 @@ import xyz.zhouxy.plusone.commons.annotation.StaticFactoryMethod;
 /**
  * 枚举类
  *
- * <p>
  * 参考 <a href="https://lostechies.com/jimmybogard/2008/08/12/enumeration-classes/">Enumeration classes</a>
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @deprecated 设计 Enumeration 的灵感来自于 .net 社区，因为 C&num; 的枚举不带行为。
  * 但 Java 的枚举可以带行为，故大多数情况下不需要这种设计。
  */

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

@@ -30,7 +30,7 @@ import java.util.concurrent.ConcurrentHashMap;
  *
  * @see UUID
  * @see IdWorker
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 public class IdGenerator {
 

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/IdWorker.java

@@ -27,11 +27,7 @@ import javax.annotation.Nullable;
 import xyz.zhouxy.plusone.commons.exception.system.NoAvailableMacFoundException;
 
 /**
- * 修改版雪花 ID 生成器
- *
- * <p>
- * 来自 Seata (https://seata.apache.org) 的 {@code org.apache.seata.common.util.IdWorker}
- *
+ * Seata 提供的修改版雪花ID。
  * <p>
  * 大体思路为：
  * <ol>
@@ -47,6 +43,7 @@ import xyz.zhouxy.plusone.commons.exception.system.NoAvailableMacFoundException;
  * <li><a href="https://juejin.cn/post/7264387737276203065">在开源项目中看到一个改良版的雪花算法，现在它是你的了。</a></li>
  * <li><a href="https://juejin.cn/post/7265516484029743138">关于若干读者，阅读“改良版雪花算法”后提出的几个共性问题的回复。</a></li>
  * </ul>
+ *
  */
 public class IdWorker {
 

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/JodaTimeTools.java

@@ -19,7 +19,7 @@ package xyz.zhouxy.plusone.commons.util;
 /**
  * Joda-Time 工具类
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 public class JodaTimeTools {
 
@@ -54,9 +54,7 @@ public class JodaTimeTools {
      * @param zone          时区
      * @return {@link org.joda.time.Instant} 对象
      */
-    public static org.joda.time.Instant toJodaInstant(
-            java.time.LocalDateTime localDateTime,
-            java.time.ZoneId zone) {
+    public static org.joda.time.Instant toJodaInstant(java.time.LocalDateTime localDateTime, java.time.ZoneId zone) {
         return toJodaInstant(java.time.ZonedDateTime.of(localDateTime, zone));
     }
 
@@ -94,9 +92,9 @@ public class JodaTimeTools {
      * {@link org.joda.time.DateTimeZone} 对象
      * 转换为 Java 中的 {@link java.time.Instant} 对象
      *
-     * @param localDateTime {@link org.joda.time.LocalDateTime} 对象
-     * @param zone {@link org.joda.time.DateTimeZone} 对象
-     * @return Java 表示时间戳的 {@link java.time.Instant} 对象
+     * @param localDateTime
+     * @param zone
+     * @return
      */
     public static java.time.Instant toJavaInstant(
             org.joda.time.LocalDateTime localDateTime,
@@ -137,9 +135,8 @@ public class JodaTimeTools {
     public static org.joda.time.DateTime toJodaDateTime(
             java.time.LocalDateTime localDateTime,
             java.time.ZoneId zone) {
-        org.joda.time.LocalDateTime jodaLocalDateTime = toJodaLocalDateTime(localDateTime);
-        org.joda.time.DateTimeZone jodaZone = toJodaZone(zone);
-        return jodaLocalDateTime.toDateTime(jodaZone);
+        org.joda.time.DateTimeZone dateTimeZone = toJodaZone(zone);
+        return toJodaInstant(java.time.ZonedDateTime.of(localDateTime, zone).toInstant()).toDateTime(dateTimeZone);
     }
 
     /**
@@ -221,15 +218,9 @@ public class JodaTimeTools {
      * @return joda-time LocalDateTime
      */
     public static org.joda.time.LocalDateTime toJodaLocalDateTime(java.time.LocalDateTime localDateTime) {
-        return new org.joda.time.LocalDateTime(
-                localDateTime.getYear(),
-                localDateTime.getMonthValue(),
-                localDateTime.getDayOfMonth(),
-                localDateTime.getHour(),
-                localDateTime.getMinute(),
-                localDateTime.getSecond(),
-                localDateTime.getNano() / 1_000_000 // 毫秒转纳秒
-        );
+        java.time.ZoneId javaZone = java.time.ZoneId.systemDefault();
+        org.joda.time.DateTimeZone jodaZone = toJodaZone(javaZone);
+        return toJodaInstant(localDateTime, javaZone).toDateTime(jodaZone).toLocalDateTime();
     }
 
     // ================================
@@ -247,15 +238,9 @@ public class JodaTimeTools {
      * @return Java 8 LocalDateTime
      */
     public static java.time.LocalDateTime toJavaLocalDateTime(org.joda.time.LocalDateTime localDateTime) {
-        return java.time.LocalDateTime.of(
-                localDateTime.getYear(),
-                localDateTime.getMonthOfYear(),
-                localDateTime.getDayOfMonth(),
-                localDateTime.getHourOfDay(),
-                localDateTime.getMinuteOfHour(),
-                localDateTime.getSecondOfMinute(),
-                localDateTime.getMillisOfSecond() * 1_000_000 // 毫秒转纳秒
-        );
+        org.joda.time.DateTimeZone jodaZone = org.joda.time.DateTimeZone.getDefault();
+        java.time.ZoneId javaZone = toJavaZone(jodaZone);
+        return toJavaInstant(localDateTime, jodaZone).atZone(javaZone).toLocalDateTime();
     }
 
     // ================================

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

@@ -25,13 +25,11 @@ import javax.annotation.Nullable;
 /**
  * 数字工具类
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 public class Numbers {
 
-    // ================================
     // #region - sum
-    // ================================
 
     /**
      * 求和
@@ -133,13 +131,9 @@ public class Numbers {
         return BigDecimals.sum(numbers);
     }
 
-    // ================================
     // #endregion
-    // ================================
 
-    // ================================
     // #region - nullToZero
-    // ================================
 
     /**
      * 将 {@code null} 转换为 {@code 0}
@@ -223,122 +217,7 @@ public class Numbers {
         return BigDecimals.nullToZero(val);
     }
 
-    // ================================
-    // #endregion - nullToZero
-    // ================================
-
-    // ================================
-    // #region - parse
-    // ================================
-
-    /**
-     * 将字符串转为对应 {@link Short}，转换失败时返回 {@code defaultValue}（允许为 {@code null}）。
-     *
-     * @param str 要转换的字符串
-     * @param defaultValue 默认值
-     * @return 转换结果
-     */
-    @Nullable
-    public static Short parseShort(@Nullable String str, @Nullable Short defaultValue) {
-        if (StringTools.isBlank(str)) {
-            return defaultValue;
-        }
-        try {
-            return Short.parseShort(str);
-        }
-        catch (NumberFormatException ignore) {
-            // ignore
-        }
-        return defaultValue;
-    }
-
-    /**
-     * 将字符串转为 {@link Integer}，转换失败时返回 {@code defaultValue}（允许为 {@code null}）。
-     *
-     * @param str 要转换的字符串
-     * @param defaultValue 默认值
-     * @return 转换结果
-     */
-    @Nullable
-    public static Integer parseInteger(@Nullable String str, @Nullable Integer defaultValue) {
-        if (StringTools.isBlank(str)) {
-            return defaultValue;
-        }
-        try {
-            return Integer.parseInt(str);
-        }
-        catch (NumberFormatException ignore) {
-            // ignore
-        }
-        return defaultValue;
-    }
-
-    /**
-     * 将字符串转为 {@link Long}，转换失败时返回 {@code defaultValue}（允许为 {@code null}）。
-     *
-     * @param str 要转换的字符串
-     * @param defaultValue 默认值
-     * @return 转换结果
-     */
-    @Nullable
-    public static Long parseLong(@Nullable String str, @Nullable Long defaultValue) {
-        if (StringTools.isBlank(str)) {
-            return defaultValue;
-        }
-        try {
-            return Long.parseLong(str);
-        }
-        catch (NumberFormatException ignore) {
-            // ignore
-        }
-        return defaultValue;
-    }
-
-    /**
-     * 将字符串转为 {@link Float}，转换失败时返回 {@code defaultValue}（允许为 {@code null}）。
-     *
-     * @param str 要转换的字符串
-     * @param defaultValue 默认值
-     * @return 转换结果
-     */
-    @Nullable
-    public static Float parseFloat(@Nullable String str, @Nullable Float defaultValue) {
-        if (StringTools.isBlank(str)) {
-            return defaultValue;
-        }
-        try {
-            return Float.parseFloat(str);
-        }
-        catch (NumberFormatException ignore) {
-            // ignore
-        }
-        return defaultValue;
-    }
-
-    /**
-     * 将字符串转为 {@link Double}，转换失败时返回 {@code defaultValue}（允许为 {@code null}）。
-     *
-     * @param str 要转换的字符串
-     * @param defaultValue 默认值
-     * @return 转换结果
-     */
-    @Nullable
-    public static Double parseDouble(@Nullable String str, @Nullable Double defaultValue) {
-        if (StringTools.isBlank(str)) {
-            return defaultValue;
-        }
-        try {
-            return Double.parseDouble(str);
-        }
-        catch (NumberFormatException ignore) {
-            // ignore
-        }
-        return defaultValue;
-    }
-
-    // ================================
-    // #endregion - parse
-    // ================================
+    // #endregion
 
     private Numbers() {
         throw new IllegalStateException("Utility class");

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

@@ -31,7 +31,7 @@ import com.google.common.annotations.Beta;
  * <p>
  * 提供一些 Optional 相关的方法
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  * @see Optional
  * @see OptionalInt

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/RandomTools.java

@@ -17,27 +17,26 @@
 package xyz.zhouxy.plusone.commons.util;
 
 import static xyz.zhouxy.plusone.commons.util.AssertTools.checkArgument;
-import static xyz.zhouxy.plusone.commons.util.AssertTools.checkArgumentNotNull;
 
 import java.security.NoSuchAlgorithmException;
 import java.security.SecureRandom;
+import java.util.Objects;
 import java.util.Random;
 import java.util.concurrent.ThreadLocalRandom;
 
-import com.google.common.collect.BoundType;
-import com.google.common.collect.Range;
-
 /**
  * 随机工具类
+ * <p>
+ * 建议调用方自行维护 Random 对象
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 public final class RandomTools {
 
     private static final SecureRandom DEFAULT_SECURE_RANDOM;
 
     static {
-        SecureRandom secureRandom;
+        SecureRandom secureRandom = null;
         try {
             secureRandom = SecureRandom.getInstanceStrong(); // 获取高强度安全随机数生成器
         }
@@ -47,41 +46,18 @@ public final class RandomTools {
         DEFAULT_SECURE_RANDOM = secureRandom;
     }
 
-    /**
-     * 大写字母
-     */
     public static final String CAPITAL_LETTERS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
-    /**
-     * 小写字母
-     */
     public static final String LOWERCASE_LETTERS = "abcdefghijklmnopqrstuvwxyz";
-    /**
-     * 数字
-     */
     public static final String NUMBERS = "0123456789";
 
-    /**
-     * 默认的 {@code SecureRandom}
-     *
-     * @return 默认的 {@code SecureRandom}
-     */
     public static SecureRandom defaultSecureRandom() {
         return DEFAULT_SECURE_RANDOM;
     }
 
-    /**
-     * 当前线程的 {@code ThreadLocalRandom}
-     *
-     * @return 当前线程的 {@code ThreadLocalRandom}
-     */
     public static ThreadLocalRandom currentThreadLocalRandom() {
         return ThreadLocalRandom.current();
     }
 
-    // ================================
-    // #region - randomStr
-    // ================================
-
     /**
      * 使用传入的随机数生成器，生成指定长度的字符串
      *
@@ -93,34 +69,20 @@ public final class RandomTools {
      * @return 随机字符串
      */
     public static String randomStr(Random random, char[] sourceCharacters, int length) {
-        checkArgumentNotNull(random, "Random cannot be null.");
-        checkArgumentNotNull(sourceCharacters, "Source characters cannot be null.");
+        checkArgument(Objects.nonNull(random), "Random cannot be null.");
+        checkArgument(Objects.nonNull(sourceCharacters), "Source characters cannot be null.");
         checkArgument(length >= 0, "The length should be greater than or equal to zero.");
         return randomStrInternal(random, sourceCharacters, length);
     }
 
-    /**
-     * 使用当前线程的 {@code ThreadLocalRandom}，生成指定长度的字符串
-     *
-     * @param sourceCharacters 字符池。字符串的字符将在数组中选，不为空
-     * @param length           字符串长度
-     * @return 随机字符串
-     */
     public static String randomStr(char[] sourceCharacters, int length) {
-        checkArgumentNotNull(sourceCharacters, "Source characters cannot be null.");
+        checkArgument(Objects.nonNull(sourceCharacters), "Source characters cannot be null.");
         checkArgument(length >= 0, "The length should be greater than or equal to zero.");
         return randomStrInternal(ThreadLocalRandom.current(), sourceCharacters, length);
     }
 
-    /**
-     * 使用默认的 {@code SecureRandom}，生成指定长度的字符串
-     *
-     * @param sourceCharacters 字符池。字符串的字符将在数组中选，不为空
-     * @param length           字符串长度
-     * @return 随机字符串
-     */
     public static String secureRandomStr(char[] sourceCharacters, int length) {
-        checkArgumentNotNull(sourceCharacters, "Source characters cannot be null.");
+        checkArgument(Objects.nonNull(sourceCharacters), "Source characters cannot be null.");
         checkArgument(length >= 0, "The length should be greater than or equal to zero.");
         return randomStrInternal(DEFAULT_SECURE_RANDOM, sourceCharacters, length);
     }
@@ -136,137 +98,24 @@ public final class RandomTools {
      * @return 随机字符串
      */
     public static String randomStr(Random random, String sourceCharacters, int length) {
-        checkArgumentNotNull(random, "Random cannot be null.");
-        checkArgumentNotNull(sourceCharacters, "Source characters cannot be null.");
+        checkArgument(Objects.nonNull(random), "Random cannot be null.");
+        checkArgument(Objects.nonNull(sourceCharacters), "Source characters cannot be null.");
         checkArgument(length >= 0, "The length should be greater than or equal to zero.");
         return randomStrInternal(random, sourceCharacters, length);
     }
 
-    /**
-     * 使用当前线程的 {@code ThreadLocalRandom}，生成指定长度的字符串
-     *
-     * @param sourceCharacters 字符池。字符串的字符将在数组中选，不为空
-     * @param length           字符串长度
-     * @return 随机字符串
-     */
     public static String randomStr(String sourceCharacters, int length) {
-        checkArgumentNotNull(sourceCharacters, "Source characters cannot be null.");
+        checkArgument(Objects.nonNull(sourceCharacters), "Source characters cannot be null.");
         checkArgument(length >= 0, "The length should be greater than or equal to zero.");
         return randomStrInternal(ThreadLocalRandom.current(), sourceCharacters, length);
     }
 
-    /**
-     * 使用默认的 {@code SecureRandom}，生成指定长度的字符串
-     *
-     * @param sourceCharacters 字符池。字符串的字符将在数组中选，不为空
-     * @param length           字符串长度
-     * @return 随机字符串
-     */
     public static String secureRandomStr(String sourceCharacters, int length) {
-        checkArgumentNotNull(sourceCharacters, "Source characters cannot be null.");
+        checkArgument(Objects.nonNull(sourceCharacters), "Source characters cannot be null.");
         checkArgument(length >= 0, "The length should be greater than or equal to zero.");
         return randomStrInternal(DEFAULT_SECURE_RANDOM, sourceCharacters, length);
     }
 
-    // ================================
-    // #endregion - randomStr
-    // ================================
-
-    // ================================
-    // #region - randomInt
-    // ================================
-
-    /**
-     * 使用传入的随机数生成器，生成随机整数
-     *
-     * @param startInclusive 最小值（包含）
-     * @param endExclusive 最大值（不包含）
-     * @return 在区间 {@code [min, max)} 内的随机整数
-     *
-     * @since 1.1.0
-     */
-    public static int randomInt(Random random, int startInclusive, int endExclusive) {
-        checkArgumentNotNull(random, "Random cannot be null.");
-        checkArgument(startInclusive < endExclusive, "Start value must be less than end value.");
-        return randomIntInternal(random, startInclusive, endExclusive);
-    }
-
-    /**
-     * 使用当前线程的 {@code ThreadLocalRandom}，生成随机整数
-     *
-     * @param startInclusive 最小值（包含）
-     * @param endExclusive 最大值（不包含）
-     * @return 在区间 {@code [min, max)} 内的随机整数
-     *
-     * @since 1.1.0
-     */
-    public static int randomInt(int startInclusive, int endExclusive) {
-        checkArgument(startInclusive < endExclusive, "Start value must be less than end value.");
-        return randomIntInternal(ThreadLocalRandom.current(), startInclusive, endExclusive);
-    }
-
-    /**
-     * 使用默认的 {@code SecureRandom}，生成随机整数
-     *
-     * @param startInclusive 最小值（包含）
-     * @param endExclusive 最大值（不包含）
-     * @return 在区间 {@code [min, max)} 内的随机整数
-     *
-     * @since 1.1.0
-     */
-    public static int secureRandomInt(int startInclusive, int endExclusive) {
-        checkArgument(startInclusive < endExclusive, "Start value must be less than end value.");
-        return randomIntInternal(DEFAULT_SECURE_RANDOM, startInclusive, endExclusive);
-    }
-
-    /**
-     * 使用传入的随机数生成器，生成随机整数
-     *
-     * @param range 整数区间
-     * @return 在指定区间内的随机整数
-     *
-     * @since 1.1.0
-     */
-    public static int randomInt(Random random, Range<Integer> range) {
-        checkArgumentNotNull(random, "Random cannot be null.");
-        checkArgumentNotNull(range, "Range cannot be null.");
-        return randomIntInternal(random, range);
-    }
-
-    /**
-     * 使用当前线程的 {@code ThreadLocalRandom}，生成随机整数
-     *
-     * @param range 整数区间
-     * @return 在指定区间内的随机整数
-     *
-     * @since 1.1.0
-     */
-    public static int randomInt(Range<Integer> range) {
-        checkArgumentNotNull(range, "Range cannot be null.");
-        return randomIntInternal(ThreadLocalRandom.current(), range);
-    }
-
-    /**
-     * 使用默认的 {@code SecureRandom}，生成随机整数
-     *
-     * @param range 整数区间
-     * @return 在指定区间内的随机整数
-     *
-     * @since 1.1.0
-     */
-    public static int secureRandomInt(Range<Integer> range) {
-        checkArgumentNotNull(range, "Range cannot be null.");
-        return randomIntInternal(DEFAULT_SECURE_RANDOM, range);
-    }
-
-    // ================================
-    // #endregion - randomInt
-    // ================================
-
-    // ================================
-    // #region - private methods
-    // ================================
-
     /**
      * 使用传入的随机数生成器，生成指定长度的字符串
      *
@@ -309,35 +158,6 @@ public final class RandomTools {
         return String.valueOf(result);
     }
 
-    /**
-     * 使用传入的随机数生成器，生成随机整数
-     *
-     * @param startInclusive 最小值（包含）
-     * @param endExclusive 最大值（不包含）
-     * @return 在区间 {@code [min, max)} 内的随机整数
-     */
-    private static int randomIntInternal(Random random, int startInclusive, int endExclusive) {
-        return random.nextInt(endExclusive - startInclusive) + startInclusive;
-    }
-
-    /**
-     * 使用传入的随机数生成器，生成随机整数
-     *
-     * @param range 整数区间
-     * @return 在指定区间内的随机整数
-     */
-    private static int randomIntInternal(Random random, Range<Integer> range) {
-        Integer lowerEndpoint = range.lowerEndpoint();
-        Integer upperEndpoint = range.upperEndpoint();
-        int min = range.lowerBoundType() == BoundType.CLOSED ? lowerEndpoint : lowerEndpoint + 1;
-        int max = range.upperBoundType() == BoundType.OPEN ? upperEndpoint : upperEndpoint + 1;
-        return random.nextInt(max - min) + min;
-    }
-
-    // ================================
-    // #endregion - private methods
-    // ================================
-
     private RandomTools() {
         throw new IllegalStateException("Utility class");
     }

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

@@ -35,7 +35,7 @@ import com.google.common.cache.LoadingCache;
 /**
  * 封装一些常用的正则操作，并可以缓存 {@link Pattern} 实例以复用。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 public final class RegexTools {
 
@@ -363,7 +363,7 @@ public final class RegexTools {
             this.flags = flags;
         }
 
-        private Pattern compilePattern() {
+        private final Pattern compilePattern() {
             return Pattern.compile(regex, flags);
         }
 

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

@@ -17,16 +17,16 @@
 package xyz.zhouxy.plusone.commons.util;
 
 import static xyz.zhouxy.plusone.commons.util.AssertTools.checkArgument;
-import static xyz.zhouxy.plusone.commons.util.AssertTools.checkArgumentNotNull;
 
 import java.net.MalformedURLException;
 import java.net.URL;
+import java.util.Objects;
 
 import javax.annotation.Nullable;
 
 import com.google.common.annotations.Beta;
 
-import xyz.zhouxy.plusone.commons.constant.PatternConsts;
+import xyz.zhouxy.plusone.commons.regex.PatternConsts;
 
 /**
  * StringTools
@@ -34,7 +34,7 @@ import xyz.zhouxy.plusone.commons.constant.PatternConsts;
  * <p>
  * 字符串工具类。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  */
 public class StringTools {
@@ -112,7 +112,7 @@ public class StringTools {
      * @return 结果
      */
     public static String repeat(final String str, int times, int maxLength) {
-        checkArgumentNotNull(str);
+        checkArgument(Objects.nonNull(str));
         return String.valueOf(ArrayTools.repeat(str.toCharArray(), times, maxLength));
     }
 
@@ -177,9 +177,6 @@ public class StringTools {
      */
     @Beta
     public static boolean isURL(@Nullable final String cs) {
-        if (cs == null) {
-            return false;
-        }
         try {
             new URL(cs);
         } catch (MalformedURLException e) {

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

@@ -32,7 +32,7 @@ import javax.annotation.Nullable;
 /**
  * TreeBuilder
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @since 1.0.0
  */
 public class TreeBuilder<T, TSubTree extends T, TIdentity> {

plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/ZipTools.java

@@ -1,108 +0,0 @@
-/*
- * Copyright 2025 the original author or authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      https://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-package xyz.zhouxy.plusone.commons.util;
-
-import static xyz.zhouxy.plusone.commons.util.AssertTools.checkArgument;
-
-import java.io.ByteArrayOutputStream;
-import java.io.IOException;
-import java.util.zip.Deflater;
-import java.util.zip.DeflaterOutputStream;
-import java.util.zip.Inflater;
-import java.util.zip.InflaterOutputStream;
-
-import javax.annotation.CheckForNull;
-import javax.annotation.Nullable;
-
-/**
- * zip 工具类
- *
- * <p>
- * 提供最基础的数据压缩/解压方法
- *
- * @author ZhouXY108 <luquanlion@outlook.com>
- *
- * @see Deflater
- * @see Inflater
- */
-public class ZipTools {
-
-    /**
-     * 使用默认压缩级别压缩数据
-     *
-     * @param input 输入
-     * @param level 压缩级别
-     * @return 压缩后的数据
-     *
-     * @throws IOException 发生 I/O 错误时抛出
-     */
-    public static byte[] zip(@Nullable byte[] input) throws IOException {
-        return zipInternal(input, Deflater.DEFAULT_COMPRESSION);
-    }
-
-    /**
-     * 使用指定压缩级别压缩数据
-     *
-     * @param input 输入
-     * @param level 压缩级别
-     * @return 压缩后的数据
-     *
-     * @throws IOException 发生 I/O 错误时抛出
-     */
-    public static byte[] zip(@Nullable byte[] input, int level) throws IOException {
-        checkArgument((level >= 0 && level <= 9) || level == Deflater.DEFAULT_COMPRESSION,
-                "invalid compression level");
-        return zipInternal(input, level);
-    }
-
-    @CheckForNull
-    private static byte[] zipInternal(@Nullable byte[] input, int level) throws IOException {
-        if (input == null) {
-            return null;
-        }
-        ByteArrayOutputStream out = new ByteArrayOutputStream();
-        try (DeflaterOutputStream dos = new DeflaterOutputStream(out, new Deflater(level))) {
-            dos.write(input);
-            dos.finish();
-            return out.toByteArray();
-        }
-    }
-
-    /**
-     * 解压数据
-     *
-     * @param input 输入
-     * @return 解压后的数据
-     *
-     * @throws IOException 发生 I/O 错误时抛出
-     */
-    @CheckForNull
-    public static byte[] unzip(@Nullable byte[] input) throws IOException {
-        if (input == null) {
-            return null;
-        }
-        ByteArrayOutputStream out = new ByteArrayOutputStream();
-        try (InflaterOutputStream dos = new InflaterOutputStream(out, new Inflater())) {
-            dos.write(input);
-            dos.finish();
-            return out.toByteArray();
-        }
-    }
-
-    private ZipTools() {
-        throw new IllegalStateException("Utility class");
-    }
-}

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

@@ -19,7 +19,7 @@
  * <p>
  * 包含树构建器（{@link TreeBuilder}）、断言工具（{@link AssertTools}）、ID 生成器（{@link IdGenerator}）及其它实用工具类。
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 @ParametersAreNonnullByDefault
 package xyz.zhouxy.plusone.commons.util;

plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/collection/MapModifierTests.java

@@ -1,316 +0,0 @@
-/*
- * Copyright 2025 the original author or authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      https://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package xyz.zhouxy.plusone.commons.collection;
-
-import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertNull;
-import static org.junit.jupiter.api.Assertions.assertThrows;
-import static org.junit.jupiter.api.Assertions.assertTrue;
-
-import java.util.Collections;
-import java.util.HashMap;
-import java.util.Map;
-import java.util.TreeMap;
-import java.util.UUID;
-import java.util.concurrent.ConcurrentHashMap;
-
-import javax.annotation.Nullable;
-
-import org.junit.jupiter.api.Test;
-
-import com.google.common.collect.ImmutableMap;
-
-import lombok.Getter;
-import lombok.extern.slf4j.Slf4j;
-
-@Slf4j
-public class MapModifierTests {
-
-    private static final String APP_START_ID = UUID.randomUUID().toString();
-    private static final String LOCKED = "LOCKED";
-
-    private static final Map<String, String> commonProperties = ImmutableMap.<String, String>builder()
-            .put("channel", "MOBILE")
-            .put("appStartId", APP_START_ID)
-            .build();
-
-    @Test
-    void demo() {
-        Map<String, String> expected = new HashMap<String, String>() {
-            {
-                put("channel", "MOBILE");
-                put("appStartId", APP_START_ID);
-                put("username", "Ben");
-                put("accountStatus", LOCKED);
-            }
-        };
-
-        // MapModifier
-        MapModifier<String, String> modifier = new MapModifier<String, String>()
-                .putAll(commonProperties)
-                .put("username", "Ben")
-                .put("accountStatus", LOCKED);
-
-        // 从 Supplier 中获取 Map，并修改数据
-        HashMap<String, String> hashMap1 = modifier.getAndModify(HashMap::new);
-        assertEquals(expected, hashMap1);
-
-        // 可以灵活使用不同 Map 类型的不同构造器
-        HashMap<String, String> hashMap2 = modifier.getAndModify(() -> new HashMap<>(8));
-        assertEquals(expected, hashMap2);
-
-        // HashMap<String, String> hashMap3 = modifier.getAndModify(() -> new HashMap<>(anotherMap));
-        TreeMap<String, String> treeMap = modifier.getAndModify(TreeMap::new);
-        assertEquals(expected, treeMap);
-        ConcurrentHashMap<String, String> concurrentHashMap = modifier.getAndModify(ConcurrentHashMap::new);
-        assertEquals(expected, concurrentHashMap);
-
-        assertNull(modifier.getAndModify(() -> (Map<String, String>) null));
-
-        // 修改已有的 Map
-        Map<String, String> srcMap = new HashMap<>();
-        srcMap.put("srcKey1", "srcValue1");
-        srcMap.put("srcKey2", "srcValue2");
-        modifier.modify(srcMap);
-        assertEquals(new HashMap<String, String>() {
-            {
-                putAll(commonProperties);
-                put("username", "Ben");
-                put("accountStatus", LOCKED);
-                put("srcKey1", "srcValue1");
-                put("srcKey2", "srcValue2");
-            }
-        }, srcMap);
-
-        assertDoesNotThrow(() -> modifier.modify((Map<String, String>) null));
-
-        // 创建一个有初始化数据的不可变的 {@code Map}
-        Map<String, String> unmodifiableMap = modifier.getUnmodifiableMap();
-        assertEquals(expected, unmodifiableMap);
-        assertThrows(UnsupportedOperationException.class,
-                () -> unmodifiableMap.put("key", "value"));
-    }
-
-    @Test
-    void createAndInitData() {
-        // 链式调用创建并初始化数据
-        HashMap<String, String> map = new MapModifier<String, String>()
-                .putAll(commonProperties)
-                .put("username", "Ben")
-                .put("accountStatus", LOCKED)
-                .getAndModify(HashMap::new);
-
-        HashMap<String, String> expected = new HashMap<String, String>() {
-            {
-                put("channel", "MOBILE");
-                put("appStartId", APP_START_ID);
-                put("username", "Ben");
-                put("accountStatus", LOCKED);
-            }
-        };
-        assertEquals(expected, map);
-    }
-
-    @Test
-    void put() {
-        Map<String, String> map = new MapModifier<String, String>()
-                .put("key1", "value0")
-                .put("key1", "value1")
-                .getAndModify(HashMap::new);
-
-        assertEquals(new HashMap<String, String>() {
-            {
-                put("key1", "value0");
-                put("key1", "value1");
-            }
-        }, map);
-
-        new MapModifier<String, String>()
-                .put("key1", "newValue1")
-                .put("key2", null)
-                .modify(map);
-
-        assertEquals("newValue1", map.get("key1"));
-        assertTrue(map.containsKey("key2"));
-        assertNull(map.get("key2"));
-    }
-
-    @Test
-    void putIfAbsent() {
-        Map<String, String> map = new MapModifier<String, String>()
-                .putIfAbsent("key1", null)
-                .putIfAbsent("key1", "value1")
-                .putIfAbsent("key1", "value2")
-                .getAndModify(HashMap::new);
-
-        assertEquals(new HashMap<String, String>() {
-            {
-                putIfAbsent("key1", null);
-                putIfAbsent("key1", "value1");
-                putIfAbsent("key1", "value2");
-            }
-        }, map);
-
-        new MapModifier<String, String>()
-                .putIfAbsent("key1", "newValue1")
-                .modify(map);
-
-        assertTrue(map.containsKey("key1"));
-        assertEquals("value1", map.get("key1"));
-    }
-
-    @Test
-    void putAll_map() {
-        Map<String, String> entries = new HashMap<String, String>() {
-            {
-                put("key1", "value1");
-                put("key2", "value2");
-            }
-        };
-        Map<String, String> map = new MapModifier<String, String>()
-                .putAll((Map<String, String>) null)
-                .putAll(Collections.emptyMap())
-                .putAll(entries)
-                .getAndModify(HashMap::new);
-        assertEquals(entries, map);
-        new MapModifier<String, String>()
-                .putAll(new HashMap<String, String>() {
-                    {
-                        put("key2", "newValue2");
-                        put("key3", "value3");
-                    }
-                })
-                .modify(map);
-        assertEquals(new HashMap<String, String>() {
-            {
-                put("key1", "value1");
-                put("key2", "value2");
-                put("key2", "newValue2");
-                put("key3", "value3");
-            }
-        }, map);
-    }
-
-    @Test
-    void putAll_entries() {
-        Map<String, String> entries = new HashMap<String, String>() {
-            {
-                put("key1", "value1");
-                put("key2", "value2");
-            }
-        };
-        Map<String, String> map = new MapModifier<String, String>()
-                .putAll(new SimpleEntry<>("key1", "value1"),
-                        new SimpleEntry<>("key2", "value2"))
-                .getAndModify(HashMap::new);
-        assertEquals(entries, map);
-        new MapModifier<String, String>()
-                .putAll()
-                .putAll(new SimpleEntry<>("key2", "newValue2"),
-                        new SimpleEntry<>("key3", "value3"))
-                .modify(map);
-        assertEquals(new HashMap<String, String>() {
-            {
-                put("key1", "value1");
-                put("key2", "value2");
-                put("key2", "newValue2");
-                put("key3", "value3");
-            }
-        }, map);
-    }
-
-    @Test
-    void computeIfAbsent_keyAndFunction() {
-        Map<String, String> map = new MapModifier<String, String>()
-                .computeIfAbsent("key1", k -> null)
-                .computeIfAbsent("key1", k -> "value1")
-                .computeIfAbsent("key1", k -> "value2")
-                .getAndModify(HashMap::new);
-
-        assertEquals(new HashMap<String, String>() {
-            {
-                computeIfAbsent("key1", k -> null);
-                computeIfAbsent("key1", k -> "value1");
-                computeIfAbsent("key1", k -> "value2");
-            }
-        }, map);
-
-        new MapModifier<String, String>()
-                .computeIfAbsent("key1", k -> "newValue1")
-                .modify(map);
-
-        assertTrue(map.containsKey("key1"));
-        assertEquals("value1", map.get("key1"));
-    }
-
-    @Test
-    void computeIfPresent_keyAndBiFunction() {
-        Map<String, String> map = new HashMap<String, String>() {{
-            put("key1", "value1");
-        }};
-        new MapModifier<String, String>()
-                .computeIfPresent("key1", (k, v) -> k + v)
-                .computeIfPresent("key2", (k, v) -> k + v)
-                .modify(map);
-        assertEquals(new HashMap<String, String>() {{
-            put("key1", "key1value1");
-        }}, map);
-    }
-
-    @Test
-    void remove() {
-        Map<String, String> map = new HashMap<String, String>() {{
-            put("key1", "value1");
-            put("key2", "value2");
-        }};
-        new MapModifier<String, String>()
-                .remove("key2")
-                .modify(map);
-        assertEquals(new HashMap<String, String>() {{
-            put("key1", "value1");
-        }}, map);
-    }
-
-    @Test
-    void clear() {
-        Map<String, String> map = new HashMap<String, String>() {{
-            put("key1", "value1");
-            put("key2", "value2");
-        }};
-        new MapModifier<String, String>()
-                .clear()
-                .modify(map);
-        assertTrue(map.isEmpty());
-    }
-
-    @Getter
-    static class SimpleEntry<K, V> implements Map.Entry<K, V> {
-        private final K key;
-        private final V value;
-
-        public SimpleEntry(K key, V value) {
-            this.key = key;
-            this.value = value;
-        }
-
-        @Override
-        public V setValue(@Nullable V value) {
-            throw new UnsupportedOperationException("Unimplemented method 'setValue'");
-        }
-    }
-}

plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/exception/test/InvalidInputExceptionTests.java

@@ -38,6 +38,7 @@ public class InvalidInputExceptionTests {
             throw InvalidInputException.Type.CONTAINS_ILLEGAL_AND_MALICIOUS_LINKS.create();
         });
         assertSame(InvalidInputException.Type.CONTAINS_ILLEGAL_AND_MALICIOUS_LINKS, e.getType());
+        assertEquals(InvalidInputException.Type.CONTAINS_ILLEGAL_AND_MALICIOUS_LINKS.getCode(), e.getTypeCode());
         assertEquals(InvalidInputException.Type.CONTAINS_ILLEGAL_AND_MALICIOUS_LINKS.getDefaultMessage(), e.getMessage());
         assertNull(e.getCause());
     }
@@ -49,6 +50,7 @@ public class InvalidInputExceptionTests {
             throw InvalidInputException.Type.CONTAINS_ILLEGAL_WORDS.create(message);
         });
         assertSame(InvalidInputException.Type.CONTAINS_ILLEGAL_WORDS, e.getType());
+        assertEquals(InvalidInputException.Type.CONTAINS_ILLEGAL_WORDS.getCode(), e.getTypeCode());
         assertEquals(message, e.getMessage());
         assertNull(e.getCause());
     }
@@ -60,6 +62,7 @@ public class InvalidInputExceptionTests {
             throw InvalidInputException.Type.PICTURE_CONTAINS_ILLEGAL_INFORMATION.create(message);
         });
         assertSame(InvalidInputException.Type.PICTURE_CONTAINS_ILLEGAL_INFORMATION, e.getType());
+        assertEquals(InvalidInputException.Type.PICTURE_CONTAINS_ILLEGAL_INFORMATION.getCode(), e.getTypeCode());
         assertNull(e.getMessage());
         assertNull(e.getCause());
     }
@@ -74,6 +77,7 @@ public class InvalidInputExceptionTests {
             });
 
             assertSame(InvalidInputException.Type.INFRINGE_COPYRIGHT, e.getType());
+            assertEquals(InvalidInputException.Type.INFRINGE_COPYRIGHT.getCode(), e.getTypeCode());
             log.info("{}", e.getMessage());
             assertEquals(nfe.toString(), e.getMessage());
             assertSame(nfe, e.getCause());
@@ -88,6 +92,7 @@ public class InvalidInputExceptionTests {
         });
 
         assertSame(InvalidInputException.Type.DEFAULT, e.getType());
+        assertEquals(InvalidInputException.Type.DEFAULT.getCode(), e.getTypeCode());
         assertNull(e.getMessage());
         assertNull(e.getCause());
     }
@@ -101,6 +106,7 @@ public class InvalidInputExceptionTests {
             throw InvalidInputException.Type.CONTAINS_ILLEGAL_AND_MALICIOUS_LINKS.create(message, nfe);
         });
         assertSame(InvalidInputException.Type.CONTAINS_ILLEGAL_AND_MALICIOUS_LINKS, e.getType());
+        assertEquals(InvalidInputException.Type.CONTAINS_ILLEGAL_AND_MALICIOUS_LINKS.getCode(), e.getTypeCode());
         assertEquals(message, e.getMessage());
         assertSame(nfe, e.getCause());
     }
@@ -114,6 +120,7 @@ public class InvalidInputExceptionTests {
             throw InvalidInputException.Type.CONTAINS_ILLEGAL_WORDS.create(message, nfe);
         });
         assertSame(InvalidInputException.Type.CONTAINS_ILLEGAL_WORDS, e.getType());
+        assertEquals(InvalidInputException.Type.CONTAINS_ILLEGAL_WORDS.getCode(), e.getTypeCode());
         assertNull(e.getMessage());
         assertSame(nfe, e.getCause());
     }
@@ -127,6 +134,7 @@ public class InvalidInputExceptionTests {
             throw InvalidInputException.Type.CONTAINS_ILLEGAL_WORDS.create(message, npe);
         });
         assertSame(InvalidInputException.Type.CONTAINS_ILLEGAL_WORDS, e.getType());
+        assertEquals(InvalidInputException.Type.CONTAINS_ILLEGAL_WORDS.getCode(), e.getTypeCode());
         assertEquals(message, e.getMessage());
         assertNull(e.getCause());
     }
@@ -140,6 +148,7 @@ public class InvalidInputExceptionTests {
             throw InvalidInputException.Type.CONTAINS_ILLEGAL_WORDS.create(message, nfe);
         });
         assertSame(InvalidInputException.Type.CONTAINS_ILLEGAL_WORDS, e.getType());
+        assertEquals(InvalidInputException.Type.CONTAINS_ILLEGAL_WORDS.getCode(), e.getTypeCode());
         assertNull(e.getMessage());
         assertNull(e.getCause());
     }
@@ -158,6 +167,7 @@ public class InvalidInputExceptionTests {
             throw new InvalidInputException();
         });
         assertSame(InvalidInputException.Type.DEFAULT, e.getType());
+        assertEquals(InvalidInputException.Type.DEFAULT.getCode(), e.getTypeCode());
         assertEquals(InvalidInputException.Type.DEFAULT.getDefaultMessage(), e.getMessage());
         assertNull(e.getCause());
     }
@@ -169,6 +179,7 @@ public class InvalidInputExceptionTests {
             throw new InvalidInputException(message);
         });
         assertSame(InvalidInputException.Type.DEFAULT, e.getType());
+        assertEquals(InvalidInputException.Type.DEFAULT.getCode(), e.getTypeCode());
         assertEquals(message, e.getMessage());
         assertNull(e.getCause());
     }
@@ -180,6 +191,7 @@ public class InvalidInputExceptionTests {
             throw new InvalidInputException(message);
         });
         assertSame(InvalidInputException.Type.DEFAULT, e.getType());
+        assertEquals(InvalidInputException.Type.DEFAULT.getCode(), e.getTypeCode());
         assertNull(e.getMessage());
         assertNull(e.getCause());
     }
@@ -194,6 +206,7 @@ public class InvalidInputExceptionTests {
             });
 
             assertSame(InvalidInputException.Type.DEFAULT, e.getType());
+            assertEquals(InvalidInputException.Type.DEFAULT.getCode(), e.getTypeCode());
             log.info("{}", e.getMessage());
             assertEquals(nfe.toString(), e.getMessage());
             assertSame(nfe, e.getCause());
@@ -208,6 +221,7 @@ public class InvalidInputExceptionTests {
         });
 
         assertSame(InvalidInputException.Type.DEFAULT, e.getType());
+        assertEquals(InvalidInputException.Type.DEFAULT.getCode(), e.getTypeCode());
         assertNull(e.getMessage());
         assertNull(e.getCause());
     }
@@ -221,6 +235,7 @@ public class InvalidInputExceptionTests {
             throw new InvalidInputException(message, nfe);
         });
         assertSame(InvalidInputException.Type.DEFAULT, e.getType());
+        assertEquals(InvalidInputException.Type.DEFAULT.getCode(), e.getTypeCode());
         assertEquals(message, e.getMessage());
         assertSame(nfe, e.getCause());
     }
@@ -234,6 +249,7 @@ public class InvalidInputExceptionTests {
             throw new InvalidInputException(message, nfe);
         });
         assertSame(InvalidInputException.Type.DEFAULT, e.getType());
+        assertEquals(InvalidInputException.Type.DEFAULT.getCode(), e.getTypeCode());
         assertNull(e.getMessage());
         assertSame(nfe, e.getCause());
     }
@@ -247,6 +263,7 @@ public class InvalidInputExceptionTests {
             throw new InvalidInputException(message, npe);
         });
         assertSame(InvalidInputException.Type.DEFAULT, e.getType());
+        assertEquals(InvalidInputException.Type.DEFAULT.getCode(), e.getTypeCode());
         assertEquals(message, e.getMessage());
         assertNull(e.getCause());
     }
@@ -260,6 +277,7 @@ public class InvalidInputExceptionTests {
             throw new InvalidInputException(message, nfe);
         });
         assertSame(InvalidInputException.Type.DEFAULT, e.getType());
+        assertEquals(InvalidInputException.Type.DEFAULT.getCode(), e.getTypeCode());
         assertNull(e.getMessage());
         assertNull(e.getCause());
     }

plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/exception/test/ParsingFailureExceptionTests.java

@@ -41,6 +41,7 @@ public class ParsingFailureExceptionTests {
             throw ParsingFailureException.DATE_TIME_PARSING_FAILURE.create();
         });
         assertSame(ParsingFailureException.DATE_TIME_PARSING_FAILURE, e.getType());
+        assertEquals(ParsingFailureException.DATE_TIME_PARSING_FAILURE.getCode(), e.getTypeCode());
         assertEquals(ParsingFailureException.DATE_TIME_PARSING_FAILURE.getDefaultMessage(), e.getMessage());
         assertNull(e.getCause());
     }
@@ -52,6 +53,7 @@ public class ParsingFailureExceptionTests {
             throw ParsingFailureException.JSON_PARSING_FAILURE.create(message);
         });
         assertSame(ParsingFailureException.Type.JSON_PARSING_FAILURE, e.getType());
+        assertEquals(ParsingFailureException.Type.JSON_PARSING_FAILURE.getCode(), e.getTypeCode());
         assertEquals(message, e.getMessage());
         assertNull(e.getCause());
     }
@@ -63,6 +65,7 @@ public class ParsingFailureExceptionTests {
             throw ParsingFailureException.XML_PARSING_FAILURE.create(message);
         });
         assertSame(ParsingFailureException.XML_PARSING_FAILURE, e.getType());
+        assertEquals(ParsingFailureException.XML_PARSING_FAILURE.getCode(), e.getTypeCode());
         assertNull(e.getMessage());
         assertNull(e.getCause());
     }
@@ -77,6 +80,7 @@ public class ParsingFailureExceptionTests {
             });
 
             assertSame(ParsingFailureException.NUMBER_PARSING_FAILURE, e.getType());
+            assertEquals(ParsingFailureException.NUMBER_PARSING_FAILURE.getCode(), e.getTypeCode());
             log.info("{}", e.getMessage());
             assertEquals(nfe.toString(), e.getMessage());
             assertSame(nfe, e.getCause());
@@ -91,6 +95,7 @@ public class ParsingFailureExceptionTests {
         });
 
         assertSame(ParsingFailureException.NUMBER_PARSING_FAILURE, e.getType());
+        assertEquals(ParsingFailureException.NUMBER_PARSING_FAILURE.getCode(), e.getTypeCode());
         assertNull(e.getMessage());
         assertNull(e.getCause());
     }
@@ -104,6 +109,7 @@ public class ParsingFailureExceptionTests {
             throw ParsingFailureException.NUMBER_PARSING_FAILURE.create(message, nfe);
         });
         assertSame(ParsingFailureException.NUMBER_PARSING_FAILURE, e.getType());
+        assertEquals(ParsingFailureException.NUMBER_PARSING_FAILURE.getCode(), e.getTypeCode());
         assertEquals(message, e.getMessage());
         assertSame(nfe, e.getCause());
     }
@@ -117,6 +123,7 @@ public class ParsingFailureExceptionTests {
             throw ParsingFailureException.DATE_TIME_PARSING_FAILURE.create(message, nfe);
         });
         assertSame(ParsingFailureException.DATE_TIME_PARSING_FAILURE, e.getType());
+        assertEquals(ParsingFailureException.DATE_TIME_PARSING_FAILURE.getCode(), e.getTypeCode());
         assertNull(e.getMessage());
         assertSame(nfe, e.getCause());
     }
@@ -130,6 +137,7 @@ public class ParsingFailureExceptionTests {
             throw ParsingFailureException.DATE_TIME_PARSING_FAILURE.create(message, npe);
         });
         assertSame(ParsingFailureException.DATE_TIME_PARSING_FAILURE, e.getType());
+        assertEquals(ParsingFailureException.DATE_TIME_PARSING_FAILURE.getCode(), e.getTypeCode());
         assertEquals(message, e.getMessage());
         assertNull(e.getCause());
     }
@@ -143,6 +151,7 @@ public class ParsingFailureExceptionTests {
             throw ParsingFailureException.DATE_TIME_PARSING_FAILURE.create(message, nfe);
         });
         assertSame(ParsingFailureException.DATE_TIME_PARSING_FAILURE, e.getType());
+        assertEquals(ParsingFailureException.DATE_TIME_PARSING_FAILURE.getCode(), e.getTypeCode());
         assertNull(e.getMessage());
         assertNull(e.getCause());
     }
@@ -166,6 +175,7 @@ public class ParsingFailureExceptionTests {
         });
 
         assertSame(ParsingFailureException.DATE_TIME_PARSING_FAILURE, e.getType());
+        assertEquals(ParsingFailureException.DATE_TIME_PARSING_FAILURE.getCode(), e.getTypeCode());
         assertEquals(dtpe.getMessage(), e.getMessage());
         assertSame(dtpe, e.getCause());
     }
@@ -179,6 +189,7 @@ public class ParsingFailureExceptionTests {
         });
 
         assertSame(ParsingFailureException.DATE_TIME_PARSING_FAILURE, e.getType());
+        assertEquals(ParsingFailureException.DATE_TIME_PARSING_FAILURE.getCode(), e.getTypeCode());
         assertEquals(ParsingFailureException.DATE_TIME_PARSING_FAILURE.getDefaultMessage(), e.getMessage());
         assertNull(e.getCause());
     }
@@ -195,6 +206,7 @@ public class ParsingFailureExceptionTests {
         });
 
         assertSame(ParsingFailureException.DATE_TIME_PARSING_FAILURE, e.getType());
+        assertEquals(ParsingFailureException.DATE_TIME_PARSING_FAILURE.getCode(), e.getTypeCode());
         assertEquals(message, e.getMessage());
         assertSame(dtpe, e.getCause());
     }
@@ -211,6 +223,7 @@ public class ParsingFailureExceptionTests {
         });
 
         assertSame(ParsingFailureException.DATE_TIME_PARSING_FAILURE, e.getType());
+        assertEquals(ParsingFailureException.DATE_TIME_PARSING_FAILURE.getCode(), e.getTypeCode());
         assertNull(e.getMessage());
         assertSame(dtpe, e.getCause());
     }
@@ -225,6 +238,7 @@ public class ParsingFailureExceptionTests {
         });
 
         assertSame(ParsingFailureException.DATE_TIME_PARSING_FAILURE, e.getType());
+        assertEquals(ParsingFailureException.DATE_TIME_PARSING_FAILURE.getCode(), e.getTypeCode());
         assertEquals(message, e.getMessage());
         assertNull(e.getCause());
     }
@@ -239,6 +253,7 @@ public class ParsingFailureExceptionTests {
         });
 
         assertSame(ParsingFailureException.DATE_TIME_PARSING_FAILURE, e.getType());
+        assertEquals(ParsingFailureException.DATE_TIME_PARSING_FAILURE.getCode(), e.getTypeCode());
         assertNull(e.getMessage());
         assertNull(e.getCause());
     }
@@ -262,6 +277,7 @@ public class ParsingFailureExceptionTests {
         });
 
         assertSame(ParsingFailureException.NUMBER_PARSING_FAILURE, e.getType());
+        assertEquals(ParsingFailureException.NUMBER_PARSING_FAILURE.getCode(), e.getTypeCode());
         assertEquals(dtpe.getMessage(), e.getMessage());
         assertSame(dtpe, e.getCause());
     }
@@ -275,6 +291,7 @@ public class ParsingFailureExceptionTests {
         });
 
         assertSame(ParsingFailureException.NUMBER_PARSING_FAILURE, e.getType());
+        assertEquals(ParsingFailureException.NUMBER_PARSING_FAILURE.getCode(), e.getTypeCode());
         assertEquals(ParsingFailureException.NUMBER_PARSING_FAILURE.getDefaultMessage(), e.getMessage());
         assertNull(e.getCause());
     }
@@ -291,6 +308,7 @@ public class ParsingFailureExceptionTests {
         });
 
         assertSame(ParsingFailureException.NUMBER_PARSING_FAILURE, e.getType());
+        assertEquals(ParsingFailureException.NUMBER_PARSING_FAILURE.getCode(), e.getTypeCode());
         assertEquals(message, e.getMessage());
         assertSame(dtpe, e.getCause());
     }
@@ -307,6 +325,7 @@ public class ParsingFailureExceptionTests {
         });
 
         assertSame(ParsingFailureException.NUMBER_PARSING_FAILURE, e.getType());
+        assertEquals(ParsingFailureException.NUMBER_PARSING_FAILURE.getCode(), e.getTypeCode());
         assertNull(e.getMessage());
         assertSame(dtpe, e.getCause());
     }
@@ -321,6 +340,7 @@ public class ParsingFailureExceptionTests {
         });
 
         assertSame(ParsingFailureException.NUMBER_PARSING_FAILURE, e.getType());
+        assertEquals(ParsingFailureException.NUMBER_PARSING_FAILURE.getCode(), e.getTypeCode());
         assertEquals(message, e.getMessage());
         assertNull(e.getCause());
     }
@@ -335,6 +355,7 @@ public class ParsingFailureExceptionTests {
         });
 
         assertSame(ParsingFailureException.NUMBER_PARSING_FAILURE, e.getType());
+        assertEquals(ParsingFailureException.NUMBER_PARSING_FAILURE.getCode(), e.getTypeCode());
         assertNull(e.getMessage());
         assertNull(e.getCause());
     }

plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/model/SemVerTests.java

@@ -1,251 +0,0 @@
-/*
- * Copyright 2025 the original author or authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      https://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package xyz.zhouxy.plusone.commons.model;
-
-import static org.apache.commons.lang3.ObjectUtils.compare;
-import static org.junit.jupiter.api.Assertions.assertAll;
-import static org.junit.jupiter.api.Assertions.assertArrayEquals;
-import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertFalse;
-import static org.junit.jupiter.api.Assertions.assertNotEquals;
-import static org.junit.jupiter.api.Assertions.assertThrows;
-import static org.junit.jupiter.api.Assertions.assertTrue;
-
-import java.util.Arrays;
-
-import org.junit.jupiter.api.Test;
-import org.junit.jupiter.params.ParameterizedTest;
-import org.junit.jupiter.params.provider.ValueSource;
-
-import lombok.extern.slf4j.Slf4j;
-
-@Slf4j
-public class SemVerTests {
-
-    @ParameterizedTest
-    @ValueSource(strings = {
-        "25.10.17",
-        "25.10.17.11",
-        "25.10.17.11.38",
-        "25.10.17-RC1",
-        "25.10.17.11-RC1",
-        "25.10.17.11.38-RC1",
-        "25.10.17+build.a20251017.1",
-        "25.10.17.11+build.a20251017.1",
-        "25.10.17.11.38+build.a20251017.1",
-        "25.10.17-RC1+build.a20251017.1",
-        "25.10.17.11-RC1+build.a20251017.1",
-        "25.10.17.11.38-RC1+build.a20251017.1",
-    })
-    void test_of_success(String value) {
-        assertDoesNotThrow(() -> SemVer.of(value));
-    }
-
-    @ParameterizedTest
-    @ValueSource(strings = {
-        "25",
-        "25.10",
-        "x.10.17",
-        "25.x.17",
-        "25.10.x",
-        "25.10.17.11.38.20",
-        "025.10.17",
-        "25.010.17",
-        "25.10.017",
-    })
-    void test_of_wrongValue(String value) {
-        IllegalArgumentException e = assertThrows(IllegalArgumentException.class, () -> SemVer.of(value));
-        assertEquals("版本号格式错误", e.getMessage());
-    }
-
-    @ParameterizedTest
-    @ValueSource(strings = {
-        "25.1.1",
-        "25.1.1-RC1",
-        "25.1.1+build.a20250101.1",
-        "25.1.1-RC1+build.a20250101.1",
-    })
-    void compareTo_Major(String version_25_x_x) { // NOSONAR sonarqube(java:S117)
-        assertTrue(compare(SemVer.of(version_25_x_x), SemVer.of("24.12.30")) > 0);
-        assertTrue(compare(SemVer.of(version_25_x_x), SemVer.of("24.12.30.1")) > 0);
-        assertTrue(compare(SemVer.of(version_25_x_x), SemVer.of("24.12.30-RC2")) > 0);
-        assertTrue(compare(SemVer.of(version_25_x_x), SemVer.of("24.12.30+build.z20241230.1")) > 0);
-        assertTrue(compare(SemVer.of(version_25_x_x), SemVer.of("24.12.30-RC2+build.z20241230.1")) > 0);
-    }
-
-    @ParameterizedTest
-    @ValueSource(strings = {
-        "25.10.1",
-        "25.10.1-RC1",
-        "25.10.1+build.a20251001.1",
-        "25.10.1-RC1+build.a20251001.1",
-    })
-    void compareTo_Minor(String version_25_10_x) { // NOSONAR sonarqube(java:S117)
-        assertTrue(compare(SemVer.of(version_25_10_x), SemVer.of("25.9.30")) > 0);
-        assertTrue(compare(SemVer.of(version_25_10_x), SemVer.of("25.9.30.1")) > 0);
-        assertTrue(compare(SemVer.of(version_25_10_x), SemVer.of("25.9.30-RC2")) > 0);
-        assertTrue(compare(SemVer.of(version_25_10_x), SemVer.of("25.9.30+build.z20250930.1")) > 0);
-        assertTrue(compare(SemVer.of(version_25_10_x), SemVer.of("25.9.30-RC2+build.z20250930.1")) > 0);
-    }
-
-    @ParameterizedTest
-    @ValueSource(strings = {
-        "25.10.17",
-        "25.10.17-RC1",
-        "25.10.17+build.a20251017.1",
-        "25.10.17-RC1+build.a20251017.1",
-    })
-    void compareTo_Patch(String version_25_10_17) { // NOSONAR sonarqube(java:S117)
-
-        assertTrue(compare(SemVer.of(version_25_10_17), SemVer.of("25.10.16")) > 0);
-        assertTrue(compare(SemVer.of(version_25_10_17), SemVer.of("25.10.16.1")) > 0);
-        assertTrue(compare(SemVer.of(version_25_10_17), SemVer.of("25.10.16-RC2")) > 0);
-        assertTrue(compare(SemVer.of(version_25_10_17), SemVer.of("25.10.16+build.z20251016.2")) > 0);
-        assertTrue(compare(SemVer.of(version_25_10_17), SemVer.of("25.10.16-RC2+build.z20251016.2")) > 0);
-    }
-
-    @Test
-    void compareTo_MoreVersionNumber() {
-
-        assertTrue(compare(SemVer.of("25.10.17.1"), SemVer.of("25.10.17")) > 0);
-        assertTrue(compare(SemVer.of("25.10.17.11"), SemVer.of("25.10.17.1")) > 0);
-        assertEquals(0, compare(SemVer.of("25.10.17.11"), SemVer.of("25.10.17.11")));
-
-        assertTrue(compare(SemVer.of("25.10.17.11.1"), SemVer.of("25.10.17.11")) > 0);
-        assertTrue(compare(SemVer.of("25.10.17.11.38"), SemVer.of("25.10.17.11.1")) > 0);
-        assertEquals(0, compare(SemVer.of("25.10.17.11.38"), SemVer.of("25.10.17.11.38")));
-    }
-
-    @Test
-    void compareTo_PreReleaseVersion() {
-
-        // 先行版的优先级低于相关联的标准版本
-        assertTrue(compare(SemVer.of("25.10.17"), SemVer.of("25.10.17-0")) > 0);
-        assertTrue(compare(SemVer.of("25.10.17"), SemVer.of("25.10.17-RC1")) > 0);
-
-        // 只有数字的标识符以数值高低比较
-        assertAll(
-                () -> assertTrue(compare("25.10.17-RC.11", "25.10.17-RC.2") < 0),
-                () -> assertTrue(compare(SemVer.of("25.10.17-RC.11"), SemVer.of("25.10.17-RC.2")) > 0)
-        );
-
-        // 纯数字优先级低于非数字
-        assertAll(
-                () -> assertTrue(compare("25.10.17-999", "25.10.17-A") < 0),
-                () -> assertTrue(compare(SemVer.of("25.10.17-A.A"), SemVer.of("25.10.17-A.99")) > 0)
-        );
-
-        SemVer[] versions = {
-                SemVer.of("25.10.17-a"),
-                SemVer.of("25.10.17-aa"),
-                SemVer.of("25.10.17-A"),
-                SemVer.of("25.10.17-AA"),
-
-                SemVer.of("25.10.17--"),
-
-                SemVer.of("25.10.17-999"),
-
-                SemVer.of("25.10.17-z"),
-                SemVer.of("25.10.17-zz"),
-                SemVer.of("25.10.17-Z"),
-                SemVer.of("25.10.17-ZZ"),
-        };
-
-        assertArrayEquals(
-                new SemVer[] {
-                        // 纯数字优先级低于非数字
-                        SemVer.of("25.10.17-999"),
-
-                        // 有字母或连接号时逐字符以 ASCII 的排序比较
-                        SemVer.of("25.10.17--"),
-
-                        SemVer.of("25.10.17-A"),
-                        SemVer.of("25.10.17-AA"),
-                        SemVer.of("25.10.17-Z"),
-                        SemVer.of("25.10.17-ZZ"),
-                        SemVer.of("25.10.17-a"),
-                        SemVer.of("25.10.17-aa"),
-                        SemVer.of("25.10.17-z"),
-                        SemVer.of("25.10.17-zz"),
-                },
-                Arrays.stream(versions)
-                        .sorted()
-                        .toArray(SemVer[]::new));
-
-        // 若开头的标识符都相同时，栏位比较多的先行版本号优先级比较高
-        assertAll(
-                () -> assertTrue(compare(SemVer.of("25.10.17-ABC.DEF.1"), SemVer.of("25.10.17-ABC.DEF")) > 0),
-                () -> assertTrue(compare(SemVer.of("25.10.17-ABC.DEF.G"), SemVer.of("25.10.17-ABC.DEF")) > 0));
-
-    }
-
-    @Test
-    void compareTo_ignoreBuildMeta() {
-
-        assertNotEquals(SemVer.of("25.10.17"), SemVer.of("25.10.17+build.20251017.01"));
-        assertTrue(compare(SemVer.of("25.10.17"), SemVer.of("25.10.17+build.20251017.01")) == 0); // NOSONAR sonarqube(java:S5785)
-
-        assertNotEquals(SemVer.of("25.10.17+build.20251017.02"), SemVer.of("25.10.17+build.20251017.01"));
-        assertTrue(compare(SemVer.of("25.10.17+build.20251017.02"), SemVer.of("25.10.17+build.20251017.01")) == 0); // NOSONAR sonarqube(java:S5785)
-
-        assertNotEquals(SemVer.of("25.10.17-ABC.DEF"), SemVer.of("25.10.17-ABC.DEF+build.20251017.01"));
-        assertTrue(compare(SemVer.of("25.10.17-ABC.DEF"), SemVer.of("25.10.17-ABC.DEF+build.20251017.01")) == 0); // NOSONAR sonarqube(java:S5785)
-
-        assertNotEquals(SemVer.of("25.10.17-ABC.DEF+build.20251017.02"), SemVer.of("25.10.17-ABC.DEF+build.20251017.01"));
-        assertTrue(compare(SemVer.of("25.10.17-ABC.DEF+build.20251017.02"), SemVer.of("25.10.17-ABC.DEF+build.20251017.01")) == 0); // NOSONAR sonarqube(java:S5785)
-    }
-
-    @ParameterizedTest
-    @ValueSource(strings = {
-        "25.10.17",
-        "25.10.17-ABC.DEF.1",
-        "25.10.17+build.20251017.a2",
-        "25.10.17-ABC.DEF.1+build.20251017.a2",
-    })
-    void test_equals(String value) {
-        final SemVer v1 = SemVer.of(value);
-        final SemVer v2 = SemVer.of(value);
-
-        assertTrue(v1.compareTo(v1) == 0); // NOSONAR sonarqube(java:S5785)
-        assertTrue(v1.compareTo(v2) == 0); // NOSONAR sonarqube(java:S5785)
-
-        assertEquals(v1, v1);
-        assertEquals(v1.hashCode(), v2.hashCode());
-        assertEquals(v1, v2);
-    }
-
-    @Test
-    void test_equals_null() {
-        assertFalse(SemVer.of("25.10.17").equals(null)); // NOSONAR sonarqube(java:S5785)
-    }
-
-    @Test
-    void details() {
-        final String s = "25.10.17-ABC.DEF.1+build.20251017.02";
-        final SemVer v = SemVer.of(s);
-        assertEquals(25, v.getMajor());
-        assertEquals(10, v.getMinor());
-        assertEquals(17, v.getPatch());
-
-        assertEquals("ABC.DEF.1", v.getPreReleaseVersion());
-        assertEquals(s, v.getValue());
-        assertEquals("v" + s, v.toString());
-
-        assertEquals("build.20251017.02", v.getBuildMetadata());
-    }
-}

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

@@ -31,7 +31,7 @@ import org.slf4j.LoggerFactory;
 
 import xyz.zhouxy.plusone.commons.annotation.StaticFactoryMethod;
 import xyz.zhouxy.plusone.commons.annotation.ValueObject;
-import xyz.zhouxy.plusone.commons.constant.PatternConsts;
+import xyz.zhouxy.plusone.commons.regex.PatternConsts;
 
 import java.util.Arrays;
 import java.util.Collections;

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

@@ -381,7 +381,7 @@ class CustomUnifiedResponseFactoryTests {
         assertThrows(NullPointerException.class, () -> CustomUnifiedResponses.error(nullStatus, "查询失败", user));
 
         // Throwable
-        BizException bizException = BizException.of("业务异常");
+        BizException bizException = new BizException("业务异常");
         assertThrows(NullPointerException.class, () -> CustomUnifiedResponses.error(nullStatus, bizException));
         assertThrows(NullPointerException.class, () -> CustomUnifiedResponses.error(nullStatus, (Throwable) null));
     }

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

@@ -379,7 +379,7 @@ class UnifiedResponseTests {
         assertThrows(NullPointerException.class, () -> UnifiedResponses.error(nullStatus, "查询失败", user));
 
         // Throwable
-        BizException bizException = BizException.of("业务异常");
+        BizException bizException = new BizException("业务异常");
         assertThrows(NullPointerException.class, () -> UnifiedResponses.error(nullStatus, bizException));
         assertThrows(NullPointerException.class, () -> UnifiedResponses.error(nullStatus, (Throwable) null));
     }

plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/model/dto/test/PagingAndSortingQueryParamsTests.java

@@ -220,7 +220,7 @@ public class PagingAndSortingQueryParamsTests {
 /**
  * 账号信息查询参数
  *
- * @author ZhouXY108 <luquanlion@outlook.com>
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 @ToString(callSuper = true)
 class AccountQueryParams extends PagingAndSortingQueryParams {
@@ -231,8 +231,9 @@ class AccountQueryParams extends PagingAndSortingQueryParams {
             .put("createTime", "create_time")
             .build();
 
-    private static final PagingParamsBuilder PAGING_PARAMS_BUILDER = PagingAndSortingQueryParams
-            .pagingParamsBuilder(20, 100, PROPERTY_COLUMN_MAP);
+    public AccountQueryParams() {
+        super(PROPERTY_COLUMN_MAP);
+    }
 
     private @Getter @Setter Long id;
     private @Getter @Setter String username;
@@ -248,10 +249,6 @@ class AccountQueryParams extends PagingAndSortingQueryParams {
         }
         return this.createTimeEnd.plusDays(1);
     }
-
-    public PagingParams buildPagingParams() {
-        return PAGING_PARAMS_BUILDER.buildPagingParams(this);
-    }
 }
 
 @Data

plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/regex/PatternConstsTests.java

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-package xyz.zhouxy.plusone.commons.constant;
+package xyz.zhouxy.plusone.commons.regex;
 
 import static org.junit.jupiter.api.Assertions.*;
 

plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/regex/PatternInfosTests.java

@@ -0,0 +1,259 @@
+/*
+ * Copyright 2024-2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package xyz.zhouxy.plusone.commons.regex;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+import java.lang.reflect.Constructor;
+import java.util.Arrays;
+import java.util.regex.Matcher;
+
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.params.ParameterizedTest;
+import org.junit.jupiter.params.provider.ValueSource;
+
+import lombok.extern.slf4j.Slf4j;
+import xyz.zhouxy.plusone.commons.model.Gender;
+
+@Slf4j
+public //
+class PatternInfosTests {
+
+    // ================================
+    // #region - BASIC_ISO_DATE
+    // ================================
+
+    @Test
+    void testBasicIsoDate_ValidDate() {
+        LocalDateMatcher localDateMatcher = PatternInfos.BASIC_ISO_DATE.matcher("20241229");
+        Matcher matcher = localDateMatcher.matcher();
+        assertTrue(matcher.matches());
+        assertTrue(localDateMatcher.matches());
+
+        assertEquals("2024", localDateMatcher.getYear());
+        assertEquals("12", localDateMatcher.getMonth());
+        assertEquals("29", localDateMatcher.getDay());
+    }
+
+    @ParameterizedTest
+    @ValueSource(strings = {
+        "20231301", // InvalidMonth
+        "20230230", // InvalidDay
+        "20210229", // NonLeapYearFeb29
+    })
+    void testBasicIsoDate_InvalidDate_butMatches(String date) {
+        // 虽然日期有误，但这个正则无法判断。实际工作中，应使用日期时间 API。
+        LocalDateMatcher matcher = PatternInfos.BASIC_ISO_DATE.matcher(date);
+        assertTrue(matcher.matches());
+    }
+
+    @ParameterizedTest
+    @ValueSource(strings = {
+        "2023041", // TooShort
+        "99999999990415", // TooLong
+        "2023-04-15", // NonNumeric
+    })
+    void testBasicIsoDate_InvalidDate_Mismatches(String date) {
+        LocalDateMatcher matcher = PatternInfos.BASIC_ISO_DATE.matcher(date);
+        assertFalse(matcher.matches());
+    }
+
+    // ================================
+    // #endregion - BASIC_ISO_DATE
+    // ================================
+
+    // ================================
+    // #region - ISO_LOCAL_DATE
+    // ================================
+
+    @Test
+    void testIsoLocalDate_ValidDate() {
+        LocalDateMatcher matcher = PatternInfos.ISO_LOCAL_DATE.matcher("2024-12-29");
+        assertTrue(matcher.matches());
+        assertEquals("2024", matcher.getYear());
+        assertEquals("12", matcher.getMonth());
+        assertEquals("29", matcher.getDay());
+
+        // LeapYearFeb29()
+        assertTrue(PatternInfos.ISO_LOCAL_DATE.matcher("2020-02-29").matches());
+
+        // BoundaryMin()
+        assertTrue(PatternInfos.ISO_LOCAL_DATE.matcher("0000-01-01").matches());
+
+        // BoundaryMax()
+        assertTrue(PatternInfos.ISO_LOCAL_DATE.matcher("999999999-12-31").matches());
+    }
+
+    @ParameterizedTest
+    @ValueSource(strings = {
+        "2023-13-01", // InvalidMonth
+        "2023-02-30", // InvalidDay
+        "2021-02-29", // NonLeapYearFeb29
+    })
+    void testIsoLocalDate_InvalidDate_butMatches(String date) {
+        // 虽然日期有误，但这个正则无法判断。实际工作中，应使用日期时间 API。
+        LocalDateMatcher matcher = PatternInfos.ISO_LOCAL_DATE.matcher(date);
+        assertTrue(matcher.matches());
+    }
+
+    @ParameterizedTest
+    @ValueSource(strings = {
+        "2023-04-1", // TooShort
+        "9999999999-04-15", // TooLong
+        "20230415",
+    })
+    void testIsoLocalDate_InvalidDate_Mismatches(String date) {
+        LocalDateMatcher matcher = PatternInfos.ISO_LOCAL_DATE.matcher(date);
+        assertFalse(matcher.matches());
+    }
+
+    // ================================
+    // #endregion - ISO_LOCAL_DATE
+    // ================================
+
+    // ================================
+    // #region - PASSWORD
+    // ================================
+
+    @Test
+    void testPassword_ValidPassword_Matches() {
+        assertTrue(PatternInfos.PASSWORD.matcher("Abc123!@#").matches());
+    }
+
+    @Test
+    void testPassword_InvalidPassword_Mismatches() {
+        assertFalse(PatternInfos.PASSWORD.matcher("Abc123 !@#").matches()); // 带空格
+        assertFalse(PatternInfos.PASSWORD.matcher("Abc123!@# ").matches()); // 带空格
+        assertFalse(PatternInfos.PASSWORD.matcher(" Abc123!@#").matches()); // 带空格
+        assertFalse(PatternInfos.PASSWORD.matcher(" Abc123!@# ").matches()); // 带空格
+        assertFalse(PatternInfos.PASSWORD.matcher("77553366998844113322").matches()); // 纯数字
+        assertFalse(PatternInfos.PASSWORD.matcher("poiujhgbfdsazxcfvghj").matches()); // 纯小写字母
+        assertFalse(PatternInfos.PASSWORD.matcher("POIUJHGBFDSAZXCFVGHJ").matches()); // 纯大写字母
+        assertFalse(PatternInfos.PASSWORD.matcher("!#$%&'*\\+-/=?^`{|}~@()[]\",.;':").matches()); // 纯特殊字符
+        assertFalse(PatternInfos.PASSWORD.matcher("sdfrghbv525842582752").matches()); // 没有小写字母
+        assertFalse(PatternInfos.PASSWORD.matcher("SDFRGHBV525842582752").matches()); // 没有小写字母
+        assertFalse(PatternInfos.PASSWORD.matcher("sdfrghbvSDFRGHBV").matches()); // 没有数字
+        assertFalse(PatternInfos.PASSWORD.matcher("Abc1!").matches()); // 太短
+        assertFalse(PatternInfos.PASSWORD.matcher("Abc1!Abc1!Abc1!Abc1!Abc1!Abc1!Abc1!").matches()); // 太长
+        assertFalse(PatternInfos.PASSWORD.matcher("").matches());
+        assertFalse(PatternInfos.PASSWORD.matcher(" ").matches());
+    }
+
+    // ================================
+    // #endregion - PASSWORD
+    // ================================
+
+    // ================================
+    // #region - EMAIL
+    // ================================
+
+    @Test
+    public void testValidEmails() {
+        assertTrue(PatternInfos.EMAIL.matcher("test@example.com").matches());
+        assertTrue(PatternInfos.EMAIL.matcher("user.name+tag+sorting@example.com").matches());
+        assertTrue(PatternInfos.EMAIL.matcher("user@sub.example.com").matches());
+        assertTrue(PatternInfos.EMAIL.matcher("user@123.123.123.123").matches());
+    }
+
+    @Test
+    public void testInvalidEmails() {
+        assertFalse(PatternInfos.EMAIL.matcher(".username@example.com").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("@missingusername.com").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("plainaddress").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username..username@example.com").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username.@example.com").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@-example.com").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@-example.com").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@.com.com").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@.com.my").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@.com").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@com.").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@com").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@example..com").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@example.com-").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@example.com.").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@example").matches());
+    }
+
+    // ================================
+    // #endregion - EMAIL
+    // ================================
+
+    // ================================
+    // #region - Chinese2ndIdCardNumber
+    // ================================
+
+    @ParameterizedTest
+    @ValueSource(strings = {
+        "44520019900101456X",
+        "44520019900101456x",
+        "445200199001014566",
+    })
+    void testChinese2ndIdCardNumber_ValidChinese2ndIdCardNumber(String value) {
+        Chinese2ndIdCardNumberMatcher chinese2ndIdCardNumberMatcher = PatternInfos.CHINESE_2ND_ID_CARD_NUMBER.matcher(value);
+        Matcher matcher = chinese2ndIdCardNumberMatcher.matcher();
+        assertTrue(matcher.matches());
+        assertEquals("44", chinese2ndIdCardNumberMatcher.getProvince());
+        assertEquals("4452", chinese2ndIdCardNumberMatcher.getCity());
+        assertEquals("445200", chinese2ndIdCardNumberMatcher.getCounty());
+        assertEquals("19900101", chinese2ndIdCardNumberMatcher.getBirthDate());
+        assertEquals("456", chinese2ndIdCardNumberMatcher.getOrderCode());
+        assertEquals("6", chinese2ndIdCardNumberMatcher.getGenderCode());
+        assertEquals(Gender.FEMALE, chinese2ndIdCardNumberMatcher.getGender());
+
+        String checkDigit = value.substring(value.length() - 1);
+        assertEquals(checkDigit, chinese2ndIdCardNumberMatcher.getCheckDigit());
+    }
+
+    @ParameterizedTest
+    @ValueSource(strings = {
+        "4452200199001014566",
+        "44520199001014566",
+        " ",
+        "",
+    })
+    void testChinese2ndIdCardNumber_InvalidChinese2ndIdCardNumber(String value) {
+        assertFalse(PatternInfos.CHINESE_2ND_ID_CARD_NUMBER.matcher(value).matches());
+    }
+
+    // ================================
+    // #endregion - Chinese2ndIdCardNumber
+    // ================================
+
+    // ================================
+    // #region - invoke constructor
+    // ================================
+
+    @Test
+    void test_constructor_isNotAccessible_ThrowsIllegalStateException() {
+        Constructor<?>[] constructors;
+        constructors = PatternInfos.class.getDeclaredConstructors();
+        Arrays.stream(constructors)
+                .forEach(constructor -> {
+                    assertFalse(constructor.isAccessible());
+                    constructor.setAccessible(true);
+                    Throwable cause = assertThrows(Exception.class, constructor::newInstance)
+                            .getCause();
+                    assertInstanceOf(IllegalStateException.class, cause);
+                    assertEquals("Utility class", cause.getMessage());
+                });
+    }
+
+    // ================================
+    // #endregion - invoke constructor
+    // ================================
+}

plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/DateTimeToolsTests.java

@@ -43,7 +43,6 @@ import org.junit.jupiter.api.Test;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
-import com.google.common.collect.BoundType;
 import com.google.common.collect.Range;
 
 import xyz.zhouxy.plusone.commons.time.Quarter;
@@ -84,6 +83,24 @@ class DateTimeToolsTests {
         CALENDAR.setTime(DATE);
     }
 
+    // Joda
+    static final org.joda.time.LocalDateTime JODA_LOCAL_DATE_TIME
+            = new org.joda.time.LocalDateTime(2024, 12, 29, 12, 58, 30, 333);
+    static final org.joda.time.LocalDate JODA_LOCAL_DATE = JODA_LOCAL_DATE_TIME.toLocalDate();
+    static final org.joda.time.LocalTime JODA_LOCAL_TIME = JODA_LOCAL_DATE_TIME.toLocalTime();
+
+    // Joda - 2024-12-29 12:58:30.333 SystemDefaultZone
+    static final org.joda.time.DateTimeZone JODA_SYS_ZONE = org.joda.time.DateTimeZone.getDefault();
+    static final org.joda.time.DateTime JODA_DATE_TIME_WITH_SYS_ZONE = JODA_LOCAL_DATE_TIME.toDateTime(JODA_SYS_ZONE);
+    static final org.joda.time.Instant JODA_INSTANT_WITH_SYS_ZONE = JODA_DATE_TIME_WITH_SYS_ZONE.toInstant();
+    static final long JODA_INSTANT_MILLIS = JODA_INSTANT_WITH_SYS_ZONE.getMillis();
+
+    // Joda - 2024-12-29 12:58:30.333 GMT+04:00
+    static final org.joda.time.DateTimeZone JODA_ZONE = org.joda.time.DateTimeZone.forID("GMT+04:00");
+    static final org.joda.time.DateTime JODA_DATE_TIME = JODA_LOCAL_DATE_TIME.toDateTime(JODA_ZONE);
+    static final org.joda.time.Instant JODA_INSTANT = JODA_DATE_TIME.toInstant();
+    static final long JODA_MILLIS = JODA_INSTANT.getMillis();
+
     // ================================
     // #region - toDate
     // ================================
@@ -92,7 +109,9 @@ class DateTimeToolsTests {
     void toDate_timeMillis() {
         assertNotEquals(SYS_DATE, DATE);
         log.info("SYS_DATE: {}, DATE: {}", SYS_DATE, DATE);
+        assertEquals(SYS_DATE, JODA_DATE_TIME_WITH_SYS_ZONE.toDate());
         assertEquals(SYS_DATE, DateTimeTools.toDate(INSTANT_MILLIS));
+        assertEquals(DATE, JODA_DATE_TIME.toDate());
         assertEquals(DATE, DateTimeTools.toDate(MILLIS));
     }
 
@@ -374,11 +393,11 @@ class DateTimeToolsTests {
     // ================================
 
     // ================================
-    // #region - range
+    // #region - others
     // ================================
 
     @Test
-    void toDateTimeRange_specifiedDate() {
+    void startDateTimeRange() {
         Range<LocalDateTime> localDateTimeRange = DateTimeTools.toDateTimeRange(LOCAL_DATE);
         assertEquals(LOCAL_DATE.atStartOfDay(), localDateTimeRange.lowerEndpoint());
         assertEquals(LocalDate.of(2024, 12, 30).atStartOfDay(), localDateTimeRange.upperEndpoint());
@@ -392,96 +411,8 @@ class DateTimeToolsTests {
         assertFalse(zonedDateTimeRange.contains(LocalDate.of(2024, 12, 30).atStartOfDay().atZone(SYS_ZONE_ID)));
     }
 
-    @Test
-    void toDateTimeRange_dateRange_openRange() {
-        // (2000-01-01..2025-10-01) -> [2000-01-02T00:00..2025-10-01T00:00)
-        Range<LocalDate> dateRange = Range.open(
-                LocalDate.of(2000, 1, 1),
-                LocalDate.of(2025, 10, 1));
-
-        Range<LocalDateTime> localDateTimeRange = DateTimeTools.toDateTimeRange(dateRange);
-        assertEquals(BoundType.CLOSED, localDateTimeRange.lowerBoundType());
-        assertEquals(LocalDateTime.of(2000, 1, 2, 0, 0), localDateTimeRange.lowerEndpoint());
-        assertEquals(BoundType.OPEN, localDateTimeRange.upperBoundType());
-        assertEquals(LocalDateTime.of(2025, 10, 1, 0, 0), localDateTimeRange.upperEndpoint());
-        log.info(localDateTimeRange.toString());
-
-        Range<ZonedDateTime> zonedDateTimeRange = DateTimeTools.toDateTimeRange(dateRange, ZONE_ID);
-        assertEquals(BoundType.CLOSED, zonedDateTimeRange.lowerBoundType());
-        assertEquals(LocalDateTime.of(2000, 1, 2, 0, 0).atZone(ZONE_ID), zonedDateTimeRange.lowerEndpoint());
-        assertEquals(BoundType.OPEN, zonedDateTimeRange.upperBoundType());
-        assertEquals(LocalDateTime.of(2025, 10, 1, 0, 0).atZone(ZONE_ID), zonedDateTimeRange.upperEndpoint());
-        log.info(zonedDateTimeRange.toString());
-    }
-
-    @Test
-    void toDateTimeRange_dateRange_openClosedRange() {
-        // (2000-01-01..2025-10-01] -> [2025-01-02T00-00..2025-10-02 00:00)
-        Range<LocalDate> dateRange = Range.openClosed(
-                LocalDate.of(2000, 1, 1),
-                LocalDate.of(2025, 10, 1));
-
-        Range<LocalDateTime> localDateTimeRange = DateTimeTools.toDateTimeRange(dateRange);
-        assertEquals(BoundType.CLOSED, localDateTimeRange.lowerBoundType());
-        assertEquals(LocalDateTime.of(2000, 1, 2, 0, 0), localDateTimeRange.lowerEndpoint());
-        assertEquals(BoundType.OPEN, localDateTimeRange.upperBoundType());
-        assertEquals(LocalDateTime.of(2025, 10, 2, 0, 0), localDateTimeRange.upperEndpoint());
-        log.info(localDateTimeRange.toString());
-
-        Range<ZonedDateTime> zonedDateTimeRange = DateTimeTools.toDateTimeRange(dateRange, ZONE_ID);
-        assertEquals(BoundType.CLOSED, zonedDateTimeRange.lowerBoundType());
-        assertEquals(LocalDateTime.of(2000, 1, 2, 0, 0).atZone(ZONE_ID), zonedDateTimeRange.lowerEndpoint());
-        assertEquals(BoundType.OPEN, zonedDateTimeRange.upperBoundType());
-        assertEquals(LocalDateTime.of(2025, 10, 2, 0, 0).atZone(ZONE_ID), zonedDateTimeRange.upperEndpoint());
-        log.info(zonedDateTimeRange.toString());
-    }
-
-    @Test
-    void toDateTimeRange_dateRange_closedRange() {
-        // [2000-01-01..2025-10-01] -> [2025-01-01T00-00..2025-10-02 00:00)
-        Range<LocalDate> dateRange = Range.closed(
-                LocalDate.of(2000, 1, 1),
-                LocalDate.of(2025, 10, 1));
-
-        Range<LocalDateTime> localDateTimeRange = DateTimeTools.toDateTimeRange(dateRange);
-        assertEquals(BoundType.CLOSED, localDateTimeRange.lowerBoundType());
-        assertEquals(LocalDateTime.of(2000, 1, 1, 0, 0), localDateTimeRange.lowerEndpoint());
-        assertEquals(BoundType.OPEN, localDateTimeRange.upperBoundType());
-        assertEquals(LocalDateTime.of(2025, 10, 2, 0, 0), localDateTimeRange.upperEndpoint());
-        log.info(localDateTimeRange.toString());
-
-        Range<ZonedDateTime> zonedDateTimeRange = DateTimeTools.toDateTimeRange(dateRange, ZONE_ID);
-        assertEquals(BoundType.CLOSED, zonedDateTimeRange.lowerBoundType());
-        assertEquals(LocalDateTime.of(2000, 1, 1, 0, 0).atZone(ZONE_ID), zonedDateTimeRange.lowerEndpoint());
-        assertEquals(BoundType.OPEN, zonedDateTimeRange.upperBoundType());
-        assertEquals(LocalDateTime.of(2025, 10, 2, 0, 0).atZone(ZONE_ID), zonedDateTimeRange.upperEndpoint());
-        log.info(zonedDateTimeRange.toString());
-    }
-
-    @Test
-    void toDateTimeRange_dateRange_closedOpenRange() {
-        // [2025-01-01..2025-10-01) -> [2025-01-01T00-00..2025-10-01 00:00)
-        Range<LocalDate> dateRange = Range.closedOpen(
-                LocalDate.of(2000, 1, 1),
-                LocalDate.of(2025, 10, 1));
-
-        Range<LocalDateTime> localDateTimeRange = DateTimeTools.toDateTimeRange(dateRange);
-        assertEquals(BoundType.CLOSED, localDateTimeRange.lowerBoundType());
-        assertEquals(LocalDateTime.of(2000, 1, 1, 0, 0), localDateTimeRange.lowerEndpoint());
-        assertEquals(BoundType.OPEN, localDateTimeRange.upperBoundType());
-        assertEquals(LocalDateTime.of(2025, 10, 1, 0, 0), localDateTimeRange.upperEndpoint());
-        log.info(localDateTimeRange.toString());
-
-        Range<ZonedDateTime> zonedDateTimeRange = DateTimeTools.toDateTimeRange(dateRange, ZONE_ID);
-        assertEquals(BoundType.CLOSED, zonedDateTimeRange.lowerBoundType());
-        assertEquals(LocalDateTime.of(2000, 1, 1, 0, 0).atZone(ZONE_ID), zonedDateTimeRange.lowerEndpoint());
-        assertEquals(BoundType.OPEN, zonedDateTimeRange.upperBoundType());
-        assertEquals(LocalDateTime.of(2025, 10, 1, 0, 0).atZone(ZONE_ID), zonedDateTimeRange.upperEndpoint());
-        log.info(zonedDateTimeRange.toString());
-    }
-
     // ================================
-    // #endregion - range
+    // #endregion - others
     // ================================
 
     // ================================

plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/JodaTimeToolsTests.java

@@ -33,7 +33,7 @@ import org.junit.jupiter.api.Test;
 public class JodaTimeToolsTests {
 
     // Java
-    static final LocalDateTime LOCAL_DATE_TIME = LocalDateTime.of(2024, 12, 29, 12, 58, 30, 333 * 1_000_000);
+    static final LocalDateTime LOCAL_DATE_TIME = LocalDateTime.of(2024, 12, 29, 12, 58, 30, 333000000);
     static final LocalDate LOCAL_DATE = LOCAL_DATE_TIME.toLocalDate();
     static final LocalTime LOCAL_TIME = LOCAL_DATE_TIME.toLocalTime();
 

plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/NumbersTests.java

@@ -26,7 +26,6 @@ import java.util.Arrays;
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertInstanceOf;
-import static org.junit.jupiter.api.Assertions.assertNull;
 import static org.junit.jupiter.api.Assertions.assertThrows;
 
 public
@@ -69,16 +68,9 @@ class NumbersTests {
 
     @Test
     public void sum_BigIntegerArray_ReturnsCorrectSum() {
-        BigInteger[] numbers = {
-            new BigInteger("1"),
-            new BigInteger("2"),
-            null,
-            new BigInteger("3")
-        };
+        BigInteger[] numbers = {new BigInteger("1"), new BigInteger("2"), new BigInteger("3")};
         BigInteger result = Numbers.sum(numbers);
         assertEquals(new BigInteger("6"), result);
-
-        assertEquals(BigInteger.ZERO, Numbers.sum(new BigInteger[0]));
     }
 
     @Test
@@ -200,100 +192,6 @@ class NumbersTests {
         assertEquals(BigDecimal.ZERO, result);
     }
 
-    /**
-     * Test for {@link Numbers#parseShort(String, Short)}.
-     */
-    @Test
-    public void parseShort() {
-        assertEquals((short) 12345, Numbers.parseShort("12345", (short) 5));
-        assertEquals((short) 5, Numbers.parseShort("1234.5", (short) 5));
-        assertEquals((short) 5, Numbers.parseShort("", (short) 5));
-        assertEquals((short) 5, Numbers.parseShort(null, (short) 5));
-
-        assertEquals((short) 12345, Numbers.parseShort("12345", null));
-        assertNull(Numbers.parseShort("1234.5", null));
-        assertNull(Numbers.parseShort("", null));
-        assertNull(Numbers.parseShort(null, null));
-    }
-
-    /**
-     * Test for {@link Numbers#parseInteger(String, Integer)}.
-     */
-    @Test
-    public void parseInteger() {
-        assertEquals(12345, Numbers.parseInteger("12345", 5));
-        assertEquals(5, Numbers.parseInteger("1234.5", 5));
-        assertEquals(5, Numbers.parseInteger("", 5));
-        assertEquals(5, Numbers.parseInteger(null, 5));
-
-        assertEquals(12345, Numbers.parseInteger("12345", null));
-        assertNull(Numbers.parseInteger("1234.5", null));
-        assertNull(Numbers.parseInteger("", null));
-        assertNull(Numbers.parseInteger(null, null));
-    }
-
-    /**
-     * Test for {@link Numbers#parseLong(String, Long)}.
-     */
-    @Test
-    public void parseLong() {
-        assertEquals(12345L, Numbers.parseLong("12345", 5L));
-        assertEquals(5L, Numbers.parseLong("1234.5", 5L));
-        assertEquals(5L, Numbers.parseLong("", 5L));
-        assertEquals(5L, Numbers.parseLong(null, 5L));
-
-        assertEquals(12345L, Numbers.parseLong("12345", null));
-        assertNull(Numbers.parseLong("1234.5", null));
-        assertNull(Numbers.parseLong("", null));
-        assertNull(Numbers.parseLong(null, null));
-    }
-
-    /**
-     * Test for {@link Numbers#parseFloat(String, Float)}.
-     */
-    @Test
-    public void parseFloat() {
-        assertEquals(1.2345f, Numbers.parseFloat("1.2345", 5.1f));
-        assertEquals(5.0f, Numbers.parseFloat("a", 5.0f));
-        assertEquals(5.0f, Numbers.parseFloat("-001Z.2345", 5.0f));
-        assertEquals(5.0f, Numbers.parseFloat("+001AB.2345", 5.0f));
-        assertEquals(5.0f, Numbers.parseFloat("001Z.2345", 5.0f));
-        assertEquals(5.0f, Numbers.parseFloat("", 5.0f));
-        assertEquals(5.0f, Numbers.parseFloat(null, 5.0f));
-
-        assertEquals(1.2345f, Numbers.parseFloat("1.2345", null));
-        assertNull(Numbers.parseFloat("a", null));
-        assertNull(Numbers.parseFloat("-001Z.2345", null));
-        assertNull(Numbers.parseFloat("+001AB.2345", null));
-        assertNull(Numbers.parseFloat("001Z.2345", null));
-        assertNull(Numbers.parseFloat("", null));
-        assertNull(Numbers.parseFloat(null, null));
-    }
-
-    /**
-     * Test for {@link Numbers#parseDouble(String, Double)}.
-     */
-    @Test
-    public void parseDouble() {
-        assertEquals(1.2345d, Numbers.parseDouble("1.2345", 5.1d));
-        assertEquals(5.0d, Numbers.parseDouble("a", 5.0d));
-        assertEquals(1.2345d, Numbers.parseDouble("001.2345", 5.1d));
-        assertEquals(-1.2345d, Numbers.parseDouble("-001.2345", 5.1d));
-        assertEquals(1.2345d, Numbers.parseDouble("+001.2345", 5.1d));
-        assertEquals(0d, Numbers.parseDouble("000.00", 5.1d));
-        assertEquals(5.1d, Numbers.parseDouble("", 5.1d));
-        assertEquals(5.1d, Numbers.parseDouble((String) null, 5.1d));
-
-        assertEquals(1.2345d, Numbers.parseDouble("1.2345", null));
-        assertEquals(null, Numbers.parseDouble("a", null));
-        assertEquals(1.2345d, Numbers.parseDouble("001.2345", null));
-        assertEquals(-1.2345d, Numbers.parseDouble("-001.2345", null));
-        assertEquals(1.2345d, Numbers.parseDouble("+001.2345", null));
-        assertEquals(0d, Numbers.parseDouble("000.00", null));
-        assertEquals(null, Numbers.parseDouble("", null));
-        assertEquals(null, Numbers.parseDouble((String) null, null));
-    }
-
     @Test
     void test_constructor_isNotAccessible_ThrowsIllegalStateException() {
         Constructor<?>[] constructors = Numbers.class.getDeclaredConstructors();

plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/RandomToolsTests.java

@@ -21,7 +21,6 @@ import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertInstanceOf;
 import static org.junit.jupiter.api.Assertions.assertThrows;
-import static org.junit.jupiter.api.Assertions.assertTrue;
 
 import java.lang.reflect.Constructor;
 import java.security.SecureRandom;
@@ -31,8 +30,6 @@ import java.util.Random;
 import org.junit.jupiter.api.BeforeAll;
 import org.junit.jupiter.api.Test;
 
-import com.google.common.collect.Range;
-
 @SuppressWarnings("null")
 public class RandomToolsTests {
 
@@ -59,16 +56,13 @@ public class RandomToolsTests {
 
     @Test
     public void randomStr_NullSourceCharacters_ThrowsException() {
-        assertThrows(IllegalArgumentException.class,
-                () -> RandomTools.randomStr(random, (char[]) null, 5));
-        assertThrows(IllegalArgumentException.class,
-                () -> RandomTools.randomStr(random, (String) null, 5));
+        assertThrows(IllegalArgumentException.class, () -> RandomTools.randomStr(random, (char[]) null, 5));
+        assertThrows(IllegalArgumentException.class, () -> RandomTools.randomStr(random, (String) null, 5));
     }
 
     @Test
     public void randomStr_NegativeLength_ThrowsException() {
-        assertThrows(IllegalArgumentException.class,
-                () -> RandomTools.randomStr(random, sourceCharactersArray, -1));
+        assertThrows(IllegalArgumentException.class, () -> RandomTools.randomStr(random, sourceCharactersArray, -1));
     }
 
     @Test
@@ -113,50 +107,6 @@ public class RandomToolsTests {
         assertEquals(5, result.length());
     }
 
-    @Test
-    public void randomInt_WithMinAndMax() {
-        for (int i = 0; i < 1000; i++) {
-            int r = RandomTools.randomInt(random, -2, 3);
-            assertTrue(r >= -2 && r < 3);
-        }
-    }
-
-    @Test
-    public void randomInt_WithClosedOpenRange() {
-        Range<Integer> co = Range.closedOpen(-2, 3);
-        for (int i = 0; i < 1000; i++) {
-            int rco = RandomTools.randomInt(random, co);
-            assertTrue(rco >= -2 && rco < 3);
-        }
-    }
-
-    @Test
-    public void randomInt_WithClosedRange() {
-        Range<Integer> cc = Range.closed(-2, 3);
-        for (int i = 0; i < 1000; i++) {
-            int rcc = RandomTools.randomInt(random, cc);
-            assertTrue(rcc >= -2 && rcc <= 3);
-        }
-    }
-
-    @Test
-    public void randomInt_WithOpenClosedRange() {
-        Range<Integer> oc = Range.openClosed(-2, 3);
-        for (int i = 0; i < 1000; i++) {
-            int roc = RandomTools.randomInt(random, oc);
-            assertTrue(roc > -2 && roc <= 3);
-        }
-    }
-
-    @Test
-    public void randomInt_WithOpenRange() {
-        Range<Integer> oo = Range.open(-2, 3);
-        for (int i = 0; i < 1000; i++) {
-            int roo = RandomTools.randomInt(random, oo);
-            assertTrue(roo > -2 && roo < 3);
-        }
-    }
-
     @Test
     void test_constructor_isNotAccessible_ThrowsIllegalStateException() {
         Constructor<?>[] constructors = RandomTools.class.getDeclaredConstructors();

plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/ZipToolsTests.java

@@ -1,102 +0,0 @@
-/*
- * Copyright 2025 the original author or authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      https://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package xyz.zhouxy.plusone.commons.util;
-
-import static org.junit.jupiter.api.Assertions.assertArrayEquals;
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertFalse;
-import static org.junit.jupiter.api.Assertions.assertInstanceOf;
-import static org.junit.jupiter.api.Assertions.assertNull;
-import static org.junit.jupiter.api.Assertions.assertThrows;
-
-import java.io.IOException;
-import java.lang.reflect.Constructor;
-import java.net.URL;
-import java.util.Arrays;
-import java.util.Random;
-import java.util.zip.DataFormatException;
-
-import org.junit.jupiter.api.BeforeAll;
-import org.junit.jupiter.api.Test;
-import org.junit.jupiter.params.ParameterizedTest;
-import org.junit.jupiter.params.provider.ValueSource;
-
-import com.google.common.base.Stopwatch;
-import com.google.common.io.Resources;
-
-import lombok.extern.slf4j.Slf4j;
-
-@Slf4j
-public class ZipToolsTests {
-
-    static byte[] bytes;
-
-    @BeforeAll
-    static void setup() throws IOException {
-        URL resource = Resources.getResource("xyz/zhouxy/plusone/commons/util/LoremIpsum.txt");
-        bytes = Resources.toByteArray(resource);
-    }
-
-    @Test
-    void zip_WithDefaultLevel() throws IOException, DataFormatException {
-        Stopwatch stopwatch = Stopwatch.createStarted();
-        byte[] zip = ZipTools.zip(bytes);
-        stopwatch.stop();
-        log.info("default level, size: {} ({})", zip.length, stopwatch);
-        assertArrayEquals(bytes, ZipTools.unzip(zip));
-
-        assertNull(ZipTools.zip(null));
-        assertNull(ZipTools.unzip(null));
-    }
-
-    @ParameterizedTest
-    @ValueSource(ints = { -1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 })
-    void zip_WithLevel(int level) throws IOException, DataFormatException {
-        Stopwatch stopwatch = Stopwatch.createStarted();
-        byte[] zip = ZipTools.zip(bytes, level);
-        stopwatch.stop();
-        log.info("level: {}, size: {} ({})", level, zip.length, stopwatch);
-        assertArrayEquals(bytes, ZipTools.unzip(zip));
-
-        assertNull(ZipTools.zip(null, level));
-        assertNull(ZipTools.unzip(null));
-    }
-
-    @Test
-    void zip_WithWrongLevel() {
-        Random random = new Random();
-        final int levelGtMax = random.nextInt() + 9;
-        assertThrows(IllegalArgumentException.class, () -> ZipTools.zip(bytes, levelGtMax));
-
-        final int levelLtMin = -1 - random.nextInt();
-        assertThrows(IllegalArgumentException.class, () -> ZipTools.zip(bytes, levelLtMin));
-    }
-
-    @Test
-    void test_constructor_isNotAccessible_ThrowsIllegalStateException() {
-        Constructor<?>[] constructors = ZipTools.class.getDeclaredConstructors();
-        Arrays.stream(constructors)
-                .forEach(constructor -> {
-                    assertFalse(constructor.isAccessible());
-                    constructor.setAccessible(true);
-                    Throwable cause = assertThrows(Exception.class, constructor::newInstance)
-                            .getCause();
-                    assertInstanceOf(IllegalStateException.class, cause);
-                    assertEquals("Utility class", cause.getMessage());
-                });
-    }
-}