Java Valid

### Java 验证机制及其有效用法

#### 使用 Bean Validation 进行参数校验

Bean Validation 是一种用于验证 Java 对象属性的标准方法。最常用的实现之一是 Hibernate Validator。

通过在实体类字段上添加注解来定义约束条件：

import javax.validation.constraints.*;

public class User {
    @NotNull(message = "用户名不能为空")
    private String username;

    @Email(message = "邮箱格式不正确")
    private String email;

    @Min(value = 18, message = "年龄必须大于等于18岁")
    private int age;
}

当创建 `User` 实例并调用验证逻辑时，如果违反任何约束，则会抛出异常或返回错误列表[^1]。

#### 利用 Spring Boot 自动化配置简化验证流程

Spring Boot 提供了内置支持以集成 Bean Validation，在控制器层可以直接应用这些功能而无需额外编写代码：

@RestController
@RequestMapping("/users")
public class UserController {

    @PostMapping
    public ResponseEntity<String> createUser(@Valid @RequestBody User user) {
        // 处理业务逻辑...
        return ResponseEntity.ok("用户已成功创建");
    }
}

这里 `@Valid` 注解确保传入的数据符合预设规则；如果有误则自动响应 HTTP 400 错误码给客户端[^2]。

#### 结合自定义注解增强灵活性

除了标准的约束之外还可以开发自己的验证器以便处理特定场景下的需求：

@Constraint(validatedBy = UniqueUsernameValidator.class)
@Target({ ElementType.FIELD })
@Retention(RetentionPolicy.RUNTIME)
public @interface UniqueUsername {
    String message() default "该用户名已被占用";
}

// 定义对应的验证处理器
public class UniqueUsernameValidator implements ConstraintValidator<UniqueUsername, String> {
    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        // 查询数据库判断是否唯一
        return !userRepository.existsByUsername(value);
    }
}

此方式允许开发者针对应用程序特有的业务规则实施更精确有效的输入过滤措施[^3]。