feat(validation): 新增校验模块并引入 SpEL Validator 用于复杂校验场景

README.md

@@ -152,6 +152,7 @@ continew-starter
 ├─ continew-starter-json（JSON 模块）
 │  └─ continew-starter-json-jackson
 ├─ continew-starter-api-doc（接口文档模块：Spring Doc + Knife4j）
+├─ continew-starter-validation（校验模块：Hibernate Validator）
 ├─ continew-starter-web（Web 开发模块：包含跨域、全局异常+响应、链路追踪等自动配置）
 ├─ continew-starter-cache（缓存模块）
 │  ├─ continew-starter-cache-redisson（Redisson）
@@ -161,7 +162,7 @@ continew-starter
 │  ├─ continew-starter-auth-satoken（国产轻量认证鉴权）
 │  └─ continew-starter-auth-justauth（第三方登录）
 ├─ continew-starter-data（数据访问模块）
-│  ├─ continew-starter-data-core（通用模块）
+│  ├─ continew-starter-data-core（核心模块）
 │  ├─ continew-starter-data-mp（MyBatis Plus）
 │  └─ continew-starter-data-mf（MyBatis Flex）
 ├─ continew-starter-security（安全模块）
@@ -179,11 +180,13 @@ continew-starter
 │  ├─ continew-starter-messaging-mail（邮件）
 │  └─ continew-starter-messaging-websocket（WebSocket）
 ├─ continew-starter-log（日志模块）
-│  ├─ continew-starter-log-core（通用模块）
+│  ├─ continew-starter-log-core（核心模块）
 │  ├─ continew-starter-log-aop（基于 AOP 实现）
 │  └─ continew-starter-log-interceptor（基于拦截器实现（Spring Boot Actuator HttpTrace 增强版））
-├─ continew-starter-file（文件处理模块）
-│  └─ continew-starter-file-excel（Easy Excel）
+├─ continew-starter-excel（Excel 文件处理模块）
+│  ├─ continew-starter-excel-core（核心模块）
+│  ├─ continew-starter-excel-fastexcel（FastExcel）
+│  └─ continew-starter-excel-poi（POI）
 ├─ continew-starter-storage（存储模块）
 │  └─ continew-starter-storage-local（本地存储）
 ├─ continew-starter-license（License 模块）
@@ -192,13 +195,13 @@ continew-starter
 │  └─ continew-starter-license-verifier（License 校验器）
 └─ continew-starter-extension（扩展模块）
    ├─ continew-starter-extension-datapermission（数据权限模块）
-   │  ├─ continew-starter-extension-datapermission-core（通用模块）
+   │  ├─ continew-starter-extension-datapermission-core（核心模块）
    │  └─ continew-starter-extension-datapermission-mp（MyBatis Plus）
    ├─ continew-starter-extension-tenant（多租户模块）
-   │  ├─ continew-starter-extension-tenant-core（通用模块）
+   │  ├─ continew-starter-extension-tenant-core（核心模块）
    │  └─ continew-starter-extension-tenant-mp（MyBatis Plus）
    └─ continew-starter-extension-crud（CRUD 模块）
