文章目录

• 前言
• 使用方法
• 常用的注解类型
• @Pattern
• @AssertFalse
• @AssertTrue
• @NotNull
• @Null
• @NotEmpty
• @NotBlank
• @DecimalMax
• @DecimalMin
• @Max
• @Min
• @Negative
• @NegativeOrZero
• @Positive
• @PositiveOrZero
• @Digits
• @Email
• @Future
• @FutureOrPresent
• @Past
• @PastOrPresent
• @Size
• @Valid

前言

还在为接口写一堆if语句校验参数吗？快来使用@Validated 校验你的参数吧，写法优雅，逻辑清晰，你值得拥有。

spring boot中已经引入了@Validated 的基础包，所以在spring boot项目中我们可以直接使用。

更新：

spring boot最新版已经默认去掉了参数校验的包，需要手动引入依赖。

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

使用方法

1、首先在Controller接口的参数上加上@Validated 注解，表示要校验这个参数：

/**
* 添加员工信息
*
* @param param
* @return
*/
@ApiOperation("添加员工信息")
@PostMapping("addEmp")
public ResponseEntity<Boolean> addEmp(@RequestBody @Validated AddEmpParam param){
return ResponseEntity.success(empService.addEmp(param));
}

2、然后在Bean上声明需要被校验的字段：

/**
* 添加员工参数实体
* @author ZhengNC
* @date 2020/5/24 16:57
*/
@ApiModel("添加员工参数实体")
@Data
public class AddEmpParam {

/**
* 手机号
*/
@ApiModelProperty("手机号")
@NotBlank(message = "手机号不能为空")
private String phone;

/**
* 姓名
*/
@ApiModelProperty("姓名")
@NotBlank(message = "姓名不能为空")
private String name;

/**
* 性别：0 未知，1男，2女
*/
@ApiModelProperty("性别：0 未知，1男，2女")
@NotNull(message = "性别不能为空")
@Min(value = 0, message = "性别输入错误")
@Max(value = 2, message = "性别输入错误")
private Integer sex;

/**
* 年龄
*/
@ApiModelProperty("年龄")
@Min(value = 18, message = "年龄不能低于18岁")
private Integer age;

/**
* 身份证
*/
@ApiModelProperty("身份证")
@Pattern(regexp = "^\\d{15}|\\d{18}|\\d{17}(\\d|X|x)$", message = "身份证号码错误")
private String idCard;

}

3、最后，如果校验不通过就会抛出异常，可以在统一异常处理类中处理这些异常：

/**
* 全局异常处理
* @author ZhengNC
* @date 2020/5/24 20:17
*/
@RestControllerAdvice
@Slf4j
public class GlobalExceptionHandler {

/**
* 处理实体类参数校验异常
* @param e
* @return
*/
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity handleMethodArgumentNotValidException(MethodArgumentNotValidException e){
return ResponseEntity.paramFailed(e.getBindingResult().getFieldError().getDefaultMessage());
}

/**
* 处理方法参数校验异常
* @param e
* @return
*/
@ExceptionHandler(ConstraintViolationException.class)
public ResponseEntity handleConstraintViolationException(ConstraintViolationException e){
if (e.getConstraintViolations().size() > 0){
return ResponseEntity.paramFailed(
((ConstraintViolation)e.getConstraintViolations().toArray()[0])
.getMessageTemplate()
);
}
return ResponseEntity.paramFailed();
}

/**
* 处理SpringWeb参数校验异常
* @param e
* @return
*/
@ExceptionHandler(MissingServletRequestParameterException.class)
public ResponseEntity handleMissingServletRequestParameterException(MissingServletRequestParameterException e){
return ResponseEntity.paramFailed();
}

/**
* 处理自定义响应类异常
* @param e
* @return
*/
@ExceptionHandler(ResponseException.class)
public ResponseEntity handleResponseException(ResponseException e){
log.error("{}", e.getStackTrace());
return ResponseEntity.failed(e.getCode(), e.getMessage());
}

/**
* 处理所有的运行时异常
* @param e
* @return
*/
@ExceptionHandler(RuntimeException.class)
public ResponseEntity handleRuntimeException(RuntimeException e){
log.error("{}", e.getStackTrace());
e.printStackTrace();
return ResponseEntity.failed();
}
}

常用的注解类型

@Pattern

校验的字符串必须满足指定的正则表达式

例：@Pattern(regexp = “^\d{15}|\d{18}|\d{17}(\d|X|x)$”, message = “身份证号码错误”)

可用类型：字符串

注意： null可以校验通过

