在网上搜索的内容,大致如下:

@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>