Compare commits

...

10 Commits
dev ... 1.0.x

Author SHA1 Message Date
a901f3231d docs: fix param name 2025-04-11 14:47:49 +08:00
91c0c18960 1.0.2 2025-04-03 11:55:26 +08:00
bc7b3eefa8 fix: 补充 ThrowingPredicate 缺失的 FunctionalInterface 注解 2025-04-03 11:51:32 +08:00
746603f939 1.0.1 2025-03-28 12:10:44 +08:00
73a99b630c doc: 修改 since 信息
1.0.0 之前新增的,其 since 修改为 1.0.0,统一以 1.0.0 作为初始版本

fix plusone/plusone-commons#30
2025-03-28 11:35:12 +08:00
f5b04a7ae8 docs: 改正 PredicateTools 的 javadoc (#39)
Reviewed-on: #39
2025-03-28 10:39:56 +08:00
dde3d1d172 docs: 删除 IdWorker 的 author 信息
Reviewed-on: #37
2025-03-28 09:31:02 +08:00
e3d60ffe97 docs: 删除 IdWorker 的 author 信息
该工具来自 seata,并非本项目原创,写 javadoc 时忘记修改模板中的 author,而seata 源代码中早就删除了该类的 author 信息,故应先删除。

见:https://github.com/apache/incubator-seata/pull/6179

close plusone/plusone-commons#31
2025-03-28 09:22:55 +08:00
aadd1857de docs: 改正 OptionalTools 的 javadoc
Reviewed-on: #35
2025-03-28 09:08:23 +08:00
e98fe66b65 docs: fix javadoc
fix issue plusone/plusone-commons#29
2025-03-28 08:55:35 +08:00
29 changed files with 33 additions and 33 deletions

View File

@ -6,7 +6,7 @@
<groupId>xyz.zhouxy.plusone</groupId>
<artifactId>plusone-commons</artifactId>
<version>1.0.0</version>
<version>1.0.2</version>
<properties>
<!-- Basic properties -->

View File

@ -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)

View File

@ -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)

View File

@ -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

View File

@ -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)

View File

@ -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)

View File

@ -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)

View File

@ -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 {

View File

@ -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 {

View File

@ -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

View File

@ -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 {

View File

@ -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

View File

@ -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 {

View File

@ -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 {

View File

@ -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;

View File

@ -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 {

View File

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

View File

@ -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 {
@ -36,12 +36,12 @@ public class PredicateTools {
* 如将 {@code Objects::nonNull} 明确地指定为 {@code Predicate&lt;String&gt;}
* 使之可以链式调用 {@link Predicate#and(Predicate)}{@link Predicate#or(Predicate)}
* 等方法连接其它 {@code Predicate<? super T>} 对象
*
*
* <pre>
* Predicate&lt;String&gt; predicate = PredicateTools.&lt;String&gt;from(Objects::nonNull)
* .and(StringUtils::isNotEmpty);
* </pre>
*
*
* @param <T> 目标类型
* @param predicate Lambda 表达式
* @return 传入的表达式自动成为 {@link Predicate} 实例

View File

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

View File

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

View File

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

View File

@ -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

View File

@ -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> {

View File

@ -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 {

View File

@ -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 {

View File

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

View File

@ -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 {

View File

@ -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

View File

@ -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;