@AssertFalse

校验的元素一定是假的

可用类型：boolean、Boolean

注意： null可以校验通过

@AssertTrue

校验的元素一定是真的

可用类型：boolean、Boolean

注意： null可以校验通过

@NotNull

不能为null

可用类型：所有

@Null

必须为null

可用类型：所有

@NotEmpty

不能为null且不能为空

可用类型：字符串、集合、Map、数组

@NotBlank

不能为null且至少有一个非空白字符

可用类型：字符串

@DecimalMax

校验的元素必须是数字，小数和整数都可以，且必须小于或等于指定的最大值（value为字符串类型）

可用类型：BigDecimal、BigInteger、字符串、（byte、short、int、long）以及它们的包装类型

注意： double和float不支持，null可以校验通过

@DecimalMin

校验的元素必须是数字，小数和整数都可以，且必须大于或等于指定的最小值（value为字符串类型）

可用类型：BigDecimal、BigInteger、字符串、（byte、short、int、long）以及它们的包装类型

注意： double和float不支持，null可以校验通过

@Max

校验的元素必须是数字，小数和整数都可以，且必须小于或等于指定的最大值（value为long类型）

可用类型：BigDecimal、BigInteger、（byte、short、int、long）以及它们的包装类型

PS：经验证 字符串 也是支持的类型

注意： double和float不支持，null可以校验通过

@Min

校验的元素必须是数字，小数和整数都可以，且必须大于或等于指定的最小值（value为long类型）

可用类型：BigDecimal、BigInteger、（byte、short、int、long）以及它们的包装类型

PS：经验证 字符串 也是支持的类型

注意： double和float不支持，null可以校验通过

@Negative

校验的元素必须是数字，且必须小于0

可用类型：BigDecimal、BigInteger、（byte、short、int、long、float、double）以及它们的包装类型

注意： null可以校验通过

@NegativeOrZero

校验的元素必须是数字，且必须小于或等于0

可用类型：BigDecimal、BigInteger、（byte、short、int、long、float、double）以及它们的包装类型

注意： null可以校验通过

@Positive

校验的元素必须是数字，且必须大于0

可用类型：BigDecimal、BigInteger、（byte、short、int、long、float、double）以及它们的包装类型

注意： null可以校验通过

@PositiveOrZero

校验的元素必须是数字，且必须大于或等于0

可用类型：BigDecimal、BigInteger、（byte、short、int、long、float、double）以及它们的包装类型

注意： null可以校验通过

@Digits

校验数字的精度，参数integer为整数位最大长度，fraction为小数位最大长度。

例如：@Digits(integer = 3, fraction = 1, message = “校验未通过”) //表示整数位最多3位，小数位最多1位

可用类型：BigDecimal、BigInteger、字符串、（byte、short、int、long）以及它们的包装类型

注意： null可以校验通过，参数fraction对小数位的校验只对BigDecimal和String生效，对于其它类型这个参数无效

@Email

校验的元素必须是一个结构完整的电子邮件地址

可用类型：字符串

注意： null可以校验通过

@Future

校验的元素必须是未来的瞬间，日期或时间

可用类型：

• java.util.Date

• java.util.Calendar

• java.time.Instant

• java.time.LocalDate

• java.time.LocalDateTime

• java.time.LocalTime

• java.time.MonthDay

• java.time.OffsetDateTime

• java.time.OffsetTime

• java.time.Year

• java.time.YearMonth

• java.time.ZonedDateTime

• java.time.chrono.HijrahDate

• java.time.chrono.JapaneseDate

• java.time.chrono.MinguoDate

• java.time.chrono.ThaiBuddhistDate

注意： null可以校验通过

@FutureOrPresent

校验的元素必须是现在或是未来的瞬间，日期或时间

可用类型：和 @Future 的可用类型相同

注意： null可以校验通过

@Past

校验的元素必须是过去的瞬间，日期或时间

可用类型：和 @Future 的可用类型相同

注意： null可以校验通过

@PastOrPresent

校验的元素必须是现在或是过去的瞬间，日期或时间

可用类型：和 @Future 的可用类型相同

注意： null可以校验通过

@Size

校验元素的尺寸必须在指定的范围内（包含边界）

例：@Size(min = 1, max = 5, message = “校验未通过”)

可用类型：字符串（校验字符串长度）、集合（校验Size）、Map（校验Size）、数组（校验length）

注意： null可以校验通过

@Valid

声明对实体类校验（嵌套校验会用到）

例如：

@Valid
private AddEmpParam empParam;

注意： null可以校验通过