Spring中@NotNull、@NotEmpty、@NotBlank和@PositiveOrZero等注解的使用

最新推荐文章于 2025-09-02 10:08:26 发布
原创 最新推荐文章于 2025-09-02 10:08:26 发布 · 1.2w 阅读 · 9 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

本文介绍了在Web项目中常用的前端参数校验注解，包括@NotNull、@NotEmpty、@NotBlank和@PositiveOrZero，详细解释了它们的功能及适用场景，帮助开发者确保参数的有效性和安全性。

我们在做web项目的时候经常会遇到前端传参的情况，这会需要对参数做校验，比如参数不能为空，集合不能为空等校验，javax.validation.constraints为我们提供了很多注解来帮忙我们做参数校验。

1、 @NotNull

The annotated element must not be {@code null}.

校验参数一定不能为null，但是可以为" "。

2、 @NotEmpty

The annotated element must not be {@code null} nor empty. Supported types are:
1、{@code CharSequence} (length of character sequence is evaluated);
2、{@code Collection} (collection size is evaluated);
3、{@code Map} (map size is evaluated);
4、Array (array length is evaluated);

校验集合类参数（如String类、Collection、Map、数据Array）不能为null或empty。其中String的length、Collection和Map的size不能为0。

3、@NotBlank

The annotated element must not be {@code null} and must contain at least one non-whitespace character. Accepts {@code CharSequence}.

校验String字符串不能为null，且不能是空字符串（" "）,即调用trim()之后字符串的长度不能为0。

4、@PositiveOrZero

The annotated element must be a positive number or 0.

校验参数必须是正整数或0。

更多链接

