Merge remote-tracking branch 'origin/feature/add-copyright' into feature/add-copyright

README.md

@@ -19,10 +19,3 @@
 目前项目还没完成，开发中……
 
 相关的文档和介绍完善中……
-
-## 编码规约
-### 关于 null
-1. 方法默认参数不为 `null`，**可以**在 Javadoc 中对参数进行说明，如“...(must not be {@code null}[ or empty string])”。方法内部**必须**做参数校验，如使用 Assert 等工具类。
-2. 如果参数允许为空，**必须**为参数添加 `@Nullable` 注解，并在 Javadoc 中对参数进行说明，如“...(may be {@code null})”。
-3. 除极特殊的情况，方法默认**不返回 `null`**，如可能返回一个对象表示值的缺失，则**必须**使用 `Optional`，**绝不在返回类型为 Optional 的方法中返回 `null`**。
-4. 在极其特殊的情况下，方法需要返回 `null`，**必须**给方法加上 `@Nullable` 注解，并在 Javadoc 中详细说明。

err_code.json

@@ -222,10 +222,6 @@
               {
                 "code": 4040201,
                 "description": "不支持的 PrincipalType"
-              },
-              {
-                "code": 4040209,
-                "description": "不支持的菜单类型"
               }
             ]
           },

plusone-basic/plusone-basic-application/pom.xml

@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="https://maven.apache.org/POM/4.0.0" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
-
+<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>
         <artifactId>plusone-basic</artifactId>

plusone-basic/plusone-basic-application/src/main/java/xyz/zhouxy/plusone/exception/handler/AllExceptionHandlerConfig.java

@@ -1,13 +1,26 @@
-package xyz.zhouxy.plusone.exception.handler;
+/*
+ * Copyright 2022-2023 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.
+ */
 
-import javax.annotation.Nonnull;
+package xyz.zhouxy.plusone.exception.handler;
 
 import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 
-import xyz.zhouxy.plusone.commons.exception.handler.AllExceptionHandler;
-import xyz.zhouxy.plusone.commons.exception.handler.BaseExceptionHandler.ExceptionInfoHolder;
+import xyz.zhouxy.plusone.exception.handler.BaseExceptionHandler.ExceptionInfoHolder;
 
 /**
  * AllExceptionHandlerConfig
@@ -17,7 +30,7 @@ import xyz.zhouxy.plusone.commons.exception.handler.BaseExceptionHandler.Excepti
 public class AllExceptionHandlerConfig {
 
     @Bean
-    AllExceptionHandler getAllExceptionHandler(@Nonnull ExceptionInfoHolder exceptionInfoHolder) {
+    AllExceptionHandler getAllExceptionHandler(ExceptionInfoHolder exceptionInfoHolder) {
         return new AllExceptionHandler(exceptionInfoHolder);
     }
 }

plusone-basic/plusone-basic-application/src/main/java/xyz/zhouxy/plusone/exception/handler/DefaultExceptionHandler.java

@@ -1,6 +1,20 @@
-package xyz.zhouxy.plusone.exception.handler;
+/*
+ * Copyright 2022-2023 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.
+ */
 
-import javax.annotation.Nonnull;
+package xyz.zhouxy.plusone.exception.handler;
 
 import org.springframework.context.support.DefaultMessageSourceResolvable;
 import org.springframework.core.Ordered;
@@ -13,8 +27,7 @@ import org.springframework.web.bind.annotation.ExceptionHandler;
 import org.springframework.web.bind.annotation.RestControllerAdvice;
 
 import lombok.extern.slf4j.Slf4j;
-import xyz.zhouxy.plusone.commons.exception.handler.BaseExceptionHandler;
-import xyz.zhouxy.plusone.commons.util.UnifiedResponse;
+import xyz.zhouxy.plusone.commons.util.RestfulResult;
 
 /**
  * 默认异常的处理器
@@ -43,7 +56,7 @@ import xyz.zhouxy.plusone.commons.util.UnifiedResponse;
 @Order(Ordered.LOWEST_PRECEDENCE - 1)
 @Slf4j
 public class DefaultExceptionHandler extends BaseExceptionHandler {
-    public DefaultExceptionHandler(@Nonnull ExceptionInfoHolder exceptionInfoHolder) {
+    public DefaultExceptionHandler(ExceptionInfoHolder exceptionInfoHolder) {
         super(exceptionInfoHolder);
         set(IllegalArgumentException.class, 4010000, "格式错误", HttpStatus.FORBIDDEN);
         set(DataAccessException.class, 6030000, "数据库错误", HttpStatus.INTERNAL_SERVER_ERROR, true);
@@ -62,7 +75,7 @@ public class DefaultExceptionHandler extends BaseExceptionHandler {
             DataAccessException.class,
             MethodArgumentNotValidException.class
     })
-    public ResponseEntity<UnifiedResponse> handleException(Exception e) {
+    public ResponseEntity<RestfulResult> handleException(Exception e) {
         log.error(e.getMessage(), e);
         return buildExceptionResponse(e);
     }

plusone-basic/plusone-basic-application/src/main/java/xyz/zhouxy/plusone/exception/handler/SysExceptionHandler.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.exception.handler;
 
 import javax.annotation.Nonnull;
@@ -8,22 +24,21 @@ import org.springframework.web.bind.annotation.ExceptionHandler;
 import org.springframework.web.bind.annotation.RestControllerAdvice;
 
 import lombok.extern.slf4j.Slf4j;
-import xyz.zhouxy.plusone.commons.exception.handler.BaseExceptionHandler;
-import xyz.zhouxy.plusone.commons.util.UnifiedResponse;
+import xyz.zhouxy.plusone.commons.util.RestfulResult;
 import xyz.zhouxy.plusone.exception.SysException;
 
 @RestControllerAdvice
 @Slf4j
 public class SysExceptionHandler extends BaseExceptionHandler {
 
-    public SysExceptionHandler(@Nonnull ExceptionInfoHolder exceptionInfoHolder) {
+    public SysExceptionHandler(ExceptionInfoHolder exceptionInfoHolder) {
         super(exceptionInfoHolder);
     }
 
     @ExceptionHandler({ SysException.class })
-    public ResponseEntity<UnifiedResponse> handleException(@Nonnull Exception e) {
+    public ResponseEntity<RestfulResult> handleException(@Nonnull Exception e) {
         log.error(e.getMessage(), e);
         HttpStatus httpStatus = getHttpStatus(e);
-        return new ResponseEntity<>(UnifiedResponse.error(getErrorCode(e), "系统错误"), httpStatus);
+        return new ResponseEntity<>(RestfulResult.error(getErrorCode(e), "系统错误"), httpStatus);
     }
 }

plusone-basic/plusone-basic-common/pom.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="https://maven.apache.org/POM/4.0.0" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+<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>
         <artifactId>plusone-basic</artifactId>
@@ -49,7 +49,7 @@
         <dependency>
             <groupId>xyz.zhouxy.plusone</groupId>
             <artifactId>plusone-exception-handler</artifactId>
-            <version>0.0.9-SNAPSHOT</version>
+            <version>0.0.8-SNAPSHOT</version>
         </dependency>
     </dependencies>
 

plusone-basic/plusone-basic-common/src/main/java/xyz/zhouxy/plusone/constant/ErrorCodeConsts.java

@@ -1,9 +1,23 @@
+/*
+ * Copyright 2022-2023 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.constant;
 
 public class ErrorCodeConsts {
     public static final int DEFAULT_ERROR_CODE = 9999999;
-    public static final int DEFAULT_SYS_ERROR_CODE = 5000000;
-    public static final int DEFAULT_BIZ_ERROR_CODE = 4000000;
 
     private ErrorCodeConsts() {
         throw new IllegalStateException("Utility class");

plusone-basic/plusone-basic-common/src/main/java/xyz/zhouxy/plusone/exception/BizException.java

@@ -1,39 +1,55 @@
+/*
+ * Copyright 2022-2023 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.exception;
 
-import xyz.zhouxy.plusone.commons.exception.BaseRuntimeException;
+import xyz.zhouxy.plusone.commons.exception.BaseException;
 
 /**
  * 业务异常
  *
  * @author <a href="https://gitee.com/zhouxy108">ZhouXY</a>
  */
