Spring Validation —— 参数校验框架

时间:2024-10-10 07:23:40

案例说明——后端校验注册表单字段

        在编写注册功能时,需要考虑字段校验的情况,这时候可以采用 Spring提供的一套参数校验框架工具——Spring Validation。一下是使用的步骤:

1. 导入validation坐标

2. 在参数上添加 @Pattern注解,指定校验规则

3. 在controller类上添加@Validated注解

4. 在全局异常处理器中处理参数校验失败的情况 

 

扩展:Spring Validation教程

一、配置与依赖

依赖引入:对于Spring Boot项目,如果版本小于2.3.x,spring-boot-starter-web会自动引入hibernate-validator依赖。如果版本大于或等于2.3.x,则需要手动引入hibernate-validator依赖。

配置类:在某些情况下,可能需要创建配置类来配置LocalValidatorFactoryBean,以便自定义校验器的注册和校验规则的加载。

二、使用方式

实现Validator接口:通过创建实现Validator接口的类,并在其中定义校验逻辑。然后,在需要校验的对象上使用@Validated注解,并指定校验器类。

使用Bean Validation注解:直接在Java对象的属性上使用Bean Validation提供的注解来定义校验规则。Spring会自动识别这些注解,并在需要时进行校验。

基于方法的校验:在Spring MVC的Controller层,可以使用@Validated注解对方法参数进行校验。如果校验失败,Spring会抛出异常,并可以通过全局异常处理器进行处理。

三、常用注解

以下是将Spring Validation中常用的注解列成表格的形式:

注解 描述 适用类型
@Null 验证对象是否为null Java对象
@NotNull 验证对象是否不为null Java对象(不适用于基本数据类型包装类的空字符串)
@NotBlank 检查字符串是否不为null、空字符串或只包含空格 String
@NotEmpty 检查集合、数组、String、Map等是否不为null或空 Collection, Array, String, Map等
@Size(min, max) 验证对象(Array, Collection, Map, String)长度是否在给定的范围之内 Array, Collection, Map, String
@AssertTrue 验证Boolean对象是否为true Boolean
@AssertFalse 验证Boolean对象是否为false Boolean
@Past 验证Date和Calendar对象是否在当前时间之前 Date, Calendar
@Future 验证Date和Calendar对象是否在当前时间之后 Date, Calendar
@Pattern(regex) 验证String对象是否符合正则表达式的规则 String
@Min(value) 验证Number和String对象是否大于等于指定的值 Number, String(转换为Number后比较)
@Max(value) 验证Number和String对象是否小于等于指定的值 Number, String(转换为Number后比较)
@DecimalMin(value) 验证数字字段是否大于等于指定的小数值(支持BigDecimal) BigDecimal, Number, String(转换为BigDecimal后比较)
@DecimalMax(value) 验证数字字段是否小于等于指定的小数值(支持BigDecimal) BigDecimal, Number, String(转换为BigDecimal后比较)
@Digits(integer, fraction) 验证数字字段的整数部分和小数部分的位数 Number, String(转换为Number后校验)
@Range(min, max) 确保数字字段在指定范围内(是@Min@Max的组合) Number, String(转换为Number后比较)
@Email 确保字段是有效的电子邮件地址 String

注意: 这些注解可以直接应用于Java对象的属性上,并通过Spring的校验机制进行验证。在Spring MVC的Controller层,可以通过@Valid@Validated注解来开启对这些注解的校验功能。如果校验失败,Spring会抛出异常,通常可以通过全局异常处理器进行处理。