From 73a99b630cc8ba12aa6390cdd8fe5cb496f219fb Mon Sep 17 00:00:00 2001 From: ZhouXY108 Date: Fri, 28 Mar 2025 11:35:12 +0800 Subject: [PATCH] =?UTF-8?q?doc:=20=E4=BF=AE=E6=94=B9=20since=20=E4=BF=A1?= =?UTF-8?q?=E6=81=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 1.0.0 之前新增的，其 since 修改为 1.0.0，统一以 1.0.0 作为初始版本 fix plusone/plusone-commons#30 --- .../xyz/zhouxy/plusone/commons/annotation/ReaderMethod.java | 2 +- .../plusone/commons/annotation/StaticFactoryMethod.java | 2 +- .../plusone/commons/annotation/UnsupportedOperation.java | 2 +- .../xyz/zhouxy/plusone/commons/annotation/ValueObject.java | 2 +- .../java/xyz/zhouxy/plusone/commons/annotation/Virtual.java | 2 +- .../xyz/zhouxy/plusone/commons/annotation/WriterMethod.java | 2 +- .../zhouxy/plusone/commons/collection/CollectionTools.java | 2 +- .../plusone/commons/exception/DataNotExistsException.java | 2 +- .../plusone/commons/exception/ParsingFailureException.java | 2 +- .../plusone/commons/exception/business/BizException.java | 2 +- .../commons/exception/business/InvalidInputException.java | 2 +- .../commons/exception/business/RequestParamsException.java | 2 +- .../exception/system/DataOperationResultException.java | 2 +- .../exception/system/NoAvailableMacFoundException.java | 2 +- .../plusone/commons/exception/system/SysException.java | 2 +- .../zhouxy/plusone/commons/function/OptionalSupplier.java | 4 ++-- .../xyz/zhouxy/plusone/commons/function/PredicateTools.java | 6 +++--- .../plusone/commons/function/ToOptionalBiFunction.java | 2 +- .../zhouxy/plusone/commons/function/ToOptionalFunction.java | 2 +- .../plusone/commons/model/Chinese2ndGenIDCardNumber.java | 2 +- .../plusone/commons/model/ValidatableStringRecord.java | 2 +- .../java/xyz/zhouxy/plusone/commons/util/ArrayTools.java | 2 +- .../java/xyz/zhouxy/plusone/commons/util/BigDecimals.java | 2 +- .../java/xyz/zhouxy/plusone/commons/util/OptionalTools.java | 2 +- .../java/xyz/zhouxy/plusone/commons/util/TreeBuilder.java | 2 +- 25 files changed, 28 insertions(+), 28 deletions(-) diff --git a/src/main/java/xyz/zhouxy/plusone/commons/annotation/ReaderMethod.java b/src/main/java/xyz/zhouxy/plusone/commons/annotation/ReaderMethod.java index 8504f0c..b6c859a 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/annotation/ReaderMethod.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/annotation/ReaderMethod.java @@ -28,7 +28,7 @@ import java.lang.annotation.Target; * 标识方法是读方法，如 getter。 * * @author ZhouXY - * @since 1.0 + * @since 1.0.0 * @see WriterMethod */ @Target(ElementType.METHOD) diff --git a/src/main/java/xyz/zhouxy/plusone/commons/annotation/StaticFactoryMethod.java b/src/main/java/xyz/zhouxy/plusone/commons/annotation/StaticFactoryMethod.java index c5ebe20..d8ff936 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/annotation/StaticFactoryMethod.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/annotation/StaticFactoryMethod.java @@ -27,7 +27,7 @@ import java.lang.annotation.Target; *