-public class BizException extends BaseRuntimeException {
+public class BizException extends BaseException {
     @java.io.Serial
     private static final long serialVersionUID = -5524759033245815405L;
 
-    public static final String DEFAULT_ERROR_CODE = "4000000";
+    public static final int DEFAULT_ERROR_CODE = 4000000;
 
-    public BizException(String code, String msg) {
+    public BizException(int code, String msg) {
         super(code, msg);
     }
 
-    public BizException(String code, Throwable cause) {
+    public BizException(int code, Throwable cause) {
         super(code, cause);
     }
 
-    public BizException(String code, String msg, Throwable cause) {
+    public BizException(int code, String msg, Throwable cause) {
         super(code, msg, cause);
     }
 
-    public static BizException of(String msg) {
-        return new BizException(DEFAULT_ERROR_CODE, msg);
+    public BizException(String msg) {
+        super(DEFAULT_ERROR_CODE, msg);
     }
 
-    public static BizException of(Throwable cause) {
-        return new BizException(DEFAULT_ERROR_CODE, cause);
+    public BizException(Throwable cause) {
+        super(DEFAULT_ERROR_CODE, cause);
     }
 
-    public static BizException of(String msg, Throwable cause) {
-        return new BizException(DEFAULT_ERROR_CODE, msg, cause);
+    public BizException(String msg, Throwable cause) {
+        super(DEFAULT_ERROR_CODE, msg, cause);
     }
 }

plusone-basic/plusone-basic-common/src/main/java/xyz/zhouxy/plusone/exception/DataNotExistException.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.exception;
 
 import org.springframework.http.HttpStatus;
@@ -14,7 +30,7 @@ public class DataNotExistException extends BizException {
     @java.io.Serial
     private static final long serialVersionUID = 6536955800679703111L;
 
-    public static final String ERROR_CODE = "4110100";
+    public static final int ERROR_CODE = 4110100;
 
     public DataNotExistException() {
         super(ERROR_CODE, "数据不存在");

plusone-basic/plusone-basic-common/src/main/java/xyz/zhouxy/plusone/exception/DataOperationResultException.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.exception;
 
 import org.springframework.http.HttpStatus;
@@ -18,7 +34,7 @@ public class DataOperationResultException extends SysException {
     @java.io.Serial
     private static final long serialVersionUID = -9220765735990318186L;
 
-    public static final String ERROR_CODE = "4110200";
+    public static final int ERROR_CODE = 4110200;
 
     public DataOperationResultException() {
         super(ERROR_CODE, "数据操作结果不符合预期");

plusone-basic/plusone-basic-common/src/main/java/xyz/zhouxy/plusone/exception/SysException.java

@@ -1,34 +1,50 @@
+/*
+ * Copyright 2022-2023 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.exception;
 
-import xyz.zhouxy.plusone.commons.exception.BaseRuntimeException;
+import xyz.zhouxy.plusone.commons.exception.BaseException;
 
-public class SysException extends BaseRuntimeException {
+public class SysException extends BaseException {
     @java.io.Serial
     private static final long serialVersionUID = 8821240827443168118L;
 
-    public static final String DEFAULT_ERROR_CODE = "5000000";
+    public static final int DEFAULT_ERROR_CODE = 5000000;
 
-    public SysException(String code, String msg) {
+    public SysException(int code, String msg) {
         super(code, msg);
     }
 
-    public SysException(String code, Throwable cause) {
+    public SysException(int code, Throwable cause) {
         super(code, cause);
     }
 
-    public SysException(String code, String msg, Throwable cause) {
+    public SysException(int code, String msg, Throwable cause) {
         super(code, msg, cause);
     }
 
-    public static SysException of(String msg) {
-        return new SysException(DEFAULT_ERROR_CODE, msg);
+    public SysException(String msg) {
+        super(DEFAULT_ERROR_CODE, msg);
     }
 
-    public static SysException of(Throwable cause) {
-        return new SysException(DEFAULT_ERROR_CODE, cause);
+    public SysException(Throwable cause) {
+        super(DEFAULT_ERROR_CODE, cause);
     }
 
-    public static SysException of(String msg, Throwable cause) {
-        return new SysException(DEFAULT_ERROR_CODE, msg, cause);
+    public SysException(String msg, Throwable cause) {
+        super(DEFAULT_ERROR_CODE, msg, cause);
     }
 }

plusone-basic/plusone-basic-common/src/main/java/xyz/zhouxy/plusone/exception/UserOperationException.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.exception;
 
 import org.springframework.http.HttpStatus;
@@ -14,28 +30,28 @@ public class UserOperationException extends BizException {
     @java.io.Serial
     private static final long serialVersionUID = 4371055414421991940L;
 
-    public static final String DEFAULT_ERROR_CODE = "4040600";
+    public static final int DEFAULT_ERROR_CODE = 4040600;
 
-    public UserOperationException(String code, String msg) {
+    public UserOperationException(String msg) {
+        super(DEFAULT_ERROR_CODE, msg);
+    }
+
+    public UserOperationException(String msg, Throwable cause) {
+        super(DEFAULT_ERROR_CODE, msg, cause);
+    }
+
+    public UserOperationException(int code, String msg) {
         super(code, msg);
     }
 
-    public UserOperationException(String code, Throwable cause) {
+    public UserOperationException(int code, Throwable cause) {
         super(code, cause);
     }
 
-    public UserOperationException(String code, String msg, Throwable cause) {
+    public UserOperationException(int code, String msg, Throwable cause) {
         super(code, msg, cause);
     }
 
-    public static UserOperationException of(String msg) {
-        return new UserOperationException(DEFAULT_ERROR_CODE, msg);
-    }
-
-    public static UserOperationException of(String msg, Throwable cause) {
-        return new UserOperationException(DEFAULT_ERROR_CODE, msg, cause);
-    }
-
     /**
      * 无效的操作
      *
@@ -52,7 +68,7 @@ public class UserOperationException extends BizException {
      * @return 异常对象
      */
     public static UserOperationException invalidOperation(String msg) {
-        return new UserOperationException("4040604", msg);
+        return new UserOperationException(4040604, msg);
     }
 
 }

plusone-basic/plusone-basic-common/src/main/java/xyz/zhouxy/plusone/util/AssertResult.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.util;
 
 import xyz.zhouxy.plusone.exception.DataNotExistException;

plusone-basic/plusone-basic-common/src/main/java/xyz/zhouxy/plusone/util/PlusoneStrUtil.java

@@ -1,5 +1,25 @@
+/*
+ * Copyright 2022-2023 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.util;
 
+import java.util.Objects;
+import java.util.regex.Pattern;
+
+import org.springframework.util.Assert;
 import org.springframework.util.StringUtils;
 
 /**
@@ -23,4 +43,17 @@ public class PlusoneStrUtil {
         return StringUtils.hasLength(value) ? value : EMPTY_STR;
     }
 
+    public static String checkString(String value, String regex, String message) {
+        Assert.notNull(value, message);
+        Assert.isTrue(Pattern.matches(regex, value), message);
+        return value;
+    }
+
+    public static String checkStringNullable(String value, String regex, String message) {
+        return Objects.nonNull(value) ? checkString(value, regex, message) : null;
+    }
+
+    public static String checkStringOrDefault(String value, String regex, String message) {
+        return StringUtils.hasText(value) ? checkString(value, regex, message) : "";
+    }
 }

plusone-basic/plusone-basic-common/src/main/java/xyz/zhouxy/plusone/util/RandomUtil.java

@@ -1,6 +1,6 @@
 package xyz.zhouxy.plusone.util;
 
-import java.security.SecureRandom;
+import java.util.concurrent.ThreadLocalRandom;
 
 public final class RandomUtil {
     private RandomUtil() {
@@ -8,7 +8,7 @@ public final class RandomUtil {
     }
 
     public static String randomStr(char[] sourceCharacters, int length) {
-        SecureRandom random = new SecureRandom();
+        ThreadLocalRandom random = ThreadLocalRandom.current();
         char[] result = new char[length];
         for (int i = 0; i < length; i++) {
             result[i] = sourceCharacters[random.nextInt(sourceCharacters.length)];

plusone-basic/plusone-basic-domain/pom.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="https://maven.apache.org/POM/4.0.0" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+<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</groupId>

plusone-basic/plusone-basic-domain/src/main/java/xyz/zhouxy/plusone/constant/EntityStatus.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.constant;
 
 import java.util.Collection;
@@ -21,12 +37,15 @@ public final class EntityStatus extends Enumeration<EntityStatus> {
     public static final EntityStatus AVAILABLE = new EntityStatus(0, "正常");
     public static final EntityStatus DISABLED = new EntityStatus(1, "禁用");
 
-    private static final ValueSet<EntityStatus> VALUE_SET = ValueSet.of(AVAILABLE, DISABLED);
+    private static final ValueSet<EntityStatus> VALUE_SET = new ValueSet<>(
+            AVAILABLE, DISABLED);
 
+    @Nonnull
     public static EntityStatus of(int id) {
         return VALUE_SET.get(id);
     }
 
+    @Nonnull
     public static Collection<EntityStatus> constants() {
         return VALUE_SET.getValues();
     }

plusone-basic/plusone-basic-domain/src/main/java/xyz/zhouxy/plusone/domain/AggregateRoot.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.domain;
 
 import java.io.Serializable;

plusone-basic/plusone-basic-domain/src/main/java/xyz/zhouxy/plusone/domain/DomainEvent.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.domain;
 
 import java.util.UUID;
@@ -17,8 +33,8 @@ import lombok.Getter;
  */
 @Getter
 public abstract class DomainEvent {
-    private final String identifier;
-    private final long happenedAt;
+    private String identifier;
+    private long happenedAt;
 
     protected DomainEvent() {
         this.identifier = UUID.randomUUID().toString();

plusone-basic/plusone-basic-domain/src/main/java/xyz/zhouxy/plusone/domain/Entity.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.domain;
 
 import java.io.Serializable;
@@ -5,8 +21,6 @@ import java.util.ArrayList;
 import java.util.List;
 import java.util.Optional;
 
-import xyz.zhouxy.plusone.commons.annotation.Overridable;
-
 /**
  * 实体
  *
@@ -28,29 +42,7 @@ public abstract class Entity<ID extends Serializable> {
 
     public abstract Optional<ID> getId();
 
-    protected final void addDomainEvent(DomainEvent domainEvent) {
+    protected void addDomainEvent(DomainEvent domainEvent) {
         domainEvents.add(domainEvent);
     }
-
-    public final List<DomainEvent> getDomainEvents() {
-        return List.copyOf(domainEvents);
-    }
-
-    @Override
-    @Overridable
-    public boolean equals(Object obj) {
-        return super.equals(obj);
-    }
-
-    @Override
-    @Overridable
-    public int hashCode() {
-        return super.hashCode();
-    }
-
-    @Override
-    @Overridable
-    public String toString() {
-        return super.toString();
-    }
 }

plusone-basic/plusone-basic-domain/src/main/java/xyz/zhouxy/plusone/domain/ICommand.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.domain;
 
 /**

plusone-basic/plusone-basic-domain/src/main/java/xyz/zhouxy/plusone/domain/ICommandHandler.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.domain;
 
 /**

plusone-basic/plusone-basic-domain/src/main/java/xyz/zhouxy/plusone/domain/IDomainEventPublisher.java

@@ -1,8 +0,0 @@
-package xyz.zhouxy.plusone.domain;
-
-public interface IDomainEventPublisher {
-
-    void publish(DomainEvent domainEvent);
-
-    <T extends DomainEvent> void subsrcibe(IDomainEventSubscriber<T> subscriber);
-}

plusone-basic/plusone-basic-domain/src/main/java/xyz/zhouxy/plusone/domain/IDomainEventSubscriber.java

@@ -1,11 +0,0 @@
-package xyz.zhouxy.plusone.domain;
-
-/**
- * 领域事件消费者
- */
-public interface IDomainEventSubscriber<T extends DomainEvent> {
-
-    void handleEvent(final T event);
-
-    Class<T> subscribedToEventType();
-}

plusone-basic/plusone-basic-domain/src/main/java/xyz/zhouxy/plusone/domain/IEventHandler.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.domain;
 
 /**

plusone-basic/plusone-basic-domain/src/main/java/xyz/zhouxy/plusone/domain/IRepository.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.domain;
 
 import java.io.Serializable;

plusone-basic/plusone-basic-domain/src/main/java/xyz/zhouxy/plusone/domain/IValueObject.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.domain;
 
 /**

plusone-basic/plusone-basic-domain/src/main/java/xyz/zhouxy/plusone/domain/IWithLabel.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.domain;
 
 /**

plusone-basic/plusone-basic-domain/src/main/java/xyz/zhouxy/plusone/domain/IWithOrderNumber.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.domain;
 
 import java.util.Comparator;

plusone-basic/plusone-basic-domain/src/main/java/xyz/zhouxy/plusone/domain/IWithVersion.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.domain;
 
 /**

plusone-basic/plusone-basic-domain/src/main/java/xyz/zhouxy/plusone/domain/ValidatableStringRecord.java

@@ -0,0 +1,57 @@
+/*
+ * Copyright 2022-2023 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.domain;
+
+import java.util.Optional;
+import java.util.regex.Pattern;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import com.fasterxml.jackson.annotation.JsonValue;
+
+/**
+ * 带校验的字符串值对象
+ *
+ * @author <a href="https://gitee.com/zhouxy108">ZhouXY</a>
+ */
+public abstract class ValidatableStringRecord implements IValueObject {
+
+    protected String value;
+    protected final Pattern format;
+
+    protected ValidatableStringRecord(Pattern format) {
+        this.format = format;
+    }
+
+    @JsonIgnore
+    protected boolean isValid() {
+        return format.matcher(value).matches();
+    }
+
+    @JsonValue
+    public String value() {
+        return value;
+    }
+
+    @Override
+    public String toString() {
+        return value;
+    }
+
+    public static String getValueOrNull(Optional<? extends ValidatableStringRecord> s) {
+        return s.isPresent() ? s.get().value() : null;
+    }
+}

plusone-basic/plusone-basic-infrastructure/pom.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="https://maven.apache.org/POM/4.0.0"
-    xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+<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</groupId>

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/config/PlusoneConfig.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.config;
 
 import org.springframework.context.annotation.Configuration;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/exception/config/PlusoneExceptionHandlerConfig.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.exception.config;
 
 import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
@@ -5,7 +21,7 @@ import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 
 import xyz.zhouxy.plusone.constant.ErrorCodeConsts;
-import xyz.zhouxy.plusone.commons.exception.handler.BaseExceptionHandler.ExceptionInfoHolder;
+import xyz.zhouxy.plusone.exception.handler.BaseExceptionHandler.ExceptionInfoHolder;
 
 @Configuration
 public class PlusoneExceptionHandlerConfig {

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/infrastructure/pojo/AbstractEntityPO.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.infrastructure.pojo;
 
 import java.time.LocalDateTime;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/jdbc/BeanPropertyParamSource.java

@@ -1,12 +1,24 @@
+/*
+ * Copyright 2022-2023 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.jdbc;
 
 import org.springframework.jdbc.core.namedparam.BeanPropertySqlParameterSource;
-import org.springframework.jdbc.core.namedparam.SqlParameterSource;
 import org.springframework.lang.Nullable;
 
-import xyz.zhouxy.plusone.commons.base.IWithCode;
-import xyz.zhouxy.plusone.commons.base.IWithIntCode;
-
 /**
  * 扩展了 {@link BeanPropertySqlParameterSource}，在将 POJO 转换为
  * {@link org.springframework.jdbc.core.namedparam.SqlParameterSource} 时，
@@ -29,14 +41,8 @@ public class BeanPropertyParamSource extends BeanPropertySqlParameterSource {
    @Nullable
    public Object getValue(String paramName) throws IllegalArgumentException {
        Object value = super.getValue(paramName);
-        if (value instanceof Enum<?> e) {
-            if (value instanceof IWithCode<?> c) {
-                return c.getCode();
-            }
-            if (value instanceof IWithIntCode c) {
-                return c.getCode();
-            }
-            return e.ordinal();
+       if (value instanceof Enum) {
+           return ((Enum<?>) value).ordinal();
        }
        return value;
    }

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/jdbc/JdbcConfig.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.jdbc;
 
 import java.util.List;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/jdbc/JdbcEntityDaoSupport.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.jdbc;
 
 import java.io.Serializable;
@@ -63,12 +79,10 @@ public abstract class JdbcEntityDaoSupport<T extends Entity<ID>, ID extends Seri
 
     protected abstract T mapRow(ResultSet rs) throws SQLException;
 
-    @Deprecated
     protected void setRowMapper(@Nonnull RowMapper<T> rowMapper) {
         this.rowMapper = rowMapper;
     }
 
-    @Deprecated
     protected void setResultSetExtractor(@Nonnull ResultSetExtractor<Optional<T>> resultSetExtractor) {
         this.resultSetExtractor = resultSetExtractor;
     }

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/jdbc/JdbcFactory.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.jdbc;
 
 import org.springframework.context.ApplicationContext;
@@ -7,7 +23,8 @@ import org.springframework.jdbc.core.namedparam.NamedParameterJdbcTemplate;
 import xyz.zhouxy.plusone.spring.SpringContextHolder;
 
 /**
- * 通过静态方法获取 Spring 容器中的 {@link JdbcTemplate} 和
+ * 全局单例，由 Spring 装配好的对象。
+ * 可通过静态方法获取 Spring 容器中的 {@link JdbcTemplate} 和
  * {@link NamedParameterJdbcTemplate} 对象。
  *
  * @author <a href="https://gitee.com/zhouxy108">ZhouXY</a>
@@ -16,19 +33,17 @@ import xyz.zhouxy.plusone.spring.SpringContextHolder;
  */
 public final class JdbcFactory {
 
-    private static final ApplicationContext SPRING_APPLICATION_CONTEXT = SpringContextHolder.getContext();
-    private static final JdbcTemplate JDBC_TEMPLATE = SPRING_APPLICATION_CONTEXT.getBean(JdbcTemplate.class);
-    private static final NamedParameterJdbcTemplate NAMED_PARAMETER_JDBC_TEMPLATE = SPRING_APPLICATION_CONTEXT.getBean(NamedParameterJdbcTemplate.class);
+    private static final ApplicationContext CONTEXT = SpringContextHolder.getContext();
 
     private JdbcFactory() {
         throw new IllegalStateException("Utility class");
     }
 
     public static JdbcTemplate getJdbcTemplate() {
-        return JDBC_TEMPLATE;
+        return CONTEXT.getBean(JdbcTemplate.class);
     }
 
     public static NamedParameterJdbcTemplate getNamedParameterJdbcTemplate() {
-        return NAMED_PARAMETER_JDBC_TEMPLATE;
+        return CONTEXT.getBean(NamedParameterJdbcTemplate.class);
     }
 }

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/jdbc/JdbcRepositorySupport.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.jdbc;
 
 import java.io.Serializable;
@@ -8,9 +24,6 @@ import javax.annotation.Nonnull;
 import org.springframework.jdbc.core.namedparam.NamedParameterJdbcTemplate;
 import org.springframework.jdbc.core.namedparam.SqlParameterSource;
 
-import com.google.common.base.Preconditions;
-
-import xyz.zhouxy.plusone.commons.annotation.Overridable;
 import xyz.zhouxy.plusone.domain.AggregateRoot;
 import xyz.zhouxy.plusone.domain.IRepository;
 
@@ -22,33 +35,35 @@ public abstract class JdbcRepositorySupport<T extends AggregateRoot<ID>, ID exte
         super(namedParameterJdbcTemplate);
     }
 
-    @Overridable
     protected abstract void doDelete(@Nonnull T entity);
 
-    @Overridable
     protected abstract Optional<T> doFindById(@Nonnull ID id);
 
-    @Overridable
     protected abstract T doInsert(@Nonnull T entity);
 
-    @Overridable
     protected abstract T doUpdate(@Nonnull T entity);
 
     @Override
     public final void delete(T entity) {
-        Preconditions.checkArgument(entity != null, "Cannot delete null.");
+        if (entity == null) {
+            throw new IllegalArgumentException("Cannot delete null.");
+        }
         doDelete(entity);
     }
 
     @Override
     public final Optional<T> find(ID id) {
-        Preconditions.checkArgument(id != null, "Id cannot be null.");
+        if (id == null) {
+            throw new IllegalArgumentException("Id cannot be null.");
+        }
         return doFindById(id);
     }
 
     @Override
     public final T save(T entity) {
-        Preconditions.checkArgument(entity != null, "Cannot save null.");
+        if (entity == null) {
+            throw new IllegalArgumentException("Cannot save null.");
+        }
         return entity.getId().isPresent() ? doUpdate(entity) : doInsert(entity);
     }
 

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/jdbc/PlusoneJdbcDaoSupport.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.jdbc;
 
 import java.util.Arrays;
@@ -16,7 +32,7 @@ import org.springframework.jdbc.core.namedparam.NamedParameterJdbcTemplate;
 import org.springframework.jdbc.core.namedparam.SqlParameterSource;
 import org.springframework.util.CollectionUtils;
 
-import xyz.zhouxy.plusone.commons.util.Numbers;
+import xyz.zhouxy.plusone.commons.util.NumberUtil;
 import xyz.zhouxy.plusone.exception.DataOperationResultException;
 
 public abstract class PlusoneJdbcDaoSupport {
@@ -88,64 +104,64 @@ public abstract class PlusoneJdbcDaoSupport {
 
     protected final long batchUpdate(String sql, SqlParameterSource[] batchArgs) {
         int[] i = this.jdbc.batchUpdate(sql, batchArgs);
-        return Numbers.sum(i);
+        return NumberUtil.sum(i);
     }
 
     protected final <T> long batchUpdate(String sql, Stream<T> c,
             @Nonnull Function<T, SqlParameterSource> paramSourceBuilder) {
         int[] i = this.jdbc.batchUpdate(sql, buildSqlParameterSourceArray(c, paramSourceBuilder));
-        return Numbers.sum(i);
+        return NumberUtil.sum(i);
     }
 
     protected final <T> long batchUpdate(String sql, Collection<T> c,
             @Nonnull Function<T, SqlParameterSource> paramSourceBuilder) {
         int[] i = this.jdbc.batchUpdate(sql, buildSqlParameterSourceArray(c, paramSourceBuilder));
-        return Numbers.sum(i);
+        return NumberUtil.sum(i);
     }
 
-    protected static <T> void assertResultEquals(T result, T expectedValue) {
+    protected static final <T> void assertResultEquals(T result, T expectedValue) {
         if (!Objects.equals(result, expectedValue)) {
             throw new DataOperationResultException();
         }
     }
 
-    protected static <T> void assertResultEquals(T result, T expectedValue, Function<T, String> errMsg) {
+    protected static final <T> void assertResultEquals(T result, T expectedValue, Function<T, String> errMsg) {
         if (!Objects.equals(result, expectedValue)) {
             throw new DataOperationResultException(errMsg.apply(result));
         }
     }
 
-    protected static <T> void assertResultEquals(T result, T expectedValue, String msgTemplate, Object... args) {
+    protected static final <T> void assertResultEquals(T result, T expectedValue, String msgTemplate, Object... args) {
         if (!Objects.equals(result, expectedValue)) {
             throw new DataOperationResultException(String.format(msgTemplate, args));
         }
     }
 
-    protected static <T, E extends Throwable> void assertResultEqualsOrThrow(T result, T expectedValue,
+    protected static final <T, E extends Throwable> void assertResultEqualsOrThrow(T result, T expectedValue,
             Function<T, E> e) throws E {
         if (!Objects.equals(result, expectedValue)) {
             throw e.apply(result);
         }
     }
 
-    protected static void assertUpdateOneRow(int result) {
+    protected static final void assertUpdateOneRow(int result) {
         assertResultEquals(result, 1);
     }
 
-    protected static void assertUpdateOneRow(int result, Function<Integer, String> errMsg) {
+    protected static final void assertUpdateOneRow(int result, Function<Integer, String> errMsg) {
         assertResultEquals(result, 1, errMsg);
     }
 
-    protected static void assertUpdateOneRow(int result, String msgTemplate, Object... args) {
+    protected static final void assertUpdateOneRow(int result, String msgTemplate, Object... args) {
         assertResultEquals(result, 1, msgTemplate, args);
     }
 
-    protected static <E extends Throwable> void assertUpdateOneRowOrThrow(int result, Function<Integer, E> e)
+    protected static final <E extends Throwable> void assertUpdateOneRowOrThrow(int result, Function<Integer, E> e)
             throws E {
         assertResultEqualsOrThrow(result, 1, e);
     }
 
-    protected static <T> SqlParameterSource[] buildSqlParameterSourceArray(
+    protected static final <T> SqlParameterSource[] buildSqlParameterSourceArray(
             T[] c,
             @Nonnull Function<T, SqlParameterSource> paramSourceBuilder) {
         if (c == null || c.length == 0) {
@@ -154,7 +170,7 @@ public abstract class PlusoneJdbcDaoSupport {
         return buildSqlParameterSourceArray(Arrays.stream(c), paramSourceBuilder);
     }
 
-    protected static <T> SqlParameterSource[] buildSqlParameterSourceArray(
+    protected static final <T> SqlParameterSource[] buildSqlParameterSourceArray(
             Collection<T> c,
             @Nonnull Function<T, SqlParameterSource> paramSourceBuilder) {
         if (CollectionUtils.isEmpty(c)) {
@@ -163,7 +179,7 @@ public abstract class PlusoneJdbcDaoSupport {
         return buildSqlParameterSourceArray(c.stream(), paramSourceBuilder);
     }
 
-    protected static <T> SqlParameterSource[] buildSqlParameterSourceArray(
+    protected static final <T> SqlParameterSource[] buildSqlParameterSourceArray(
             Stream<T> stream,
             @Nonnull Function<T, SqlParameterSource> paramSourceBuilder) {
         Objects.requireNonNull(stream);

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/jdbc/common/ResultMapper.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.jdbc.common;
 
 import java.sql.ResultSet;
@@ -8,7 +24,7 @@ import java.sql.SQLException;
  *
  * <p>
  * 通过在 {@link #map(ResultSet)} 中配置 {@link ResultSet} 到对象的映射，
- * 可将 {@link #rowMapper(ResultSet, int)} 的方法引用，
+ * 可将 {@link #rowMapper(ResultSet, int)} 的方法应用，
  * 直接当成 {@link org.springframework.jdbc.core.RowMapper} 对象传给
  * {@link org.springframework.jdbc.core.namedparam.NamedParameterJdbcTemplate}
  * 的查询方法，

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/jdbc/common/SimpleResultMapper.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.jdbc.common;
 
 import java.sql.ResultSet;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/jdbc/converter/EnumToOrdinalConverter.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.jdbc.converter;
 
 import org.springframework.core.convert.converter.Converter;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/jdbc/converter/OrdinalToEnumConverter.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.jdbc.converter;
 
 import org.springframework.core.convert.converter.Converter;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/mail/MailMessageFactory.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.mail;
 
 import org.springframework.mail.SimpleMailMessage;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/mail/MailService.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.mail;
 
 import javax.mail.MessagingException;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/mail/PlusoneMailAutoConfiguration.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.mail;
 
 import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/mail/PlusoneMailProperties.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.mail;
 
 import lombok.Getter;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/mail/SimpleMailService.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.mail;
 
 import lombok.extern.slf4j.Slf4j;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/mybatis/MyBatisContextUtil.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.mybatis;
 
 import org.apache.ibatis.session.SqlSessionFactory;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/mybatis/MyBatisPlusConfig.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.mybatis;
 
 import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/oss/FastDFSAutoConfig.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.oss;
 
 import java.io.IOException;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/oss/FastDFSException.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.oss;
 
 /**

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/oss/FastDFSProperties.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.oss;
 
 import java.util.List;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/oss/FastDFSUtil.java

@@ -1,17 +1,24 @@
+/*
+ * Copyright 2022-2023 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.oss;
 
 import java.io.ByteArrayInputStream;
-import java.io.File;
 import java.io.IOException;
 import java.io.InputStream;
-import java.math.BigInteger;
-import java.security.MessageDigest;
-import java.security.NoSuchAlgorithmException;
-import java.util.Arrays;
-import java.util.Objects;
-
-import javax.annotation.Nonnull;
-import javax.annotation.Nullable;
 
 import org.csource.common.MyException;
 import org.csource.common.NameValuePair;
@@ -23,11 +30,7 @@ import org.csource.fastdfs.TrackerServer;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
-import com.google.common.io.Files;
-
 import lombok.Getter;
-import xyz.zhouxy.plusone.commons.annotation.StaticFactoryMethod;
-import xyz.zhouxy.plusone.exception.SysException;
 
 public class FastDFSUtil {
 
@@ -57,7 +60,7 @@ public class FastDFSUtil {
      * @throws FastDFSException
      */
     public String[] upload(FastDFSFile file) throws FastDFSException {
-        logger.info("File Name: {}, File Length: {}", file.getFileName(), file.getContent().length);
+        logger.info("File Name: {}, File Length: {}", file.getName(), file.getContent().length);
 
         NameValuePair[] metaList = new NameValuePair[1];
         metaList[0] = new NameValuePair("author", file.getAuthor());
@@ -76,7 +79,7 @@ public class FastDFSUtil {
                     uploadResults[0], uploadResults[1], System.currentTimeMillis() - startTime);
 
         } catch (IOException e) {
-            throw new FastDFSException("IO Exception when uploadind the file:" + file.getFileName(), e);
+            throw new FastDFSException("IO Exception when uploadind the file:" + file.getName(), e);
         } catch (MyException e) {
             throw new FastDFSException(e);
         }
@@ -122,72 +125,18 @@ public class FastDFSUtil {
         }
     }
 
+    @Getter
     public static final class FastDFSFile {
-        @Getter
-        private final String fileName;
-        private final byte[] content;
-        @Getter
-        private final String ext;
-        @Getter
-        private final String md5;
-        @Getter
-        private final String author;
+        private String name;
+        private byte[] content;
+        private String ext;
+        private String md5;
+        private String author;
 
-        private FastDFSFile(@Nonnull File file, @Nullable String author) throws IOException {
-            this.fileName = file.getName();
-            this.content = Files.toByteArray(file);
-            this.ext = Files.getFileExtension(fileName);
-            this.md5 = md5Hex(content);
-            this.author = author;
-        }
-
-        private FastDFSFile(@Nonnull String fileName, @Nonnull byte[] content, @Nullable String author) {
-            this.fileName = fileName;
+        public FastDFSFile(String name, byte[] content, String ext) {
+            this.name = name;
             this.content = content;
-            this.ext = Files.getFileExtension(fileName);
-            this.md5 = md5Hex(content);
-            this.author = author;
-        }
-
-        @Nonnull
-        @StaticFactoryMethod(FastDFSFile.class)
-        public static FastDFSFile of(@Nonnull File file) throws IOException {
-            return new FastDFSFile(file, null);
-        }
-
-        @Nonnull
-        @StaticFactoryMethod(FastDFSFile.class)
-        public static FastDFSFile of(@Nonnull File file, @Nullable String author) throws IOException {
-            return new FastDFSFile(file, author);
-        }
-
-        @Nonnull
-        @StaticFactoryMethod(FastDFSFile.class)
-        public static FastDFSFile of(@Nonnull String fileName, @Nonnull byte[] content) {
-            return new FastDFSFile(fileName, content, null);
-        }
-
-        @Nonnull
-        @StaticFactoryMethod(FastDFSFile.class)
-        public static FastDFSFile of(@Nonnull String fileName, @Nonnull byte[] content, @Nullable String author) {
-            return new FastDFSFile(fileName, content, author);
-        }
-
-        public byte[] getContent() {
-            return Arrays.copyOf(content, content.length);
-        }
-
-        @Nonnull
-        private static String md5Hex(byte[] data) {
-            try {
-                MessageDigest messageDigest = MessageDigest.getInstance("MD5");
-                messageDigest.update(data);
-                byte[] result = messageDigest.digest();
-                var sha512Hex = new BigInteger(1, result).toString(16);
-                return Objects.requireNonNull(sha512Hex);
-            } catch (NoSuchAlgorithmException e) {
-                throw SysException.of(e);
-            }
+            this.ext = ext;
         }
     }
 }

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/redis/RedisStrCacheDAO.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.redis;
 
 import org.springframework.data.redis.core.StringRedisTemplate;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/redis/StrCacheDAO.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.redis;
 
 import java.util.concurrent.TimeUnit;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/sms/PlusoneSmsAutoConfiguration.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.sms;
 
 import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/sms/SmsProperties.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.sms;
 
 import java.util.Map;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/sms/SmsService.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.sms;
 
 /**

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/sms/TencentSmsServiceImpl.java

@@ -1,6 +1,20 @@
-package xyz.zhouxy.plusone.sms;
+/*
+ * Copyright 2022-2023 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.
+ */
 
-import org.springframework.stereotype.Service;
+package xyz.zhouxy.plusone.sms;
 
 import com.tencentcloudapi.common.Credential;
 import com.tencentcloudapi.common.exception.TencentCloudSDKException;
@@ -10,8 +24,11 @@ import com.tencentcloudapi.sms.v20210111.SmsClient;
 import com.tencentcloudapi.sms.v20210111.models.SendSmsRequest;
 import com.tencentcloudapi.sms.v20210111.models.SendSmsResponse;
 
+import org.springframework.stereotype.Service;
+
 import lombok.extern.slf4j.Slf4j;
-import xyz.zhouxy.plusone.exception.SysException;
+import xyz.zhouxy.plusone.constant.ErrorCodeConsts;
+import xyz.zhouxy.plusone.exception.BizException;
 import xyz.zhouxy.plusone.sms.SmsProperties.SmsCredentialProperties;
 import xyz.zhouxy.plusone.sms.SmsProperties.SmsHttpProperties;
 import xyz.zhouxy.plusone.sms.SmsProperties.SmsProxyProperties;
@@ -68,7 +85,7 @@ public class TencentSmsServiceImpl implements SmsService {
 
         } catch (TencentCloudSDKException e) {
             log.error(e.getMessage(), e);
-            throw SysException.of(e);
+            throw new BizException(ErrorCodeConsts.DEFAULT_ERROR_CODE, e);
         }
     }
 

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/spring/SpringContextHolder.java

@@ -1,16 +1,34 @@
+/*
+ * Copyright 2022-2023 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.spring;
 
 import org.springframework.context.ApplicationContext;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 
-public enum SpringContextHolder {
-
-    INSTANCE
-    ;
+public class SpringContextHolder {
 
     private ApplicationContext context;
 
+    private static final SpringContextHolder INSTANCE = new SpringContextHolder();
+
+    private SpringContextHolder() {
+    }
+
     public static ApplicationContext getContext() {
         return INSTANCE.context;
     }

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/validator/DtoValidator.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.validator;
 
 import java.lang.annotation.ElementType;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/validator/InvalidInputExceptionHandler.java

@@ -1,15 +1,29 @@
-package xyz.zhouxy.plusone.validator;
+/*
+ * Copyright 2022-2023 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.
+ */
 
-import javax.annotation.Nonnull;
+package xyz.zhouxy.plusone.validator;
 
 import org.springframework.web.bind.annotation.RestControllerAdvice;
 
-import xyz.zhouxy.plusone.commons.exception.handler.BaseExceptionHandler;
+import xyz.zhouxy.plusone.exception.handler.BaseExceptionHandler;
 
 @RestControllerAdvice
 public class InvalidInputExceptionHandler extends BaseExceptionHandler {
 
-    public InvalidInputExceptionHandler(@Nonnull ExceptionInfoHolder exceptionInfoHolder) {
+    public InvalidInputExceptionHandler(ExceptionInfoHolder exceptionInfoHolder) {
         super(exceptionInfoHolder);
         set(InvalidInputException.class, InvalidInputException.ERROR_CODE, "无效的用户输入");
     }

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/validator/ValidateDto.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.validator;
 
 import java.lang.annotation.ElementType;

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/web/config/WebCorsConfig.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.web.config;
 
 import org.springframework.context.annotation.Configuration;
@@ -12,7 +28,6 @@ import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
 @Configuration
 public class WebCorsConfig implements WebMvcConfigurer {
 
-    // TODO 不放行全部，通过配置文件配置允许访问的域名
     @Override
     public void addCorsMappings(CorsRegistry registry) {
         registry.addMapping("/**")

plusone-basic/plusone-basic-infrastructure/src/main/java/xyz/zhouxy/plusone/web/config/WebEnumMapConfig.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.web.config;
 
 import org.springframework.context.annotation.Configuration;

plusone-basic/plusone-basic-infrastructure/src/test/java/xyz/zhouxy/plusone/validatortest/BaseValidatorTest.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.validatortest;
 
 import java.util.regex.Pattern;
@@ -36,7 +52,7 @@ class LoginCommandValidator extends BaseValidator<LoginCommand> {
     private LoginCommandValidator() {
         ruleForString(LoginCommand::getAccount)
                 .notNull("邮箱地址不能为空")
-                .matchesOne(new Pattern[] { PatternConsts.EMAIL, PatternConsts.MOBILE_PHONE },
+                .matchesOr(new Pattern[] { PatternConsts.EMAIL, PatternConsts.MOBILE_PHONE },
                         value -> new RuntimeException('"' + value + "\" 不是邮箱地址或手机号"));
         ruleForString(LoginCommand::getPwd)
                 .notNull("密码不能为空")

plusone-basic/pom.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="https://maven.apache.org/POM/4.0.0" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+<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>
         <artifactId>plusone</artifactId>

plusone-start/pom.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="https://maven.apache.org/POM/4.0.0" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+<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>
         <artifactId>plusone</artifactId>

plusone-start/src/main/java/xyz/zhouxy/plusone/PlusoneApplication.java

@@ -1,12 +1,32 @@
+/*
+ * Copyright 2022-2023 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;
 
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 
+import lombok.extern.slf4j.Slf4j;
+
 @SpringBootApplication
+@Slf4j
 public class PlusoneApplication {
 
     public static void main(String[] args) {
+        log.debug("Plusone started!");
         SpringApplication.run(PlusoneApplication.class, args);
     }
 

plusone-start/src/test/java/xyz/zhouxy/plusone/AccountQueriesTests.java

@@ -1,33 +0,0 @@
-package xyz.zhouxy.plusone;
-
-import java.util.Collections;
-import java.util.List;
-
-import javax.annotation.Resource;
-
-import org.junit.jupiter.api.Test;
-import org.springframework.boot.test.context.SpringBootTest;
-
-import lombok.extern.slf4j.Slf4j;
-import xyz.zhouxy.plusone.system.application.query.AccountQueries;
-import xyz.zhouxy.plusone.system.application.query.params.AccountQueryParams;
-import xyz.zhouxy.plusone.system.application.query.result.AccountOverview;
-
-@Slf4j
-@SpringBootTest(classes = PlusoneApplication.class)
-class AccountQueriesTests {
-
-    @Resource
-    AccountQueries accountQueries;
-
-    @Test
-    void testQueryPage() {
-        AccountQueryParams queryParams = new AccountQueryParams();
-        // queryParams.setOrderBy(List.of("email", "mobile_phone", "id"));
-        queryParams.setSize(20);
-        queryParams.setPageNum(1L);
-        queryParams.setOrderBy(Collections.emptyList());
-        List<AccountOverview> l = accountQueries.queryAccountOverview(queryParams);
-        log.info("l: {}", l);
-    }
-}

plusone-start/src/test/java/xyz/zhouxy/plusone/FastDFSTests.java

@@ -1,11 +1,28 @@
+/*
+ * Copyright 2022-2023 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;
 
-import java.io.File;
+import java.io.FileInputStream;
 import java.io.FileNotFoundException;
 import java.io.IOException;
 
 import javax.annotation.Resource;
 
+import org.apache.commons.io.IOUtils;
 import org.junit.jupiter.api.Test;
 import org.springframework.boot.test.context.SpringBootTest;
 
@@ -23,7 +40,10 @@ class FastDFSTests {
 
     @Test
     void testOSS() throws FileNotFoundException, IOException, FastDFSException {
-        String[] upload = fastDFSUtil.upload(FastDFSFile.of(new File("D:\\ZhouXY\\Desktop\\666.png")));
+        try (FileInputStream in = new FileInputStream("D:\\ZhouXY\\Desktop\\666.png");) {
+            byte[] content = IOUtils.toByteArray(in);
+            String[] upload = fastDFSUtil.upload(new FastDFSFile("666.png", content, "png"));
             log.info(String.join("/", upload));
         }
+    }
 }

plusone-start/src/test/java/xyz/zhouxy/plusone/SerialTests.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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;
 
 import java.io.ObjectStreamClass;

plusone-start/src/test/java/xyz/zhouxy/plusone/TestAop.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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;
 
 import static org.junit.jupiter.api.Assertions.assertNotNull;

plusone-system/plusone-system-application/pom.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="https://maven.apache.org/POM/4.0.0" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+<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>
         <artifactId>plusone-system</artifactId>

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/common/exception/AccountRegisterException.java

@@ -1,57 +0,0 @@
-package xyz.zhouxy.plusone.system.application.common.exception;
-
-import org.springframework.http.HttpStatus;
-import org.springframework.web.bind.annotation.ResponseStatus;
-
-import xyz.zhouxy.plusone.exception.BizException;
-
-@ResponseStatus(HttpStatus.BAD_REQUEST)
-public class AccountRegisterException extends BizException {
-
-    @java.io.Serial
-    private static final long serialVersionUID = 7580245181633370195L;
-
-    public AccountRegisterException() {
-        this("4020000", "用户注册错误");
-    }
-
-    public AccountRegisterException(String message) {
-        this("4020000", message);
-    }
-
-    public AccountRegisterException(Throwable cause) {
-        super("4020000", cause);
-    }
-
-    public AccountRegisterException(String code, String message) {
-        super(code, message);
-    }
-
-    public AccountRegisterException(String code, Throwable cause) {
-        super(code, cause);
-    }
-
-    public static AccountRegisterException emailOrMobilePhoneRequiredException() {
-        return new AccountRegisterException("4020300", "邮箱和手机号应至少绑定一个");
-    }
-
-    public static AccountRegisterException usernameAlreadyExists(String username) {
-        return new AccountRegisterException("4020400", String.format("用户名 %s 已存在", username));
-    }
-
-    public static AccountRegisterException emailAlreadyExists(String value) {
-        return new AccountRegisterException("4020500", String.format("邮箱 %s 已存在", value));
-    }
-
-    public static AccountRegisterException mobilePhoneAlreadyExists(String value) {
-        return new AccountRegisterException("4020600", String.format("手机号 %s 已存在", value));
-    }
-
-    public static AccountRegisterException codeErrorException() {
-        return new AccountRegisterException("4020701", "校验码错误");
-    }
-
-    public static AccountRegisterException codeNotExistsException() {
-        return new AccountRegisterException("4020702", "校验码不存在或已过期");
-    }
-}

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/common/exception/UnsupportedMenuTypeException.java

@@ -1,19 +0,0 @@
-package xyz.zhouxy.plusone.system.application.common.exception;
-
-import xyz.zhouxy.plusone.validator.InvalidInputException;
-
-public class UnsupportedMenuTypeException extends InvalidInputException {
-
-    @java.io.Serial
-    private static final long serialVersionUID = -769169844015637730L;
-
-    public static final String ERROR_CODE = "4040209";
-
-    public UnsupportedMenuTypeException() {
-        this("不支持的菜单类型");
-    }
-
-    public UnsupportedMenuTypeException(String message) {
-        super(ERROR_CODE, message);
-    }
-}

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/common/exception/UnsupportedPrincipalTypeException.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.system.application.common.exception;
 
 import xyz.zhouxy.plusone.exception.BizException;
@@ -11,7 +27,7 @@ public class UnsupportedPrincipalTypeException extends BizException {
 
     private static final long serialVersionUID = 5207757290868470762L;
 
-    public static final String ERR_CODE = "4040201";
+    public static final int ERR_CODE = 4040201;
     private static final String DEFAULT_ERROR_MSG = "不支持的 PrincipalType";
 
     public UnsupportedPrincipalTypeException() {

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/common/exception/handler/AccountLoginExceptionHandler.java

@@ -1,26 +0,0 @@
-package xyz.zhouxy.plusone.system.application.common.exception.handler;
-
-import java.util.Objects;
-
-import javax.annotation.Nonnull;
-
-import org.springframework.http.ResponseEntity;
-import org.springframework.web.bind.annotation.ExceptionHandler;
-import org.springframework.web.bind.annotation.RestControllerAdvice;
-
-import xyz.zhouxy.plusone.commons.exception.handler.BaseExceptionHandler;
-import xyz.zhouxy.plusone.commons.util.UnifiedResponse;
-import xyz.zhouxy.plusone.system.application.common.exception.AccountLoginException;
-
-@RestControllerAdvice
-public class AccountLoginExceptionHandler extends BaseExceptionHandler {
-
-    public AccountLoginExceptionHandler(@Nonnull ExceptionInfoHolder exceptionInfoHolder) {
-        super(exceptionInfoHolder);
-    }
-
-    @ExceptionHandler({ AccountLoginException.class })
-    public ResponseEntity<UnifiedResponse> handleException(Exception e) {
-        return buildExceptionResponse(Objects.requireNonNull(e));
-    }
-}

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/common/model/AuthenticationInfo.java

@@ -1,138 +0,0 @@
-package xyz.zhouxy.plusone.system.application.common.model;
-
-import java.util.Map;
-import java.util.Optional;
-import java.util.OptionalInt;
-import java.util.OptionalLong;
-import java.util.OptionalDouble;
-import java.util.concurrent.ConcurrentHashMap;
-
-import javax.annotation.Nonnull;
-import javax.annotation.Nullable;
-
-import xyz.zhouxy.plusone.exception.BizException;
-
-public class AuthenticationInfo<T> {
-
-    /** token 值 */
-    private final String token;
-
-    /** 此 token 对应的LoginId，未登录时不会构建此类的实例 */
-    private final T loginId;
-
-    /** 账号类型 */
-    private final String loginType;
-
-    /** 登录设备类型 */
-    private final String deviceType;
-
-    /** 自定义数据 */
-    @Nonnull
-    private final Map<String, Object> metadata;
-
-    private AuthenticationInfo(String token, T loginId, String loginType, String deviceType,
-            @Nonnull Map<String, Object> metadata) {
-        this.token = token;
-        this.loginId = loginId;
-        this.loginType = loginType;
-        this.deviceType = deviceType;
-        this.metadata = metadata;
-    }
-
-    public String getToken() {
-        return token;
-    }
-
-    public T getLoginId() {
-        return loginId;
-    }
-
-    public String getLoginType() {
-        return loginType;
-    }
-
-    public String getDeviceType() {
-        return deviceType;
-    }
-
-    private Object getObjFromMetadata(String key) {
-        if (this.metadata.containsKey(key)) {
-            return this.metadata.get(key);
-        }
-        throw BizException.of(String.format("不存在 key 为 \"%s\"的元数据。", key));
-    }
-
-    public OptionalDouble getMetadataAsDouble(String key) {
-        Object valObj = getObjFromMetadata(key);
-        if (valObj instanceof Double val) {
-            return OptionalDouble.of(val.doubleValue());
-        }
-        return OptionalDouble.empty();
-    }
-
-    public OptionalLong getMetadataAsLong(String key) {
-        Object valObj = getObjFromMetadata(key);
-        if (valObj instanceof Long val) {
-            return OptionalLong.of(val.longValue());
-        }
-        return OptionalLong.empty();
-    }
-
-    public OptionalInt getMetadataAsInt(String key) {
-        Object valObj = getObjFromMetadata(key);
-        if (valObj instanceof Integer val) {
-            return OptionalInt.of(val.intValue());
-        }
-        return OptionalInt.empty();
-    }
-
-    public Optional<String> getMetadataAsString(String key) {
-        Object valObj = getObjFromMetadata(key);
-        if (valObj instanceof String val) {
-            return Optional.of(val);
-        }
-        return Optional.empty();
-    }
-
-    @SuppressWarnings("unchecked")
-    public <C> Optional<C> getMetadata(String key, Class<C> type) {
-        Object valObj = getObjFromMetadata(key);
-        if (valObj == null || !type.isAssignableFrom(valObj.getClass())) {
-            return Optional.empty();
-        }
-        return Optional.of((C) valObj);
-    }
-
-    // ==========================================
-    // builder
-
-    public static <T> Builder<T> builder(String token, T loginId, String loginType, String deviceType) {
-        return new Builder<>(token, loginId, loginType, deviceType);
-    }
-
-    public static final class Builder<T> {
-        private final String token;
-        private final T loginId;
-        private final String loginType;
-        private final String deviceType;
-
-        @Nonnull
-        private final Map<String, Object> meta = new ConcurrentHashMap<>();
-
-        private Builder(String token, T loginId, String loginType, String deviceType) {
-            this.token = token;
-            this.loginId = loginId;
-            this.loginType = loginType;
-            this.deviceType = deviceType;
-        }
-
-        public <C> Builder<T> putMetadata(String key, @Nullable C value) {
-            this.meta.put(key, value);
-            return this;
-        }
-
-        public AuthenticationInfo<T> build() {
-            return new AuthenticationInfo<>(token, loginId, loginType, deviceType, meta);
-        }
-    }
-}

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/common/model/PlusoneContext.java

@@ -1,21 +0,0 @@
-package xyz.zhouxy.plusone.system.application.common.model;
-
-public class PlusoneContext {
-    private static final ThreadLocal<AuthenticationInfo<Long>> context = new ThreadLocal<>();
-
-    public static void setContext(AuthenticationInfo<Long> value) {
-        context.set(value);
-    }
-
-    public static AuthenticationInfo<Long> getContext() {
-        return context.get();
-    }
-
-    public static void remove() {
-        context.remove();
-    }
-
-    private PlusoneContext() {
-        throw new IllegalStateException("Utility class");
-    }
-}

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/common/util/MenuUtil.java

@@ -0,0 +1,77 @@
+/*
+ * Copyright 2022-2023 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.system.application.common.util;
+
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Comparator;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+import xyz.zhouxy.plusone.domain.IWithOrderNumber;
+import xyz.zhouxy.plusone.system.application.query.result.MenuViewObject;
+import xyz.zhouxy.plusone.system.domain.model.menu.Menu.MenuType;
+
+/**
+ * 菜单工具类
+ *
+ * @author <a href="https://gitee.com/zhouxy108">ZhouXY</a>
+ */
+public class MenuUtil {
+    private MenuUtil() {
+        throw new IllegalStateException("Utility class");
+    }
+
+    /**
+     * 构建菜单树
+     *
+     * @param allMenus 菜单列表
+     * @return 菜单树
+     */
+    public static List<MenuViewObject> buildMenuTree(Collection<MenuViewObject> allMenus) {
+        // 先排序，保证添加到 rootMenus 中的顺序，以及 addChild 添加的子菜单的顺序
+        allMenus = allMenus.stream()
+                .sorted(Comparator.comparing(IWithOrderNumber::getOrderNumber))
+                .toList();
+
+        // 一级菜单
+        List<MenuViewObject> rootMenus = new ArrayList<>();
+        // key: 菜单 id; value: 菜单对象. 方便根据 id 查找相应对象。
+        Map<Long, MenuViewObject> menuListMap = new HashMap<>();
+
+        for (var menu : allMenus) {
+            // 添加 MENU_LIST 到 map 中，方便后面调用对象的方法
+            if (menu.getType() == MenuType.MENU_LIST.ordinal()) {
+                menuListMap.put(menu.getId(), menu);
+            }
+            // 一级菜单
+            if (menu.getParentId() == 0) {
+                rootMenus.add(menu);
+            }
+        }
+        for (var menu : allMenus) {
+            var parent = menuListMap.getOrDefault(menu.getParentId(), null);
+            // 父菜单存在于 map 中，调用父菜单的 addChild 方法将当前菜单添加为父菜单的子菜单。
+            if (parent != null) {
+                parent.addChild(menu);
+            }
+        }
+
+        return rootMenus;
+    }
+}

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/common/util/PrincipalType.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.system.application.common.util;
 
 import java.util.regex.Pattern;

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/common/util/PrincipalUtil.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright 2022-2023 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.system.application.common.util;
 
 import javax.annotation.Nullable;

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/controller/AccountContextController.java

@@ -1,4 +1,20 @@
-package xyz.zhouxy.plusone.system.application.web.controller;
+/*
+ * Copyright 2022-2023 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.system.application.controller;
 
 import static xyz.zhouxy.plusone.system.constant.AuthLogic.adminAuthLogic;
 
@@ -7,7 +23,7 @@ import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
-import xyz.zhouxy.plusone.commons.util.UnifiedResponse;
+import xyz.zhouxy.plusone.commons.util.RestfulResult;
 import xyz.zhouxy.plusone.system.application.service.AccountContextService;
 import xyz.zhouxy.plusone.system.application.service.command.ChangePasswordCommand;
 import xyz.zhouxy.plusone.system.application.service.command.ChangePasswordWithoutLoginCommand;
@@ -28,34 +44,34 @@ public class AccountContextController {
     }
 
     @GetMapping("info")
-    public UnifiedResponse getAccountInfo() {
+    public RestfulResult getAccountInfo() {
         adminAuthLogic.checkLogin();
         var result = service.getAccountInfo();
-        return UnifiedResponse.success("查询成功", result);
+        return RestfulResult.success("查询成功", result);
     }
 
     @GetMapping("logout")
-    public UnifiedResponse logout() {
+    public RestfulResult logout() {
         service.logout();
-        return UnifiedResponse.success("注销成功");
+        return RestfulResult.success("注销成功");
     }
 
     @GetMapping("menus")
-    public UnifiedResponse getMenuTree() {
+    public RestfulResult getMenuTree() {
         adminAuthLogic.checkLogin();
         var result = service.getMenuTree();
-        return UnifiedResponse.success("查询成功", result);
+        return RestfulResult.success("查询成功", result);
     }
 
     @PostMapping("changePassword")
-    public UnifiedResponse changePassword(ChangePasswordCommand command) {
+    public RestfulResult changePassword(ChangePasswordCommand command) {
         service.changePassword(command);
-        return UnifiedResponse.success("修改成功，请重新登录。");
+        return RestfulResult.success("修改成功，请重新登录。");
     }
 
     @PostMapping("changePasswordWithoutLogin")
-    public UnifiedResponse changePasswordWithoutLogin(ChangePasswordWithoutLoginCommand command) {
+    public RestfulResult changePasswordWithoutLogin(ChangePasswordWithoutLoginCommand command) {
         service.changePasswordWithoutLogin(command);
-        return UnifiedResponse.success("修改成功，请重新登录。");
+        return RestfulResult.success("修改成功，请重新登录。");
     }
 }

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/controller/AccountManagementController.java

@@ -1,7 +1,23 @@
-package xyz.zhouxy.plusone.system.application.web.controller;
+/*
+ * Copyright 2022-2023 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.system.application.controller;
 
 import static xyz.zhouxy.plusone.system.constant.AuthLogic.adminAuthLogic;
-import static xyz.zhouxy.plusone.commons.util.UnifiedResponse.success;
+import static xyz.zhouxy.plusone.commons.util.RestfulResult.success;
 
 import java.util.List;
 
@@ -16,7 +32,7 @@ import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
-import xyz.zhouxy.plusone.commons.util.UnifiedResponse;
+import xyz.zhouxy.plusone.commons.util.RestfulResult;
 import xyz.zhouxy.plusone.system.application.query.params.AccountQueryParams;
 import xyz.zhouxy.plusone.system.application.service.AccountManagementService;
 import xyz.zhouxy.plusone.system.application.service.command.CreateAccountCommand;
@@ -38,7 +54,7 @@ public class AccountManagementController {
     }
 
     @PostMapping
-    public UnifiedResponse createAccount(@RequestBody @Valid CreateAccountCommand command) {
+    public RestfulResult createAccount(@RequestBody @Valid CreateAccountCommand command) {
         adminAuthLogic.checkLogin();
         adminAuthLogic.checkPermission("sys-account-create");
         service.createAccount(command);
@@ -46,7 +62,7 @@ public class AccountManagementController {
     }
 
     @DeleteMapping
-    public UnifiedResponse deleteAccounts(@RequestBody List<Long> ids) {
+    public RestfulResult deleteAccounts(@RequestBody List<Long> ids) {
         adminAuthLogic.checkLogin();
         adminAuthLogic.checkPermission("sys-account-delete");
         service.deleteAccounts(ids);
@@ -54,7 +70,7 @@ public class AccountManagementController {
     }
 
     @PatchMapping("{id}")
-    public UnifiedResponse updateAccountInfo(
+    public RestfulResult updateAccountInfo(
             @PathVariable("id") Long id,
             @RequestBody @Valid UpdateAccountCommand command) {
         adminAuthLogic.checkLogin();
@@ -64,7 +80,7 @@ public class AccountManagementController {
     }
 
     @GetMapping("query")
-    public UnifiedResponse queryAccountOverviewList(AccountQueryParams queryParams) {
+    public RestfulResult queryAccountOverviewList(AccountQueryParams queryParams) {
         adminAuthLogic.checkLogin();
         adminAuthLogic.checkPermission("sys-account-list");
         var accountOverviewList = service.queryAccountOverviewList(queryParams);
@@ -72,7 +88,7 @@ public class AccountManagementController {
     }
 
     @GetMapping("{accountId}")
-    public UnifiedResponse queryAccountDetails(@PathVariable("accountId") Long accountId) {
+    public RestfulResult queryAccountDetails(@PathVariable("accountId") Long accountId) {
         adminAuthLogic.checkLogin();
         adminAuthLogic.checkPermission("sys-account-details");
         var accountDetails = service.queryAccountDetails(accountId);

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/controller/AdminLoginController.java

@@ -1,6 +1,22 @@
-package xyz.zhouxy.plusone.system.application.web.controller;
+/*
+ * Copyright 2022-2023 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.
+ */
 
-import static xyz.zhouxy.plusone.commons.util.UnifiedResponse.success;
+package xyz.zhouxy.plusone.system.application.controller;
+
+import static xyz.zhouxy.plusone.commons.util.RestfulResult.success;
 
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PostMapping;
@@ -12,7 +28,7 @@ import org.springframework.web.bind.annotation.RestController;
 import xyz.zhouxy.plusone.system.application.service.AdminLoginService;
 import xyz.zhouxy.plusone.system.application.service.command.LoginByOtpCommand;
 import xyz.zhouxy.plusone.system.application.service.command.LoginByPasswordCommand;
-import xyz.zhouxy.plusone.commons.util.UnifiedResponse;
+import xyz.zhouxy.plusone.commons.util.RestfulResult;
 
 /**
  * Admin 账号登录
@@ -30,19 +46,19 @@ public class AdminLoginController {
     }
 
     @PostMapping("byPassword")
-    public UnifiedResponse loginByPassword(@RequestBody LoginByPasswordCommand command) {
+    public RestfulResult loginByPassword(@RequestBody LoginByPasswordCommand command) {
         var loginInfo = service.loginByPassword(command);
         return success("登录成功", loginInfo);
     }
 
     @PostMapping("byOtp")
-    public UnifiedResponse loginByOtp(@RequestBody LoginByOtpCommand command) {
+    public RestfulResult loginByOtp(@RequestBody LoginByOtpCommand command) {
         var loginInfo = service.loginByOtp(command);
         return success("登录成功", loginInfo);
     }
 
     @GetMapping("sendOtp")
-    public UnifiedResponse sendOtp(@RequestParam String principal) {
+    public RestfulResult sendOtp(@RequestParam String principal) {
         service.sendOtp(principal);
         return success("发送成功");
     }

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/controller/DictManagementController.java

@@ -1,7 +1,23 @@
-package xyz.zhouxy.plusone.system.application.web.controller;
+/*
+ * Copyright 2022-2023 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.system.application.controller;
 
 import static xyz.zhouxy.plusone.system.constant.AuthLogic.adminAuthLogic;
-import static xyz.zhouxy.plusone.commons.util.UnifiedResponse.success;
+import static xyz.zhouxy.plusone.commons.util.RestfulResult.success;
 
 import java.util.List;
 
@@ -20,7 +36,7 @@ import xyz.zhouxy.plusone.system.application.query.params.DictQueryParams;
 import xyz.zhouxy.plusone.system.application.service.DictManagementService;
 import xyz.zhouxy.plusone.system.application.service.command.CreateDictCommand;
 import xyz.zhouxy.plusone.system.application.service.command.UpdateDictCommand;
-import xyz.zhouxy.plusone.commons.util.UnifiedResponse;
+import xyz.zhouxy.plusone.commons.util.RestfulResult;
 
 /**
  * 数据字典管理
@@ -38,21 +54,21 @@ public class DictManagementController {
     }
 
     @PostMapping
-    public UnifiedResponse createDict(@RequestBody @Valid CreateDictCommand command) {
+    public RestfulResult createDict(@RequestBody @Valid CreateDictCommand command) {
         adminAuthLogic.checkPermission("sys-dict-create");
         service.createDict(command);
         return success();
     }
 
     @DeleteMapping
-    public UnifiedResponse deleteDicts(@RequestBody List<Long> ids) {
+    public RestfulResult deleteDicts(@RequestBody List<Long> ids) {
         adminAuthLogic.checkPermission("sys-dict-delete");
         service.deleteDicts(ids);
         return success();
     }
 
     @PatchMapping("{id}")
-    public UnifiedResponse updateDict(
+    public RestfulResult updateDict(
             @PathVariable("id") Long id,
             @RequestBody @Valid UpdateDictCommand command) {
         adminAuthLogic.checkPermission("sys-dict-update");
@@ -61,21 +77,21 @@ public class DictManagementController {
     }
 
     @GetMapping("{dictId}")
-    public UnifiedResponse findDictDetails(@PathVariable("dictId") Long dictId) {
+    public RestfulResult findDictDetails(@PathVariable("dictId") Long dictId) {
         adminAuthLogic.checkPermission("sys-dict-details");
         var dictDetails = service.findDictDetails(dictId);
         return success("查询成功", dictDetails);
     }
 
     @GetMapping("all")
-    public UnifiedResponse loadAllDicts() {
+    public RestfulResult loadAllDicts() {
         adminAuthLogic.checkPermissionAnd("sys-dict-list", "sys-dict-details");
         var dicts = service.loadAllDicts();
         return success("查询成功", dicts);
     }
 
     @GetMapping("query")
-    public UnifiedResponse queryDictOverviewList(@Valid DictQueryParams queryParams) {
+    public RestfulResult queryDictOverviewList(@Valid DictQueryParams queryParams) {
         adminAuthLogic.checkPermission("sys-dict-list");
         var dicts = service.queryDictOverviewList(queryParams);
         return success("查询成功", dicts);

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/controller/MenuManagementController.java

@@ -1,7 +1,23 @@
-package xyz.zhouxy.plusone.system.application.web.controller;
+/*
+ * Copyright 2022-2023 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.system.application.controller;
 
 import static xyz.zhouxy.plusone.system.constant.AuthLogic.adminAuthLogic;
-import static xyz.zhouxy.plusone.commons.util.UnifiedResponse.success;
+import static xyz.zhouxy.plusone.commons.util.RestfulResult.success;
 
 import javax.validation.Valid;
 
@@ -18,7 +34,7 @@ import org.springframework.web.bind.annotation.RestController;
 import xyz.zhouxy.plusone.system.application.service.MenuManagementService;
 import xyz.zhouxy.plusone.system.application.service.command.CreateMenuCommand;
 import xyz.zhouxy.plusone.system.application.service.command.UpdateMenuCommand;
-import xyz.zhouxy.plusone.commons.util.UnifiedResponse;
+import xyz.zhouxy.plusone.commons.util.RestfulResult;
 
 /**
  * 菜单管理
@@ -37,7 +53,7 @@ public class MenuManagementController {
 
     // ==================== create ====================
     @PostMapping
-    public UnifiedResponse createMenu(@RequestBody @Valid CreateMenuCommand command) {
+    public RestfulResult createMenu(@RequestBody @Valid CreateMenuCommand command) {
         adminAuthLogic.checkPermission("sys-menu-create");
         service.createMenu(command);
         return success();
@@ -45,7 +61,7 @@ public class MenuManagementController {
 
     // ==================== delete ====================
     @DeleteMapping("{id}")
-    public UnifiedResponse deleteMenu(@PathVariable("id") Long id) {
+    public RestfulResult deleteMenu(@PathVariable("id") Long id) {
         adminAuthLogic.checkPermission("sys-menu-delete");
         service.deleteMenu(id);
         return success();
@@ -53,7 +69,7 @@ public class MenuManagementController {
 
     // ==================== update ====================
     @PatchMapping("{id}")
-    public UnifiedResponse updateMenu(
+    public RestfulResult updateMenu(
             @PathVariable("id") Long id,
             @RequestBody @Valid UpdateMenuCommand command) {
         adminAuthLogic.checkPermission("sys-menu-update");
@@ -63,21 +79,21 @@ public class MenuManagementController {
 
     // ==================== query ====================
     @GetMapping("{id}")
-    public UnifiedResponse findById(@PathVariable("id") Long id) {
+    public RestfulResult findById(@PathVariable("id") Long id) {
         adminAuthLogic.checkPermission("sys-menu-details");
         var result = service.findById(id);
-        return UnifiedResponse.success("查询成功", result);
+        return RestfulResult.success("查询成功", result);
     }
 
     @GetMapping("queryByAccountId")
-    public UnifiedResponse queryByAccountId(@RequestParam Long accountId) {
+    public RestfulResult queryByAccountId(@RequestParam Long accountId) {
         adminAuthLogic.checkPermission("sys-menu-details");
         var result = service.queryByAccountId(accountId);
         return success("查询成功", result);
     }
 
     @GetMapping("queryByRoleId")
-    public UnifiedResponse queryByRoleId(@RequestParam Long roleId) {
+    public RestfulResult queryByRoleId(@RequestParam Long roleId) {
         adminAuthLogic.checkPermission("sys-menu-details");
         var result = service.queryByRoleId(roleId);
         return success("查询成功", result);

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/controller/RegisterAccountController.java

@@ -1,6 +1,22 @@
-package xyz.zhouxy.plusone.system.application.web.controller;
+/*
+ * Copyright 2022-2023 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.
+ */
 
-import static xyz.zhouxy.plusone.commons.util.UnifiedResponse.success;
+package xyz.zhouxy.plusone.system.application.controller;
+
+import static xyz.zhouxy.plusone.commons.util.RestfulResult.success;
 
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PostMapping;
@@ -11,7 +27,7 @@ import org.springframework.web.bind.annotation.RestController;
 
 import xyz.zhouxy.plusone.system.application.service.RegisterAccountService;
 import xyz.zhouxy.plusone.system.application.service.command.RegisterAccountCommand;
-import xyz.zhouxy.plusone.commons.util.UnifiedResponse;
+import xyz.zhouxy.plusone.commons.util.RestfulResult;
 
 /**
  * 注册账号服务
@@ -29,13 +45,13 @@ public class RegisterAccountController {
     }
 
     @PostMapping
-    public UnifiedResponse registerAccount(@RequestBody RegisterAccountCommand command) {
+    public RestfulResult registerAccount(@RequestBody RegisterAccountCommand command) {
         service.registerAccount(command);
         return success("注册成功");
     }
 
     @GetMapping("sendCode")
-    public UnifiedResponse sendCode(@RequestParam String principal) {
+    public RestfulResult sendCode(@RequestParam String principal) {
         service.sendCode(principal);
         return success("发送成功");
     }

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/controller/RoleManagementController.java

@@ -1,4 +1,20 @@
-package xyz.zhouxy.plusone.system.application.web.controller;
+/*
+ * Copyright 2022-2023 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.system.application.controller;
 
 import javax.validation.Valid;
 import static xyz.zhouxy.plusone.system.constant.AuthLogic.adminAuthLogic;
@@ -17,7 +33,7 @@ import xyz.zhouxy.plusone.system.application.query.params.RoleQueryParams;
 import xyz.zhouxy.plusone.system.application.service.RoleManagementService;
 import xyz.zhouxy.plusone.system.application.service.command.CreateRoleCommand;
 import xyz.zhouxy.plusone.system.application.service.command.UpdateRoleCommand;
-import xyz.zhouxy.plusone.commons.util.UnifiedResponse;
+import xyz.zhouxy.plusone.commons.util.RestfulResult;
 
 /**
  * 角色管理服务
@@ -35,44 +51,44 @@ public class RoleManagementController {
     }
 
     @PostMapping
-    public UnifiedResponse createRole(@RequestBody @Valid CreateRoleCommand command) {
+    public RestfulResult createRole(@RequestBody @Valid CreateRoleCommand command) {
         adminAuthLogic.checkPermission("sys-role-create");
         service.createRole(command);
-        return UnifiedResponse.success();
+        return RestfulResult.success();
     }
 
     @PatchMapping
-    public UnifiedResponse updateRole(@RequestBody @Valid UpdateRoleCommand command) {
+    public RestfulResult updateRole(@RequestBody @Valid UpdateRoleCommand command) {
         adminAuthLogic.checkPermission("sys-role-update");
         service.updateRole(command);
-        return UnifiedResponse.success();
+        return RestfulResult.success();
     }
 
     @DeleteMapping("{id}")
-    public UnifiedResponse delete(@PathVariable("id") Long id) {
+    public RestfulResult delete(@PathVariable("id") Long id) {
         adminAuthLogic.checkPermission("sys-role-delete");
         service.delete(id);
-        return UnifiedResponse.success();
+        return RestfulResult.success();
     }
 
     @GetMapping("exists")
-    public UnifiedResponse exists(@RequestParam("id") Long id) {
+    public RestfulResult exists(@RequestParam("id") Long id) {
         adminAuthLogic.checkPermissionOr("sys-role-list", "sys-role-details");
         var isExists = service.exists(id);
-        return UnifiedResponse.success(isExists ? "存在" : "不存在", isExists);
+        return RestfulResult.success(isExists ? "存在" : "不存在", isExists);
     }
 
     @GetMapping("{id}")
-    public UnifiedResponse findById(@PathVariable("id") Long id) {
+    public RestfulResult findById(@PathVariable("id") Long id) {
         adminAuthLogic.checkPermission("sys-role-details");
         var result = service.findById(id);
-        return UnifiedResponse.success("查询成功", result);
+        return RestfulResult.success("查询成功", result);
     }
 
     @GetMapping("query")
-    public UnifiedResponse query(RoleQueryParams params) {
+    public RestfulResult query(RoleQueryParams params) {
         adminAuthLogic.checkPermission("sys-role-list");
         var result = service.query(params);
-        return UnifiedResponse.success("查询成功", result);
+        return RestfulResult.success("查询成功", result);
     }
 }

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/exception/AccountLoginException.java

@@ -1,4 +1,20 @@
-package xyz.zhouxy.plusone.system.application.common.exception;
+/*
+ * Copyright 2022-2023 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.system.application.exception;
 
 import org.springframework.http.HttpStatus;
 import org.springframework.web.bind.annotation.ResponseStatus;
@@ -10,13 +26,13 @@ public class AccountLoginException extends BizException {
     @java.io.Serial
     private static final long serialVersionUID = -3040996790739138556L;
 
-    private static final String DEFAULT_ERR_CODE = "4030000";
+    private static final int DEFAULT_ERR_CODE = 4030000;
 
     private AccountLoginException() {
         super(DEFAULT_ERR_CODE, "用户登录异常");
     }
 
-    private AccountLoginException(String code, String message) {
+    private AccountLoginException(int code, String message) {
         super(code, message);
     }
 
@@ -25,7 +41,7 @@ public class AccountLoginException extends BizException {
     }
 
     public static AccountLoginException accountNotExistException(String msg) {
-        return new AccountLoginException("4030101", msg);
+        return new AccountLoginException(4030101, msg);
     }
 
     public static AccountLoginException otpErrorException() {
@@ -33,7 +49,7 @@ public class AccountLoginException extends BizException {
     }
 
     public static AccountLoginException otpErrorException(String msg) {
-        return new AccountLoginException("4030501", msg);
+        return new AccountLoginException(4030501, msg);
     }
 
     public static AccountLoginException otpNotExistsException() {
@@ -41,7 +57,7 @@ public class AccountLoginException extends BizException {
     }
 
     public static AccountLoginException otpNotExistsException(String msg) {
-        return new AccountLoginException("4030502", msg);
+        return new AccountLoginException(4030502, msg);
     }
 
     public static AccountLoginException passwordErrorException() {
@@ -49,6 +65,6 @@ public class AccountLoginException extends BizException {
     }
 
     public static AccountLoginException passwordErrorException(String msg) {
-        return new AccountLoginException("4030200", msg);
+        return new AccountLoginException(4030200, msg);
     }
 }

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/exception/AccountRegisterException.java

@@ -0,0 +1,73 @@
+/*
+ * Copyright 2022-2023 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.system.application.exception;
+
+import org.springframework.http.HttpStatus;
+import org.springframework.web.bind.annotation.ResponseStatus;
+
+import xyz.zhouxy.plusone.exception.BizException;
+
+@ResponseStatus(HttpStatus.BAD_REQUEST)
+public class AccountRegisterException extends BizException {
+
+    @java.io.Serial
+    private static final long serialVersionUID = 7580245181633370195L;
+
+    public AccountRegisterException() {
+        this(4020000, "用户注册错误");
+    }
+
+    public AccountRegisterException(String message) {
+        this(4020000, message);
+    }
+
+    public AccountRegisterException(Throwable cause) {
+        super(4020000, cause);
+    }
+
+    public AccountRegisterException(int code, String message) {
+        super(code, message);
+    }
+
+    public AccountRegisterException(int code, Throwable cause) {
+        super(code, cause);
+    }
+
+    public static AccountRegisterException emailOrMobilePhoneRequiredException() {
+        return new AccountRegisterException(4020300, "邮箱和手机号应至少绑定一个");
+    }
+
+    public static AccountRegisterException usernameAlreadyExists(String username) {
+        return new AccountRegisterException(4020400, String.format("用户名 %s 已存在", username));
+    }
+
+    public static AccountRegisterException emailAlreadyExists(String value) {
+        return new AccountRegisterException(4020500, String.format("邮箱 %s 已存在", value));
+    }
+
+    public static AccountRegisterException mobilePhoneAlreadyExists(String value) {
+        return new AccountRegisterException(4020600, String.format("手机号 %s 已存在", value));
+    }
+
+    public static AccountRegisterException codeErrorException() {
+        return new AccountRegisterException(4020701, "校验码错误");
+    }
+
+    public static AccountRegisterException codeNotExistsException() {
+        return new AccountRegisterException(4020702, "校验码不存在或已过期");
+    }
+}

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/exception/UnsupportedMenuTypeException.java

@@ -0,0 +1,33 @@
+/*
+ * Copyright 2022-2023 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.system.application.exception;
+
+import xyz.zhouxy.plusone.validator.InvalidInputException;
+
+public class UnsupportedMenuTypeException extends InvalidInputException {
+
+    @java.io.Serial
+    private static final long serialVersionUID = -769169844015637730L;
+
+    public UnsupportedMenuTypeException() {
+        this("不支持的菜单类型");
+    }
+
+    public UnsupportedMenuTypeException(String message) {
+        super(message);
+    }
+}

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/exception/handler/AccountLoginExceptionHandler.java

@@ -0,0 +1,40 @@
+/*
+ * Copyright 2022-2023 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.system.application.exception.handler;
+
+import javax.annotation.Nonnull;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+
+import xyz.zhouxy.plusone.exception.handler.BaseExceptionHandler;
+import xyz.zhouxy.plusone.system.application.exception.AccountLoginException;
+import xyz.zhouxy.plusone.commons.util.RestfulResult;
+
+@RestControllerAdvice
+public class AccountLoginExceptionHandler extends BaseExceptionHandler {
+
+    public AccountLoginExceptionHandler(ExceptionInfoHolder exceptionInfoHolder) {
+        super(exceptionInfoHolder);
+    }
+
+    @ExceptionHandler({ AccountLoginException.class })
+    public ResponseEntity<RestfulResult> handleException(@Nonnull Exception e) {
+        return buildExceptionResponse(e);
+    }
+}

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/exception/handler/SaTokenExceptionHandler.java

@@ -1,6 +1,20 @@
-package xyz.zhouxy.plusone.system.application.common.exception.handler;
+/*
+ * Copyright 2022-2023 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.
+ */
 
-import javax.annotation.Nonnull;
+package xyz.zhouxy.plusone.system.application.exception.handler;
 
 import org.springframework.http.HttpStatus;
 import org.springframework.http.ResponseEntity;
@@ -16,8 +30,8 @@ import cn.dev33.satoken.exception.NotSafeException;
 import cn.dev33.satoken.exception.SaTokenException;
 import cn.dev33.satoken.exception.SameTokenInvalidException;
 import lombok.extern.slf4j.Slf4j;
-import xyz.zhouxy.plusone.commons.exception.handler.BaseExceptionHandler;
-import xyz.zhouxy.plusone.commons.util.UnifiedResponse;
+import xyz.zhouxy.plusone.exception.handler.BaseExceptionHandler;
+import xyz.zhouxy.plusone.commons.util.RestfulResult;
 
 /**
  * Sa-Token 异常处理器
@@ -29,7 +43,7 @@ import xyz.zhouxy.plusone.commons.util.UnifiedResponse;
 public class SaTokenExceptionHandler extends BaseExceptionHandler {
 
 
-    public SaTokenExceptionHandler(@Nonnull ExceptionInfoHolder exceptionInfoHolder) {
+    public SaTokenExceptionHandler(ExceptionInfoHolder exceptionInfoHolder) {
         super(exceptionInfoHolder);
         set(NotPermissionException.class, 4030103, "会话未能通过权限认证", HttpStatus.FORBIDDEN);
         set(NotRoleException.class, 4030103, "会话未能通过角色认证", HttpStatus.FORBIDDEN);
@@ -52,7 +66,7 @@ public class SaTokenExceptionHandler extends BaseExceptionHandler {
     }
 
     @ExceptionHandler(SaTokenException.class)
-    public ResponseEntity<UnifiedResponse> handleSaTokenException(SaTokenException e) {
+    public ResponseEntity<RestfulResult> handleSaTokenException(SaTokenException e) {
         log.error(e.getMessage(), e);
         return buildExceptionResponse(e);
     }

plusone-system/plusone-system-application/src/main/java/xyz/zhouxy/plusone/system/application/query/AccountQueries.java

@@ -1,9 +1,23 @@
+/*
+ * Copyright 2022-2023 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.system.application.query;
 
 import java.util.List;
 
-import javax.annotation.Nonnull;
-
 import org.apache.ibatis.annotations.Mapper;
 
 import xyz.zhouxy.plusone.commons.util.PageDTO;
@@ -25,7 +39,6 @@ public interface AccountQueries {
         return PageDTO.of(content, total);
     }
 
-    @Nonnull
     List<AccountOverview> queryAccountOverview(AccountQueryParams queryParams);
 
     long count(AccountQueryParams queryParams);