模型验证
验证用户输入的内容是否符合要求是应用程序中常见的功能,我们使用 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,也可以通过正则表达式和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;
}