release: 1.0.3

该用例在 JDK17 环境下使用 Gson 进行系列化时，报 `com.google.gson.JsonIOException: Failed making field 'java.time.LocalDateTime#date' accessible; either increase its visibility or write a custom TypeAdapter for its declaring type`。

See: https://github.com/google/gson/blob/main/Troubleshooting.md#reflection-inaccessible
Co-authored-by: ZhouXY108 <luquanlion@outlook.com>
Co-committed-by: ZhouXY108 <luquanlion@outlook.com>

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>xyz.zhouxy.plusone</groupId>
     <artifactId>plusone-commons</artifactId>
-    <version>1.0.0</version>
+    <version>1.0.3</version>
 
     <properties>
         <!-- Basic properties -->
@@ -16,18 +16,18 @@
         <maven.compiler.target>1.8</maven.compiler.target>
 
         <!-- Versions of compile dependencies -->
-        <guava.version>33.4.0-jre</guava.version>
+        <guava.version>33.4.2-jre</guava.version>
-        <joda-time.version>2.13.0</joda-time.version>
+        <joda-time.version>2.14.0</joda-time.version>
 
         <!-- Versions of test dependencies -->
         <commons-lang3.version>3.17.0</commons-lang3.version>
         <logback.version>1.2.13</logback.version>
-        <junit.version>5.11.4</junit.version>
+        <junit.version>5.12.1</junit.version>
         <lombok.version>1.18.36</lombok.version>
-        <hutool.version>5.8.35</hutool.version>
+        <hutool.version>5.8.37</hutool.version>
         <mybatis.version>3.5.19</mybatis.version>
         <h2.version>2.2.224</h2.version>
-        <jackson.version>2.18.2</jackson.version>
+        <jackson.version>2.18.3</jackson.version>
         <gson.version>2.12.1</gson.version>
     </properties>
 

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

@@ -28,7 +28,7 @@ import java.lang.annotation.Target;
  * 标识方法是读方法，如 getter。
  *
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 1.0
+ * @since 1.0.0
  * @see WriterMethod
  */
 @Target(ElementType.METHOD)

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

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

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

@@ -29,7 +29,7 @@ import java.lang.annotation.Documented;
  *
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  * @version 1.0
- * @since 1.0
+ * @since 1.0.0
  * @see UnsupportedOperationException
  */
 @Documented

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

@@ -26,7 +26,7 @@ import java.lang.annotation.Target;
  * ValueObject - 值对象
  *
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 0.1.0
+ * @since 1.0.0
  */
 @Inherited
 @Target(ElementType.TYPE)

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

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

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

@@ -28,7 +28,7 @@ import java.lang.annotation.Target;
  * 标识方法是写方法，如 setter。
  *
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 1.0
+ * @since 1.0.0
  * @see ReaderMethod
  */
 @Target(ElementType.METHOD)

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

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

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

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

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

@@ -36,7 +36,7 @@ import xyz.zhouxy.plusone.commons.exception.MultiTypesException.ExceptionType;
  * </p>
  *
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 0.1.0
+ * @since 1.0.0
  */
 public final class ParsingFailureException
         extends RuntimeException

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

