Jakarta Bean Validation

Validation 官网

https://beanvalidation.org/

常见注解

Bean Validation中定义的注解：

注解	详细信息
@Null	被注释的元素必须为 null
@NotNull	被注释的元素必须不为 null
@AssertTrue	被注释的元素必须为 true
@AssertFalse	被注释的元素必须为 false
@Min(value)	被注释的元素必须是一个数字，其值必须大于等于指定的最小值
@Max(value)	被注释的元素必须是一个数字，其值必须小于等于指定的最大值
@DecimalMin(value)	被注释的元素必须是一个数字，其值必须大于等于指定的最小值
@DecimalMax(value)	被注释的元素必须是一个数字，其值必须小于等于指定的最大值
@Size(max, min)	被注释的元素的大小必须在指定的范围内
@Digits (integer, fraction)	被注释的元素必须是一个数字，其值必须在可接受的范围内
@Past	被注释的元素必须是一个过去的日期
@Future	被注释的元素必须是一个将来的日期
@Pattern(value)	被注释的元素必须符合指定的正则表达式

Hibernate validator 在JSR303的基础上对校验注解进行了扩展，扩展注解如下：

注解	详细信息
@Email	被注释的元素必须是电子邮箱地址
@Length	被注释的字符串的大小必须在指定的范围内
@NotEmpty	被注释的字符串的必须非空
@Range	被注释的元素必须在合适的范围内

导包

您需要在 pom.xml 文件中添加以下依赖项

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

实体类

您还需要使用验证注解来定义实体类。例如：

@Data
@AllArgsConstructor
@NoArgsConstructor
public class User {private String name;private Integer age;private String email;
}

DTO 类

然后创建一个相应的 DTO 类，并在其中使用验证注解，比如 UserDTO：

@Data
@AllArgsConstructor
@NoArgsConstructor
public class UserDTO {@NotBlank(message = "name不能为空或者空格")@Size(min=3, max=9,message = "长度在3-9之间")private String name;@NotNull(message = "age不能为空")@Max(value=60,message = "年龄最大60")@Min(value=18,message = "年龄最小18")private Integer age;@NotNull@Email(message = "邮箱格式不正确")private String email;
}

Controller控制器

在控制器中，您可以使用 @Validated 注解为请求体启用验证。例如：

@RestController
public class UserController {@PostMapping("/add")public String add(@Validated @RequestBody UserDTO userDTO) {User user = new User();BeanUtils.copyProperties(userDTO, user);return "注册成功";}
}

全局异常配置类

要全局处理验证错误，您可以使用 @RestControllerAdvice 和 @ExceptionHandler 注解创建一个全局异常处理器。例如：

@RestControllerAdvice
@Component
public class GlobalExceptionHandler {@ExceptionHandler(MethodArgumentNotValidException.class)public Object handleMethodArgumentNotValidException(MethodArgumentNotValidException e) {// 获取异常信息BindingResult bindingResult = e.getBindingResult();List<ObjectError> allErrors = bindingResult.getAllErrors();// 构建返回结果Map<String, Object> result = new LinkedHashMap<>();result.put("code", "400");result.put("message", "参数校验失败");Map<String, Object> errors = new LinkedHashMap<>();allErrors.forEach(error -> errors.put(((FieldError) error).getField(), error.getDefaultMessage()));result.put("errors", errors);return result;}
}

启动类

用来启动web项目

@SpringBootApplication
public class ValidationApplication {public static void main(String[] args) {SpringApplication.run(ValidationApplication.class, args);}
}

启动项目

postman测试

用户名不合法

{   "name":"","age":20,"email":"奇遇少年@163.com"
}

年龄不合法

{   "name":"奇遇少年","age":10,"email":"奇遇少年@163.com"
}

邮箱格式不合法

{   "name":"奇遇少年","age":20,"email":"奇遇少年"
}

数据正确，注册成功

{   "name":"奇遇少年","age":20,"email":"奇遇少年@163.com"
}