@NotNull
和 @NotEmpty
是用于验证输入数据的注解,它们有不同的作用和适用场景:
-
@NotNull
注解:- 作用:确保字段的值不是
null
。 - 适用类型:任何对象类型(例如
String
、Collection
、Map
、Array
等)。 - 示例:如果字段的值是
null
,验证将失败;但如果字段的值是空字符串、空集合等,则验证通过。
java">public class UserDTO { @NotNull(message = "Username cannot be null") private String username; // getters and setters }
- 作用:确保字段的值不是
-
@NotEmpty
注解:- 作用:确保字段的值不是
null
,而且不能为空(对于字符串,不能为空字符串;对于集合,不能为空集合)。 - 适用类型:字符串、集合、地图等(适用于
CharSequence
、Collection
、Map
和数组)。 - 示例:如果字段的值是
null
或空字符串、空集合等,验证将失败。
java">public class UserDTO { @NotEmpty(message = "Username cannot be empty") private String username; // getters and setters }
- 作用:确保字段的值不是
示例代码
假设有一个用户注册的 DTO 类,我们希望确保用户名不能为空,密码不能为空且长度至少为 8:
java">import javax.validation.constraints.NotNull;
import javax.validation.constraints.NotEmpty;
import javax.validation.constraints.Size;
public class UserDTO {
@NotEmpty(message = "Username cannot be empty")
private String username;
@NotNull(message = "Password cannot be null")
@Size(min = 8, message = "Password must be at least 8 characters long")
private String password;
// getters and setters
}
在 controller
中:
java">import org.springframework.web.bind.annotation.*;
import javax.validation.Valid;
@RestController
@RequestMapping("/users")
public class UserController {
@PostMapping("/register")
public ResponseEntity<String> registerUser(@Valid @RequestBody UserDTO userDTO) {
// 处理注册逻辑
return ResponseEntity.ok("User registered successfully");
}
}
总结
- 使用
@NotNull
确保字段不为null
。 - 使用
@NotEmpty
确保字段不为null
且不为空。 - 具体使用哪个注解取决于你的业务需求,例如:对于用户名,通常希望它既不为
null
也不为空,因此使用@NotEmpty
更合适;而对于密码,我们不仅希望它不为null
,还希望它符合一定的长度,因此可以组合使用@NotNull
和@Size
。