Spring Web 嵌套对象校验失效

问题复现

  • 当开发一个学籍管理系统时,我们会提供了一个 API 接口去添加学生的相关信息,学生中有个嵌套属性联系电话,其对象定义参考下面的代码:

    java 复制代码
    import lombok.Data;
    import javax.validation.constraints.Size;
    @Data
    public class Student {
        @Size(max = 10)
        private String name;
        private short age;
        private Phone phone;
    }
    
    @Data
    class Phone {
        @Size(max = 10)
        private String number;
    }
  • 这里我们也给 Phone 对象做了合法性要求(@Size(max = 10)),当我们使用下面的请求(请求 body 携带一个联系电话信息超过 10 位),测试校验会发现这个约束并不生效。

  • 定义完对象后,我们再定义一个 Controller 去使用它,使用方法如下:

    java 复制代码
    import lombok.extern.slf4j.Slf4j;
    import org.springframework.web.bind.annotation.RequestBody;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RequestMethod;
    import org.springframework.web.bind.annotation.RestController;
    @RestController
    @Slf4j
    @Validated
    public class StudentController {
        @RequestMapping(path = "students", method = RequestMethod.POST)
        public void addStudent(@Validated @RequestBody Student student){
            log.info("add new student: {}", student.toString());
            //省略业务代码
        };
    }
  • 我们提供了一个支持学生信息添加的接口。启动服务后,使用 IDEA 自带的 HTTP Client 工具来发送下面的请求以添加一个学生:

    json 复制代码
    POST http://localhost:8080/students
    Content-Type: application/json
    {
      "name": "xiaoming",
      "age": 10,
      "phone": {"number":"12306123061230612306"}
    }
  • 发现校验器并没有生效。

案例解析

  • 关于 student 本身的 Phone 类型成员是否校验是在校验过程中(即案例 1 中的代码行 binder.validate(validationHints))决定的。

  • 在校验执行时,首先会根据 Student 的类型定义找出所有的校验点,然后对 Student 对象实例执行校验,这个逻辑过程可以参考代码 ValidatorImpl#validate:

    java 复制代码
    @Override
    public final <T> Set<ConstraintViolation<T>> validate(T object, Class<?>... groups) {
       //省略部分非关键代码
       Class<T> rootBeanClass = (Class<T>) object.getClass();
       //获取校验对象类型的"信息"(包含"约束")
       BeanMetaData<T> rootBeanMetaData = beanMetaDataManager.getBeanMetaData( rootBeanClass );
    
       if ( !rootBeanMetaData.hasConstraints() ) {
          return Collections.emptySet();
       }
    
       //省略部分非关键代码
       //执行校验
       return validateInContext( validationContext, valueContext, validationOrder );
    }
  • 这里语句"beanMetaDataManager.getBeanMetaData( rootBeanClass )"根据 Student 类型组装出 BeanMetaData,BeanMetaData 即包含了需要做的校验(即 Constraint)。

  • 在组装 BeanMetaData 过程中,会根据成员字段是否标记了 @Valid 来决定(记录)这个字段以后是否做级联校验,参考代码 AnnotationMetaDataProvider#getCascadingMetaData:

    java 复制代码
    private CascadingMetaDataBuilder getCascadingMetaData(Type type, AnnotatedElement annotatedElement,
          Map<TypeVariable<?>, CascadingMetaDataBuilder> containerElementTypesCascadingMetaData) {
       return CascadingMetaDataBuilder.annotatedObject( type, annotatedElement.isAnnotationPresent( Valid.class ), containerElementTypesCascadingMetaData,
                   getGroupConversions( annotatedElement ) );
    }
  • 在上述代码中"annotatedElement.isAnnotationPresent( Valid.class )"决定了 CascadingMetaDataBuilder#cascading 是否为 true。如果是,则在后续做具体校验时,做级联校验,而级联校验的过程与宿主对象(即 Student)的校验过程大体相同,即先根据对象类型获取定义再来做校验。

  • 在当前案例代码中,phone 字段并没有被 @Valid 标记,所以关于这个字段信息的 cascading 属性肯定是 false,因此在校验 Student 时并不会级联校验它。

问题修正

  • 从源码级别了解了嵌套 Validation 失败的原因后,我们会发现,要让嵌套校验生效,解决的方法只有一种,就是加上 @Valid,修正代码如下:

    java 复制代码
    @Valid
    private Phone phone;
  • 当修正完问题后,我们会发现校验生效了。而如果此时去调试修正后的案例代码,会看到 phone 字段 MetaData 信息中的 cascading 确实为 true 了,参考下图:

相关推荐
Jabes.yang4 小时前
Java面试场景:从Spring Web到Kafka的音视频应用挑战
大数据·spring boot·kafka·spring security·java面试·spring webflux
程序员小凯7 小时前
Spring Boot性能优化详解
spring boot·后端·性能优化
tuine7 小时前
SpringBoot使用LocalDate接收参数解析问题
java·spring boot·后端
番茄Salad8 小时前
Spring Boot项目中Maven引入依赖常见报错问题解决
spring boot·后端·maven
摇滚侠9 小时前
Spring Boot 3零基础教程,yml配置文件,笔记13
spring boot·redis·笔记
!if9 小时前
springboot mybatisplus 配置SQL日志,但是没有日志输出
spring boot·sql·mybatis
阿挥的编程日记10 小时前
基于SpringBoot的影评管理系统
java·spring boot·后端
java坤坤10 小时前
Spring Boot 集成 SpringDoc OpenAPI(Swagger)实战:从配置到接口文档落地
java·spring boot·后端
摇滚侠11 小时前
Spring Boot 3零基础教程,整合Redis,笔记12
spring boot·redis·笔记
荣淘淘11 小时前
互联网大厂Java求职面试全景实战解析(涵盖Spring Boot、微服务及云原生技术)
java·spring boot·redis·jwt·cloud native·microservices·interview