Spring Boot进阶(101)：@NotNull 注解也能搞错？同事这波操作让我直接裂开！
**My Coding Family**
01-09 2257
哈喽，家人们，有没有被“空指针异常”搞得怀疑人生的经历？今天我就亲身体验了一把，这波真的是直接裂开！事情是这样的：有位用户在使用 ERP 系统时，为了偷懒不填必填字段（后来排查才知道，真是服了），直接敲了一堆空格绕过校验，成功提交了数据。结果，这问题可就来了——领导点开详情页面，发现页面一片空白。于是，领导火速在 DD 群里艾特我，要求赶紧处理。说实话，看到那一刻我确实有点紧张：页面空白？不对劲啊，这种低级问题怎么可能出现在我负责的系统里？
28个验证注解，通过业务案例让你精通Java数据校验(收藏篇)
肖哥弹架构博客
08-04 896
Hibernate Validator 验证注解应用案例，通过业务讲解28个验证注解，通过业务案例让你精通Java数据校验(收藏篇)
Spring中@NotNull、@NotEmpty、@NotBlank和@PositiveOrZero注解的使用
贝la的博客
03-28 981
校验集合类参数（如String类、Collection、Map、数据Array）不能为null或empty。其中String的length、Collection和Map的size不能为0。校验String字符串不能为null，且不能是空字符串（” "）,即调用trim()之后字符串的长度不能为0。校验参数一定不能为null，但是可以为" “。校验参数必须是正整数或0。
Java字段校验注解解析
最新发布
shuaizai
09-02 819
你是否厌倦了用冗长的if-else语句进行字段校验？代码中充斥着重复的条件判断，每次新增校验规则都要复制粘贴，维护起来如同在迷宫中摸索？这里有一个更好的解决方案：让你的代码更加简洁，维护起来轻松自如。Java 中常用的字段校验注解主要来自 JSR 380（Bean Validation 2.0）规范，这些注解通常作为正则表达式（如@Pattern）的有效补充。
Spring 各种注解（@）的含义与认识
09-04 4191
依赖注入，从字面上理解，即是：以注入的方式实现依赖； Spring 容器负责创建应用程序中的 bean，并通过 DI（依赖注入）来协调这些对象之间的关系。当描述 bean 如何进行装配（autowired）时，Spring 具有强大的灵活性，提供了以下三种主要的装配机制： 在 XML 中显式配置； 在 Java 中进行显式配置； XXConfig（JavaConfig） 隐式的 bean 发现机制
【深度思考】如何优雅的校验参数？
申城异乡人
12-22 5073
Hibernate Validator使用指南。
Spring Boot参数校验：入门指南与最佳实践
2401_83147072的博客
04-15 1279
工作中我们经常会遇到验证字段是否必填，或者字段的值是否在给定范围之内等等类似的问题，如果说是一两个字段的验证还好，验证的字段很多的话，代码就会被大量的if语句包围。通常来说，这些关于字段的判断应该和业务逻辑分开来，可能我们想到的第一个解决方案就是通过AOP，这也能解决我们的问题的。但实际上大可不必，作为一个成熟的语言，Java已经给我们提供解决方案了，那就是。
SpringBoot如何优雅的实现参数验证
admin_2022的博客
05-24 874
SpringBoot如何优雅的实现参数验证
spring 注解验证@NotNull等使用方法
08-19
Spring 注解验证@NotNull 等使用方法 Spring 框架提供了一种基于注解的验证机制，通过使用注解可以对 JavaBean 的属性进行验证。这种机制可以在 Controller 层、Service 层、DAO 层等任何需要验证数据的地方使用。...
@NotNull、@NotBlank 和 @NotEmpty 注解的区别
千层冷面的博客
01-16 852
NotNull: 确保对象不是null，但不检查空字符串或集合的空性。@NotBlank: 确保字符串不是null，并且去除前后的空白字符后至少包含一个字符。@NotEmpty: 确保集合不是null，并且至少包含一个元素。
spring boot参数验证注解@NotNull、@NotBlank和@NotEmpty区别
liqinglonguo的博客
05-10 1508
使用spring boot参数验证是常常会使用@NotNull、@NotBlank和@NotEmpty三个判断是否不为空的注解，中文都有不能为空的意思，大部分使用者都傻傻分清它们之间到底有什么区别。今天就让咱们来一起探索它们之间的不同吧。
深入解析常见数据校验注解：@NotNull、@NotEmpty、@NotBlank、@Valid 使用示例
沉梦听雨的博客
12-29 1530
通过深入了解这些常见的数据校验注解，我们能够更好地保障程序接收到的数据的合法性。这些注解的使用不仅简单而且强大，为我们构建稳健的应用提供了有力的支持。在实际应用中，根据具体场景和需求选择合适的注解，结合异常处理，能够有效地提高程序的健壮性和安全性。
java参数校验（@Validated、@Valid）使用详解
热门推荐
墨鸦的博客
04-27 4万+
java参数校验（@Validated、@Valid）使用详解
Java Springboot 参数校验
kuroshiro的博客
06-26 1695
Java Springboot 参数校验
validate 注解解释
千山
12-11 2508
常用验证注解 常用的注解主要有以下几个，作用及内容如下所示 @Null，标注的属性值必须为空 @NotNull，标注的属性值不能为空 @AssertTrue，标注的属性值必须为true @AssertFalse，标注的属性值必须为false @Min，标注的属性值不能小于min中指定的值 @Max，标注的属性值不能大于max中指定的值 @DecimalMin，小数值，同上 @DecimalMa...
记@Validated注解
weixin_45530527的博客
06-07 6424
记@Validated注解
validator 自动化校验
逸飞兮
09-23 2230
温馨提示 请收藏再看。此文篇幅太长，你短时间看不完；此文干货太多，错过太可惜。 示例代码可以关注逸飞兮（公众号）回复jy获取。 收获 讲解详细：能让你掌握使用 hibernate-validator 及类似校验工具的各种使用姿势 内容全面：可以当做知识字典来查询 what 注意：hibernate-validator 与 持久层框架 hibernate 没有什么关系，hibernate...
深入了解数据校验：Java Bean Validation 2.0（JSR380）
07-24 601
我们知道通常情况下程序肯定是分层的，不同的层一般由不同的人来开发。若你是一个有经验的程序员， 我相信你肯定见过在不同的层了都出现了相同的校验代码，这就是某种意义上的垃圾代码。 为了解决这个问题，Bean Validation为JavaBean验证定义了相应的元数据模型和 API...
Spring -- 02 -- Validation校验注解解析
Gene Xu
07-06 2487
在日常与页面的联调中，我们会发现，尽管前端已经对请求参数做了校验，但有时候后端程序还是会报错，因此我们可以在后端再做一次校验，以确保数据的正确性，此时校验注解就派上了用场 一、注解 @Null 字段必须为 null @NotNull 字段不能为 null @NotBlank 字段不能为 null，且去掉首尾空格后长度不能为 0 只能作用于字符串 @NotE...
Spring中@NotEmpty，@NotBlank，@NotNull，@Valid，@Validated注解分组
07-26
### @NotEmpty、@NotBlank、@NotNull、@Valid 与 @Validated 的区别和使用场景 #### **@NotNull** - 用于验证对象是否为 null。 - 适用于任何类型（包括字符串、数字、集合等）。 - 不会检查空字符串或空集合，仅验证是否为 null。 - 示例： ```java @NotNull(message = "Name cannot be null") private String name; ``` [^1] #### **@NotEmpty** - 用于验证字符串、集合、数组等是否为空。 - 对字符串而言，验证长度是否大于0。 - 对集合或数组而言，验证元素数量是否大于0。 - 不允许 null 值（null 会被认为是无效）。 - 示例： ```java @NotEmpty(message = "List cannot be empty") private List<String> items; ``` [^1] #### **@NotBlank** - 专门用于验证字符串是否为空白。 - 检查字符串是否包含非空白字符（即去除前后空格后是否为空）。 - 只适用于字符串类型。 - 示例： ```java @NotBlank(message = "Username cannot be blank") private String username; ``` #### **@Valid** - 是 JSR-303 标准规范的一部分，由 `javax` 提供。 - 用于在方法参数上进行参数校验。 - 支持嵌套验证，但不支持分组验证。 - 示例： ```java @PostMapping("/users") public ResponseEntity<?> createUser(@Valid @RequestBody User user, BindingResult result) { if (result.hasErrors()) { // handle errors } // save user } ``` #### **@Validated** - 是 Spring 提供的验证注解，对 `@Valid` 进行了二次封装。 - 支持分组验证，适用于复杂的验证逻辑。 - 可以标注在类级别上，也可以用于方法级别。 - 示例： ```java @Validated @RestController public class UserController { @PutMapping("/student") public ApiResult updateStudent(@RequestBody @Validated({Student.Update.class}) Student student, BindingResult result) { if (result.hasErrors()) { for (ObjectError error : result.getAllErrors()) { // do stuff } return ApiResult.error(); } studentService.update(student); return ApiResult.success(); } } ``` [^4] #### **分组验证的使用场景** - 分组验证用于在不同业务场景下应用不同的验证规则。 - 使用 `@Validated` 注解并传入分组接口，可以实现对特定场景的验证逻辑。 - 示例： ```java public interface IGroupA {} public interface IGroupB {} @PutMapping("/student") public ApiResult updateStudent(@RequestBody @Validated({IGroupA.class}) Student student, BindingResult result) { // 验证逻辑 } ``` [^5] #### **总结** - `@NotNull`、`@NotEmpty` 和 `@NotBlank` 用于基本的字段非空验证，分别适用于不同的数据类型和场景。 - `@Valid` 是标准的 JSR-303 验证注解，适用于简单的参数验证，不支持分组。 - `@Validated` 是 Spring 提供的增强版验证注解，支持分组验证和类级别的验证。 - 在需要分组验证或复杂的业务场景时，推荐使用 `@Validated`。 ---
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值