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

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