一文读懂Spring中的@Validated注解

1. 基本知识

在Spring框架中，@Validated注解用于在方法参数级别上开启方法参数校验的功能

在方法参数上使用JSR-303/JSR-380规范中定义的校验注解，如@NotNull、@NotBlank、@Size等，以对方法参数进行约束

与@Valid注解有所不同，@Valid注解通常用于在Bean级别上进行校验，而@Validated注解则用于在方法参数级别上进行校验

对于Java的相关知识推荐阅读：java框架 零基础从入门到精通的学习路线 附开源项目面经等（超全）

• 作用范围：用于方法的参数上，表示对该参数进行校验
• Spring版本：在Spring 3.1版本中引入的，用于支持方法参数的校验功能
• 校验失败处理：校验失败时，Spring会抛出MethodArgumentNotValidException异常
  Controller中通过@ExceptionHandler方法来捕获这个异常，并进行自定义的错误处理或返回错误信息给客户端
• 参数校验的开启与配置：在Spring配置文件中添加<mvc:annotation-driven/>或者在Spring Boot应用中添加spring-boot-starter-validation依赖来启用

示例Demo：

import org.springframework.stereotype.Service;
import org.springframework.validation.annotation.Validated;
import javax.validation.constraints.NotBlank;

@Service
@Validated
public class MyService {

    public void process(@NotBlank(message = "Name must not be blank") String name) {
        // 方法体
    }
}

2. @validated和@valid差异

示例Demo如下：

import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;
import javax.validation.Valid;

@RestController
@Validated
public class MyController {

    @PostMapping("/process")
    public ResponseEntity<String> process(@Valid @RequestBody RequestDTO requestDTO) {
        // 处理请求逻辑
        return ResponseEntity.ok("Processed successfully");
    }
}