@Valid使用方法

### @Valid 注解使用教程

#### Maven 依赖引入
为了在项目中使用 `@Valid` 注解，需先引入相应的依赖。对于 Spring Boot 应用程序来说，可以通过添加如下 Maven 配置来完成：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

此操作会自动导入必要的 Bean Validation API 和 Hibernate Validator 实现[^1]。

#### 控制器层中的应用实例
当处理 HTTP 请求时，在控制器的方法参数上使用 `@Valid` 可以触发对传入对象字段的有效性检查。如果验证失败，则抛出异常并返回错误响应给客户端。下面是一个具体的例子展示如何在一个 RESTful Web Service 的 POST 方法里运用该注解来进行请求体校验:

@RestController
public class UserController {

    @PostMapping("/users")
    public ResponseEntity<String> createUser(@Valid @RequestBody UserRequest userRequest) {
        // 处理业务逻辑...
        return ResponseEntity.ok("User created successfully");
    }
}

此处假设 `UserRequest` 类定义了一些带有约束条件的属性，比如用户名长度限制等[^2]。

#### 内部类特殊情形下的注意事项
值得注意的是，在某些情况下（例如存在嵌套的对象结构），可能需要额外标注父级容器上的成员变量为 `@Valid` 才能确保子元素也能被正确检验。具体可参见以下代码片段说明这一现象的发生场景及其解决方案[^3]:

@Data
public static class ParentClass {
    
    @Valid // 此处标记非常重要！它使得内含列表里的每一个Item都能接受到完整的验证流程。
    private List<Item> items;
}

@Data
public static class Item {
    
    @NotNull(message = "ID cannot be null.")
    private Long id;

    @Size(min=5, max=20, message="Name must between 5 and 20 characters long.")
    private String name;
}

通过上述设置之后，即使是在复杂的数据模型下也能够有效地执行全面而细致化的输入合法性判断工作了。