Skip to content

模型验证

验证用户输入的内容是否符合要求是应用程序中常见的功能,我们使用 Spring 提供的 @Valid 注解来实现验证功能。

验证注解

注解说明
@Pattern(value)限制必须符合指定的正则表达式
@NotNull限制必须不为null
@NotEmpty验证注解的元素值不为null且不为空(字符串长度不为0、集合大小不为0)
@NotBlank验证注解的元素值不为空(不为null、去除首位空格后长度为0),不同于@NotEmpty,@NotBlank只应用于字符串且在比较时会去除字符串的空格
@Size(max,min)限制字符长度必须在min到max之间
@Max(value)限制必须为一个不大于指定值的数字
@Min(value)限制必须为一个不小于指定值的数字
@DecimalMax(value)限制必须为一个不大于指定值的数字
@DecimalMin(value)限制必须为一个不小于指定值的数字
@Digits(integer,fraction)限制必须为一个小数,且整数部分的位数不能超过integer,小数部分的位数不能超过fraction
@Email验证注解的元素值是Email,也可以通过正则表达式和flag指定自定义的email格式
@Null限制只能为null
@AssertFalse限制必须为false
@AssertTrue限制必须为true
@Future限制必须是一个将来的日期
@Past限制必须是一个过去的日期
@Past验证注解的元素值(日期类型)比当前时间早
@DictValue(name)验证注解的元素值是否在字典值内,字典分类通过name指定。空值则不做验证。

示例

java
// 控制器方法参数前添加 "@Valid"
@GetMapping
public AjaxResult list(@Valid QueryDto dto) {
    ...
}
java
// 模型属性添加验证规则
public class QueryDto {

  @NotBlank(message = "编号不能为空")
  private String id;

  @NotBlank(message = "不能为空")
  @DictValue(name = "sex", message = "无效的性别")
  private String gender;

}