Spring注解@NoNull、@NotEmpty、@NotBlank的区别及注解无效以及嵌套对象的无效解决办法

时间：2025-03-01 10:41:26

1.三者的区别

@NotNull：
不能为null，但可以为empty(""," “,” ") ，一般用在基本数据类型的非空校验上，而且被其标注的字段可以使用 @size/@Max/@Min对字段数值进行大小的控制
@NotEmpty：
不能为null，而且长度必须大于0(" “,” ")，一般用在集合类上面
@NotBlank：
不能为null，注意是只能用在String上，而且调用trim()后，长度必须大于0

简述三者区别

@NotNull://CharSequence, Collection, Map 和 Array 对象不能是 null, 但可以是空集（size = 0）。
@NotEmpty://CharSequence, Collection, Map 和 Array 对象不能是 null 并且相关对象的 size 大于 0。
@NotBlank://String 不能是 null 且去除两端空白字符后的长度（trimmed length）大于 0。

2.失效问题

（1）单个对象无效，必须在controller中加上@Valid 或者@Validated。@Validated要和@NotEmpty组合使用

import ;

public ResultModel test(@Validated @RequestBody TestParam testParam){
}

 （2）嵌套对象，对象的对象中失效解决办法，需要在外层对象的属性上加@Valid

import ;
import ;

@Data
public class TestParam {
   @NotBlank
   private String className;
 
   @Validated
   private List<UserDTO> users;
}
import ;

@Data
public class UserDTO {
    @NotBlank
    private String name;
 
}

isEmpty 和 isBlank 区别

. 类提供了 String 的常用操作,最为常用的判空有如下两种 isEmpty(String str) 和 isBlank(String str)。

分析

我们通过源码来分析区别：

/**
* <p>Checks if a CharSequence is empty ("") or null.</p>
*
* <pre>
* (null)      = true
* ("")        = true
* (" ")       = false
* ("bob")     = false
* ("  bob  ") = false
* </pre>
*/
public static boolean isEmpty(final CharSequence cs) {
    return cs == null || () == 0;
}
/**
* <p>Checks if a CharSequence is not empty ("") and not null.</p>
*
* <pre>
* (null)      = false
* ("")        = false
* (" ")       = true
* ("bob")     = true
* ("  bob  ") = true
* </pre>
*/
public static boolean isNotEmpty(final CharSequence cs) {
    return !isEmpty(cs);
}
/**
 * <p>Checks if a CharSequence is empty (""), null or whitespace only.</p>
 *
 * <p>Whitespace is defined by {@link Character#isWhitespace(char)}.</p>
 *
 * <pre>
 * (null)      = true
 * ("")        = true
 * (" ")       = true
 * ("bob")     = false
 * ("  bob  ") = false
 * </pre>
 *
*/
public static boolean isBlank(final CharSequence cs) {
    final int strLen = length(cs);
    if (strLen == 0) {
        return true;
    }
    for (int i = 0; i < strLen; i++) {
        if (!((i))) {
            return false;
        }
    }
    return true;
}
/**
 * <p>Checks if a CharSequence is not empty (""), not null and not whitespace only.</p>
 *
 * <p>Whitespace is defined by {@link Character#isWhitespace(char)}.</p>
 *
 * <pre>
 * (null)      = false
 * ("")        = false
 * (" ")       = false
 * ("bob")     = true
 * ("  bob  ") = true
 * </pre>
 *
*/
public static boolean isNotBlank(final CharSequence cs) {
    return !isBlank(cs);
}

可以看到：

  1. (final CharSequence cs) 判断某字符串是否为空，为空的标准是 cs == null 或者() == 0
  2. (final CharSequence cs) 判断某字符串是否为空或长度为 0 或由空白符 (whitespace) 构成
  3. (final CharSequence cs) 等价于 !isEmpty(final CharSequence cs)
  4. (final CharSequence cs) 等价于 !isBlank(final CharSequence cs)， 我自己更喜欢使用(final CharSequence cs)来执行判空操作，因为判断的条件更多更具体，特别是进行参数校验时，推荐使用。

相关文章