在 java 中校验非空,核心做法是引入 jsr-380 (bean validation) 规范实现(如 hibernate validator),并在实体类字段上添加 @notnull 或 @notblank 注解。配合 spring boot 的 @validated 或 @valid 使用,框架会在请求进入控制器时自动触发校验,若字段为空则抛出 methodargumentnotvalidexception 并拦截后续逻辑。

@NotNull 与 @NotBlank 的区别是什么
@NotNull 仅检查对象引用是否为 null,允许字符串为空串 "";而 @NotBlank 专门针对 String 类型,要求值不为 null 且去除首尾空格后长度大于 0。对于集合类型,通常需结合 @NotEmpty 使用以确保列表不为空且包含元素。

import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;
public class UserDTO {
@NotNull(message = "用户ID不能为空")
private Long id;
@NotBlank(message = "用户名不能为空")
private String username;
}
上述代码定义了 DTO 结构。当传入 JSON 数据时,若 id 缺失或为 null,校验失败;若 username 为 null、空串或纯空格,校验均失败。这是处理基本类型和字符串最标准的非空校验方式。
如何对嵌套对象进行非空校验
当 DTO 中包含另一个对象作为属性时,必须在该属性上添加 @Valid 注解,否则嵌套对象的校验规则不会生效。这确保了深层结构的非空约束能被递归执行,防止内部对象为空导致的数据不一致。

import jakarta.validation.Valid;
import jakarta.validation.constraints.NotNull;
public class OrderDTO {
@NotNull(message = "订单详情不能为空")
@Valid // 关键:启用级联校验
private OrderDetail detail;
}
public class OrderDetail {
@NotBlank(message = "商品名称不能为空")
private String productName;
}
在 OrderDTO 中,detail 字段被标记为 @NotNull 且带有 @Valid。如果请求体中 detail 为 null,直接报错;如果 detail 存在但内部的 productName 为空,同样会触发校验错误。这种组合保证了复杂对象链路的完整性。
自定义校验注解如何实现非空逻辑
若标准注解无法满足特定业务需求(例如校验 UUID 格式的非空性),可通过定义自定义注解并结合 ConstraintValidator 接口实现。这种方式将校验逻辑封装在独立的验证器类中,通过 isValid 方法返回布尔值来决定校验结果。
import jakarta.validation.Constraint;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import static java.lang.annotation.RetentionPolicy.RUNTIME;
@Constraint(validatedBy = CustomNullValidator.class)
@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RUNTIME)
public @interface CustomNonEmpty {
String message() default "自定义非空校验失败";
Class>[] groups() default {};
Class extends jakarta.validation.Payload>[] payload() default {};
}
import jakarta.validation.ConstraintValidator;
import jakarta.validation.ConstraintValidatorContext;
public class CustomNullValidator implements ConstraintValidator<customnonempty object> {
@Override
public boolean isValid(Object value, ConstraintValidatorContext context) {
if (value == null) return false;
if (value instanceof String s) return !s.isBlank();
return true; // 其他类型视为非空
}
}</customnonempty>
使用时只需在字段上标注 @CustomNonEmpty。该注解底层委托给 CustomNullValidator,其 isValid 方法首先判断 null,再针对 String 类型做空白字符过滤。这种模式适用于需要复用复杂非空逻辑的场景,且完全兼容现有的校验框架机制。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