标识方法为静态工厂方法 * * @author ZhouXY - * @since 0.1.0 + * @since 1.0.0 */ @Target(ElementType.METHOD) @Retention(RetentionPolicy.RUNTIME) diff --git a/src/main/java/xyz/zhouxy/plusone/commons/annotation/UnsupportedOperation.java b/src/main/java/xyz/zhouxy/plusone/commons/annotation/UnsupportedOperation.java index 67a19ef..ad6879b 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/annotation/UnsupportedOperation.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/annotation/UnsupportedOperation.java @@ -29,7 +29,7 @@ import java.lang.annotation.Documented; * * @author ZhouXY * @version 1.0 - * @since 1.0 + * @since 1.0.0 * @see UnsupportedOperationException */ @Documented diff --git a/src/main/java/xyz/zhouxy/plusone/commons/annotation/ValueObject.java b/src/main/java/xyz/zhouxy/plusone/commons/annotation/ValueObject.java index 62bf4ec..abbb664 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/annotation/ValueObject.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/annotation/ValueObject.java @@ -26,7 +26,7 @@ import java.lang.annotation.Target; * ValueObject - 值对象 * * @author ZhouXY - * @since 0.1.0 + * @since 1.0.0 */ @Inherited @Target(ElementType.TYPE) diff --git a/src/main/java/xyz/zhouxy/plusone/commons/annotation/Virtual.java b/src/main/java/xyz/zhouxy/plusone/commons/annotation/Virtual.java index 3302ded..e5e32cd 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/annotation/Virtual.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/annotation/Virtual.java @@ -26,7 +26,7 @@ import java.lang.annotation.Target; *

该注解用于提醒、强调父类虽然有默认实现，但子类可以根据自己的需要覆写。

