feat: 新增 plusone-json-jackson 模块

plusone-commons/pom.xml

@@ -71,7 +71,17 @@
 
         <dependency>
             <groupId>org.junit.jupiter</groupId>
-            <artifactId>junit-jupiter</artifactId>
+            <artifactId>junit-jupiter-api</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-params</artifactId>
             <scope>test</scope>
         </dependency>
 

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

@@ -33,49 +33,43 @@ package xyz.zhouxy.plusone.commons.exception.system;
  */
 public final class DataOperationResultException extends SysException {
 
-    private final long expected;
-    private final long actual;
+    private static final String DEFAULT_MSG = "数据操作的结果不符合预期";
 
     /**
-     * 创建一个 {@code DataOperationResultException} 对象
-     *
-     * @param expected 预期影响的行数
-     * @param actual 实际影响的行数
+     * 使用默认 message 构造新的 {@code DataOperationResultException}。
+     * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
      */
-    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;
+    public DataOperationResultException() {
+        super(DEFAULT_MSG);
     }
 
     /**
-     * 创建一个 {@code DataOperationResultException} 对象
+     * 使用指定的 {@code message} 构造新的 {@code DataOperationResultException}。
+     * {@code cause} 未初始化，后面可能会通过调用 {@link #initCause} 进行初始化。
      *
-     * @param expected 预期影响的行数
-     * @param actual 实际影响的行数
-     * @param message 错误信息
+     * @param message 异常信息
      */
-    public DataOperationResultException(long expected, long actual, String message) {
+    public DataOperationResultException(String message) {
         super(message);
-        this.expected = expected;
-        this.actual = actual;
     }
 
     /**
-     * 预期影响的行数
+     * 使用指定的 {@code cause} 构造新的 {@code DataOperationResultException}。
+     * {@code message} 为 (cause==null ? null : cause.toString())。
      *
-     * @return the expected
+     * @param cause 包装的异常
      */
-    public long getExpected() {
-        return expected;
+    public DataOperationResultException(Throwable cause) {
+        super(cause);
     }
 
     /**
-     * 实际影响的行数
+     * 使用指定的 {@code message} 和 {@code cause} 构造新的 {@code DataOperationResultException}。
      *
-     * @return the actual
+     * @param message 异常信息
+     * @param cause   包装的异常
      */
-    public long getActual() {
-        return actual;
+    public DataOperationResultException(String message, Throwable cause) {
+        super(message, cause);
     }
 }

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

@@ -334,7 +334,7 @@ public class AssertTools {
             String errorMessageTemplate, Object... errorMessageArgs)
             throws DataNotExistsException {
         checkCondition(obj != null,
-                () -> new DataNotExistsException(String.format(errorMessageTemplate, errorMessageArgs)));
+        () -> new DataNotExistsException(String.format(errorMessageTemplate, errorMessageArgs)));
         return obj;
     }
 
@@ -411,154 +411,141 @@ public class AssertTools {
     /**
      * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
      *
-     * @param expected 预期影响的行数
-     * @param actualRowCount 实际影响的行数
+     * @param expectedValue 预计的数量
+     * @param result 实际影响的数据量
      */
-    public static void checkAffectedRows(int expected, int actualRowCount) {
-        if (expected != actualRowCount) {
-            throw new DataOperationResultException(expected, 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);
     }
 
     /**
      * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
      *
-     * @param expected 预期影响的行数
-     * @param actualRowCount 实际影响的行数
+     * @param expectedValue 预计的数量
+     * @param result 实际影响的数据量
      * @param errorMessage 异常信息
      */
-    public static void checkAffectedRows(int expected, int actualRowCount,
-            @Nullable String errorMessage) {
-        if (expected != actualRowCount) {
-            throw new DataOperationResultException(expected, actualRowCount, errorMessage);
-        }
+    public static void checkAffectedRows(int expectedValue, int result, @Nullable String errorMessage) {
+        checkCondition(expectedValue == result, () -> new DataOperationResultException(errorMessage));
     }
 
     /**
      * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
      *
-     * @param expected 预期影响的行数
-     * @param actualRowCount 实际影响的行数
+     * @param expectedValue 预计的数量
+     * @param result 实际影响的数据量
      * @param errorMessageSupplier 异常信息
      */
-    public static void checkAffectedRows(int expected, int actualRowCount,
+    public static void checkAffectedRows(int expectedValue, int result,
             Supplier<String> errorMessageSupplier) {
-        if (expected != actualRowCount) {
-            throw new DataOperationResultException(expected, actualRowCount, errorMessageSupplier.get());
-        }
+        checkCondition(expectedValue == result,
+                () -> new DataOperationResultException(errorMessageSupplier.get()));
     }
 
     /**
      * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
      *
-     * @param expected 预期影响的行数
-     * @param actualRowCount 实际影响的行数
+     * @param expectedValue 预计的数量
+     * @param result 实际影响的数据量
      * @param errorMessageTemplate 异常信息模板
      * @param errorMessageArgs 异常信息参数
      */
-    public static void checkAffectedRows(int expected, int actualRowCount,
+    public static void checkAffectedRows(int expectedValue, int result,
             String errorMessageTemplate, Object... errorMessageArgs) {
-        if (expected != actualRowCount) {
-            throw new DataOperationResultException(expected, actualRowCount,
-                    String.format(errorMessageTemplate, errorMessageArgs));
-        }
+        checkCondition(expectedValue == result,
+                () -> new DataOperationResultException(String.format(errorMessageTemplate, errorMessageArgs)));
     }
 
     /**
      * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
      *
-     * @param expected 预期影响的行数
-     * @param actualRowCount 实际影响的行数
+     * @param expectedValue 预计的数量
+     * @param result 实际影响的数据量
      */
-    public static void checkAffectedRows(long expected, long actualRowCount) {
-        if (expected != actualRowCount) {
-            throw new DataOperationResultException(expected, 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);
     }
 
     /**
      * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
      *
-     * @param expected 预期影响的行数
-     * @param actualRowCount 实际影响的行数
+     * @param expectedValue 预计的数量
+     * @param result 实际影响的数据量
      * @param errorMessage 异常信息
      */
-    public static void checkAffectedRows(long expected, long actualRowCount,
-            @Nullable String errorMessage) {
-        if (expected != actualRowCount) {
-            throw new DataOperationResultException(expected, actualRowCount, errorMessage);
-        }
+    public static void checkAffectedRows(long expectedValue, long result, @Nullable String errorMessage) {
+        checkCondition(expectedValue == result, () -> new DataOperationResultException(errorMessage));
     }
 
     /**
      * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
      *
-     * @param expected 预期影响的行数
-     * @param actualRowCount 实际影响的行数
+     * @param expectedValue 预计的数量
+     * @param result 实际影响的数据量
      * @param errorMessageSupplier 异常信息
      */
-    public static void checkAffectedRows(long expected, long actualRowCount,
+    public static void checkAffectedRows(long expectedValue, long result,
             Supplier<String> errorMessageSupplier) {
-        if (expected != actualRowCount) {
-            throw new DataOperationResultException(expected, actualRowCount, errorMessageSupplier.get());
-        }
+        checkCondition(expectedValue == result,
+                () -> new DataOperationResultException(errorMessageSupplier.get()));
     }
 
     /**
      * 当影响的数据量与预计不同时抛出 {@link DataOperationResultException}。
      *
-     * @param expected 预期影响的行数
-     * @param actualRowCount 实际影响的行数
+     * @param expectedValue 预计的数量
+     * @param result 实际影响的数据量
      * @param errorMessageTemplate 异常信息模板
      * @param errorMessageArgs 异常信息参数
      */
-    public static void checkAffectedRows(long expected, long actualRowCount,
+    public static void checkAffectedRows(long expectedValue, long result,
             String errorMessageTemplate, Object... errorMessageArgs) {
-        if (expected != actualRowCount) {
-            throw new DataOperationResultException(expected, actualRowCount,
-                    String.format(errorMessageTemplate, errorMessageArgs));
-        }
+        checkCondition(expectedValue == result,
+                () -> new DataOperationResultException(String.format(errorMessageTemplate, errorMessageArgs)));
     }
 
     /**
      * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
      *
-     * @param actualRowCount 实际影响的行数
+     * @param result 实际影响的数据量
      */
-    public static void checkAffectedOneRow(int actualRowCount) {
-        checkAffectedRows(1, actualRowCount);
+    public static void checkAffectedOneRow(int result) {
+        checkAffectedRows(1, result,
+                () -> "The number of rows affected is expected to be 1, but is: " + result);
     }
 
     /**
      * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
      *
-     * @param actualRowCount 实际影响的行数
+     * @param result 实际影响的数据量
      * @param errorMessage 异常信息
      */
-    public static void checkAffectedOneRow(int actualRowCount, String errorMessage) {
-        checkAffectedRows(1, actualRowCount, errorMessage);
+    public static void checkAffectedOneRow(int result, String errorMessage) {
+        checkAffectedRows(1, result, errorMessage);
     }
 
     /**
      * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
      *
-     * @param actualRowCount 实际影响的行数
+     * @param result 实际影响的数据量
      * @param errorMessageSupplier 异常信息
      */
-    public static void checkAffectedOneRow(int actualRowCount, Supplier<String> errorMessageSupplier) {
-        checkAffectedRows(1, actualRowCount, errorMessageSupplier);
+    public static void checkAffectedOneRow(int result, Supplier<String> errorMessageSupplier) {
+        checkAffectedRows(1, result, errorMessageSupplier);
     }
 
     /**
      * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
      *
-     * @param actualRowCount 实际影响的行数
+     * @param result 实际影响的数据量
      * @param errorMessageTemplate 异常信息模板
      * @param errorMessageArgs 异常信息参数
      */
-    public static void checkAffectedOneRow(int actualRowCount,
+    public static void checkAffectedOneRow(int result,
             String errorMessageTemplate, Object... errorMessageArgs) {
-        checkAffectedRows(1, actualRowCount, errorMessageTemplate, errorMessageArgs);
+        checkAffectedRows(1, result, errorMessageTemplate, errorMessageArgs);
     }
 
     /**
@@ -567,39 +554,40 @@ public class AssertTools {
      * @param result 实际影响的数据量
      */
     public static void checkAffectedOneRow(long result) {
-        checkAffectedRows(1L, result);
+        checkAffectedRows(1L, result,
+                () -> "The number of rows affected is expected to be 1, but is: " + result);
     }
 
     /**
      * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
      *
-     * @param actualRowCount 实际影响的行数
+     * @param result 实际影响的数据量
      * @param errorMessage 异常信息
      */
-    public static void checkAffectedOneRow(long actualRowCount, String errorMessage) {
-        checkAffectedRows(1L, actualRowCount, errorMessage);
+    public static void checkAffectedOneRow(long result, String errorMessage) {
+        checkAffectedRows(1L, result, errorMessage);
     }
 
     /**
      * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
      *
-     * @param actualRowCount 实际影响的行数
+     * @param result 实际影响的数据量
      * @param errorMessageSupplier 异常信息
      */
-    public static void checkAffectedOneRow(long actualRowCount, Supplier<String> errorMessageSupplier) {
-        checkAffectedRows(1L, actualRowCount, errorMessageSupplier);
+    public static void checkAffectedOneRow(long result, Supplier<String> errorMessageSupplier) {
+        checkAffectedRows(1L, result, errorMessageSupplier);
     }
 
     /**
      * 当影响的数据量不为 1 时抛出 {@link DataOperationResultException}。
      *
-     * @param actualRowCount 实际影响的行数
+     * @param result 实际影响的数据量
      * @param errorMessageTemplate 异常信息模板
      * @param errorMessageArgs 异常信息参数
      */
-    public static void checkAffectedOneRow(long actualRowCount,
+    public static void checkAffectedOneRow(long result,
             String errorMessageTemplate, Object... errorMessageArgs) {
-        checkAffectedRows(1L, actualRowCount, errorMessageTemplate, errorMessageArgs);
+        checkAffectedRows(1L, result, errorMessageTemplate, errorMessageArgs);
     }
 
     // ================================

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

@@ -220,23 +220,6 @@ 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");
     }

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

@@ -370,38 +370,6 @@ class StringToolsTests {
     // #endregion - desensitize
     // ================================
 
-    // ================================
-    // #region - toQuotedString
-    // ================================
-
-    @Test
-    void toQuotedString_NullInput_ReturnsNullStr() {
-        String result = StringTools.toQuotedString(null);
-        assertEquals("null", result);
-
-        assertEquals("The value is null.", String.format("The value is %s.", result));
-    }
-
-    @Test
-    void toQuotedString_EmptyString_ReturnsEmptyString() {
-        String result = StringTools.toQuotedString("");
-        assertEquals("\"\"", result);
-
-        assertEquals("The value is \"\".", String.format("The value is %s.", result));
-    }
-
-    @Test
-    void toQuotedString_ValidInput_ReturnsQuotedString() {
-        String result = StringTools.toQuotedString("Hello World");
-        assertEquals("\"Hello World\"", result);
-
-        assertEquals("The value is \"Hello World\".", String.format("The value is %s.", result));
-    }
-
-    // ================================
-    // #endregion - toQuotedString
-    // ================================
-
     @Test
     void test_constructor_isNotAccessible_ThrowsIllegalStateException() {
         Constructor<?>[] constructors = StringTools.class.getDeclaredConstructors();

plusone-dependencies/pom.xml

@@ -209,12 +209,20 @@
             </dependency>
 
             <dependency>
-                <groupId>org.junit</groupId>
-                <artifactId>junit-bom</artifactId>
+                <groupId>org.junit.jupiter</groupId>
+                <artifactId>junit-jupiter-api</artifactId>
                 <version>${junit.version}</version>
-                <type>pom</type>
-                <scope>import</scope>
-              </dependency>
+            </dependency>
+            <dependency>
+                <groupId>org.junit.jupiter</groupId>
+                <artifactId>junit-jupiter-engine</artifactId>
+                <version>${junit.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>org.junit.jupiter</groupId>
+                <artifactId>junit-jupiter-params</artifactId>
+                <version>${junit.version}</version>
+            </dependency>
         </dependencies>
     </dependencyManagement>
 

plusone-json/plusone-json-jackson/pom.xml

@@ -0,0 +1,43 @@
+<?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-json</artifactId>
+        <version>1.1.0-SNAPSHOT</version>
+    </parent>
+
+    <artifactId>plusone-json-jackson</artifactId>
+
+    <description>
+        Jackson 相关模块
+    </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>
+
+    <dependencies>
+        <dependency>
+            <groupId>xyz.zhouxy.plusone</groupId>
+            <artifactId>plusone-commons</artifactId>
+            <version>1.1.0-SNAPSHOT</version>
+        </dependency>
+        <!-- Jackson -->
+        <dependency>
+            <groupId>com.fasterxml.jackson.core</groupId>
+            <artifactId>jackson-databind</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.fasterxml.jackson.datatype</groupId>
+            <artifactId>jackson-datatype-jsr310</artifactId>
+        </dependency>
+    </dependencies>
+
+</project>

plusone-json/plusone-json-jackson/src/xyz/zhouxy/plusone/json/jackson/JacksonTools.java

@@ -0,0 +1,39 @@
+/*
+ * 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.json.jackson;
+
+import com.fasterxml.jackson.databind.Module;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
+
+public class JacksonTools {
+
+    public static ObjectMapper newObjectMapperWithJavaTimeModule() {
+        return newObjectMapperWithModules(new JavaTimeModule());
+    }
+
+    public static ObjectMapper newObjectMapperWithModules(Module... modules) {
+        ObjectMapper objectMapper = new ObjectMapper();
+        for (Module module : modules) {
+            objectMapper.registerModule(module);
+        }
+        return objectMapper;
+    }
+
+    private JacksonTools() {
+        throw new IllegalStateException("Utility class");
+    }
+}

plusone-json/pom.xml

@@ -0,0 +1,42 @@
+<?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-SNAPSHOT</version>
+    </parent>
+
+    <artifactId>plusone-json</artifactId>
+    <packaging>pom</packaging>
+
+    <modules>
+        <module>plusone-json-jackson</module>
+    </modules>
+
+    <description>
+        JSON 相关模块
+    </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-SNAPSHOT</version>
+                <type>pom</type>
+                <scope>import</scope>
+            </dependency>
+        </dependencies>
+    </dependencyManagement>
+</project>

pom.xml

@@ -12,6 +12,7 @@
     <modules>
         <module>plusone-commons</module>
         <module>plusone-dependencies</module>
+        <module>plusone-json</module>
     </modules>
 
     <repositories>