Java 中怎么使用 @NotEmpty 注解校验集合或字符串不为空-java教程-PHP中文网

@notempty是hibernate validator注解，要求对象非null且内容非空（字符串长度>0、集合size>0等），比@notnull严格、比@notblank适用范围广；需手动引入spring-boot-starter-validation依赖，不自动trim空格，不适用于基本包装类。

java 中怎么使用 @notempty 注解校验集合或字符串不为空

在 Java 中，@NotEmpty 是 Hibernate Validator 提供的校验注解，用于确保字符串、集合、数组、Map 等对象**既不为 null，且内容不为空**（比如字符串长度 > 0，集合 size > 0）。它比 @NotNull 更严格，也比 @NotBlank（仅适用于 String，还要求去除首尾空格后非空）适用范围更广。

需要添加依赖

Spring Boot 2.3+ 默认移除了 spring-boot-starter-validation 的自动依赖，需手动引入：

Maven 依赖示例：

<dependency><groupid>org.springframework.boot</groupid><artifactid>spring-boot-starter-validation</artifactid></dependency>

非 Spring Boot 项目则需引入：hibernate-validator + jakarta.validation-api（注意 Jakarta EE 9+ 命名空间已从 javax.validation 升级为 jakarta.validation）。

Java Maven Code Review

审查Java Maven项目（ZIP压缩包或GitLab仓库URL），检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载

基本用法：作用于字段或参数

直接加在实体类字段或 Controller 方法参数上即可，配合 @Valid 或 @Validated 触发校验：

校验字符串：@NotEmpty 要求不为 null 且长度 > 0（等价于 str != null && !str.trim().isEmpty() 不成立——它不自动 trim，只判 length > 0）
校验集合（List/Set/Map）：@NotEmpty 要求不为 null 且 size() > 0
校验数组：@NotEmpty 要求不为 null 且 length > 0

示例：

public class UserRequest {
    @NotEmpty(message = "用户名不能为空")
    private String username;

    @NotEmpty(message = "角色列表不能为空")
    private List<string> roles;

    @NotEmpty(message = "标签映射不能为空")
    private Map<string string> tags;
}</string></string>

Controller 中启用校验：

@PostMapping("/user")
public ResponseEntity> createUser(@Valid @RequestBody UserRequest request) {
    return ResponseEntity.ok().build();
}

注意常见误区

@NotEmpty 对 String 不做 trim，" "（纯空格）会被认为“非空”而通过校验；如需忽略空格，应组合使用 @NotBlank
它不能校验嵌套对象内部字段，如需校验 List<address></address> 中每个 Address.city 非空，要在 Address 类中对 city 加 @NotEmpty，并在 List<address></address> 上加 @Valid
若字段类型是基本包装类（如 Integer）、布尔类型等，@NotEmpty 不适用——它们用 @NotNull 更合适
Spring MVC 默认只对 @RequestBody 和 @ModelAttribute 参数生效；对 @RequestParam 或 @PathVariable 需配合 @Validated 和分组，或改用 @NotBlank/@NotNull