release: 1.1.0-RC1

docs: 修改 javadoc 中的格式错误
feat(gson): 添加 Gson 适配器以支持 JSR-310 中常用的类
2025-06-08 13:38:03 +08:00 · 2025-06-08 13:08:45 +08:00 · 2025-06-07 01:02:15 +08:00 · 2025-06-07 00:56:11 +08:00 · 2025-06-07 00:22:04 +08:00 · 2025-06-06 19:13:52 +08:00
110 changed files with 1210 additions and 533 deletions
--- a/README.md
+++ b/README.md
@@ -73,7 +73,7 @@ System.out.println(result); // Output: Return string

 异常实现 `MultiTypesException` 的 `MultiTypesException#getType` 方法，返回对应的场景类型。

-表示场景类型的枚举实现 `MultiTypesException.ExceptionType`，其中的工厂方法用于创建类型对象。
+表示场景类型的枚举实现 `MultiTypesException.ExceptionType`，其中的工厂方法用于创建对应类型的异常。
 ```java
 public final class LoginException
        extends RuntimeException
--- a/cspell.json
+++ b/cspell.json
@@ -1,7 +1,7 @@
 {
    "version": "0.2",
    "ignorePaths": [
-        "src/test"
+        "*/src/test"
    ],
    "dictionaryDefinitions": [],
    "dictionaries": [],
@@ -14,25 +14,31 @@
        "cspell",
        "databind",
        "datasource",
+        "dbutils",
        "fasterxml",
        "findbugs",
        "gson",
        "Hikari",
        "hutool",
+        "jasypt",
+        "jbcrypt",
        "Jdbc",
        "joda",
        "logback",
        "mapstruct",
+        "mindrot",
        "Multimap",
        "Multiset",
        "mybatis",
        "Nonnull",
        "NOSONAR",
        "okhttp",
+        "ooxml",
        "overriden",
        "plusone",
        "println",
        "projectlombok",
+        "querydsl",
        "regexs",
        "Seata",
        "sonarlint",
--- a/plusone-commons/pom.xml
+++ b/plusone-commons/pom.xml
@@ -0,0 +1,124 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <parent>
+        <groupId>xyz.zhouxy.plusone</groupId>
+        <artifactId>plusone-parent</artifactId>
+        <version>1.1.0-RC1</version>
+    </parent>
+
+    <artifactId>plusone-commons</artifactId>
+
+    <description>
+        常见工具集，结合 guava 使用。
+    </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>
+    </properties>
+
+    <dependencyManagement>
+        <dependencies>
+            <dependency>
+                <groupId>xyz.zhouxy.plusone</groupId>
+                <artifactId>plusone-dependencies</artifactId>
+                <version>1.1.0-RC1</version>
+                <type>pom</type>
+                <scope>import</scope>
+            </dependency>
+        </dependencies>
+    </dependencyManagement>
+
+    <dependencies>
+
+        <!-- ========== Compile Dependencies ========== -->
+
+        <dependency>
+            <groupId>com.google.code.findbugs</groupId>
+            <artifactId>jsr305</artifactId>
+        </dependency>
+
+        <dependency>
+            <groupId>com.google.guava</groupId>
+            <artifactId>guava</artifactId>
+        </dependency>
+
+        <dependency>
+            <groupId>joda-time</groupId>
+            <artifactId>joda-time</artifactId>
+            <optional>true</optional>
+        </dependency>
+
+        <!-- Gson -->
+        <dependency>
+            <groupId>com.google.code.gson</groupId>
+            <artifactId>gson</artifactId>
+            <optional>true</optional>
+        </dependency>
+
+        <!-- ========== Test Dependencies ========== -->
+
+        <dependency>
+            <groupId>org.apache.commons</groupId>
+            <artifactId>commons-lang3</artifactId>
+            <scope>test</scope>
+        </dependency>
+
+        <dependency>
+            <groupId>ch.qos.logback</groupId>
+            <artifactId>logback-classic</artifactId>
+            <scope>test</scope>
+        </dependency>
+
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter</artifactId>
+            <scope>test</scope>
+        </dependency>
+
+        <dependency>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+            <optional>true</optional>
+            <scope>test</scope>
+        </dependency>
+
+        <dependency>
+            <groupId>cn.hutool</groupId>
+            <artifactId>hutool-core</artifactId>
+            <scope>test</scope>
+        </dependency>
+
+        <dependency>
+            <groupId>org.mybatis</groupId>
+            <artifactId>mybatis</artifactId>
+            <scope>test</scope>
+        </dependency>
+
+        <dependency>
+            <groupId>com.h2database</groupId>
+            <artifactId>h2</artifactId>
+            <scope>test</scope>
+        </dependency>
+
+        <!-- Jackson -->
+        <dependency>
+            <groupId>com.fasterxml.jackson.core</groupId>
+            <artifactId>jackson-databind</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.fasterxml.jackson.datatype</groupId>
+            <artifactId>jackson-datatype-jsr310</artifactId>
+            <scope>test</scope>
+        </dependency>
+
+    </dependencies>
+
+</project>
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/annotation/ReaderMethod.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/annotation/ReaderMethod.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/annotation/StaticFactoryMethod.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/annotation/StaticFactoryMethod.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/annotation/UnsupportedOperation.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/annotation/UnsupportedOperation.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/annotation/ValueObject.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/annotation/ValueObject.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/annotation/Virtual.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/annotation/Virtual.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/annotation/WriterMethod.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/annotation/WriterMethod.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/annotation/package-info.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/annotation/package-info.java
@@ -24,17 +24,15 @@
 * 标识<b>静态工厂方法</b>。
 * 《Effective Java》的 Item1 建议考虑用静态工厂方法替换构造器，
 * 因而考虑有一个注解可以标记一下静态工厂方法，以和其它方法进行区分。
- * </p>
 *
 * <h3>
 * 2. {@link ReaderMethod} 和 {@link WriterMethod}
 * </h3>
 * <p>
 * 分别标识<b>读方法</b>（如 getter）或<b>写方法</b>（如 setter）。
- * </p>
+ *
 * <p>
 * 最早是写了一个集合类，为了方便判断使用读写锁时，哪些情况下使用读锁，哪些情况下使用写锁。
- * </p>
 *
 * <h3>
 * 3. {@link UnsupportedOperation}
@@ -42,22 +40,19 @@
 * <p>
 * 标识该方法不被支持或没有实现，将抛出 {@link UnsupportedOperationException}。
 * 为了方便在使用时，不需要点进源码，就能知道该方法没有实现。
- * </p>
 *
 * <h3>
 * 4. {@link Virtual}
 * </h3>
 * <p>
- * Java 非 final 的实例方法，对应 C++/C# 中的虚方法，允许被子类覆写。
+ * Java 非 final 的实例方法，对应 C++/C&num; 中的虚方法，允许被子类覆写。
 * {@link Virtual} 注解旨在设计父类时，强调该方法父类虽然有默认实现，但子类可以根据自己的需要覆写。
- * </p>
 *
 * <h3>
 * 5. {@link ValueObject}
 * </h3>
 * <p>
 * 标记一个类，表示其作为值对象，区别于 Entity。
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 */
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/base/IWithCode.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/base/IWithCode.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/base/IWithIntCode.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/base/IWithIntCode.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/base/IWithLongCode.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/base/IWithLongCode.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/base/Ref.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/base/Ref.java
@@ -27,7 +27,7 @@ import javax.annotation.Nullable;
 /**
 * {@link Ref} 包装了一个值，表示对该值的应用。
 *
- * <p>灵感来自于 C# 的 {@value ref} 参数修饰符。C# 允许通过以下方式，将值返回给调用端：</p>
+ * <p>灵感来自于 C&num; 的 {@code ref} 参数修饰符。C&num; 允许通过以下方式，将值返回给调用端：</p>
 * <pre>
 * void Method(ref int refArgument)
 * {
@@ -51,7 +51,7 @@ import javax.annotation.Nullable;
 * <p>
 * 当一个方法需要产生多个结果时，无法有多个返回值，可以使用 {@link Ref} 作为参数传入，方法内部修改 {@link Ref} 的值。
 * 调用方在调用方法之后，使用 {@code getValue()} 获取结果。
- * </p>
+ *
 * <pre>
 * String method(final Ref&lt;Integer&gt; intRefArgument, final Ref&lt;String&gt; strRefArgument) {
 *     intRefArgument.transformValue(i -&gt; i + 44);
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/base/package-info.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/base/package-info.java
@@ -20,8 +20,8 @@
 * <h3>1. Ref</h3>
 * <p>
 * {@link Ref} 包装了一个值，表示对该值的应用。
- * </p>
- * <p>灵感来自于 C# 的 {@value ref} 参数修饰符。C# 允许通过以下方式，将值返回给调用端：</p>
+ *
+ * <p>灵感来自于 C&num; 的 {@code ref} 参数修饰符。C&num; 允许通过以下方式，将值返回给调用端：</p>
 * <pre>
 * void Method(ref int refArgument)
 * {
@@ -45,7 +45,7 @@
 * <p>
 * 当一个方法需要产生多个结果时，无法有多个返回值，可以使用 {@link Ref} 作为参数传入，方法内部修改 {@link Ref} 的值。
 * 调用方在调用方法之后，使用 {@code getValue()} 获取结果。
- * </p>
+ *
 * <pre>
 * String method(Ref&lt;Integer&gt; intRefArgument, Ref&lt;String&gt; strRefArgument) {
 *     intRefArgument.transformValue(i -&gt; i + 44);
@@ -65,7 +65,6 @@
 * <p>
 * 类似于枚举这样的类型，通常需要设置固定的码值表示对应的含义。
 * 可实现 {@link IWithCode}、{@link IWithIntCode}、{@link IWithLongCode}，便于在需要的地方对这些接口的实现进行处理。
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 */
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/collection/CollectionTools.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/collection/CollectionTools.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/collection/package-info.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/collection/package-info.java
@@ -15,7 +15,7 @@
 */

 /**
- * <h2>集合<h2>
+ * <h2>集合</h2>
 *
 * <h3>
 * 1. {@link CollectionTools}
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/constant/PatternConsts.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/constant/PatternConsts.java
@@ -31,7 +31,7 @@ public final class PatternConsts {
     * yyyyMMdd
     *
     * @see RegexConsts#BASIC_ISO_DATE
-     * </p>
+     *
     */
    public static final Pattern BASIC_ISO_DATE = Pattern.compile(RegexConsts.BASIC_ISO_DATE);

--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/constant/RegexConsts.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/constant/RegexConsts.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/constant/package-info.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/constant/package-info.java
@@ -15,7 +15,7 @@
 */

 /**
- * <h2>常量<h2>
+ * <h2>常量</h2>
 *
 * <h3>
 * 1. 正则常量
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/DataNotExistsException.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/DataNotExistsException.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/MultiTypesException.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/MultiTypesException.java
@@ -24,13 +24,12 @@ import xyz.zhouxy.plusone.commons.base.IWithCode;
 *
 * <p>
 * 异常在不同场景下被抛出，可以用不同的枚举值，表示不同的场景类型。
- * </p>
+ *
 * <p>
 * 异常实现 {@link MultiTypesException} 的 {@link #getType} 方法，返回对应的场景类型。
- * </p>
+ *
 * <p>
- * 表示场景类型的枚举实现 {@link ExceptionType}，其中的工厂方法用于创建类型对象。
- * </p>
+ * 表示场景类型的枚举实现 {@link ExceptionType}，其中的工厂方法用于创建对应类型的异常。
 *
 * <pre>
 * public final class LoginException
@@ -61,7 +60,7 @@ import xyz.zhouxy.plusone.commons.base.IWithCode;
 *
 *     // ...
 *
- *     public enum Type implements ExceptionType<LoginException> {
+ *     public enum Type implements ExceptionType&lt;LoginException&gt; {
 *         DEFAULT("00", "当前会话未登录"),
 *         NOT_TOKEN("10", "未提供token"),
 *         INVALID_TOKEN("20", "token无效"),
@@ -117,7 +116,6 @@ import xyz.zhouxy.plusone.commons.base.IWithCode;
 * <pre>
 * throw LoginException.Type.TOKEN_TIMEOUT.create();
 * </pre>
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 * @since 1.0.0
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/ParsingFailureException.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/ParsingFailureException.java
@@ -33,7 +33,6 @@ import xyz.zhouxy.plusone.commons.exception.MultiTypesException.ExceptionType;
 * <pre>
 * throw new RequestParamsException(ParsingFailureException.of(ParsingFailureException.Type.NUMBER_PARSING_FAILURE));
 * </pre>
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 * @since 1.0.0
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/business/BizException.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/business/BizException.java
@@ -21,11 +21,10 @@ package xyz.zhouxy.plusone.commons.exception.business;
 *
 * <p>
 * 业务异常
- * </p>
 *
 * <p>
 * <b>NOTE: 通常表示业务中的意外情况。如：用户错误输入、缺失必填字段、用户余额不足等。</b>
- * </p>
+ *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 * @since 1.0.0
 */
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/business/InvalidInputException.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/business/InvalidInputException.java
@@ -26,11 +26,10 @@ import xyz.zhouxy.plusone.commons.exception.MultiTypesException;
 *
 * <p>
 * 用户输入内容非法
- * </p>
 *
 * <p>
 * <b>NOTE: 属业务异常</b>
- * </p>
+ *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 * @since 1.0.0
 */
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/business/RequestParamsException.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/business/RequestParamsException.java
@@ -21,7 +21,6 @@ package xyz.zhouxy.plusone.commons.exception.business;
 *
 * <p>
 * 用户请求参数错误
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 * @since 1.0.0
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/business/package-info.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/business/package-info.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/package-info.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/package-info.java
@@ -15,18 +15,17 @@
 */

 /**
- * <h2>异常<h2>
+ * <h2>异常</h2>
 *
 * <h3>1. {@link MultiTypesException} - 多类型异常</h3>
 * <p>
 * 异常在不同场景下被抛出，可以用不同的枚举值，表示不同的场景类型。
- * </p>
+ *
 * <p>
 * 异常实现 {@link MultiTypesException} 的 {@link MultiTypesException#getType} 方法，返回对应的场景类型。
- * </p>
+ *
 * <p>
- * 表示场景类型的枚举实现 {@link MultiTypesException.ExceptionType}，其中的工厂方法用于创建类型对象。
- * </p>
+ * 表示场景类型的枚举实现 {@link MultiTypesException.ExceptionType}，其中的工厂方法用于创建对应类型的异常。
 *
 * <pre>
 * public final class LoginException
@@ -57,7 +56,7 @@
 *
 *     // ...
 *
- *     public enum Type implements ExceptionType<LoginException> {
+ *     public enum Type implements ExceptionType&lt;LoginException&gt; {
 *         DEFAULT("00", "当前会话未登录"),
 *         NOT_TOKEN("10", "未提供token"),
 *         INVALID_TOKEN("20", "token无效"),
@@ -113,7 +112,6 @@
 * <pre>
 * throw LoginException.Type.TOKEN_TIMEOUT.create();
 * </pre>
- * </p>
 *
 * <h3>2. 业务异常</h3>
 * 预设常见的业务异常。可继承 {@link BizException} 自定义业务异常。
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/system/DataOperationResultException.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/system/DataOperationResultException.java
@@ -21,55 +21,60 @@ package xyz.zhouxy.plusone.commons.exception.system;
 *
 * <p>
 * 当数据操作的结果不符合预期时抛出。
- * </p>
 *
 * <p>
 * 比如当一个 insert 或 update 操作时，预计影响数据库中的一行数据，但结果却影响了零条数据或多条数据，
 * 当出现这种始料未及的诡异情况时，抛出 {@link DataOperationResultException} 并回滚事务。
 * 后续需要排查原因。
- * </p>
+ *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 * @since 1.0.0
 */
 public final class DataOperationResultException extends SysException {

-    private static final String DEFAULT_MSG = "数据操作的结果不符合预期";
+    private final long expected;
+    private final long actual;

    /**
-     * 使用默认 message 构造新的 {@code DataOperationResultException}。
-     * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
+     * 创建一个 {@code DataOperationResultException} 对象
+     *
+     * @param expected 预期影响的行数
+     * @param actual 实际影响的行数
     */
-    public DataOperationResultException() {
-        super(DEFAULT_MSG);
+    public DataOperationResultException(long expected, long actual) {
+        super(String.format("The number of rows affected is expected to be %d, but is: %d", expected, actual));
+        this.expected = expected;
+        this.actual = actual;
    }

    /**
-     * 使用指定的 {@code message} 构造新的 {@code DataOperationResultException}。
-     * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
+     * 创建一个 {@code DataOperationResultException} 对象
     *
-     * @param message 异常信息
+     * @param expected 预期影响的行数
+     * @param actual 实际影响的行数
+     * @param message 错误信息
     */
-    public DataOperationResultException(String message) {
+    public DataOperationResultException(long expected, long actual, String message) {
        super(message);
+        this.expected = expected;
+        this.actual = actual;
    }

    /**
-     * 使用指定的 {@code cause} 构造新的 {@code DataOperationResultException}。
-     * {@code message} 为 (cause==null ? null : cause.toString())。
+     * 预期影响的行数
     *
-     * @param cause 包装的异常
+     * @return the expected
     */
-    public DataOperationResultException(Throwable cause) {
-        super(cause);
+    public long getExpected() {
+        return expected;
    }

    /**
-     * 使用指定的 {@code message} 和 {@code cause} 构造新的 {@code DataOperationResultException}。
+     * 实际影响的行数
     *
-     * @param message 异常信息
-     * @param cause   包装的异常
+     * @return the actual
     */
-    public DataOperationResultException(String message, Throwable cause) {
-        super(message, cause);
+    public long getActual() {
+        return actual;
    }
 }
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/system/NoAvailableMacFoundException.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/system/NoAvailableMacFoundException.java
@@ -21,7 +21,6 @@ package xyz.zhouxy.plusone.commons.exception.system;
 *
 * <p>
 * 在无法找到可访问的 Mac 地址时抛出
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 * @since 1.0.0
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/system/SysException.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/system/SysException.java
@@ -21,7 +21,6 @@ package xyz.zhouxy.plusone.commons.exception.system;
 *
 * <p>
 * 通常表示应用代码存在问题，或因环境问题，引发异常。
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 * @since 1.0.0
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/system/package-info.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/system/package-info.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/BoolUnaryOperator.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/BoolUnaryOperator.java
@@ -24,7 +24,6 @@ import com.google.common.annotations.Beta;
 * <p>
 * 一个特殊的 {@link java.util.function.UnaryOperator}。
 * 表示对 {@code boolean} 值的一元操作。
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 * @since 1.0.0
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/CharUnaryOperator.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/CharUnaryOperator.java
@@ -24,7 +24,6 @@ import com.google.common.annotations.Beta;
 * <p>
 * 一个特殊的 {@link java.util.function.UnaryOperator}。
 * 表示对 {@code char} 的一元操作。
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 * @since 1.0.0
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/Executable.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/Executable.java
@@ -21,7 +21,6 @@ package xyz.zhouxy.plusone.commons.function;
 *
 * <p>
 * 表示一个无入参无返回值的操作，可抛出异常。
- * </p>
 *
 * @param <E> 可抛出的异常类型
 *
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/OptionalSupplier.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/OptionalSupplier.java
@@ -24,7 +24,6 @@ import java.util.function.Supplier;
 *
 * <p>
 * 返回 {@code Optional&lt;T&gt;} 对象。
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 * @since 1.0.0
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/PredicateTools.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/PredicateTools.java
@@ -23,7 +23,6 @@ import java.util.function.Predicate;
 *
 * <p>
 * {@link Predicate} 相关操作。
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 * @since 1.0.0
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/ThrowingConsumer.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/ThrowingConsumer.java
@@ -21,7 +21,6 @@ package xyz.zhouxy.plusone.commons.function;
 *
 * <p>
 * 允许抛出异常的消费操作。是一个特殊的 {@link java.util.function.Consumer}。
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 * @since 1.0.0
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/ThrowingFunction.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/ThrowingFunction.java
@@ -20,7 +20,6 @@ package xyz.zhouxy.plusone.commons.function;
 *
 * <p>
 * 接收一个参数，并返回一个结果，可以抛出异常。
- * </p>
 *
 * @param <T> 入参类型
 * @param <R> 返回结果类型
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/ThrowingPredicate.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/ThrowingPredicate.java
@@ -21,7 +21,6 @@ package xyz.zhouxy.plusone.commons.function;
 *
 * <p>
 * 接收一个参数，返回一个布尔值，可抛出异常。
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 * @since 1.0.0
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/ThrowingSupplier.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/ThrowingSupplier.java
@@ -21,7 +21,6 @@ package xyz.zhouxy.plusone.commons.function;
 *
 * <p>
 * 允许抛出异常的 Supplier 接口。
- * </p>
 *
 * @param <T> 结果类型
 * @param <E> 异常类型
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/ToOptionalBiFunction.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/ToOptionalBiFunction.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/ToOptionalFunction.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/ToOptionalFunction.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/package-info.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/function/package-info.java
@@ -20,7 +20,6 @@
 * <h3>1. PredicateTools</h3>
 * <p>
 * {@link PredicateTools} 用于 {@link java.util.function.Predicate} 的相关操作。
- * </p>
 *
 * <h3>2. Functional interfaces</h3>
 * <p>
@@ -39,7 +38,6 @@
 * | Optional      | ToOptionalBiFunction | Optional&lt;R&gt; apply(T,U)           |
 * | Optional      | ToOptionalFunction   | Optional&lt;R&gt; apply(T)             |
 * </pre>
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 */
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/gson/adapter/JSR310TypeAdapters.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/gson/adapter/JSR310TypeAdapters.java
@@ -0,0 +1,187 @@
+/*
+ * 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.gson.adapter;
+
+import java.io.IOException;
+import java.time.Instant;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.ZonedDateTime;
+import java.time.format.DateTimeFormatter;
+
+import com.google.gson.TypeAdapter;
+import com.google.gson.stream.JsonReader;
+import com.google.gson.stream.JsonWriter;
+
+import xyz.zhouxy.plusone.commons.util.AssertTools;
+
+/**
+ * 包含 JSR-310 相关数据类型的 {@code TypeAdapter}
+ *
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
+ * @since 1.1.0
+ * @see TypeAdapter
+ * @see com.google.gson.GsonBuilder
+ */
+public class JSR310TypeAdapters {
+
+    /**
+     * {@code LocalDate} 的 {@code TypeAdapter}，
+     * 用于 Gson 对 {@code LocalDate} 进行相互转换。
+     */
+    public static final class LocalDateTypeAdapter extends TypeAdapter<LocalDate> {
+
+        private final DateTimeFormatter dateTimeFormatter;
+
+        /**
+         * 默认构造函数，
+         * 使用 {@link DateTimeFormatter#ISO_LOCAL_DATE} 进行 {@link LocalDate} 的序列化与反序列化。
+         */
+        public LocalDateTypeAdapter() {
+            this.dateTimeFormatter = DateTimeFormatter.ISO_LOCAL_DATE;
+        }
+
+        /**
+         * 构造函数，
+         * 使用传入的 {@link DateTimeFormatter} 进行 {@link LocalDate} 的序列化与反序列化。
+         *
+         * @param formatter 用于序列化 {@link LocalDate} 的格式化器，不可为 {@code null}。
+         */
+        public LocalDateTypeAdapter(DateTimeFormatter formatter) {
+            AssertTools.checkArgumentNotNull(formatter, "formatter can not be null.");
+            this.dateTimeFormatter = formatter;
+        }
+
+        /** {@inheritDoc} */
+        @Override
+        public void write(JsonWriter out, LocalDate value) throws IOException {
+            out.value(dateTimeFormatter.format(value));
+        }
+
+        /** {@inheritDoc} */
+        @Override
+        public LocalDate read(JsonReader in) throws IOException {
+            return LocalDate.parse(in.nextString(), dateTimeFormatter);
+        }
+    }
+
+    /**
+     * {@code LocalDateTime} 的 {@code TypeAdapter}，
+     * 用于 Gson 对 {@code LocalDateTime} 进行相互转换。
+     */
+    public static final class LocalDateTimeTypeAdapter extends TypeAdapter<LocalDateTime> {
+
+        private final DateTimeFormatter dateTimeFormatter;
+
+        /**
+         * 默认构造函数，
+         * 使用 {@link DateTimeFormatter#ISO_LOCAL_DATE_TIME} 进行 {@link LocalDateTime} 的序列化与反序列化。
+         */
+        public LocalDateTimeTypeAdapter() {
+            this.dateTimeFormatter = DateTimeFormatter.ISO_LOCAL_DATE_TIME;
+        }
+
+        /**
+         * 构造函数，
+         * 使用传入的 {@link DateTimeFormatter} 进行 {@link LocalDateTime} 的序列化与反序列化。
+         *
+         * @param formatter 用于序列化 {@link LocalDateTime} 的格式化器，不可为 {@code null}。
+         */
+        public LocalDateTimeTypeAdapter(DateTimeFormatter formatter) {
+            AssertTools.checkArgumentNotNull(formatter, "formatter can not be null.");
+            this.dateTimeFormatter = formatter;
+        }
+
+        /** {@inheritDoc} */
+        @Override
+        public void write(JsonWriter out, LocalDateTime value) throws IOException {
+            out.value(dateTimeFormatter.format(value));
+        }
+
+        /** {@inheritDoc} */
+        @Override
+        public LocalDateTime read(JsonReader in) throws IOException {
+            return LocalDateTime.parse(in.nextString(), dateTimeFormatter);
+        }
+    }
+
+    /**
+     * {@code ZonedDateTime} 的 {@code TypeAdapter}，
+     * 用于 Gson 对 {@code ZonedDateTime} 进行相互转换。
+     */
+    public static final class ZonedDateTimeTypeAdapter extends TypeAdapter<ZonedDateTime> {
+
+        private final DateTimeFormatter dateTimeFormatter;
+
+        /**
+         * 默认构造函数，
+         * 使用 {@link DateTimeFormatter#ISO_ZONED_DATE_TIME} 进行 {@link ZonedDateTime} 的序列化与反序列化。
+         */
+        public ZonedDateTimeTypeAdapter() {
+            this.dateTimeFormatter = DateTimeFormatter.ISO_ZONED_DATE_TIME;
+        }
+
+        /**
+         * 构造函数，
+         * 使用传入的 {@link DateTimeFormatter} 进行 {@link ZonedDateTime} 的序列化与反序列化。
+         *
+         * @param formatter 用于序列化 {@link ZonedDateTime} 的格式化器，不可为 {@code null}。
+         */
+        public ZonedDateTimeTypeAdapter(DateTimeFormatter formatter) {
+            AssertTools.checkArgumentNotNull(formatter, "formatter can not be null.");
+            this.dateTimeFormatter = formatter;
+        }
+
+        /** {@inheritDoc} */
+        @Override
+        public void write(JsonWriter out, ZonedDateTime value) throws IOException {
+            out.value(dateTimeFormatter.format(value));
+        }
+
+        /** {@inheritDoc} */
+        @Override
+        public ZonedDateTime read(JsonReader in) throws IOException {
+            return ZonedDateTime.parse(in.nextString(), dateTimeFormatter);
+        }
+    }
+
+    /**
+    * {@code Instant} 的 {@code TypeAdapter}，
+    * 用于 Gson 对 {@code Instant} 进行相互转换。
+    *
+    * <p>
+    * 使用 {@link DateTimeFormatter#ISO_INSTANT} 进行 {@link Instant} 的序列化与反序列化。
+    *
+    */
+    public static final class InstantTypeAdapter extends TypeAdapter<Instant> {
+
+        /** {@inheritDoc} */
+        @Override
+        public void write(JsonWriter out, Instant value) throws IOException {
+            out.value(DateTimeFormatter.ISO_INSTANT.format(value));
+        }
+
+        /** {@inheritDoc} */
+        @Override
+        public Instant read(JsonReader in) throws IOException {
+            return Instant.parse(in.nextString());
+        }
+    }
+
+    private JSR310TypeAdapters() {
+        throw new IllegalStateException("Utility class");
+    }
+}
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/gson/adapter/package-info.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/gson/adapter/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * 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.
+ */
+
+/**
+ * Gson 相关类型适配器
+ */
+package xyz.zhouxy.plusone.commons.gson.adapter;
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/gson/package-info.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/gson/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * 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.
+ */
+
+/**
+ * Gson 相关辅助工具
+ */
+package xyz.zhouxy.plusone.commons.gson;
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/Chinese2ndGenIDCardNumber.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/Chinese2ndGenIDCardNumber.java
@@ -40,7 +40,6 @@ import xyz.zhouxy.plusone.commons.util.StringTools;
 *
 * <p>
 * 中国第二代居民身份证号
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 * @since 1.0.0
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/Gender.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/Gender.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/IDCardNumber.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/IDCardNumber.java
@@ -23,6 +23,8 @@ import xyz.zhouxy.plusone.commons.util.StringTools;

 /**
 * 身份证号
+ *
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 */
 public interface IDCardNumber {

--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/ValidatableStringRecord.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/ValidatableStringRecord.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/dto/PageResult.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/dto/PageResult.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/dto/PagingAndSortingQueryParams.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/dto/PagingAndSortingQueryParams.java
@@ -37,9 +37,9 @@ import xyz.zhouxy.plusone.commons.util.StringTools;
 * <p>
 * 根据传入的 {@code size} 和 {@code pageNum}，
 * 提供 {@code getOffset} 方法计算 SQL 语句中 {@code offset} 的值。
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
+ * @see PagingParams
 * @see PageResult
 */
 public class PagingAndSortingQueryParams {
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/dto/PagingParams.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/dto/PagingParams.java
@@ -21,6 +21,12 @@ import java.util.List;

 import xyz.zhouxy.plusone.commons.model.dto.PagingAndSortingQueryParams.SortableProperty;

+/**
+ * 分页参数
+ *
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
+ * @see PagingAndSortingQueryParams
+ */
 public class PagingParams {

    /** 每页大小 */
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/dto/UnifiedResponse.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/dto/UnifiedResponse.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/dto/UnifiedResponses.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/dto/UnifiedResponses.java
@@ -40,7 +40,7 @@ public class UnifiedResponses {
     * @return {@code UnifiedResponse} 对象。
     *         {@code code} = "2000000", {@code message} = "SUCCESS", {@code data} = null
     */
-    public static UnifiedResponse<Void> success() {
+    public static <T> UnifiedResponse<T> success() {
        return new UnifiedResponse<>(SUCCESS_CODE, DEFAULT_SUCCESS_MSG);
    }

@@ -51,7 +51,7 @@ public class UnifiedResponses {
     * @return {@code UnifiedResponse} 对象。
     *         {@code code} = "2000000", {@code data} = null
     */
-    public static UnifiedResponse<Void> success(@Nullable String message) {
+    public static <T> UnifiedResponse<T> success(@Nullable String message) {
        return new UnifiedResponse<>(SUCCESS_CODE, message);
    }

@@ -83,7 +83,7 @@ public class UnifiedResponses {
     * @param message 错误信息
     * @return {@code UnifiedResponse} 对象（{@code data} 为 {@code null}）
     */
-    public static UnifiedResponse<Void> error(String code, @Nullable String message) {
+    public static <T> UnifiedResponse<T> error(String code, @Nullable String message) {
        return new UnifiedResponse<>(code, message);
    }

@@ -109,7 +109,7 @@ public class UnifiedResponses {
     *         {@code message} 为异常的 {@code message}，
     *         {@code data} 为 {@code null}。
     */
-    public static UnifiedResponse<Void> error(String code, Throwable e) {
+    public static <T> UnifiedResponse<T> error(String code, Throwable e) {
        return new UnifiedResponse<>(code, e.getMessage());
    }

@@ -128,7 +128,7 @@ public class UnifiedResponses {
     * @param message 响应信息
     * @return {@code UnifiedResponse} 对象（{@code data} 为 {@code null}）
     */
-    public static UnifiedResponse<Void> of(String code, @Nullable String message) {
+    public static <T> UnifiedResponse<T> of(String code, @Nullable String message) {
        return new UnifiedResponse<>(code, message);
    }

--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/dto/package-info.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/dto/package-info.java
@@ -22,12 +22,12 @@
 * 分页组件由 {@link PagingAndSortingQueryParams} 作为入参，
 * 因为分页必须伴随着排序，不然可能出现同一个对象重复出现在不同页，有的对象不被查询到的情况，
 * 所以分页查询的入参必须包含排序条件。
- * </p>
+ *
 * <p>
 * 用户可继承 {@link PagingAndSortingQueryParams}
 * 构建自己的分页查询入参，需在构造器中调用 {@link PagingAndSortingQueryParams} 的构造器，传入一个 Map 作为白名单，
 * key 是供前端指定用于排序的属性名，value 是对应数据库中的字段名，只有在白名单中指定的属性名才允许作为排序条件。
- * </p>
+ *
 * <p>
 * {@link PagingAndSortingQueryParams} 包含三个主要的属性：
 * <ul>
@@ -37,21 +37,20 @@
 * </ul>
 * 其中 orderBy 是一个 List，可以指定多个排序条件，每个排序条件是一个字符串，
 * 格式为“属性名-ASC”或“属性名-DESC”，分别表示升序和降序。
- * </p>
+ *
 * <p>
 * 比如前端传入的 orderBy 为 ["name-ASC","age-DESC"]，意味着要按 name 进行升序，name 相同的情况下则按 age 进行降序。
- * </p>
+ *
 * <p>
 * 使用时调用 {@link PagingAndSortingQueryParams#buildPagingParams()} 方法获取分页参数 {@link PagingParams}。
- * </p>
+ *
 * <p>
 * 分页结果可以存放到 {@link PageResult} 中，作为出参。
- * </p>
 *
 * <h3>2. {@link UnifiedResponse}</h3>
 * <p>
 * {@link UnifiedResponse} 对返回给前端的数据进行封装，包含 code、message、data。
- * </p>
+ *
 * <p>
 * 可使用 {@link UnifiedResponses} 快速构建 {@link UnifiedResponse} 对象。
 * {@link UnifiedResponses} 默认的成功代码为 "2000000"，
@@ -60,7 +59,6 @@
 * 中所示范的，继承 {@link UnifiedResponses} 实现自己的工厂类，
 * 自定义 SUCCESS_CODE 和 DEFAULT_SUCCESS_MSG 和工厂方法。
 * 见 <a href="http://zhouxy.xyz:3000/plusone/plusone-commons/issues/22">issue#22</a>。
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 */
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/package-info.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/package-info.java
@@ -18,7 +18,6 @@
 * <h2>业务建模组件</h2>
 * <p>
 * 包含业务建模可能用到的性别、身份证等元素，也包含 DTO 相关类，如分页查询参数，响应结果，分页结果等。
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 */
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/time/Quarter.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/time/Quarter.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/time/YearQuarter.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/time/YearQuarter.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/time/package-info.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/time/package-info.java
@@ -15,7 +15,7 @@
 */

 /**
- * <h2>时间 API<h2>
+ * <h2>时间 API</h2>
 *
 * <h3>1. 季度 API</h3>
 *
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/ArrayTools.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/ArrayTools.java
@@ -33,7 +33,6 @@ import javax.annotation.Nullable;
 *
 * <p>
 * 数组工具类
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 * @since 1.0.0
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/AssertTools.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/AssertTools.java
@@ -29,7 +29,6 @@ import xyz.zhouxy.plusone.commons.exception.system.DataOperationResultException;
 *
 * <p>
 * 本工具类不封装过多判断逻辑，鼓励充分使用项目中的工具类进行逻辑判断。
- * </p>
 *
 * <pre>
 * AssertTools.checkArgument(StringUtils.hasText(str), "The argument cannot be blank.");
@@ -411,141 +410,154 @@ public class AssertTools {
    /**
     * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
     *
-     * @param expectedValue 预计的数量
-     * @param result 实际影响的数据量
+     * @param expected 预期影响的行数
+     * @param actualRowCount 实际影响的行数
     */
-    public static void checkAffectedRows(int expectedValue, int result) {
-        checkAffectedRows(expectedValue, result,
-                "The number of rows affected is expected to be %d, but is: %d", expectedValue, result);
+    public static void checkAffectedRows(int expected, int actualRowCount) {
+        if (expected != actualRowCount) {
+            throw new DataOperationResultException(expected, actualRowCount);
+        }
    }

    /**
     * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
     *
-     * @param expectedValue 预计的数量
-     * @param result 实际影响的数据量
+     * @param expected 预期影响的行数
+     * @param actualRowCount 实际影响的行数
     * @param errorMessage 异常信息
     */
-    public static void checkAffectedRows(int expectedValue, int result, @Nullable String errorMessage) {
-        checkCondition(expectedValue == result, () -> new DataOperationResultException(errorMessage));
+    public static void checkAffectedRows(int expected, int actualRowCount,
+            @Nullable String errorMessage) {
+        if (expected != actualRowCount) {
+            throw new DataOperationResultException(expected, actualRowCount, errorMessage);
+        }
    }

    /**
     * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
     *
-     * @param expectedValue 预计的数量
-     * @param result 实际影响的数据量
+     * @param expected 预期影响的行数
+     * @param actualRowCount 实际影响的行数
     * @param errorMessageSupplier 异常信息
     */
-    public static void checkAffectedRows(int expectedValue, int result,
+    public static void checkAffectedRows(int expected, int actualRowCount,
            Supplier<String> errorMessageSupplier) {
-        checkCondition(expectedValue == result,
-                () -> new DataOperationResultException(errorMessageSupplier.get()));
+        if (expected != actualRowCount) {
+            throw new DataOperationResultException(expected, actualRowCount, errorMessageSupplier.get());
+        }
    }

    /**
     * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
     *
-     * @param expectedValue 预计的数量
-     * @param result 实际影响的数据量
+     * @param expected 预期影响的行数
+     * @param actualRowCount 实际影响的行数
     * @param errorMessageTemplate 异常信息模板
     * @param errorMessageArgs 异常信息参数
     */
-    public static void checkAffectedRows(int expectedValue, int result,
+    public static void checkAffectedRows(int expected, int actualRowCount,
            String errorMessageTemplate, Object... errorMessageArgs) {
-        checkCondition(expectedValue == result,
-                () -> new DataOperationResultException(String.format(errorMessageTemplate, errorMessageArgs)));
+        if (expected != actualRowCount) {
+            throw new DataOperationResultException(expected, actualRowCount,
+                    String.format(errorMessageTemplate, errorMessageArgs));
+        }
    }

    /**
     * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
     *
-     * @param expectedValue 预计的数量
-     * @param result 实际影响的数据量
+     * @param expected 预期影响的行数
+     * @param actualRowCount 实际影响的行数
     */
-    public static void checkAffectedRows(long expectedValue, long result) {
-        checkAffectedRows(expectedValue, result,
-                "The number of rows affected is expected to be %d, but is: %d", expectedValue, result);
+    public static void checkAffectedRows(long expected, long actualRowCount) {
+        if (expected != actualRowCount) {
+            throw new DataOperationResultException(expected, actualRowCount);
+        }
    }

    /**
     * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
     *
-     * @param expectedValue 预计的数量
-     * @param result 实际影响的数据量
+     * @param expected 预期影响的行数
+     * @param actualRowCount 实际影响的行数
     * @param errorMessage 异常信息
     */
-    public static void checkAffectedRows(long expectedValue, long result, @Nullable String errorMessage) {
-        checkCondition(expectedValue == result, () -> new DataOperationResultException(errorMessage));
+    public static void checkAffectedRows(long expected, long actualRowCount,
+            @Nullable String errorMessage) {
+        if (expected != actualRowCount) {
+            throw new DataOperationResultException(expected, actualRowCount, errorMessage);
+        }
    }

    /**
     * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
     *
-     * @param expectedValue 预计的数量
-     * @param result 实际影响的数据量
+     * @param expected 预期影响的行数
+     * @param actualRowCount 实际影响的行数
     * @param errorMessageSupplier 异常信息
     */
-    public static void checkAffectedRows(long expectedValue, long result,
+    public static void checkAffectedRows(long expected, long actualRowCount,
            Supplier<String> errorMessageSupplier) {
-        checkCondition(expectedValue == result,
-                () -> new DataOperationResultException(errorMessageSupplier.get()));
+        if (expected != actualRowCount) {
+            throw new DataOperationResultException(expected, actualRowCount, errorMessageSupplier.get());
+        }
    }

    /**
     * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
     *
-     * @param expectedValue 预计的数量
-     * @param result 实际影响的数据量
+     * @param expected 预期影响的行数
+     * @param actualRowCount 实际影响的行数
     * @param errorMessageTemplate 异常信息模板
     * @param errorMessageArgs 异常信息参数
     */
-    public static void checkAffectedRows(long expectedValue, long result,
+    public static void checkAffectedRows(long expected, long actualRowCount,
            String errorMessageTemplate, Object... errorMessageArgs) {
-        checkCondition(expectedValue == result,
-                () -> new DataOperationResultException(String.format(errorMessageTemplate, errorMessageArgs)));
+        if (expected != actualRowCount) {
+            throw new DataOperationResultException(expected, actualRowCount,
+                    String.format(errorMessageTemplate, errorMessageArgs));
+        }
    }

    /**
     * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
     *
-     * @param result 实际影响的数据量
+     * @param actualRowCount 实际影响的行数
     */
-    public static void checkAffectedOneRow(int result) {
-        checkAffectedRows(1, result,
-                () -> "The number of rows affected is expected to be 1, but is: " + result);
+    public static void checkAffectedOneRow(int actualRowCount) {
+        checkAffectedRows(1, actualRowCount);
    }

    /**
     * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
     *
-     * @param result 实际影响的数据量
+     * @param actualRowCount 实际影响的行数
     * @param errorMessage 异常信息
     */
-    public static void checkAffectedOneRow(int result, String errorMessage) {
-        checkAffectedRows(1, result, errorMessage);
+    public static void checkAffectedOneRow(int actualRowCount, String errorMessage) {
+        checkAffectedRows(1, actualRowCount, errorMessage);
    }

    /**
     * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
     *
-     * @param result 实际影响的数据量
+     * @param actualRowCount 实际影响的行数
     * @param errorMessageSupplier 异常信息
     */
-    public static void checkAffectedOneRow(int result, Supplier<String> errorMessageSupplier) {
-        checkAffectedRows(1, result, errorMessageSupplier);
+    public static void checkAffectedOneRow(int actualRowCount, Supplier<String> errorMessageSupplier) {
+        checkAffectedRows(1, actualRowCount, errorMessageSupplier);
    }

    /**
     * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
     *
-     * @param result 实际影响的数据量
+     * @param actualRowCount 实际影响的行数
     * @param errorMessageTemplate 异常信息模板
     * @param errorMessageArgs 异常信息参数
     */
-    public static void checkAffectedOneRow(int result,
+    public static void checkAffectedOneRow(int actualRowCount,
            String errorMessageTemplate, Object... errorMessageArgs) {
-        checkAffectedRows(1, result, errorMessageTemplate, errorMessageArgs);
+        checkAffectedRows(1, actualRowCount, errorMessageTemplate, errorMessageArgs);
    }

    /**
@@ -554,40 +566,39 @@ public class AssertTools {
     * @param result 实际影响的数据量
     */
    public static void checkAffectedOneRow(long result) {
-        checkAffectedRows(1L, result,
-                () -> "The number of rows affected is expected to be 1, but is: " + result);
+        checkAffectedRows(1L, result);
    }

    /**
     * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
     *
-     * @param result 实际影响的数据量
+     * @param actualRowCount 实际影响的行数
     * @param errorMessage 异常信息
     */
-    public static void checkAffectedOneRow(long result, String errorMessage) {
-        checkAffectedRows(1L, result, errorMessage);
+    public static void checkAffectedOneRow(long actualRowCount, String errorMessage) {
+        checkAffectedRows(1L, actualRowCount, errorMessage);
    }

    /**
     * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
     *
-     * @param result 实际影响的数据量
+     * @param actualRowCount 实际影响的行数
     * @param errorMessageSupplier 异常信息
     */
-    public static void checkAffectedOneRow(long result, Supplier<String> errorMessageSupplier) {
-        checkAffectedRows(1L, result, errorMessageSupplier);
+    public static void checkAffectedOneRow(long actualRowCount, Supplier<String> errorMessageSupplier) {
+        checkAffectedRows(1L, actualRowCount, errorMessageSupplier);
    }

    /**
     * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
     *
-     * @param result 实际影响的数据量
+     * @param actualRowCount 实际影响的行数
     * @param errorMessageTemplate 异常信息模板
     * @param errorMessageArgs 异常信息参数
     */
-    public static void checkAffectedOneRow(long result,
+    public static void checkAffectedOneRow(long actualRowCount,
            String errorMessageTemplate, Object... errorMessageArgs) {
-        checkAffectedRows(1L, result, errorMessageTemplate, errorMessageArgs);
+        checkAffectedRows(1L, actualRowCount, errorMessageTemplate, errorMessageArgs);
    }

    // ================================
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/BigDecimals.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/BigDecimals.java
@@ -28,7 +28,6 @@ import xyz.zhouxy.plusone.commons.annotation.StaticFactoryMethod;
 *
 * <p>
 * BigDecimal 工具类
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 * @since 1.0.0
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/DateTimeTools.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/DateTimeTools.java
@@ -215,7 +215,6 @@ public class DateTimeTools {
     * <p>
     * 传入不同 {@link ZoneId}，获取到的 {@link ZonedDateTime} 对象实际上还是同一时间戳，
     * 只是不同时区的表示。
-     * </p>
     *
     * @param timeMillis 时间戳
     * @param zone       时区
@@ -230,7 +229,6 @@ public class DateTimeTools {
     * <p>
     * 传入不同 {@link ZoneId}，获取到的 {@link ZonedDateTime} 对象实际上还是同一时间戳，
     * 只是不同时区的表示。
-     * </p>
     *
     * @param dateTime {@link Date} 对象
     * @param zone     时区
@@ -245,7 +243,6 @@ public class DateTimeTools {
     * <p>
     * 传入不同 {@link ZoneId}，获取到的 {@link ZonedDateTime} 对象实际上表示的还是还是同一时间戳的时间，
     * 只是不同时区的表示。
-     * </p>
     *
     * @param dateTime {@link Date} 对象
     * @param timeZone 时区
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/EnumTools.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/EnumTools.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/Enumeration.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/Enumeration.java
@@ -33,7 +33,8 @@ import xyz.zhouxy.plusone.commons.annotation.StaticFactoryMethod;
 *
 * 参考 <a href="https://lostechies.com/jimmybogard/2008/08/12/enumeration-classes/">Enumeration classes</a>
 *
- * @deprecated 设计 Enumeration 的灵感来自于 .net 社区，因为 C# 的枚举不带行为。
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
+ * @deprecated 设计 Enumeration 的灵感来自于 .net 社区，因为 C&num; 的枚举不带行为。
 * 但 Java 的枚举可以带行为，故大多数情况下不需要这种设计。
 */
@Deprecated
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/IdGenerator.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/IdGenerator.java
@@ -26,7 +26,6 @@ import java.util.concurrent.ConcurrentHashMap;
 *
 * <p>
 * 生成 UUID 和 修改版雪花ID（Seata 版本）
- * </p>
 *
 * @see UUID
 * @see IdWorker
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/IdWorker.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/IdWorker.java
@@ -34,7 +34,7 @@ import xyz.zhouxy.plusone.commons.exception.system.NoAvailableMacFoundException;
 * <li>每个机器线程安全地生成序列，前面加上机器的id，这样就不会与其它机器的id相冲突。</li>
 * <li>时间戳作为序列的“预留位”，它更像是应用启动时最开始的序列的一部分，在一个时间戳里生成 4096 个 id 之后，直接生成下一个时间戳的 id。</li>
 * </ol>
- * </p>
+ *
 * <p>
 * 详情见以下介绍：
 * <ul>
@@ -43,7 +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>
- * </p>
+ *
 */
 public class IdWorker {

--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/Numbers.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/Numbers.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/OptionalTools.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/OptionalTools.java
@@ -45,7 +45,6 @@ public class OptionalTools {
     * <p>
     * 包装类为 {@code null} 表示值的缺失，转为 {@link OptionalInt} 后，由
     * {@link OptionalInt#empty()} 表示值的缺失。
-     * </p>
     *
     * @param value 包装对象
     * @return {@link OptionalInt} 实例
@@ -58,7 +57,6 @@ public class OptionalTools {
     * 将 {@code Optional<Integer>} 对象转为 {@link OptionalInt} 对象。
     * <p>
     * {@code Optional<Integer>} 将整数包装了两次，改为使用 {@link OptionalInt} 包装其中的整数数据。
-     * </p>
     *
     * @param optionalObj {@code Optional<Integer>} 对象
     * @return {@link OptionalInt} 实例
@@ -72,7 +70,6 @@ public class OptionalTools {
     * <p>
     * 包装类为 {@code null} 表示值的缺失，转为 {@link OptionalLong} 后，由
     * {@link OptionalLong#empty()} 表示值的缺失。
-     * </p>
     *
     * @param value 包装对象
     * @return {@link OptionalLong} 实例
@@ -85,7 +82,6 @@ public class OptionalTools {
     * 将 {@code Optional<Long>} 转为 {@link OptionalLong}。
     * <p>
     * {@code Optional<Long>} 将整数包装了两次，改为使用 {@link OptionalLong} 包装其中的整数数据。
-     * </p>
     *
     * @param optionalObj 包装对象
     * @return {@link OptionalLong} 实例
@@ -99,7 +95,6 @@ public class OptionalTools {
     * <p>
     * 包装类为 {@code null} 表示值的缺失，转为 {@link OptionalDouble} 后，由
     * {@link OptionalDouble#empty()} 表示值的缺失。
-     * </p>
     *
     * @param value 包装对象
     * @return {@link OptionalDouble} 实例
@@ -112,7 +107,6 @@ public class OptionalTools {
     * 将 {@code Optional<Double>} 转为 {@link OptionalDouble}。
     * <p>
     * {@code Optional<Double>} 将整数包装了两次，改为使用 {@link OptionalDouble} 包装其中的整数数据。
-     * </p>
     *
     * @param optionalObj 包装对象
     * @return {@link OptionalDouble} 实例
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/RandomTools.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/RandomTools.java
@@ -26,7 +26,7 @@ import java.util.concurrent.ThreadLocalRandom;
 * 随机工具类
 * <p>
 * 建议调用方自行维护 Random 对象
- * </p>
+ *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 */
 public final class RandomTools {
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/RegexTools.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/RegexTools.java
@@ -17,26 +17,40 @@
 package xyz.zhouxy.plusone.commons.util;

 import java.util.Arrays;
-import java.util.Map;
-import java.util.concurrent.ConcurrentHashMap;
+import java.util.Objects;
+import java.util.Optional;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;

 import javax.annotation.Nonnull;
 import javax.annotation.Nullable;

+import com.google.common.cache.CacheBuilder;
+import com.google.common.cache.CacheLoader;
+import com.google.common.cache.LoadingCache;
+
 /**
- * 封装一些常用的正则操作，并可以缓存 {@link Pattern} 实例以复用（最多缓存大概 256 个）。
+ * 封装一些常用的正则操作，并可以缓存 {@link Pattern} 实例以复用。
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- *
 */
 public final class RegexTools {

-    private static final int DEFAULT_CACHE_INITIAL_CAPACITY = 64;
    private static final int MAX_CACHE_SIZE = 256;
-    private static final Map<String, Pattern> PATTERN_CACHE
-            = new ConcurrentHashMap<>(DEFAULT_CACHE_INITIAL_CAPACITY);
+    private static final int DEFAULT_FLAG = 0;
+    private static final LoadingCache<RegexAndFlags, Pattern> PATTERN_CACHE = CacheBuilder
+            .newBuilder()
+            .maximumSize(MAX_CACHE_SIZE)
+            .build(new CacheLoader<RegexAndFlags, Pattern>() {
+                @SuppressWarnings("null")
+                public Pattern load(@Nonnull RegexAndFlags regexAndFlags) {
+                    return regexAndFlags.compilePattern();
+                }
+            });
+
+    // ================================
+    // #region - getPattern
+    // ================================

    /**
     * 获取 {@link Pattern} 实例。
@@ -46,8 +60,20 @@ public final class RegexTools {
     * @return {@link Pattern} 实例
     */
    public static Pattern getPattern(final String pattern, final boolean cachePattern) {
+        return getPattern(pattern, DEFAULT_FLAG, cachePattern);
+    }
+
+    /**
+     * 获取 {@link Pattern} 实例。
+     *
+     * @param pattern      正则表达式
+     * @param flags        正则表达式匹配标识
+     * @param cachePattern 是否缓存 {@link Pattern} 实例
+     * @return {@link Pattern} 实例
+     */
+    public static Pattern getPattern(final String pattern, final int flags, final boolean cachePattern) {
        AssertTools.checkNotNull(pattern);
-        return cachePattern ? cacheAndGetPatternInternal(pattern) : getPatternInternal(pattern);
+        return cachePattern ? cacheAndGetPatternInternal(pattern, flags) : getPatternInternal(pattern, flags);
    }

    /**
@@ -57,34 +83,29 @@ public final class RegexTools {
     * @return {@link Pattern} 实例
     */
    public static Pattern getPattern(final String pattern) {
+        return getPattern(pattern, DEFAULT_FLAG);
+    }
+
+    /**
+     * 获取 {@link Pattern} 实例，不缓存。
+     *
+     * @param pattern 正则表达式
+     * @param flags   正则表达式匹配标识
+     * @return {@link Pattern} 实例
+     */
+    @Nonnull
+    public static Pattern getPattern(final String pattern, final int flags) {
        AssertTools.checkNotNull(pattern);
-        return getPatternInternal(pattern);
+        return getPatternInternal(pattern, flags);
    }

-    /**
-     * 将各个正则表达式转为 {@link Pattern} 实例。
-     *
-     * @param patterns     正则表达式
-     * @param cachePattern 是否缓存 {@link Pattern} 实例
-     * @return {@link Pattern} 实例数组
-     */
-    public static Pattern[] getPatterns(final String[] patterns, final boolean cachePattern) {
-        AssertTools.checkArgument(ArrayTools.isAllElementsNotNull(patterns));
-        return cachePattern
-                ? cacheAndGetPatternsInternal(patterns)
-                : getPatternsInternal(patterns);
-    }
+    // ================================
+    // #endregion - getPattern
+    // ================================

-    /**
-     * 将各个正则表达式转为 {@link Pattern} 实例，不缓存。
-     *
-     * @param patterns 正则表达式
-     * @return {@link Pattern} 实例数组
-     */
-    public static Pattern[] getPatterns(final String[] patterns) {
-        AssertTools.checkArgument(ArrayTools.isAllElementsNotNull(patterns));
-        return getPatternsInternal(patterns);
-    }
+    // ================================
+    // #region - matches
+    // ================================

    /**
     * 判断 {@code input} 是否匹配 {@code pattern}。
@@ -105,9 +126,9 @@ public final class RegexTools {
     * @param patterns 正则
     * @return 判断结果
     */
-    public static boolean matchesOne(@Nullable final CharSequence input, final Pattern[] patterns) {
+    public static boolean matchesAny(@Nullable final CharSequence input, final Pattern[] patterns) {
        AssertTools.checkArgument(ArrayTools.isAllElementsNotNull(patterns));
-        return matchesOneInternal(input, patterns);
+        return matchesAnyInternal(input, patterns);
    }

    /**
@@ -132,11 +153,21 @@ public final class RegexTools {
     */
    public static boolean matches(@Nullable final CharSequence input, final String pattern,
            final boolean cachePattern) {
-        AssertTools.checkNotNull(pattern);
-        Pattern p = cachePattern
-                ? cacheAndGetPatternInternal(pattern)
-                : getPatternInternal(pattern);
-        return matchesInternal(input, p);
+        return matches(input, pattern, DEFAULT_FLAG, cachePattern);
+    }
+
+    /**
+     * 判断 {@code input} 是否匹配 {@code pattern}。
+     *
+     * @param input        输入
+     * @param pattern      正则表达式
+     * @param flags        正则表达式匹配标识
+     * @param cachePattern 是否缓存 {@link Pattern} 实例
+     * @return 判断结果
+     */
+    public static boolean matches(@Nullable final CharSequence input, final String pattern, final int flags,
+            final boolean cachePattern) {
+        return matchesInternal(input, getPattern(pattern, flags, cachePattern));
    }

    /**
@@ -147,69 +178,29 @@ public final class RegexTools {
     * @return 判断结果
     */
    public static boolean matches(@Nullable final CharSequence input, final String pattern) {
-        AssertTools.checkNotNull(pattern);
-        return matchesInternal(input, getPatternInternal(pattern));
+        return matches(input, pattern, DEFAULT_FLAG);
    }

    /**
-     * 判断 {@code input} 是否匹配 {@code patterns} 中的一个。
+     * 判断 {@code input} 是否匹配 {@code pattern}。不缓存 {@link Pattern} 实例。
     *
     * @param input   输入
-     * @param patterns     正则表达式
-     * @param cachePattern 是否缓存 {@link Pattern} 实例
+     * @param pattern 正则表达式
+     * @param flags   正则表达式匹配标识
     * @return 判断结果
     */
-    public static boolean matchesOne(@Nullable final CharSequence input, final String[] patterns,
-            final boolean cachePattern) {
-        AssertTools.checkArgument(ArrayTools.isAllElementsNotNull(patterns));
-        final Pattern[] patternSet = cachePattern
-                ? cacheAndGetPatternsInternal(patterns)
-                : getPatternsInternal(patterns);
-        return matchesOneInternal(input, patternSet);
+    public static boolean matches(@Nullable final CharSequence input,
+            final String pattern, final int flags) {
+        return matchesInternal(input, getPattern(pattern, flags));
    }

-    /**
-     * 判断 {@code input} 是否匹配 {@code patterns} 中的一个。不缓存 {@link Pattern} 实例。
-     *
-     * @param input    输入
-     * @param patterns 正则表达式
-     * @return 判断结果
-     */
-    public static boolean matchesOne(@Nullable final CharSequence input, final String[] patterns) {
-        AssertTools.checkArgument(ArrayTools.isAllElementsNotNull(patterns));
-        final Pattern[] patternSet = getPatternsInternal(patterns);
-        return matchesOneInternal(input, patternSet);
-    }
+    // ================================
+    // #endregion - matches
+    // ================================

-    /**
-     * 判断 {@code input} 是否匹配全部正则。
-     *
-     * @param input        输入
-     * @param patterns     正则表达式
-     * @param cachePattern 是否缓存 {@link Pattern} 实例
-     * @return 判断结果
-     */
-    public static boolean matchesAll(@Nullable final CharSequence input, final String[] patterns,
-            final boolean cachePattern) {
-        AssertTools.checkArgument(ArrayTools.isAllElementsNotNull(patterns));
-        final Pattern[] patternSet = cachePattern
-                ? cacheAndGetPatternsInternal(patterns)
-                : getPatternsInternal(patterns);
-        return matchesAllInternal(input, patternSet);
-    }
-
-    /**
-     * 判断 {@code input} 是否匹配全部正则。不缓存 {@link Pattern} 实例。
-     *
-     * @param input    输入
-     * @param patterns 正则表达式
-     * @return 判断结果
-     */
-    public static boolean matchesAll(@Nullable final CharSequence input, final String[] patterns) {
-        AssertTools.checkArgument(ArrayTools.isAllElementsNotNull(patterns));
-        final Pattern[] patternSet = getPatternsInternal(patterns);
-        return matchesAllInternal(input, patternSet);
-    }
+    // ================================
+    // #region - getMatcher
+    // ================================

    /**
     * 生成 Matcher。
@@ -233,12 +224,21 @@ public final class RegexTools {
     * @return 结果
     */
    public static Matcher getMatcher(final CharSequence input, final String pattern, boolean cachePattern) {
-        AssertTools.checkNotNull(input);
-        AssertTools.checkNotNull(pattern);
-        final Pattern p = cachePattern
-                ? cacheAndGetPatternInternal(pattern)
-                : getPatternInternal(pattern);
-        return p.matcher(input);
+        return getMatcher(input, pattern, DEFAULT_FLAG, cachePattern);
+    }
+
+    /**
+     * 生成 Matcher。
+     *
+     * @param input        输入
+     * @param pattern      正则表达式
+     * @param flags        正则表达式匹配标识
+     * @param cachePattern 是否缓存 {@link Pattern} 实例
+     * @return 结果
+     */
+    public static Matcher getMatcher(final CharSequence input,
+            final String pattern, final int flags, boolean cachePattern) {
+        return getMatcher(input, getPattern(pattern, flags, cachePattern));
    }

    /**
@@ -249,70 +249,56 @@ public final class RegexTools {
     * @return 结果
     */
    public static Matcher getMatcher(final CharSequence input, final String pattern) {
-        AssertTools.checkNotNull(input);
-        AssertTools.checkNotNull(pattern);
-        return getPatternInternal(pattern).matcher(input);
+        return getMatcher(input, pattern, DEFAULT_FLAG);
    }

-    // ========== internal methods ==========
+    /**
+     * 生成 Matcher。不缓存 {@link Pattern} 实例。
+     *
+     * @param input   输入
+     * @param pattern 正则表达式
+     * @param flags   正则表达式匹配标识
+     * @return 结果
+     */
+    public static Matcher getMatcher(final CharSequence input, final String pattern, final int flags) {
+        AssertTools.checkNotNull(input);
+        AssertTools.checkNotNull(pattern);
+        return getPatternInternal(pattern, flags).matcher(input);
+    }
+
+    // ================================
+    // #endregion - getMatcher
+    // ================================
+
+    // ================================
+    // #region - internal methods
+    // ================================

    /**
     * 获取 {@link Pattern} 实例。
     *
     * @param pattern      正则表达式
+     * @param flags        正则表达式匹配标识
     * @return {@link Pattern} 实例
     */
    @Nonnull
-    private static Pattern cacheAndGetPatternInternal(final String pattern) {
-        if (PATTERN_CACHE.size() < MAX_CACHE_SIZE) {
-            return PATTERN_CACHE.computeIfAbsent(pattern, Pattern::compile);
-        }
-        Pattern result = PATTERN_CACHE.get(pattern);
-        if (result != null) {
-            return result;
-        }
-        return Pattern.compile(pattern);
+    private static Pattern cacheAndGetPatternInternal(final String pattern, final int flags) {
+        final RegexAndFlags regexAndFlags = new RegexAndFlags(pattern, flags);
+        return PATTERN_CACHE.getUnchecked(regexAndFlags);
    }

    /**
     * 获取 {@link Pattern} 实例，不缓存。
     *
     * @param pattern 正则表达式
+     * @param flags   正则表达式匹配标识
     * @return {@link Pattern} 实例
     */
    @Nonnull
-    private static Pattern getPatternInternal(final String pattern) {
-        Pattern result = PATTERN_CACHE.get(pattern);
-        if (result == null) {
-            result = Pattern.compile(pattern);
-        }
-        return result;
-    }
-
-    /**
-     * 将各个正则表达式转为 {@link Pattern} 实例。
-     *
-     * @param patterns 正则表达式
-     * @return {@link Pattern} 实例数组
-     */
-    @Nonnull
-    private static Pattern[] cacheAndGetPatternsInternal(final String[] patterns) {
-        return Arrays.stream(patterns)
-                .map(RegexTools::cacheAndGetPatternInternal)
-                .toArray(Pattern[]::new);
-    }
-
-    /**
-     * 将各个正则表达式转为 {@link Pattern} 实例。
-     *
-     * @param patterns 正则表达式
-     * @return {@link Pattern} 实例数组
-     */
-    @Nonnull
-    private static Pattern[] getPatternsInternal(final String[] patterns) {
-        return Arrays.stream(patterns)
-                .map(RegexTools::getPatternInternal)
-                .toArray(Pattern[]::new);
+    private static Pattern getPatternInternal(final String pattern, final int flags) {
+        final RegexAndFlags regexAndFlags = new RegexAndFlags(pattern, flags);
+        return Optional.ofNullable(PATTERN_CACHE.getIfPresent(regexAndFlags))
+                .orElseGet(regexAndFlags::compilePattern);
    }

    /**
@@ -333,7 +319,7 @@ public final class RegexTools {
     * @param patterns 正则表达式
     * @return 判断结果
     */
-    private static boolean matchesOneInternal(@Nullable final CharSequence input, final Pattern[] patterns) {
+    private static boolean matchesAnyInternal(@Nullable final CharSequence input, final Pattern[] patterns) {
        return input != null
                && Arrays.stream(patterns)
                        .anyMatch(pattern -> pattern.matcher(input).matches());
@@ -352,8 +338,49 @@ public final class RegexTools {
                        .allMatch(pattern -> pattern.matcher(input).matches());
    }

+    // ================================
+    // #endregion - internal methods
+    // ================================
+
    private RegexTools() {
        // 不允许实例化
        throw new IllegalStateException("Utility class");
    }
+
+    // ================================
+    // #region - RegexAndFlags
+    // ================================
+
+    private static final class RegexAndFlags {
+        private final String regex;
+        private final int flags;
+
+        private RegexAndFlags(String regex, int flags) {
+            this.regex = regex;
+            this.flags = flags;
+        }
+
+        private final Pattern compilePattern() {
+            return Pattern.compile(regex, flags);
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(regex, flags);
+        }
+
+        @Override
+        public boolean equals(@Nullable Object obj) {
+            if (this == obj)
+                return true;
+            if (!(obj instanceof RegexAndFlags))
+                return false;
+            RegexAndFlags other = (RegexAndFlags) obj;
+            return Objects.equals(regex, other.regex) && flags == other.flags;
+        }
+    }
+
+    // ================================
+    // #endregion - RegexAndFlags
+    // ================================
 }
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/SnowflakeIdGenerator.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/SnowflakeIdGenerator.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/StringTools.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/StringTools.java
@@ -31,7 +31,6 @@ import xyz.zhouxy.plusone.commons.constant.PatternConsts;
 *
 * <p>
 * 字符串工具类。
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 * @since 1.0.0
@@ -220,6 +219,23 @@ public class StringTools {
        return String.valueOf(charArray);
    }

+    /**
+     * 转换为带引号的字符串
+     *
+     * @param value 值
+     * @return 带引号的字符串
+     * @since 1.1.0
+     */
+    public static String toQuotedString(@Nullable String value) {
+        if (value == null) {
+            return "null";
+        }
+        if (value.isEmpty()) {
+            return "\"\"";
+        }
+        return "\"" + value + "\"";
+    }
+
    private StringTools() {
        throw new IllegalStateException("Utility class");
    }
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/TreeBuilder.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/TreeBuilder.java
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/package-info.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/package-info.java
@@ -18,7 +18,6 @@
 * <h2>工具类</h2>
 * <p>
 * 包含树构建器（{@link TreeBuilder}）、断言工具（{@link AssertTools}）、ID 生成器（{@link IdGenerator}）及其它实用工具类。
- * </p>
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 */
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/EnumerationTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/EnumerationTests.java
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/SerialTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/SerialTests.java
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/base/IWithCodeTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/base/IWithCodeTests.java
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/base/RefTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/base/RefTests.java
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/collection/CollectionToolsTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/collection/CollectionToolsTests.java
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/constant/PatternConstsTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/constant/PatternConstsTests.java
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/exception/test/InvalidInputExceptionTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/exception/test/InvalidInputExceptionTests.java
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/exception/test/ParsingFailureExceptionTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/exception/test/ParsingFailureExceptionTests.java
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/function/FunctionTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/function/FunctionTests.java
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/gson/adapter/JSR310TypeAdaptersTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/gson/adapter/JSR310TypeAdaptersTests.java
@@ -0,0 +1,145 @@
+/*
+ * 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.gson.adapter;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import java.time.Instant;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.ZoneId;
+import java.time.ZonedDateTime;
+import java.time.format.DateTimeFormatter;
+import java.time.format.DateTimeFormatterBuilder;
+import java.time.temporal.ChronoField;
+
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+import com.google.gson.Gson;
+import com.google.gson.GsonBuilder;
+
+import lombok.extern.slf4j.Slf4j;
+import xyz.zhouxy.plusone.commons.gson.adapter.JSR310TypeAdapters.*;
+
+@Slf4j
+public final class JSR310TypeAdaptersTests {
+
+    final Gson gsonWithDefaultFormatter = new GsonBuilder()
+            .registerTypeAdapter(LocalDate.class, new LocalDateTypeAdapter().nullSafe())
+            .registerTypeAdapter(LocalDateTime.class, new LocalDateTimeTypeAdapter().nullSafe())
+            .registerTypeAdapter(ZonedDateTime.class, new ZonedDateTimeTypeAdapter().nullSafe())
+            .registerTypeAdapter(Instant.class, new InstantTypeAdapter().nullSafe())
+            .create();
+
+    final DateTimeFormatter dateFormatter = DateTimeFormatter.ofPattern("yyyy/MM/dd");
+    final DateTimeFormatter localDateTimeFormatter = new DateTimeFormatterBuilder()
+            .appendPattern("yyyy/MM/dd HH:mm:ss")
+            .appendValue(ChronoField.MILLI_OF_SECOND, 3)
+            .toFormatter();
+    final DateTimeFormatter zonedDateTimeFormatter = new DateTimeFormatterBuilder()
+            .appendPattern("yyyy/MM/dd HH:mm:ss")
+            .appendValue(ChronoField.MILLI_OF_SECOND, 3)
+            .appendZoneId()
+            .toFormatter();
+    final Gson gsonWithSpecifiedFormatter = new GsonBuilder()
+            .registerTypeAdapter(LocalDate.class, new LocalDateTypeAdapter(dateFormatter).nullSafe())
+            .registerTypeAdapter(LocalDateTime.class, new LocalDateTimeTypeAdapter(localDateTimeFormatter).nullSafe())
+            .registerTypeAdapter(ZonedDateTime.class, new ZonedDateTimeTypeAdapter(zonedDateTimeFormatter).nullSafe())
+            .create();
+
+    final LocalDate date = LocalDate.of(2025, 6, 6);
+    final LocalDateTime localDateTime = date.atTime(6, 6, 6, 666000000);
+    final ZonedDateTime zonedDateTime = localDateTime.atZone(ZoneId.of("+08:00"));
+    final Instant instant = zonedDateTime.toInstant();
+
+    @DisplayName("测试使用 TypeAdapter 中默认的 formatter 进行序列化")
+    @Test
+    void test_serialize_defaultFormatter() {
+        Foo foo = new Foo();
+        foo.localDate = date;
+        foo.localDateTime = localDateTime;
+        foo.zonedDateTime = zonedDateTime;
+        foo.instant = instant;
+
+        String json = String.format(
+            "{\"localDate\":\"%s\",\"localDateTime\":\"%s\",\"zonedDateTime\":\"%s\",\"instant\":\"%s\"}",
+            DateTimeFormatter.ISO_LOCAL_DATE.format(date),
+            DateTimeFormatter.ISO_LOCAL_DATE_TIME.format(localDateTime),
+            DateTimeFormatter.ISO_ZONED_DATE_TIME.format(zonedDateTime),
+            DateTimeFormatter.ISO_INSTANT.format(instant)
+        );
+
+        assertEquals(json, gsonWithDefaultFormatter.toJson(foo));
+    }
+
+    @DisplayName("测试指定 formatter 进行序列化")
+    @Test
+    void test_serialize_specifiedFormatter() {
+        Foo foo = new Foo();
+        foo.localDate = date;
+        foo.localDateTime = localDateTime;
+        foo.zonedDateTime = zonedDateTime;
+
+        String json = String.format(
+            "{\"localDate\":\"%s\",\"localDateTime\":\"%s\",\"zonedDateTime\":\"%s\"}",
+            dateFormatter.format(date),
+            localDateTimeFormatter.format(localDateTime),
+            zonedDateTimeFormatter.format(zonedDateTime)
+        );
+
+        assertEquals(json, gsonWithSpecifiedFormatter.toJson(foo));
+    }
+
+    @DisplayName("测试使用 TypeAdapter 中默认的 formatter 进行反序列化")
+    @Test
+    void test_deserialize_defaultFormatter() {
+        String json = String.format(
+            "{\"localDate\":\"%s\",\"localDateTime\":\"%s\",\"zonedDateTime\":\"%s\",\"instant\":\"%s\"}",
+            DateTimeFormatter.ISO_LOCAL_DATE.format(date),
+            DateTimeFormatter.ISO_LOCAL_DATE_TIME.format(localDateTime),
+            DateTimeFormatter.ISO_ZONED_DATE_TIME.format(zonedDateTime),
+            DateTimeFormatter.ISO_INSTANT.format(instant)
+        );
+        Foo foo = gsonWithDefaultFormatter.fromJson(json, Foo.class);
+        assertEquals(date, foo.localDate);
+        assertEquals(localDateTime, foo.localDateTime);
+        assertEquals(zonedDateTime, foo.zonedDateTime);
+        assertEquals(instant, foo.instant);
+    }
+
+    @DisplayName("测试指定 formatter 进行反序列化")
+    @Test
+    void test_deserialize_specifiedFormatter() {
+        String json = String.format(
+            "{\"localDate\":\"%s\",\"localDateTime\":\"%s\",\"zonedDateTime\":\"%s\"}",
+            dateFormatter.format(date),
+            localDateTimeFormatter.format(localDateTime),
+            zonedDateTimeFormatter.format(zonedDateTime)
+        );
+        Foo foo = gsonWithSpecifiedFormatter.fromJson(json, Foo.class);
+        assertEquals(date, foo.localDate);
+        assertEquals(localDateTime, foo.localDateTime);
+        assertEquals(zonedDateTime, foo.zonedDateTime);
+    }
+
+    static class Foo {
+        LocalDate localDate;
+        LocalDateTime localDateTime;
+        ZonedDateTime zonedDateTime;
+        Instant instant;
+    }
+}
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/model/Chinese2ndGenIDCardNumberTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/model/Chinese2ndGenIDCardNumberTests.java
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/model/ValidatableStringRecordTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/model/ValidatableStringRecordTests.java
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/model/dto/CustomUnifiedResponseFactoryTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/model/dto/CustomUnifiedResponseFactoryTests.java
@@ -558,11 +558,11 @@ class CustomUnifiedResponseFactoryTests {
        public static final String SUCCESS_CODE = "0000000";
        public static final String DEFAULT_SUCCESS_MSG = "成功";

-        public static UnifiedResponse<Void> success() {
+        public static <T> UnifiedResponse<T> success() {
            return of(SUCCESS_CODE, DEFAULT_SUCCESS_MSG);
        }

-        public static UnifiedResponse<Void> success(@Nullable String message) {
+        public static <T> UnifiedResponse<T> success(@Nullable String message) {
            return of(SUCCESS_CODE, message);
        }

--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/model/dto/UnifiedResponseTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/model/dto/UnifiedResponseTests.java
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/model/dto/test/PagingAndSortingQueryParamsTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/model/dto/test/PagingAndSortingQueryParamsTests.java
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/time/QuarterTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/time/QuarterTests.java
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/time/YearQuarterTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/time/YearQuarterTests.java
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/ArrayToolsTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/ArrayToolsTests.java
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/AssertToolsTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/AssertToolsTests.java
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/BigDecimalsTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/BigDecimalsTests.java
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/DateTimeToolsTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/DateTimeToolsTests.java
@@ -400,7 +400,7 @@ class DateTimeToolsTests {
    // ================================

    // ================================
-    // #region - ZondId <--> DateTimeZone
+    // #region - ZoneId <--> DateTimeZone
    // ================================

    @Test
@@ -412,7 +412,7 @@ class DateTimeToolsTests {
    }

    // ================================
-    // #endregion - ZondId <--> DateTimeZone
+    // #endregion - ZoneId <--> DateTimeZone
    // ================================

    // ================================
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/EnumToolsTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/EnumToolsTests.java
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/IdGeneratorTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/IdGeneratorTests.java
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
ZhouXY108	8828b12c78	release: 1.1.0-RC1	2025-06-08 13:38:03 +08:00
ZhouXY108	89acbecc5a	docs: 修改 javadoc 中的格式错误	2025-06-08 13:08:45 +08:00
zhouxy108	336d99d4ba	feat(gson): 添加 Gson 适配器以支持 JSR-310 中常用的类 Reviewed-on: http://zhouxy.xyz:3000/plusone/plusone-commons/pulls/57	2025-06-07 01:02:15 +08:00
ZhouXY108	0731bf2c22	refactor(gson): 合并多个 JSR-310 类型适配器到 `JSR310TypeAdapters` 中 - 将 InstantTypeAdapter、LocalDateTimeTypeAdapter、LocalDateTypeAdapter 和 ZonedDateTimeTypeAdapter 合并到 JSR310TypeAdapters 类中 - 更新包结构，移动适配器到 adapter 子包 - 新增相关包的 javadoc	2025-06-07 00:56:11 +08:00
ZhouXY108	2827f69aef	feat(gson): 新增 `InstantTypeAdapter` 用于 Gson 序列化和反序列化 `Instant` `InstantTypeAdapter` 用于 Gson 通过 `DateTimeFormatter#ISO_INSTANT` 序列化和反序列化 `Instant` 类型。	2025-06-07 00:22:04 +08:00
ZhouXY108	2e73ca5f6d	feat(gson): 添加 Gson 适配器以支持 Java 8 日期时间 API - 新增 `LocalDateTimeTypeAdapter`、`LocalDateTypeAdapter` 和 `ZonedDateTimeTypeAdapter` - 将 Gson 作为可选依赖	2025-06-06 19:13:52 +08:00
ZhouXY108	1239a11cd7	refactor: 优化 `UnifiedResponses` 工厂方法的泛型定义将不指定 data 的工厂方法也改成泛型方法，而不是返回 `UnifiedResponse<Void>`。	2025-06-06 11:40:20 +08:00
ZhouXY108	f8a2046d2d	refactor!: 将 `RegexTools` 的 `matchesOne` 方法重命名为 `matchesAny`	2025-06-04 17:12:29 +08:00
ZhouXY108	fb2036c038	build: 升级 logback 到 `1.3.15` logback 1.3.x 是最后一个支持 JDK8 的版本。如果使用 Spring Boot，建议使用 Spring Boot 绑定的版本，但是 Spring Boot 2.7.x 最高只支持 logback 1.2.x，所以不可避免使用的有漏洞的版本。	2025-05-28 21:14:27 +08:00
ZhouXY108	f9b4c3c58c	feat: 新增 `StringTools#toQuotedString` 方法	2025-05-18 15:18:52 +08:00
ZhouXY108	3ca2ec3be0	build: 简化依赖声明	2025-05-14 10:42:06 +08:00
ZhouXY108	f83bb55fd6	refactor!: 重构 `DataOperationResultException` (#56 ) 删除 `DataOperationResultException` 多余的构造方法，仅提供两个构造方法。创建 `DataOperationResultException` 实例时，必须将预计影响的行数和实际影响的行数作为入参。（不兼容）重构 `AssertTools` 中相关的断言方法。 Reviewed-on: http://zhouxy.xyz:3000/plusone/plusone-commons/pulls/56 Co-authored-by: ZhouXY108 <luquanlion@outlook.com> Co-committed-by: ZhouXY108 <luquanlion@outlook.com>	2025-05-09 21:45:30 +08:00
ZhouXY108	e90e3dc1b4	fix(dependencies): 改正 jasypt 版本配置 Reviewed-on: http://zhouxy.xyz:3000/plusone/plusone-commons/pulls/55 Co-authored-by: ZhouXY108 <luquanlion@outlook.com> Co-committed-by: ZhouXY108 <luquanlion@outlook.com>	2025-05-02 17:07:48 +08:00
ZhouXY108	b774d8c477	chore: 更新 Code Spell Checker 的配置 Reviewed-on: http://zhouxy.xyz:3000/plusone/plusone-commons/pulls/54 Co-authored-by: ZhouXY108 <luquanlion@outlook.com> Co-committed-by: ZhouXY108 <luquanlion@outlook.com>	2025-05-02 15:27:32 +08:00
ZhouXY108	2a18a47ffe	chore: 更新 `guava` Reviewed-on: http://zhouxy.xyz:3000/plusone/plusone-commons/pulls/53 Co-authored-by: ZhouXY108 <luquanlion@outlook.com> Co-committed-by: ZhouXY108 <luquanlion@outlook.com>	2025-05-02 15:09:06 +08:00
ZhouXY108	cb903a8cce	docs: 修改 `MultiTypesException` 文档描述 Co-authored-by: ZhouXY108 <luquanlion@outlook.com> Co-committed-by: ZhouXY108 <luquanlion@outlook.com>	2025-05-02 14:13:07 +08:00
ZhouXY108	030ed9ed3b	refactor: 更改项目结构创建父项目 plusone-parent，将 plusone-commons 放在 plusone-parent 下；在 plusone-parent 下创建 plusone-dependencies，由 plusone-dependencies 管理可能用到的所有依赖。	2025-05-02 11:31:57 +08:00
ZhouXY108	5ce738bdfc	docs: 完善 javadoc	2025-05-01 03:46:03 +08:00
ZhouXY108	97a4ae2279	perf: `RegexTools` 的缓存改用 guava cache	2025-05-01 02:15:23 +08:00
ZhouXY108	af66cd2380	feat: `RegexTools` 新增重载方法，当将字符串视为正则表达式入参时，允许传对应的 `flags`	2025-05-01 02:08:23 +08:00
ZhouXY108	3b519105bf	refactor!: 删除 `RegexTools` 中以 `String[]` 作为多个正则表达式入参的方法字符串无法代表一个正则表达式，还需考虑正则表达式的 flag(s)，所以当使用多个正则表达式时，更推荐使用 `Pattern[]`。	2025-04-30 22:57:47 +08:00