@@ -27,7 +27,7 @@ package xyz.zhouxy.plusone.commons.exception.business;
  * <b>NOTE: 通常表示业务中的意外情况。如：用户错误输入、缺失必填字段、用户余额不足等。</b>
  * </p>
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 0.1.0
+ * @since 1.0.0
  */
 public class BizException extends RuntimeException {
 

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

@@ -32,7 +32,7 @@ import xyz.zhouxy.plusone.commons.exception.MultiTypesException;
  * <b>NOTE: 属业务异常</b>
  * </p>
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 0.1.0
+ * @since 1.0.0
  */
 public final class InvalidInputException
         extends RequestParamsException

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

@@ -24,7 +24,7 @@ package xyz.zhouxy.plusone.commons.exception.business;
  * </p>
  *
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 0.1.0
+ * @since 1.0.0
  */
 public class RequestParamsException extends BizException {
 

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

@@ -29,7 +29,7 @@ package xyz.zhouxy.plusone.commons.exception.system;
  * 后续需要排查原因。
  * </p>
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 0.1.0
+ * @since 1.0.0
  */
 public final class DataOperationResultException extends SysException {
 

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

@@ -24,7 +24,7 @@ package xyz.zhouxy.plusone.commons.exception.system;
  * </p>
  *
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 0.1.0
+ * @since 1.0.0
  */
 public class NoAvailableMacFoundException extends SysException {
     private static final long serialVersionUID = 152827098461071551L;

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

@@ -24,7 +24,7 @@ package xyz.zhouxy.plusone.commons.exception.system;
  * </p>
  *
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 0.1.0
+ * @since 1.0.0
  */
 public class SysException extends RuntimeException {
 

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

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

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

@@ -19,14 +19,14 @@ package xyz.zhouxy.plusone.commons.function;
 import java.util.function.Predicate;
 
 /**
- * Predicates
+ * PredicateTools
  *
  * <p>
  * {@link Predicate} 相关操作。
  * </p>
  *
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 0.1.0
+ * @since 1.0.0
  * @see Predicate
  */
 public class PredicateTools {

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

@@ -16,6 +16,7 @@
 
 package xyz.zhouxy.plusone.commons.function;
 
+@FunctionalInterface
 public interface ThrowingPredicate<T, E extends Throwable> {
 
     /**

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

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

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

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

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

@@ -39,7 +39,7 @@ import xyz.zhouxy.plusone.commons.util.StringTools;
  * </p>
  *
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 1.0
+ * @since 1.0.0
  * @see xyz.zhouxy.plusone.commons.constant.PatternConsts#CHINESE_2ND_ID_CARD_NUMBER
  */
 @ValueObject

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

@@ -30,7 +30,7 @@ import xyz.zhouxy.plusone.commons.util.AssertTools;
  * 带校验的字符串值对象
  *
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 0.1.0
+ * @since 1.0.0
  */
 public abstract class ValidatableStringRecord<T extends ValidatableStringRecord<T>>
         implements Comparable<T> {

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

@@ -37,7 +37,7 @@ import javax.annotation.Nullable;
  * </p>
  *
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 0.1.0
+ * @since 1.0.0
  */
 public class ArrayTools {
 

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

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

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

@@ -184,7 +184,7 @@ public class DateTimeTools {
     /**
      * 使用指定时区，将 {@link LocalDateTime} 对象转换为 {@link Instant} 对象
      *
-     * @param LocalDateTime {@link LocalDateTime} 对象
+     * @param localDateTime {@link LocalDateTime} 对象
      * @param zone          时区
      * @return {@link Instant} 对象
      */

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

@@ -42,7 +42,6 @@ import xyz.zhouxy.plusone.commons.exception.system.NoAvailableMacFoundException;
  * <li><a href="https://juejin.cn/post/7265516484029743138">关于若干读者，阅读“改良版雪花算法”后提出的几个共性问题的回复。</a></li>
  * </ul>
  * </p>
- * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
  */
 public class IdWorker {
 

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

@@ -26,13 +26,13 @@ import javax.annotation.Nullable;
 import com.google.common.annotations.Beta;
 
 /**
- * OptionalUtil
+ * OptionalTools
  *
  * <p>
  * 提供一些 Optional 相关的方法
  *
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 0.1.0
+ * @since 1.0.0
  * @see Optional
  * @see OptionalInt
  * @see OptionalLong

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

@@ -31,7 +31,7 @@ import javax.annotation.Nullable;
  * TreeBuilder
  *
  * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- * @since 1.0
+ * @since 1.0.0
  */
 public class TreeBuilder<T, TSubTree extends T, TIdentity> {
     private final Function<T, TIdentity> identityGetter;

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

@@ -212,6 +212,7 @@ public class PagingAndSortingQueryParamsTests {
             List<AccountVO> list = accountQueries.queryAccountList(params, pagingParams);
             long count = accountQueries.countAccount(params);
             PageResult<AccountVO> accountPageResult = PageResult.of(list, count);
+            // TODO [修复] 从 JDK 17 开始，也允许使用反射访问内部字段，所以这里会报错。参考 https://github.com/google/gson/blob/main/Troubleshooting.md#reflection-inaccessible
             log.info(gson.toJson(accountPageResult));
 
             assertEquals(Lists.newArrayList(