在网上搜索的内容,大致如下:
@NotEmpty 用在集合类上面
@NotBlank 用在 String 上面
@NotNull 用在基本类型上
只有简单的结果,但是再更具体一点的内容就搜不到了,所以去看了看源码,发现了如下的注释:
# 1. @NotEmpty
/** | |
* Asserts that the annotated string, collection, map or array is not {@code null} or empty. | |
* | |
* @author Emmanuel Bernard | |
* @author Hardy Ferentschik | |
*/ |
也就是说,加了 @NotEmpty 的 String 类、Collection、Map、数组,是不能为 null 或者长度为 0 的(String、Collection、Map 的 isEmpty () 方法)。
# 2. @NotBlank
/** | |
* Validate that the annotated string is not {@code null} or empty. | |
* The difference to {@code NotEmpty} is that trailing whitespaces are getting ignored. | |
* | |
* @author Hardy Ferentschik | |
*/ |
“The difference to {@code NotEmpty} is that trailing whitespaces are getting ignored.” –> 和 {@code NotEmpty} 不同的是,尾部空格被忽略,也就是说,纯空格的 String 也是不符合规则的。所以才会说 @NotBlank 用于 String。
# 3. @NotNull
/** | |
* The annotated element must not be {@code null}. | |
* Accepts any type. | |
* | |
* @author Emmanuel Bernard | |
*/ |
这个就很好理解了,不能为 null。
# 4. Examples:
@Null 验证对象是否为 null
@NotNull 验证对象是否不为 null, 无法查检长度为 0 的字符串
@NotBlank 检查约束字符串是不是 Null 还有被 Trim 的长度是否大于 0, 只对字符串,且会去掉前后空格.
@NotEmpty 检查约束元素是否为 NULL 或者是 EMPTY,用在集合类上面
# 5. 其他
# Booelan 检查
@AssertTrue 验证 Boolean 对象是否为 true
@AssertFalse 验证 Boolean 对象是否为 false
# 长度检查
@Size (min=, max=) 验证对象(Array,Collection,Map,String)长度是否在给定的范围之内。可以验证集合内元素的多少。
@Length (min=, max=) Validates that the annotated string is between min and max included. 主要用于 String 类型
# 日期检查
@Past 验证 Date 和 Calendar 对象是否在当前时间之前
@Future 验证 Date 和 Calendar 对象是否在当前时间之后
@Pattern 验证 String 对象是否符合正则表达式的规则
# 数值检查
建议使用在 Stirng,Integer 类型,不建议使用在 int 类型上,
因为表单值为 “” 时无法转换为 int,但可以转换为 Stirng 为 "",Integer 为 null
@Min 验证 Number 和 String 对象是否大等于指定的值
@Max 验证 Number 和 String 对象是否小等于指定的值
@DecimalMax 被标注的值必须不大于约束中指定的最大值。这个约束的参数是一个通过 BigDecimal 定义的最大值的字符串表示。小数存在精度
@DecimalMin 被标注的值必须不小于约束中指定的最小值。这个约束的参数是一个通过 BigDecimal 定义的最小值的字符串表示。小数存在精度
@Digits 验证 Number 和 String 的构成是否合法
@Digits (integer=,fraction=) 验证字符串是否是符合指定格式的数字,interger 指定整数精度,fraction 指定小数精度。
# 其他
@Valid 递归的对关联对象进行校验,如果关联对象是个集合或者数组,那么对其中的元素进行递归校验,如果是一个 map, 则对其中的值部分进行校验.(是否进行递归验证)
@CreditCardNumber 信用卡验证
@Email 验证是否是邮件地址,如果为 null, 不进行验证,算通过验证。
@ScriptAssert(lang= ,script=, alias=)
@URL(protocol=,host=, port=,regexp=, flags=)
@Range(min=, max=) Checks whether the annotated value lies between (inclusive) the specified minimum and maximum.
@Range(min=10000,max=50000,message="range.bean.wage")
# 小结
枚举:@NotNull 校验是否为空 值的正确性有框架判定
引用:首先 @NotNull 判定是否为空,然后 @valid 进行级联校验
数值:@NotNull 判断是否为空, 使用 @size/@Max/@Min 进行大小的控制
日期:@NotNull 校验是否为空 @DateTimeFormat 结合 jode 可以固定日期的格式
对于日期的范围 注解解决不了 需要写方法判断了
日期类型输入纯文本数字也是可以通过的 值得注意
字符串:使用 @NotBlank, 而不是 @NotNull、@NotEmpty,@NotBlan 是 2 者的结合;使用 @Length 限制长度
对于其输入的具体内容的控制 目前没有好办法
@NotEmpty 用在集合类上面 不能为 null,而且长度必须大于 0 (""," ")
@NotBlank 用在 String 上面 只能作用在 String 上,不能为 null,而且调用 trim () 后,长度必须大于 0 ("test") 即:必须有实际字符
@NotNull 用在基本类型上 不能为 null,但可以为 empty (""," "," ")
# 级联校验
public class ReportVO { | |
@NotNull(message = "举报内容不能为空") | |
@Valid | |
private ReportContent content; | |
@NotNull(message = "举报信息不能为空") | |
@Valid | |
private ReportInfo info; | |
} |
public class ReportInfo extends BaseTenantDomain<String> { | |
private String reportContentId; | |
@NotBlank(message = "举报人id不能为空") | |
private String reportorId; | |
@NotNull(message = "举报类型不能为空") | |
private ReportType reportType; | |
@NotBlank(message = "举报详细描述不能为空") | |
@Size(max=100, message = "举报详细描述不能超过100") | |
private String desc; | |
private Date reportTime; // 举报时间 | |
private Date dealTime; // 处理时间 | |
} |
public void report(@RequestBody @Valid ReportVO reportVo) { | |
contentService.report(reportVo.getContent(), reportVo.getInfo()); | |
}<span style="font-family:microsoft yahei;"><span style="font-size: 15px; line-height: 35px;"> | |
</span></span> |