2 Commits

Author SHA1 Message Date
58175cc74f chore: 更新代码仓库地址 2025-07-25 10:25:41 +08:00
f4c3793aab chore: 修改 @author 信息 (#59@Gitea)
Co-authored-by: ZhouXY108 <luquanlion@outlook.com>
Co-committed-by: ZhouXY108 <luquanlion@outlook.com>
2025-07-25 10:23:26 +08:00
73 changed files with 73 additions and 73 deletions

View File

@@ -211,7 +211,7 @@ throw LoginException.Type.TOKEN_TIMEOUT.create();
#### 2. UnifiedResponse #### 2. UnifiedResponse
UnifiedResponse 对返回给前端的数据进行封装,包含 `code`、`message`、`data。` UnifiedResponse 对返回给前端的数据进行封装,包含 `code`、`message`、`data。`
可使用 `UnifiedResponses` 快速构建 `UnifiedResponse` 对象。 `UnifiedResponses` 默认的成功代码为 "2000000" 用户按测试类 `CustomUnifiedResponseFactoryTests` 中所示范的,继承 `UnifiedResponses` 实现自己的工厂类, 自定义 `SUCCESS_CODE` 和 `DEFAULT_SUCCESS_MSG` 和工厂方法。 见 [issue#22](http://zhouxy.xyz:3000/plusone/plusone-commons/issues/22)。 可使用 `UnifiedResponses` 快速构建 `UnifiedResponse` 对象。 `UnifiedResponses` 默认的成功代码为 "2000000" 用户按测试类 `CustomUnifiedResponseFactoryTests` 中所示范的,继承 `UnifiedResponses` 实现自己的工厂类, 自定义 `SUCCESS_CODE` 和 `DEFAULT_SUCCESS_MSG` 和工厂方法。 见 [issue#22](http://gitea.zhouxy.xyz/plusone/plusone-commons/issues/22)。
## 八、time - 时间 API ## 八、time - 时间 API
### 1. 季度 ### 1. 季度

View File

@@ -27,7 +27,7 @@ import java.lang.annotation.Target;
* <p> * <p>
* 标识方法是读方法,如 getter。 * 标识方法是读方法,如 getter。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
* @see WriterMethod * @see WriterMethod
*/ */

View File

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

View File

@@ -27,7 +27,7 @@ import java.lang.annotation.Documented;
* *
* <p>标识方法为不支持的操作。该方法将抛出 {@link UnsupportedOperationException}。 * <p>标识方法为不支持的操作。该方法将抛出 {@link UnsupportedOperationException}。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @version 1.0 * @version 1.0
* @since 1.0.0 * @since 1.0.0
* @see UnsupportedOperationException * @see UnsupportedOperationException

View File

@@ -25,7 +25,7 @@ import java.lang.annotation.Target;
/** /**
* ValueObject - 值对象 * ValueObject - 值对象
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
*/ */
@Inherited @Inherited

View File

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

View File

@@ -27,7 +27,7 @@ import java.lang.annotation.Target;
* <p> * <p>
* 标识方法是写方法,如 setter。 * 标识方法是写方法,如 setter。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
* @see ReaderMethod * @see ReaderMethod
*/ */

View File

@@ -54,6 +54,6 @@
* <p> * <p>
* 标记一个类,表示其作为值对象,区别于 Entity。 * 标记一个类,表示其作为值对象,区别于 Entity。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
package xyz.zhouxy.plusone.commons.annotation; package xyz.zhouxy.plusone.commons.annotation;

View File

@@ -26,7 +26,7 @@ import javax.annotation.Nullable;
* 用于像自定义异常等需要带有 {@code code} 字段的类, * 用于像自定义异常等需要带有 {@code code} 字段的类,
* 方便其它地方的程序判断该类的是否实现了此接口,以此获取其实例的 {@code code} 字段的值。 * 方便其它地方的程序判断该类的是否实现了此接口,以此获取其实例的 {@code code} 字段的值。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
public interface IWithCode<T> { public interface IWithCode<T> {

View File

@@ -25,7 +25,7 @@ import javax.annotation.Nullable;
* 用于像自定义异常等需要带有 {@code code} 字段的类, * 用于像自定义异常等需要带有 {@code code} 字段的类,
* 方便其它地方的程序判断该类的是否实现了此接口,以此获取其实例的 {@code code} 字段的值。 * 方便其它地方的程序判断该类的是否实现了此接口,以此获取其实例的 {@code code} 字段的值。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
public interface IWithIntCode { public interface IWithIntCode {

View File

@@ -25,7 +25,7 @@ import javax.annotation.Nullable;
* 用于像自定义异常等需要带有 {@code code} 字段的类, * 用于像自定义异常等需要带有 {@code code} 字段的类,
* 方便其它地方的程序判断该类的是否实现了此接口,以此获取其实例的 {@code code} 字段的值。 * 方便其它地方的程序判断该类的是否实现了此接口,以此获取其实例的 {@code code} 字段的值。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
public interface IWithLongCode { public interface IWithLongCode {

View File

@@ -67,7 +67,7 @@ import javax.annotation.Nullable;
* System.out.println(result); // Output: Return string * System.out.println(result); // Output: Return string
* </pre> * </pre>
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
*/ */
public final class Ref<T> { public final class Ref<T> {

View File

@@ -66,7 +66,7 @@
* 类似于枚举这样的类型,通常需要设置固定的码值表示对应的含义。 * 类似于枚举这样的类型,通常需要设置固定的码值表示对应的含义。
* 可实现 {@link IWithCode}、{@link IWithIntCode}、{@link IWithLongCode},便于在需要的地方对这些接口的实现进行处理。 * 可实现 {@link IWithCode}、{@link IWithIntCode}、{@link IWithLongCode},便于在需要的地方对这些接口的实现进行处理。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
@CheckReturnValue @CheckReturnValue
@ParametersAreNonnullByDefault @ParametersAreNonnullByDefault

View File

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

View File

@@ -22,7 +22,7 @@
* </h3> * </h3>
* 集合工具类 * 集合工具类
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
@ParametersAreNonnullByDefault @ParametersAreNonnullByDefault
package xyz.zhouxy.plusone.commons.collection; package xyz.zhouxy.plusone.commons.collection;

View File

@@ -21,7 +21,7 @@ import java.util.regex.Pattern;
/** /**
* 正则表达式常量 * 正则表达式常量
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @see RegexConsts * @see RegexConsts
* @see xyz.zhouxy.plusone.commons.util.RegexTools * @see xyz.zhouxy.plusone.commons.util.RegexTools
*/ */

View File

@@ -19,7 +19,7 @@ package xyz.zhouxy.plusone.commons.constant;
/** /**
* 正则表达式常量 * 正则表达式常量
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @see PatternConsts * @see PatternConsts
*/ */
public final class RegexConsts { public final class RegexConsts {

View File

@@ -22,7 +22,7 @@
* </h3> * </h3>
* {@link RegexConsts} 包含常见正则表达式;{@link PatternConsts} 包含对应的 {@link Pattern} 对象。 * {@link RegexConsts} 包含常见正则表达式;{@link PatternConsts} 包含对应的 {@link Pattern} 对象。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
package xyz.zhouxy.plusone.commons.constant; package xyz.zhouxy.plusone.commons.constant;

View File

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

View File

@@ -124,7 +124,7 @@ import xyz.zhouxy.plusone.commons.base.IWithCode;
* *
* @param <X> 具体异常类 * @param <X> 具体异常类
* @param <T> 异常场景 * @param <T> 异常场景
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
*/ */
public interface IMultiTypesException< public interface IMultiTypesException<

View File

@@ -34,7 +34,7 @@ import xyz.zhouxy.plusone.commons.exception.IMultiTypesException.IExceptionType;
* throw new RequestParamsException(ParsingFailureException.Type.NUMBER_PARSING_FAILURE.create()); * throw new RequestParamsException(ParsingFailureException.Type.NUMBER_PARSING_FAILURE.create());
* </pre> * </pre>
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
*/ */
public final class ParsingFailureException public final class ParsingFailureException

View File

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

View File

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

View File

@@ -22,7 +22,7 @@ package xyz.zhouxy.plusone.commons.exception.business;
* <p> * <p>
* 用户请求参数错误 * 用户请求参数错误
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
*/ */
public class RequestParamsException extends BizException { public class RequestParamsException extends BizException {

View File

@@ -17,6 +17,6 @@
/** /**
* 业务异常 * 业务异常
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
package xyz.zhouxy.plusone.commons.exception.business; package xyz.zhouxy.plusone.commons.exception.business;

View File

@@ -121,7 +121,7 @@
* <h3>3. 系统异常</h3> * <h3>3. 系统异常</h3>
* 预设常见的系统异常。可继承 {@link SysException} 自定义系统异常。 * 预设常见的系统异常。可继承 {@link SysException} 自定义系统异常。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
package xyz.zhouxy.plusone.commons.exception; package xyz.zhouxy.plusone.commons.exception;

View File

@@ -27,7 +27,7 @@ package xyz.zhouxy.plusone.commons.exception.system;
* 当出现这种始料未及的诡异情况时,抛出 {@link DataOperationResultException} 并回滚事务。 * 当出现这种始料未及的诡异情况时,抛出 {@link DataOperationResultException} 并回滚事务。
* 后续需要排查原因。 * 后续需要排查原因。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
*/ */
public final class DataOperationResultException extends SysException { public final class DataOperationResultException extends SysException {

View File

@@ -22,7 +22,7 @@ package xyz.zhouxy.plusone.commons.exception.system;
* <p> * <p>
* 在无法找到可访问的 Mac 地址时抛出 * 在无法找到可访问的 Mac 地址时抛出
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
*/ */
public class NoAvailableMacFoundException extends SysException { public class NoAvailableMacFoundException extends SysException {

View File

@@ -22,7 +22,7 @@ package xyz.zhouxy.plusone.commons.exception.system;
* <p> * <p>
* 通常表示应用代码存在问题,或因环境问题,引发异常。 * 通常表示应用代码存在问题,或因环境问题,引发异常。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
*/ */
public class SysException extends RuntimeException { public class SysException extends RuntimeException {

View File

@@ -17,6 +17,6 @@
/** /**
* 系统异常 * 系统异常
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
package xyz.zhouxy.plusone.commons.exception.system; package xyz.zhouxy.plusone.commons.exception.system;

View File

@@ -25,7 +25,7 @@ import com.google.common.annotations.Beta;
* 一个特殊的 {@link java.util.function.UnaryOperator}。 * 一个特殊的 {@link java.util.function.UnaryOperator}。
* 表示对 {@code boolean} 值的一元操作。 * 表示对 {@code boolean} 值的一元操作。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
* @see java.util.function.UnaryOperator * @see java.util.function.UnaryOperator
*/ */

View File

@@ -25,7 +25,7 @@ import com.google.common.annotations.Beta;
* 一个特殊的 {@link java.util.function.UnaryOperator}。 * 一个特殊的 {@link java.util.function.UnaryOperator}。
* 表示对 {@code char} 的一元操作。 * 表示对 {@code char} 的一元操作。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
* @see java.util.function.UnaryOperator * @see java.util.function.UnaryOperator
*/ */

View File

@@ -24,7 +24,7 @@ package xyz.zhouxy.plusone.commons.function;
* *
* @param <E> 可抛出的异常类型 * @param <E> 可抛出的异常类型
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
*/ */
@FunctionalInterface @FunctionalInterface

View File

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

View File

@@ -24,7 +24,7 @@ import java.util.function.Predicate;
* <p> * <p>
* {@link Predicate} 相关操作。 * {@link Predicate} 相关操作。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
* @see Predicate * @see Predicate
*/ */

View File

@@ -22,7 +22,7 @@ package xyz.zhouxy.plusone.commons.function;
* <p> * <p>
* 允许抛出异常的消费操作。是一个特殊的 {@link java.util.function.Consumer}。 * 允许抛出异常的消费操作。是一个特殊的 {@link java.util.function.Consumer}。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
* @see java.util.function.Consumer * @see java.util.function.Consumer
*/ */

View File

@@ -25,7 +25,7 @@ package xyz.zhouxy.plusone.commons.function;
* @param <R> 返回结果类型 * @param <R> 返回结果类型
* @param <E> 异常类型 * @param <E> 异常类型
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0 * @since 1.0
* @see java.util.function.Function * @see java.util.function.Function
*/ */

View File

@@ -22,7 +22,7 @@ package xyz.zhouxy.plusone.commons.function;
* <p> * <p>
* 接收一个参数,返回一个布尔值,可抛出异常。 * 接收一个参数,返回一个布尔值,可抛出异常。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
* @see java.util.function.Predicate * @see java.util.function.Predicate
*/ */

View File

@@ -25,7 +25,7 @@ package xyz.zhouxy.plusone.commons.function;
* @param <T> 结果类型 * @param <T> 结果类型
* @param <E> 异常类型 * @param <E> 异常类型
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
* @see java.util.function.Supplier * @see java.util.function.Supplier
*/ */

View File

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

View File

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

View File

@@ -39,6 +39,6 @@
* | Optional | ToOptionalFunction | Optional&lt;R&gt; apply(T) | * | Optional | ToOptionalFunction | Optional&lt;R&gt; apply(T) |
* </pre> * </pre>
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
package xyz.zhouxy.plusone.commons.function; package xyz.zhouxy.plusone.commons.function;

View File

@@ -33,7 +33,7 @@ import com.google.gson.stream.JsonWriter;
/** /**
* 包含 JSR-310 相关数据类型的 {@code TypeAdapter} * 包含 JSR-310 相关数据类型的 {@code TypeAdapter}
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.1.0 * @since 1.1.0
* @see TypeAdapter * @see TypeAdapter
* @see com.google.gson.GsonBuilder * @see com.google.gson.GsonBuilder

View File

@@ -42,7 +42,7 @@ import xyz.zhouxy.plusone.commons.util.StringTools;
* <p> * <p>
* 中国第二代居民身份证号 * 中国第二代居民身份证号
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
* @see xyz.zhouxy.plusone.commons.constant.PatternConsts#CHINESE_2ND_ID_CARD_NUMBER * @see xyz.zhouxy.plusone.commons.constant.PatternConsts#CHINESE_2ND_ID_CARD_NUMBER
*/ */

View File

@@ -23,7 +23,7 @@ import xyz.zhouxy.plusone.commons.base.IWithIntCode;
/** /**
* 性别 * 性别
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
public enum Gender implements IWithIntCode { public enum Gender implements IWithIntCode {
UNKNOWN(0, "Unknown", "未知"), UNKNOWN(0, "Unknown", "未知"),

View File

@@ -24,7 +24,7 @@ import xyz.zhouxy.plusone.commons.util.StringTools;
/** /**
* 身份证号 * 身份证号
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
public interface IDCardNumber { public interface IDCardNumber {

View File

@@ -31,7 +31,7 @@ import xyz.zhouxy.plusone.commons.annotation.ReaderMethod;
/** /**
* 带校验的字符串值对象 * 带校验的字符串值对象
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
* *
* @deprecated 弃用。使用工厂方法创建对象,并在其中进行校验即可。 * @deprecated 弃用。使用工厂方法创建对象,并在其中进行校验即可。

View File

@@ -29,7 +29,7 @@ import xyz.zhouxy.plusone.commons.collection.CollectionTools;
* *
* @param <T> 内容列表的元素类型 * @param <T> 内容列表的元素类型
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @see PagingAndSortingQueryParams * @see PagingAndSortingQueryParams
*/ */
public class PageResult<T> { public class PageResult<T> {

View File

@@ -39,7 +39,7 @@ import xyz.zhouxy.plusone.commons.util.StringTools;
* 根据传入的 {@code size} 和 {@code pageNum} * 根据传入的 {@code size} 和 {@code pageNum}
* 提供 {@code getOffset} 方法计算 SQL 语句中 {@code offset} 的值。 * 提供 {@code getOffset} 方法计算 SQL 语句中 {@code offset} 的值。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @see PagingParams * @see PagingParams
* @see PageResult * @see PageResult
*/ */

View File

@@ -24,7 +24,7 @@ import xyz.zhouxy.plusone.commons.model.dto.PagingAndSortingQueryParams.Sortable
/** /**
* 分页参数 * 分页参数
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @see PagingAndSortingQueryParams * @see PagingAndSortingQueryParams
*/ */
public class PagingParams { public class PagingParams {

View File

@@ -22,7 +22,7 @@ import javax.annotation.Nullable;
/** /**
* 统一结果,对返回给前端的数据进行封装。 * 统一结果,对返回给前端的数据进行封装。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
public class UnifiedResponse<T> { public class UnifiedResponse<T> {

View File

@@ -21,7 +21,7 @@ import javax.annotation.Nullable;
/** /**
* UnifiedResponse 工厂 * UnifiedResponse 工厂
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
* @see UnifiedResponse * @see UnifiedResponse
*/ */

View File

@@ -60,7 +60,7 @@
* 自定义 SUCCESS_CODE 和 DEFAULT_SUCCESS_MSG 和工厂方法。 * 自定义 SUCCESS_CODE 和 DEFAULT_SUCCESS_MSG 和工厂方法。
* 见 <a href="http://zhouxy.xyz:3000/plusone/plusone-commons/issues/22">issue#22</a>。 * 见 <a href="http://zhouxy.xyz:3000/plusone/plusone-commons/issues/22">issue#22</a>。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
@ParametersAreNonnullByDefault @ParametersAreNonnullByDefault
package xyz.zhouxy.plusone.commons.model.dto; package xyz.zhouxy.plusone.commons.model.dto;

View File

@@ -19,7 +19,7 @@
* <p> * <p>
* 包含业务建模可能用到的性别、身份证等元素,也包含 DTO 相关类,如分页查询参数,响应结果,分页结果等。 * 包含业务建模可能用到的性别、身份证等元素,也包含 DTO 相关类,如分页查询参数,响应结果,分页结果等。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
@ParametersAreNonnullByDefault @ParametersAreNonnullByDefault
package xyz.zhouxy.plusone.commons.model; package xyz.zhouxy.plusone.commons.model;

View File

@@ -32,7 +32,7 @@ import xyz.zhouxy.plusone.commons.base.IWithIntCode;
/** /**
* 季度 * 季度
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
public enum Quarter implements IWithIntCode { public enum Quarter implements IWithIntCode {
/** 第一季度 */ /** 第一季度 */

View File

@@ -37,7 +37,7 @@ import xyz.zhouxy.plusone.commons.annotation.StaticFactoryMethod;
/** /**
* 表示年份与季度 * 表示年份与季度
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
@Immutable @Immutable
public final class YearQuarter implements Comparable<YearQuarter>, Serializable { public final class YearQuarter implements Comparable<YearQuarter>, Serializable {

View File

@@ -22,7 +22,7 @@
* 模仿 JDK 的 {@link java.time.Month} 和 {@link java.time.YearMonth} * 模仿 JDK 的 {@link java.time.Month} 和 {@link java.time.YearMonth}
* 实现 {@link Quarter}{@link YearQuarter},对季度进行建模。 * 实现 {@link Quarter}{@link YearQuarter},对季度进行建模。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
@ParametersAreNonnullByDefault @ParametersAreNonnullByDefault
package xyz.zhouxy.plusone.commons.time; package xyz.zhouxy.plusone.commons.time;

View File

@@ -37,7 +37,7 @@ import javax.annotation.Nullable;
* <p> * <p>
* 数组工具类 * 数组工具类
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
*/ */
public class ArrayTools { public class ArrayTools {

View File

@@ -39,7 +39,7 @@ import xyz.zhouxy.plusone.commons.exception.system.DataOperationResultException;
* "must be a well-formed email address"); * "must be a well-formed email address");
* </pre> * </pre>
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
public class AssertTools { public class AssertTools {

View File

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

View File

@@ -40,7 +40,7 @@ import xyz.zhouxy.plusone.commons.time.YearQuarter;
/** /**
* 日期时间工具类 * 日期时间工具类
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
public class DateTimeTools { public class DateTimeTools {

View File

@@ -26,7 +26,7 @@ import javax.annotation.Nullable;
/** /**
* 枚举工具类 * 枚举工具类
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
public final class EnumTools { public final class EnumTools {

View File

@@ -35,7 +35,7 @@ import xyz.zhouxy.plusone.commons.annotation.StaticFactoryMethod;
* *
* 参考 <a href="https://lostechies.com/jimmybogard/2008/08/12/enumeration-classes/">Enumeration classes</a> * 参考 <a href="https://lostechies.com/jimmybogard/2008/08/12/enumeration-classes/">Enumeration classes</a>
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @deprecated 设计 Enumeration 的灵感来自于 .net 社区,因为 C&num; 的枚举不带行为。 * @deprecated 设计 Enumeration 的灵感来自于 .net 社区,因为 C&num; 的枚举不带行为。
* 但 Java 的枚举可以带行为,故大多数情况下不需要这种设计。 * 但 Java 的枚举可以带行为,故大多数情况下不需要这种设计。
*/ */

View File

@@ -30,7 +30,7 @@ import java.util.concurrent.ConcurrentHashMap;
* *
* @see UUID * @see UUID
* @see IdWorker * @see IdWorker
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
public class IdGenerator { public class IdGenerator {

View File

@@ -19,7 +19,7 @@ package xyz.zhouxy.plusone.commons.util;
/** /**
* Joda-Time 工具类 * Joda-Time 工具类
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
public class JodaTimeTools { public class JodaTimeTools {

View File

@@ -25,7 +25,7 @@ import javax.annotation.Nullable;
/** /**
* 数字工具类 * 数字工具类
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
public class Numbers { public class Numbers {

View File

@@ -31,7 +31,7 @@ import com.google.common.annotations.Beta;
* <p> * <p>
* 提供一些 Optional 相关的方法 * 提供一些 Optional 相关的方法
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
* @see Optional * @see Optional
* @see OptionalInt * @see OptionalInt

View File

@@ -29,7 +29,7 @@ import java.util.concurrent.ThreadLocalRandom;
* <p> * <p>
* 建议调用方自行维护 Random 对象 * 建议调用方自行维护 Random 对象
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
public final class RandomTools { public final class RandomTools {

View File

@@ -35,7 +35,7 @@ import com.google.common.cache.LoadingCache;
/** /**
* 封装一些常用的正则操作,并可以缓存 {@link Pattern} 实例以复用。 * 封装一些常用的正则操作,并可以缓存 {@link Pattern} 实例以复用。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
public final class RegexTools { public final class RegexTools {

View File

@@ -34,7 +34,7 @@ import xyz.zhouxy.plusone.commons.constant.PatternConsts;
* <p> * <p>
* 字符串工具类。 * 字符串工具类。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
*/ */
public class StringTools { public class StringTools {

View File

@@ -32,7 +32,7 @@ import javax.annotation.Nullable;
/** /**
* TreeBuilder * TreeBuilder
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
* @since 1.0.0 * @since 1.0.0
*/ */
public class TreeBuilder<T, TSubTree extends T, TIdentity> { public class TreeBuilder<T, TSubTree extends T, TIdentity> {

View File

@@ -19,7 +19,7 @@
* <p> * <p>
* 包含树构建器({@link TreeBuilder})、断言工具({@link AssertTools}、ID 生成器({@link IdGenerator})及其它实用工具类。 * 包含树构建器({@link TreeBuilder})、断言工具({@link AssertTools}、ID 生成器({@link IdGenerator})及其它实用工具类。
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
@ParametersAreNonnullByDefault @ParametersAreNonnullByDefault
package xyz.zhouxy.plusone.commons.util; package xyz.zhouxy.plusone.commons.util;

View File

@@ -220,7 +220,7 @@ public class PagingAndSortingQueryParamsTests {
/** /**
* 账号信息查询参数 * 账号信息查询参数
* *
* @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a> * @author ZhouXY108 <luquanlion@outlook.com>
*/ */
@ToString(callSuper = true) @ToString(callSuper = true)
class AccountQueryParams extends PagingAndSortingQueryParams { class AccountQueryParams extends PagingAndSortingQueryParams {