【@NotBlank】@NotBlank与@NotEmpty与@NotNull区别

这里写目录标题

  • [🎯 核心定义](#🎯 核心定义)
  • [📊 与其他注解的区别](#📊 与其他注解的区别)
  • [💻 代码示例](#💻 代码示例)
  • [🛠️ 如何使用](#🛠️ 如何使用)
  • [💡 适用场景建议](#💡 适用场景建议)

@NotBlank 是 Java Bean Validation(数据校验)中一个非常常用的注解,主要用于严格校验字符串。

🎯 核心定义

@NotBlank 专门用于String(字符串)类型的字段或参数。

它的校验逻辑非常严格,要求被注解的字符串必须同时满足以下三个条件:

不能为 null。

不能是空字符串 ""。

不能是纯空白字符(例如:" "、"\t"、"\n" 等,即去除首尾空格后长度必须大于 0)。

📊 与其他注解的区别

为了方便你记忆,我整理了一个对比表格。这是 @NotBlank 最容易混淆的三个注解:

注解 适用类型 校验严格度 能否通过纯空格 " "
@NotNull 所有对象 最宽松 能 (只检查 null)
@NotEmpty 字符串、集合、数组 中等 能 (只检查长度/大小)
@NotBlank 仅字符串 最严格 不能 (会 trim() 后检查)

一句话总结区别:

@NotNull 只管"有没有"(不为 null)。

@NotEmpty 管"是不是空的"(长度/大小 > 0)。

@NotBlank 管"是不是真的有内容"(必须有非空格字符)。

💻 代码示例

假设我们有一个用户注册的场景:

java 复制代码
public class User {
    // 只要不为 null 就行,可以是 "" 或 "   "
    @NotNull 
    private String field1;

    // 不能为 null,且长度必须 > 0,所以 "   " 是允许的
    @NotEmpty 
    private String field2;

    // 不能为 null,不能是 "",且不能是 "   " (纯空格会被视为无效)
    @NotBlank 
    private String username; 

    // getter and setter...
}

测试数据验证结果:

输入值 @NotNull @NotEmpty @NotBlank
null ❌ 失败 ❌ 失败 ❌ 失败
"" (空字符串) ✅ 通过 ❌ 失败 ❌ 失败
" " (纯空格) ✅ 通过 ✅ 通过 ❌ 失败
"abc" (正常内容) ✅ 通过 ✅ 通过 ✅ 通过

🛠️ 如何使用

在 Spring Boot 项目中,通常配合 @Valid 或 @Validated 使用。

引入依赖(通常 Spring Boot Starter 已包含):

xml 复制代码
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

在实体类或 Controller 参数上使用:

java 复制代码
@RestController
@Validated
public class UserController {
    
    @PostMapping("/register")
    public String register(@RequestBody @Valid User user) {
        // 业务逻辑
        return "success";
    }
}

如果前端传入的 username 是 null、"" 或 " ",框架会自动拦截并抛出异常,不会进入业务逻辑。

💡 适用场景建议

使用 @NotBlank:用于业务必填且必须有意义的文本字段,如:用户名、密码、真实姓名、地址、备注等。防止用户"偷懒"只输入空格。

使用 @NotEmpty:用于集合(List/Set)判空,或者字符串只要求长度大于 0(允许空格)的特殊场景。

使用 @NotNull:用于 Long、Integer 等包装类,或者日期类型,或者你只关心对象是否存在而不关心内容的场景。

相关推荐
布莱克6052 小时前
Swift 方法详解:实例方法、类型方法与 mutating 机制
服务器·开发语言·ios·ssh·swift·方法
Risehuxyc4 小时前
PHP能不能在参数里放匿名函数
开发语言·php
码云社区4 小时前
Java家政服务系统源码:人员技能、服务范围与多商家业务落地
java·开发语言·家政服务·家政小程序·家政系统
FRing035 小时前
vue3干货总结3(defineOptions(Vue3.3)、defineModel(Vue3.4)、Pinia)
开发语言·前端·vue.js·vue3
摇滚侠5 小时前
《On Java 中文版 基础卷》阅读笔记 接口 18
java·笔记·python
CoderYanger5 小时前
Java EE 进阶:9.MyBatis 操作数据库(进阶)(第八弹):MyBatis Generator
java·数据库·spring boot·spring·java-ee·tomcat·mybatis
whitelbwwww6 小时前
CUDA C++实战--中级
开发语言·前端·c++
FungLeo7 小时前
FengCMS · PHP+MySQL 升级实录 · 内容写入一致性:锁等待超时与跨模型子树删除竞态
开发语言·mysql·php·工程实践·fengcms
jaysee-sjc8 小时前
【黑马点评】Day02:优惠券秒杀与分布式锁
java·分布式·nginx·spring·node.js·tomcat·maven
谙弆悕博士8 小时前
多智能体架构详解:市场拍卖式架构(Market-based / 竞价协商)
开发语言·架构·去中心化·多智能体·智能体·拍卖架构