javax.annotation：@Nullable 与 @CheckForNull

Question

两者有什么区别？两者似乎都意味着该值可能为空，应进行相应处理，即检查是否为空。

更新： 上面的两个注释是 JSR-305/FindBugs 的一部分： http://findbugs.sourceforge.net/manual/annotations.html

Answer 1

@Nonnull 和 @Nullable 由 IntelliJ IDEA 正确处理。 FindBugs 发现了@Nonnull 的问题，但错过了@Nullable 和@CheckForNUll 的问题。 IDEA 和 FindBugs 检测到的问题用 cmets 标记。

package com.db.icestation;

import javax.annotation.CheckForNull;
import javax.annotation.Nonnull;
import javax.annotation.Nullable;

public class test {

    @Nullable public String nullable() {
        return "";
    }

    @Nonnull public String nonnull() {
        return null; // IDEA, findbugs
    }

    @CheckForNull public String checkForNull() {
        return null;
    }

    public static void main(String[] args) {
        System.out.println(new test().nullable().length()); // IDEA
        System.out.println(new test().nonnull().length());
        System.out.println(new test().checkForNull().length());
    }
}

Answer 2

在 IntelliJ Idea 中，默认支持 @javax.annotation.Nullable，任何取消引用 @Nullable 参数或返回值的尝试都将导致警告。

@alexander-pavlov，您可以在“恒定条件和异常”检查的配置中添加@javax.annotation.CheckForNull。转到文件->设置->检查->可能的错误->恒定条件和异常->配置注释。

我更喜欢这样做，因为@CheckForNull 比@lbalazscs 在上面的回答中提到的@Nullable 具有更明确的含义。

Answer 3

我认为您添加的链接很清楚：如果您使用 @CheckForNull 并且使用该值的代码不检查 null，FindBugs 会将其显示为错误。

FindBugs 将忽略 @Nullable。

在实践中，此注解仅用于覆盖总体NonNull 注解。

在必须始终检查值的情况下使用@CheckForNull。使用@Nullable，null 可能没问题。

编辑：@CheckForNull 目前似乎没有得到很好的支持，所以我建议避免使用它并使用@NonNull（另见Which @NotNull Java annotation should I use?）。 另一个想法是直接与 FindBugs 开发人员联系，并询问他们对文档中的不一致之处的意见。