我希望使我的代码更具可读性，以及使用工具，如IDE代码检查和/或静态代码分析(FindBugs和Sonar)，以避免nullpointerexception。许多工具似乎与彼此的@NotNull/@NonNull/ @NonNull注释不兼容，在我的代码中列出所有这些工具会让人难以阅读。有没有什么建议，哪一个是“最好的”?下面是我找到的等价注释列表:
javax.validation.constraints.NotNull
Created for runtime validation, not static analysis.
documentation
edu.umd.cs.findbugs.annotations.NonNull
Used by FindBugs (dead project) and its successor SpotBugs static analysis and therefore Sonar (now Sonarqube)
FindBugs documentation, SpotBugs documentation
javax.annotation.Nonnull
This might work with FindBugs too, but JSR-305 is inactive. (See also: What is the status of JSR 305?)
source
org.jetbrains.annotations.NotNull
Used by IntelliJ IDEA IDE for static analysis.
documentation
lombok.NonNull
Used to control code generation in Project Lombok.
Placeholder annotation since there is no standard.
source,
documentation
androidx.annotation.NonNull
Marker annotation available in Android, provided by annotation package
documentation
org.eclipse.jdt.annotation.NonNull
Used by Eclipse for static code analysis
documentation
如果你正在使用Spring框架构建应用程序，我建议使用来自bean Validation的javax.validation.constraints.NotNull，它被打包在以下依赖项中:
<dependency>
<groupId>javax.validation</groupId>
<artifactId>validation-api</artifactId>
<version>1.1.0.Final</version>
</dependency>
这种注释的主要优点是Spring同时支持用javax.validation.constraints.NotNull注释的方法参数和类字段。要启用支持，您需要做的是:
supply the api jar for beans validation and jar with implementation of validator of jsr-303/jsr-349 annotations (which comes with Hibernate Validator 5.x dependency):
<dependency>
<groupId>javax.validation</groupId>
<artifactId>validation-api</artifactId>
<version>1.1.0.Final</version>
</dependency>
<dependency>
<groupId>org.hibernate</groupId>
<artifactId>hibernate-validator</artifactId>
<version>5.4.1.Final</version>
</dependency>
provide MethodValidationPostProcessor to spring's context
@Configuration
@ValidationConfig
public class ValidationConfig implements MyService {
@Bean
public MethodValidationPostProcessor providePostProcessor() {
return new MethodValidationPostProcessor()
}
}
finally you annotate your classes with Spring's org.springframework.validation.annotation.Validated and validation will be automatically handled by Spring.
例子:
@Service
@Validated
public class MyServiceImpl implements MyService {
@Override
public Something doSomething(@NotNull String myParameter) {
// No need to do something like assert myParameter != null
}
}
当您尝试调用方法doSomething并传递null作为参数值时，spring(通过HibernateValidator)将抛出ConstraintViolationException。这里不需要手工工作。
您还可以验证返回值。
javax.validation.constraints.NotNull对Beans验证框架的另一个重要好处是，目前它仍在开发中，新特性计划在新版本2.0中实现。
@Nullable呢?在Beans Validation 1.1中没有类似的东西。好吧，我可以争辩说，如果你决定使用@ nonull，而不是任何没有用@NonNull注释的东西都是有效的“nullable”，所以@Nullable注释是无用的。
根据Java 7的特性列表，JSR-308类型注释被推迟到Java 8。甚至没有提到JSR-305注释。
在最新的JSR-308草案的附录中有一些关于JSR-305状态的信息。这包括观察到JSR-305注释似乎被抛弃了。JSR-305页面还将其显示为“inactive”。
同时，实用的答案是使用最广泛使用的工具所支持的注释类型……如果情况发生变化，也要做好改变的准备。
事实上，JSR-308没有定义任何注释类型/类，而且看起来他们认为这超出了范围。(考虑到JSR-305的存在，他们是正确的)。
然而，如果JSR-308真的想要加入Java 8，那么如果人们对JSR-305重新产生兴趣，我也不会感到惊讶。AFAIK, JSR-305团队还没有正式放弃他们的工作。他们已经沉默了2年多了。
有趣的是，Bill Pugh (JSR-305的技术主管)是FindBugs背后的人之一。
如果你正在为android开发，那么你在某种程度上与Eclipse(编辑:在撰写本文时，不再)有一定的联系，它有自己的注释。它包含在Eclipse 3.8+ (Juno)中，但默认禁用。
您可以在首选项> Java >编译器>错误/警告>空分析(底部可折叠部分)中启用它。
勾选“启用基于注释的空分析”
http://wiki.eclipse.org/JDT_Core/Null_Analysis#Usage有关于设置的建议。然而，如果你的工作空间中有外部项目(如facebook SDK)，它们可能不满足这些建议，你可能不想在每次SDK更新时修复它们;-)
我使用:
空指针访问:错误
违反空规范:错误(链接到第1点)
潜在的空指针访问:警告(否则facebook SDK将有警告)
空注释和空推断之间的冲突:警告(链接到第3点)
如果你正在使用Spring框架构建应用程序，我建议使用来自bean Validation的javax.validation.constraints.NotNull，它被打包在以下依赖项中:
<dependency>
<groupId>javax.validation</groupId>
<artifactId>validation-api</artifactId>
<version>1.1.0.Final</version>
</dependency>
这种注释的主要优点是Spring同时支持用javax.validation.constraints.NotNull注释的方法参数和类字段。要启用支持，您需要做的是:
supply the api jar for beans validation and jar with implementation of validator of jsr-303/jsr-349 annotations (which comes with Hibernate Validator 5.x dependency):
<dependency>
<groupId>javax.validation</groupId>
<artifactId>validation-api</artifactId>
<version>1.1.0.Final</version>
</dependency>
<dependency>
<groupId>org.hibernate</groupId>
<artifactId>hibernate-validator</artifactId>
<version>5.4.1.Final</version>
</dependency>
provide MethodValidationPostProcessor to spring's context
@Configuration
@ValidationConfig
public class ValidationConfig implements MyService {
@Bean
public MethodValidationPostProcessor providePostProcessor() {
return new MethodValidationPostProcessor()
}
}
finally you annotate your classes with Spring's org.springframework.validation.annotation.Validated and validation will be automatically handled by Spring.
例子:
@Service
@Validated
public class MyServiceImpl implements MyService {
@Override
public Something doSomething(@NotNull String myParameter) {
// No need to do something like assert myParameter != null
}
}
当您尝试调用方法doSomething并传递null作为参数值时，spring(通过HibernateValidator)将抛出ConstraintViolationException。这里不需要手工工作。
您还可以验证返回值。
javax.validation.constraints.NotNull对Beans验证框架的另一个重要好处是，目前它仍在开发中，新特性计划在新版本2.0中实现。
@Nullable呢?在Beans Validation 1.1中没有类似的东西。好吧，我可以争辩说，如果你决定使用@ nonull，而不是任何没有用@NonNull注释的东西都是有效的“nullable”，所以@Nullable注释是无用的。
这里已经有太多答案了，但是(a)现在是2019年，仍然没有“标准”Nullable， (b)没有其他答案引用Kotlin。
引用Kotlin是很重要的，因为Kotlin与Java是100%可互操作的，并且它有一个核心的Null安全特性。在调用Java库时，它可以利用这些注释让Kotlin工具知道Java API是否可以接受或返回null。
据我所知，唯一与Kotlin兼容的Nullable包是org.jetbrains.annotations和android.support.annotation(现在是androidx.annotation)。后者只与Android兼容，所以不能在非Android的JVM/Java/Kotlin项目中使用。然而，JetBrains包在任何地方都可以工作。
因此，如果您开发的Java包也应该在Android和Kotlin上工作(并且得到Android Studio和IntelliJ的支持)，那么最好的选择可能是JetBrains包。
Maven:
<dependency>
<groupId>org.jetbrains</groupId>
<artifactId>annotations-java5</artifactId>
<version>15.0</version>
</dependency>
Gradle:
implementation 'org.jetbrains:annotations-java5:15.0'
