我希望使我的代码更具可读性,并使用IDE代码检查和/或静态代码分析(FindBugs和Sonar)等工具来避免NullPointerExceptions.许多工具似乎与彼此的@NotNull/ @NonNull/ @Nonnull注释不兼容,并列出我的代码中的所有这些工具都很难阅读.有什么建议是"最好的"吗?这是我发现的等效注释列表:
javax.validation.constraints.NotNull
创建用于运行时验证,而不是静态分析.
文件
edu.umd.cs.findbugs.annotations.NonNull
由Findbugs静态分析使用,因此Sonar(现为Sonarqube)
文档
javax.annotation.Nonnull
这可能也适用于Findbugs,但JSR-305处于非活动状态.(另请参阅:JSR 305的状态是什么?)
来源
org.jetbrains.annotations.NotNull
由IntelliJ IDEA IDE用于静态分析.
文件
lombok.NonNull
用于控制Project Lombok中的代码生成.
占位符注释,因为没有标准.
来源,
文档
android.support.annotation.NonNull
Android中提供的标记注释,由support-annotations包
文档提供
org.eclipse.jdt.annotation.NonNull
Eclipse用于静态代码分析
文档
我已经看到了JSR305与JSR308(Java Type Anotations)的问题 - 这将成为标准吗?我理解JSR 308和JSR 305之间的区别.
我也明白,在这个时候,308是针对Java 7,305不是,我很好奇305的整体状态.
具体来说,我在我的一些项目中使用Google Collections和JSR-305(与Guice最佳实践倡导者的方式类似)并且想知道是否有更多"未来方向" - 我应该使用的友好方法代替.我打算在JSR-305小组上询问这个问题,但该小组没有太多活动,我只是想知道这里是否有人有更多信息.
什么是最好的 'NonNull'注释?
意义上的"最佳"
以下是世界目前的样子 - 任何进一步的见解都值得赞赏:
javax.validation.constraints.NotNull(Docs)
+ javax包因此看起来是未来的
- JEE的一部分不是 JSE.在JSE中需要导入额外的库.
- 静态分析工具不支持(仅限运行时验证)
(docs)edu.umd.cs.findbugs.annotations.NonNull
- 外部库而不是javax包
- 不推荐使用,因为findbugs版本3.X
+用于静态分析(由findbugs和Sonar提供)
(docs)javax.annotation.Nonnull
+用于静态分析(在findbugs中)
- JSR-305处于休眠/死亡/未知状态,如fb邮件列表所示.提交人Bill Pugh,即使直接被问到,多年来也没有对该州进行评论......
(文档,有趣的演示文稿)org.eclipse.jdt.annotation_2.0.0
+用于静态分析(虽然在eclipse中不在findbugs中)
- eclipse专有(没有尝试独立使用它们)
(docs)org.jetbrains.annotations.NotNull
+用于静态分析(虽然不是在findbugs
中的IntelliJ )- IntelliJ专有(但也可以公开作为jar)
lombok.NonNull(docs)
+用于控制代码生成
- 专有注释
android.support.annotation.NonNull(docs)
+ android …