* * @author ZhouXY - * @since 0.1.0 + * @since 1.0.0 */ @Target(ElementType.METHOD) @Retention(RetentionPolicy.SOURCE) diff --git a/src/main/java/xyz/zhouxy/plusone/commons/annotation/WriterMethod.java b/src/main/java/xyz/zhouxy/plusone/commons/annotation/WriterMethod.java index f2aa0fb..2116793 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/annotation/WriterMethod.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/annotation/WriterMethod.java @@ -28,7 +28,7 @@ import java.lang.annotation.Target; * 标识方法是写方法，如 setter。 * * @author ZhouXY - * @since 1.0 + * @since 1.0.0 * @see ReaderMethod */ @Target(ElementType.METHOD) diff --git a/src/main/java/xyz/zhouxy/plusone/commons/collection/CollectionTools.java b/src/main/java/xyz/zhouxy/plusone/commons/collection/CollectionTools.java index 2f0c776..25d3e73 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/collection/CollectionTools.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/collection/CollectionTools.java @@ -34,7 +34,7 @@ import com.google.common.collect.Table; * 集合工具类 * * @author ZhouXY - * @since 0.1.0 + * @since 1.0.0 */ public class CollectionTools { diff --git a/src/main/java/xyz/zhouxy/plusone/commons/exception/DataNotExistsException.java b/src/main/java/xyz/zhouxy/plusone/commons/exception/DataNotExistsException.java index 5877a68..4c6bea0 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/exception/DataNotExistsException.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/exception/DataNotExistsException.java @@ -20,7 +20,7 @@ package xyz.zhouxy.plusone.commons.exception; * 数据不存在异常 * * @author ZhouXY - * @since 0.1.0 + * @since 1.0.0 */ public final class DataNotExistsException extends Exception { diff --git a/src/main/java/xyz/zhouxy/plusone/commons/exception/ParsingFailureException.java b/src/main/java/xyz/zhouxy/plusone/commons/exception/ParsingFailureException.java index 69a1d65..af59d7c 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/exception/ParsingFailureException.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/exception/ParsingFailureException.java @@ -36,7 +36,7 @@ import xyz.zhouxy.plusone.commons.exception.MultiTypesException.ExceptionType; *

* * @author ZhouXY - * @since 0.1.0 + * @since 1.0.0 */ public final class ParsingFailureException extends RuntimeException diff --git a/src/main/java/xyz/zhouxy/plusone/commons/exception/business/BizException.java b/src/main/java/xyz/zhouxy/plusone/commons/exception/business/BizException.java index ed4b664..f07b49d 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/exception/business/BizException.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/exception/business/BizException.java @@ -27,7 +27,7 @@ package xyz.zhouxy.plusone.commons.exception.business; * NOTE: 通常表示业务中的意外情况。如：用户错误输入、缺失必填字段、用户余额不足等。 *

* @author ZhouXY - * @since 0.1.0 + * @since 1.0.0 */ public class BizException extends RuntimeException { diff --git a/src/main/java/xyz/zhouxy/plusone/commons/exception/business/InvalidInputException.java b/src/main/java/xyz/zhouxy/plusone/commons/exception/business/InvalidInputException.java index ec4cb55..53fc682 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/exception/business/InvalidInputException.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/exception/business/InvalidInputException.java @@ -32,7 +32,7 @@ import xyz.zhouxy.plusone.commons.exception.MultiTypesException; * NOTE: 属业务异常 *

* @author ZhouXY - * @since 0.1.0 + * @since 1.0.0 */ public final class InvalidInputException extends RequestParamsException diff --git a/src/main/java/xyz/zhouxy/plusone/commons/exception/business/RequestParamsException.java b/src/main/java/xyz/zhouxy/plusone/commons/exception/business/RequestParamsException.java index 4d9155a..c6e3638 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/exception/business/RequestParamsException.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/exception/business/RequestParamsException.java @@ -24,7 +24,7 @@ package xyz.zhouxy.plusone.commons.exception.business; *

* * @author ZhouXY - * @since 0.1.0 + * @since 1.0.0 */ public class RequestParamsException extends BizException { diff --git a/src/main/java/xyz/zhouxy/plusone/commons/exception/system/DataOperationResultException.java b/src/main/java/xyz/zhouxy/plusone/commons/exception/system/DataOperationResultException.java index bbb49f6..bffbeb0 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/exception/system/DataOperationResultException.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/exception/system/DataOperationResultException.java @@ -29,7 +29,7 @@ package xyz.zhouxy.plusone.commons.exception.system; * 后续需要排查原因。 *

* @author ZhouXY - * @since 0.1.0 + * @since 1.0.0 */ public final class DataOperationResultException extends SysException { diff --git a/src/main/java/xyz/zhouxy/plusone/commons/exception/system/NoAvailableMacFoundException.java b/src/main/java/xyz/zhouxy/plusone/commons/exception/system/NoAvailableMacFoundException.java index d7c76f8..a02ffc6 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/exception/system/NoAvailableMacFoundException.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/exception/system/NoAvailableMacFoundException.java @@ -24,7 +24,7 @@ package xyz.zhouxy.plusone.commons.exception.system; *

* * @author ZhouXY - * @since 0.1.0 + * @since 1.0.0 */ public class NoAvailableMacFoundException extends SysException { private static final long serialVersionUID = 152827098461071551L; diff --git a/src/main/java/xyz/zhouxy/plusone/commons/exception/system/SysException.java b/src/main/java/xyz/zhouxy/plusone/commons/exception/system/SysException.java index 7480bd6..a0e9b3c 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/exception/system/SysException.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/exception/system/SysException.java @@ -24,7 +24,7 @@ package xyz.zhouxy.plusone.commons.exception.system; *

* * @author ZhouXY - * @since 0.1.0 + * @since 1.0.0 */ public class SysException extends RuntimeException { diff --git a/src/main/java/xyz/zhouxy/plusone/commons/function/OptionalSupplier.java b/src/main/java/xyz/zhouxy/plusone/commons/function/OptionalSupplier.java index 44988b2..ac572b3 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/function/OptionalSupplier.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/function/OptionalSupplier.java @@ -24,9 +24,9 @@ import java.util.function.Supplier; * *

* 返回 {@code Optional<T>} 对象。 - * + * * @author ZhouXY - * @since 0.1.0 + * @since 1.0.0 * @see Optional * @see Supplier */ diff --git a/src/main/java/xyz/zhouxy/plusone/commons/function/PredicateTools.java b/src/main/java/xyz/zhouxy/plusone/commons/function/PredicateTools.java index 2ff7a94..7b1be6c 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/function/PredicateTools.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/function/PredicateTools.java @@ -26,7 +26,7 @@ import java.util.function.Predicate; *

* * @author ZhouXY - * @since 0.1.0 + * @since 1.0.0 * @see Predicate */ public class PredicateTools { @@ -36,12 +36,12 @@ public class PredicateTools { * 如将 {@code Objects::nonNull} 明确地指定为 {@code Predicate<String>}， * 使之可以链式调用 {@link Predicate#and(Predicate)}、{@link Predicate#or(Predicate)} * 等方法，连接其它 {@code Predicate} 对象。 - * + * * 
      * Predicate<String> predicate = PredicateTools.<String>from(Objects::nonNull)
      *         .and(StringUtils::isNotEmpty);
      *
- * + * * @param 目标类型 * @param predicate Lambda 表达式 * @return 传入的表达式自动成为 {@link Predicate} 实例 diff --git a/src/main/java/xyz/zhouxy/plusone/commons/function/ToOptionalBiFunction.java b/src/main/java/xyz/zhouxy/plusone/commons/function/ToOptionalBiFunction.java index e236a12..3880bdd 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/function/ToOptionalBiFunction.java +++ b/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 ZhouXY - * @since 0.1.0 + * @since 1.0.0 * @see Optional * @see BiFunction */ diff --git a/src/main/java/xyz/zhouxy/plusone/commons/function/ToOptionalFunction.java b/src/main/java/xyz/zhouxy/plusone/commons/function/ToOptionalFunction.java index 88db3a4..e28c6be 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/function/ToOptionalFunction.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/function/ToOptionalFunction.java @@ -26,7 +26,7 @@ import java.util.function.Function; * 接受类型为 T 的参数，返回 {@code Optional<R>} 对象。 * * @author ZhouXY - * @since 0.1.0 + * @since 1.0.0 * @see Optional * @see Function */ diff --git a/src/main/java/xyz/zhouxy/plusone/commons/model/Chinese2ndGenIDCardNumber.java b/src/main/java/xyz/zhouxy/plusone/commons/model/Chinese2ndGenIDCardNumber.java index f802468..deb8eed 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/model/Chinese2ndGenIDCardNumber.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/model/Chinese2ndGenIDCardNumber.java @@ -39,7 +39,7 @@ import xyz.zhouxy.plusone.commons.util.StringTools; *

* * @author ZhouXY - * @since 1.0 + * @since 1.0.0 * @see xyz.zhouxy.plusone.commons.constant.PatternConsts#CHINESE_2ND_ID_CARD_NUMBER */ @ValueObject diff --git a/src/main/java/xyz/zhouxy/plusone/commons/model/ValidatableStringRecord.java b/src/main/java/xyz/zhouxy/plusone/commons/model/ValidatableStringRecord.java index c679a14..4db3c28 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/model/ValidatableStringRecord.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/model/ValidatableStringRecord.java @@ -30,7 +30,7 @@ import xyz.zhouxy.plusone.commons.util.AssertTools; * 带校验的字符串值对象 * * @author ZhouXY - * @since 0.1.0 + * @since 1.0.0 */ public abstract class ValidatableStringRecord> implements Comparable { diff --git a/src/main/java/xyz/zhouxy/plusone/commons/util/ArrayTools.java b/src/main/java/xyz/zhouxy/plusone/commons/util/ArrayTools.java index 8ad67ee..9044a77 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/util/ArrayTools.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/util/ArrayTools.java @@ -37,7 +37,7 @@ import javax.annotation.Nullable; *

* * @author ZhouXY - * @since 0.1.0 + * @since 1.0.0 */ public class ArrayTools { diff --git a/src/main/java/xyz/zhouxy/plusone/commons/util/BigDecimals.java b/src/main/java/xyz/zhouxy/plusone/commons/util/BigDecimals.java index 1b006c7..61e6bdf 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/util/BigDecimals.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/util/BigDecimals.java @@ -31,7 +31,7 @@ import xyz.zhouxy.plusone.commons.annotation.StaticFactoryMethod; *

* * @author ZhouXY - * @since 0.1.0 + * @since 1.0.0 */ public class BigDecimals { diff --git a/src/main/java/xyz/zhouxy/plusone/commons/util/OptionalTools.java b/src/main/java/xyz/zhouxy/plusone/commons/util/OptionalTools.java index 7abfe59..b36f41a 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/util/OptionalTools.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/util/OptionalTools.java @@ -32,7 +32,7 @@ import com.google.common.annotations.Beta; * 提供一些 Optional 相关的方法 * * @author ZhouXY - * @since 0.1.0 + * @since 1.0.0 * @see Optional * @see OptionalInt * @see OptionalLong diff --git a/src/main/java/xyz/zhouxy/plusone/commons/util/TreeBuilder.java b/src/main/java/xyz/zhouxy/plusone/commons/util/TreeBuilder.java index 824d645..e571806 100644 --- a/src/main/java/xyz/zhouxy/plusone/commons/util/TreeBuilder.java +++ b/src/main/java/xyz/zhouxy/plusone/commons/util/TreeBuilder.java @@ -31,7 +31,7 @@ import javax.annotation.Nullable; * TreeBuilder * * @author ZhouXY - * @since 1.0 + * @since 1.0.0 */ public class TreeBuilder { private final Function identityGetter;