-      ├─ continew-starter-extension-crud-core（通用模块）
+      ├─ continew-starter-extension-crud-core（核心模块）
       ├─ continew-starter-extension-crud-mp（MyBatis Plus）
       └─ continew-starter-extension-crud-mf（MyBatis Flex）
 ```

continew-starter-bom/pom.xml

@@ -39,6 +39,13 @@
                 <version>${revision}</version>
             </dependency>
 
+            <!-- 校验模块 -->
+            <dependency>
+                <groupId>top.continew</groupId>
+                <artifactId>continew-starter-validation</artifactId>
+                <version>${revision}</version>
+            </dependency>
+
             <!-- Web 模块 -->
             <dependency>
                 <groupId>top.continew</groupId>

continew-starter-core/src/main/java/top/continew/starter/core/util/CheckUtils.java

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-package top.continew.starter.core.validation;
+package top.continew.starter.core.util;
 
 import cn.hutool.core.text.CharSequenceUtil;
 import top.continew.starter.core.constant.StringConstants;

continew-starter-core/src/main/java/top/continew/starter/core/util/ValidationUtils.java

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-package top.continew.starter.core.validation;
+package top.continew.starter.core.util;
 
 import cn.hutool.core.text.CharSequenceUtil;
 import top.continew.starter.core.exception.BadRequestException;

continew-starter-core/src/main/java/top/continew/starter/core/util/Validator.java

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-package top.continew.starter.core.validation;
+package top.continew.starter.core.util;
 
 import cn.hutool.core.text.CharSequenceUtil;
 import cn.hutool.core.util.ObjectUtil;

continew-starter-core/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports

@@ -1,4 +1,3 @@
 top.continew.starter.core.autoconfigure.project.ProjectAutoConfiguration
-top.continew.starter.core.autoconfigure.ValidatorAutoConfiguration
 top.continew.starter.core.autoconfigure.threadpool.ThreadPoolAutoConfiguration
 top.continew.starter.core.autoconfigure.threadpool.AsyncAutoConfiguration

continew-starter-data/continew-starter-data-mf/src/main/java/top/continew/starter/data/mf/util/QueryWrapperHelper.java

@@ -28,7 +28,7 @@ import org.slf4j.LoggerFactory;
 import org.springframework.data.domain.Sort;
 import top.continew.starter.core.exception.BadRequestException;
 import top.continew.starter.core.util.ReflectUtils;
-import top.continew.starter.core.validation.ValidationUtils;
+import top.continew.starter.core.util.ValidationUtils;
 import top.continew.starter.data.core.annotation.Query;
 import top.continew.starter.data.core.annotation.QueryIgnore;
 import top.continew.starter.data.core.enums.QueryType;

continew-starter-data/continew-starter-data-mp/src/main/java/top/continew/starter/data/mp/service/impl/ServiceImpl.java

@@ -20,8 +20,8 @@ import cn.hutool.core.util.ClassUtil;
 import com.baomidou.mybatisplus.core.mapper.BaseMapper;
 import com.baomidou.mybatisplus.extension.repository.CrudRepository;
 import top.continew.starter.core.util.ReflectUtils;
-import top.continew.starter.core.validation.CheckUtils;
 import top.continew.starter.data.mp.service.IService;
+import top.continew.starter.core.util.CheckUtils;
 
 import java.io.Serializable;
 import java.lang.reflect.Field;

continew-starter-data/continew-starter-data-mp/src/main/java/top/continew/starter/data/mp/util/QueryWrapperHelper.java

@@ -28,7 +28,7 @@ import org.slf4j.LoggerFactory;
 import org.springframework.data.domain.Sort;
 import top.continew.starter.core.exception.BadRequestException;
 import top.continew.starter.core.util.ReflectUtils;
-import top.continew.starter.core.validation.ValidationUtils;
+import top.continew.starter.core.util.ValidationUtils;
 import top.continew.starter.data.core.annotation.Query;
 import top.continew.starter.data.core.annotation.QueryIgnore;
 import top.continew.starter.data.core.enums.QueryType;

continew-starter-dependencies/pom.xml

@@ -39,6 +39,7 @@
         <aws-crt.version>0.38.5</aws-crt.version>
         <thumbnails.version>0.4.20</thumbnails.version>
         <graceful-response.version>5.0.5-boot3</graceful-response.version>
+        <spel-validator.version>0.5.0-beta</spel-validator.version>
         <crane4j.version>2.9.0</crane4j.version>
         <knife4j.version>4.5.0</knife4j.version>
         <tlog.version>1.5.2</tlog.version>
@@ -266,6 +267,13 @@
                 <version>${graceful-response.version}</version>
             </dependency>
 
+            <!-- SpEL Validator（基于 SpEL 的 jakarta.validation-api 扩展增强包） -->
+            <dependency>
+                <groupId>cn.sticki</groupId>
+                <artifactId>spel-validator-javax</artifactId>
+                <version>${spel-validator.version}</version>
+            </dependency>
+
             <!-- Crane4j（基于注解的，用于完成一切 “根据 A 的 key 值拿到 B，再把 B 的属性映射到 A” 这类需求的字段填充框架） -->
             <dependency>
                 <groupId>cn.crane4j</groupId>

continew-starter-extension/continew-starter-extension-crud/continew-starter-extension-crud-core/src/main/java/top/continew/starter/extension/crud/autoconfigure/CrudTreeProperties.java

@@ -17,7 +17,7 @@
 package top.continew.starter.extension.crud.autoconfigure;
 
 import cn.hutool.core.lang.tree.TreeNodeConfig;
-import top.continew.starter.core.validation.CheckUtils;
+import top.continew.starter.core.util.CheckUtils;
 import top.continew.starter.extension.crud.annotation.TreeField;
 
 /**

continew-starter-extension/continew-starter-extension-crud/continew-starter-extension-crud-core/src/main/java/top/continew/starter/extension/crud/model/query/SortQuery.java

@@ -21,7 +21,7 @@ import cn.hutool.core.util.ArrayUtil;
 import io.swagger.v3.oas.annotations.media.Schema;
 import org.springframework.data.domain.Sort;
 import top.continew.starter.core.constant.StringConstants;
-import top.continew.starter.core.validation.ValidationUtils;
+import top.continew.starter.core.util.ValidationUtils;
 import top.continew.starter.data.core.util.SqlInjectionUtils;
 
 import java.io.Serial;

continew-starter-extension/continew-starter-extension-crud/continew-starter-extension-crud-mf/src/main/java/top/continew/starter/extension/crud/service/CrudServiceImpl.java

@@ -33,7 +33,7 @@ import org.springframework.data.domain.Sort;
 import org.springframework.transaction.annotation.Transactional;
 import top.continew.starter.core.constant.StringConstants;
 import top.continew.starter.core.util.ReflectUtils;
-import top.continew.starter.core.validation.ValidationUtils;
+import top.continew.starter.core.util.ValidationUtils;
 import top.continew.starter.data.mf.base.BaseMapper;
 import top.continew.starter.data.mf.service.impl.ServiceImpl;
 import top.continew.starter.data.mf.util.QueryWrapperHelper;

continew-starter-extension/continew-starter-extension-crud/continew-starter-extension-crud-mp/src/main/java/top/continew/starter/extension/crud/service/CrudServiceImpl.java

@@ -37,8 +37,6 @@ import org.springframework.transaction.annotation.Transactional;
 import top.continew.starter.core.constant.StringConstants;
 import top.continew.starter.core.util.ClassUtils;
 import top.continew.starter.core.util.ReflectUtils;
-import top.continew.starter.core.validation.CheckUtils;
-import top.continew.starter.core.validation.ValidationUtils;
 import top.continew.starter.data.mp.mapper.BaseMapper;
 import top.continew.starter.data.mp.service.impl.ServiceImpl;
 import top.continew.starter.data.mp.util.QueryWrapperHelper;
@@ -52,6 +50,8 @@ import top.continew.starter.extension.crud.model.query.SortQuery;
 import top.continew.starter.extension.crud.model.resp.LabelValueResp;
 import top.continew.starter.extension.crud.model.resp.PageResp;
 import top.continew.starter.excel.util.ExcelUtils;
+import top.continew.starter.core.util.CheckUtils;
+import top.continew.starter.core.util.ValidationUtils;
 
 import java.lang.reflect.Field;
 import java.util.*;

continew-starter-messaging/continew-starter-messaging-mail/src/main/java/top/continew/starter/messaging/mail/core/MailConfig.java

@@ -17,7 +17,7 @@
 package top.continew.starter.messaging.mail.core;
 
 import cn.hutool.core.map.MapUtil;
-import top.continew.starter.core.validation.ValidationUtils;
+import top.continew.starter.core.util.ValidationUtils;
 
 import java.nio.charset.Charset;
 import java.nio.charset.StandardCharsets;

continew-starter-messaging/continew-starter-messaging-mail/src/main/java/top/continew/starter/messaging/mail/core/MailConfigurer.java

@@ -17,7 +17,7 @@
 package top.continew.starter.messaging.mail.core;
 
 import org.springframework.mail.javamail.JavaMailSenderImpl;
-import top.continew.starter.core.validation.ValidationUtils;
+import top.continew.starter.core.util.ValidationUtils;
 
 /**
  * 邮件配置

continew-starter-security/continew-starter-security-password/src/main/java/top/continew/starter/security/password/autoconfigure/PasswordEncoderAutoConfiguration.java

@@ -33,7 +33,7 @@ import org.springframework.security.crypto.password.PasswordEncoder;
 import org.springframework.security.crypto.password.Pbkdf2PasswordEncoder;
 import org.springframework.security.crypto.scrypt.SCryptPasswordEncoder;
 import top.continew.starter.core.constant.PropertiesConstants;
-import top.continew.starter.core.validation.CheckUtils;
+import top.continew.starter.core.util.CheckUtils;
 
 import java.util.HashMap;
 import java.util.List;

continew-starter-security/continew-starter-security-sensitivewords/pom.xml

@@ -22,6 +22,7 @@
             <artifactId>hutool-dfa</artifactId>
         </dependency>
 
+        <!-- Spring Boot 校验模块（Hibernate Validator） -->
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-validation</artifactId>

continew-starter-storage/continew-starter-storage-core/src/main/java/top/continew/starter/storage/manger/StorageManager.java

@@ -17,7 +17,7 @@
 package top.continew.starter.storage.manger;
 
 import top.continew.starter.cache.redisson.util.RedisUtils;
-import top.continew.starter.core.validation.ValidationUtils;
+import top.continew.starter.core.util.ValidationUtils;
 import top.continew.starter.storage.constant.StorageConstant;
 import top.continew.starter.storage.strategy.StorageStrategy;
 

continew-starter-storage/continew-starter-storage-local/src/main/java/top/continew/starter/storage/strategy/LocalStorageStrategy.java

@@ -24,8 +24,8 @@ import cn.hutool.core.util.StrUtil;
 import cn.hutool.crypto.digest.DigestUtil;
 import top.continew.starter.core.constant.StringConstants;
 import top.continew.starter.core.exception.BusinessException;
-import top.continew.starter.core.validation.CheckUtils;
-import top.continew.starter.core.validation.ValidationUtils;
+import top.continew.starter.core.util.CheckUtils;
+import top.continew.starter.core.util.ValidationUtils;
 import top.continew.starter.storage.client.LocalClient;
 import top.continew.starter.storage.constant.StorageConstant;
 import top.continew.starter.storage.dao.StorageDao;

continew-starter-storage/continew-starter-storage-oss/src/main/java/top/continew/starter/storage/strategy/OssStorageStrategy.java

@@ -36,8 +36,8 @@ import software.amazon.awssdk.transfer.s3.model.Upload;
 import software.amazon.awssdk.transfer.s3.progress.LoggingTransferListener;
 import top.continew.starter.core.constant.StringConstants;
 import top.continew.starter.core.exception.BusinessException;
-import top.continew.starter.core.validation.CheckUtils;
-import top.continew.starter.core.validation.ValidationUtils;
+import top.continew.starter.core.util.CheckUtils;
+import top.continew.starter.core.util.ValidationUtils;
 import top.continew.starter.storage.client.OssClient;
 import top.continew.starter.storage.constant.StorageConstant;
 import top.continew.starter.storage.dao.StorageDao;

continew-starter-validation/pom.xml

@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<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>top.continew</groupId>
+        <artifactId>continew-starter</artifactId>
+        <version>${revision}</version>
+    </parent>
+
+    <artifactId>continew-starter-validation</artifactId>
+    <packaging>jar</packaging>
+
+    <name>${project.artifactId}</name>
+    <description>ContiNew Starter 验证模块</description>
+
+    <dependencies>
+        <!-- 核心模块 -->
+        <dependency>
+            <groupId>top.continew</groupId>
+            <artifactId>continew-starter-core</artifactId>
+        </dependency>
+
+        <!-- Spring Boot 校验模块（Hibernate Validator） -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-validation</artifactId>
+        </dependency>
+
+        <!-- SpEL Validator（基于 SpEL 的 jakarta.validation-api 扩展增强包） -->
+        <dependency>
+            <groupId>cn.sticki</groupId>
+            <artifactId>spel-validator-javax</artifactId>
+        </dependency>
+    </dependencies>
+</project>

continew-starter-validation/src/main/java/top/continew/starter/validation/autoconfigure/ValidatorAutoConfiguration.java

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-package top.continew.starter.core.autoconfigure;
+package top.continew.starter.validation.autoconfigure;
 
 import jakarta.annotation.PostConstruct;
 import jakarta.validation.Validator;

continew-starter-validation/src/main/java/top/continew/starter/validation/constraints/EnumValue.java

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-package top.continew.starter.core.validation.constraints;
+package top.continew.starter.validation.constraints;
 
 import jakarta.validation.Constraint;
 import jakarta.validation.Payload;

continew-starter-validation/src/main/java/top/continew/starter/validation/constraints/EnumValueValidator.java

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-package top.continew.starter.core.validation.constraints;
+package top.continew.starter.validation.constraints;
 
 import cn.hutool.core.convert.Convert;
 import cn.hutool.core.text.CharSequenceUtil;

continew-starter-validation/src/main/java/top/continew/starter/validation/constraints/JsonString.java

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-package top.continew.starter.core.validation.constraints;
+package top.continew.starter.validation.constraints;
 
 import jakarta.validation.Constraint;
 import jakarta.validation.Payload;

continew-starter-validation/src/main/java/top/continew/starter/validation/constraints/JsonStringValidator.java

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-package top.continew.starter.core.validation.constraints;
+package top.continew.starter.validation.constraints;
 
 import cn.hutool.json.JSONUtil;
 import jakarta.validation.ConstraintValidator;

continew-starter-validation/src/main/java/top/continew/starter/validation/constraints/Mobile.java

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-package top.continew.starter.core.validation.constraints;
+package top.continew.starter.validation.constraints;
 
 import jakarta.validation.Constraint;
 import jakarta.validation.Payload;

continew-starter-validation/src/main/java/top/continew/starter/validation/constraints/MobileValidator.java

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-package top.continew.starter.core.validation.constraints;
+package top.continew.starter.validation.constraints;
 
 import cn.hutool.core.util.PhoneUtil;
 import jakarta.validation.ConstraintValidator;

continew-starter-validation/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports

@@ -0,0 +1 @@
+top.continew.starter.validation.autoconfigure.ValidatorAutoConfiguration

pom.xml

@@ -38,6 +38,7 @@
         <module>continew-starter-core</module>
         <module>continew-starter-json</module>
         <module>continew-starter-api-doc</module>
+        <module>continew-starter-validation</module>
         <module>continew-starter-web</module>
         <module>continew-starter-cache</module>
         <module>continew-starter-auth</module>