在 Java 中,@NotNull 注解用于指示某个字段、方法参数或返回值不应为 null。这个注解通常与静态代码分析工具(如 FindBugs、PMD、IntelliJ IDEA 等)一起使用,以帮助开发者在编译时捕获潜在的 NullPointerException。
要在 Java 中使用 @NotNull 注解,你需要遵循以下步骤:
javax.validation:validation-api 依赖添加到项目中。如果你使用的是 Maven,可以在 pom.xml 文件中添加以下依赖:<dependency> <groupId>javax.validation</groupId> <artifactId>validation-api</artifactId> <version>2.0.1.Final</version> </dependency> 对于 Gradle 项目,在 build.gradle 文件中添加以下依赖:
implementation 'javax.validation:validation-api:2.0.1.Final' javax.validation.constraints.NotNull 类:import javax.validation.constraints.NotNull; @NotNull 注解:public class User { @NotNull(message = "Name cannot be null") private String name; public User(@NotNull(message = "Name cannot be null") String name) { this.name = name; } @NotNull(message = "Email cannot be null") private String email; public String getEmail() { return email; } public void setEmail(@NotNull(message = "Email cannot be null") String email) { this.email = email; } } 在上面的示例中,我们为 User 类的 name 和 email 字段添加了 @NotNull 注解,以确保它们在创建对象或设置属性时不能为 null。如果这些字段为 null,静态代码分析工具将发出警告。
注意:@NotNull 注解本身不会导致编译时错误,但它可以与 Java 验证框架(如 Hibernate Validator)一起使用,以便在运行时进行非空检查。要使用运行时验证,你需要在应用程序中配置验证器,并在适当的时候触发验证。