常用的校验注解之@NotEmpty、@NotBlank、@NotNull的区别

在 Java 中进行数据检验和处理时，注解是一种非常强大和便捷的工具。在数据校验方面，常用的注解包括 @NotEmpty、 @NotBlank和 @NotNull。这些注解用于确保输入的数据在处理过程中满足特定的条件，但是它们之间存在一些关键区别。

1. @NotEmpty

@NotEmpty不能为 null，且长度必须大于0，一般用在集合类或数组上。换句话说 ，被标注的字段必须至少包含一个非空字符、元素或项。

public class User {
    @NotEmpty
    private String username;

	@NotEmpty
    private List<User> list;
}

在上面的例子中，userName字段被标注为@NotBlank，意味着在验证时，userName必须既不为 null，也不为空字符串。

2. @NotBlank

@NotBlank只适用于字符串类型的字段，不能为 null，且调用 trim() 后，长度必须大于0，既：必须有实际字符。

public class User {
    @NotBlank
    private String productName;
}

3. @NotNull

@NotNull相较前两者更加简单，它只检查目标字段是否为 null。一般用在 Integer 类型的基本数据类型的非空校验上，而且被其标注的字段可以使用@size、@Max、@Min对字段数值进行大小的控制。

public class User {
    @NotNull
    private Long orderId;
}

在上述代码中，orderId 字段被标注为@NotNull，表示在处理时，orderId 不能为 null。

4. 区别总结

• @NotEmpty：验证字段不为 null，且长度不为零。适用于字符串、集合和数组
• @NotBlank：验证字段不为 null，长度不为零，且去除两端空格后也不为空。仅适用于字符串。
• @NotNull：验证字段不为 null。一般用于数字类型。

5. 常用的校验注解

注解	说明
@NUll	限制只能为 null
@NotNull	限制必须不能为 null
@AssertTrue	限制必须为 true
@AssertFalse	限制必须为 false
@Min( value )	限制必须为一个不小于指定值的数字
@Max( value )	限制必须为一个不大于指定值的数字
@DecimalMin( value )	被限制的元素必须是一个数字，其值必须大于等于指定的最小值
@DecimalMax( value )	被限制的元素必须是一个数字，其值必须小于等于指定的最大值
@Size( max, min )	限制字符长度必须在 min 到 max 的指定范围内
@Digits( integer, fraction )	限制必须为一个小数，且整数部分的位数不能超过 integer、小数部分的位数不能超过 fraction 的在可接受的范围内
@Past	被限制的元素(日期类型)必须是一个过去的日期
@Future	被限制的元素(日期类型)必须是一个将来的日期
@Pattern( value )	限制必须符合指定的正则表达式
@Email	被限制的元素值为是电子邮件地址，也可以通过正则表达式和 flag 指定自定义的 email
@Length	被限制的字符串的大小必须在指定的范围内
@NotEmpty	被限制的字符串必须非空(不为 null 且不为空)
@Range	被限制的元素必须在合适的范围内

---

好事定律：每件事最后都会是好事，如果不是好事，说明还没到最后。