番石榴的意思是什么checkNotNull


问题内容

我是番石榴的新手(老实说,我不是“新手”,我是这个主题的新手),所以我决定阅读一些文档,并在阅读本文时感到非常惊讶:

com.google.common.base.Preconditions.checkNotNull(...)

我不明白这种方法的意义。这意味着不要这样做:

myObject.getAnything();

NullPointerException如果myObject为null ,则可能会导致)

我应该用

checkNotNull(myObject).getAnything();

抛出NullPointerException如果myObject是空和返回myObject,如果它不为空。

我很困惑,这可能是有史以来最愚蠢的问题,但是…

这有什么意义呢?在我能想到的任何情况下,这两行所做的事情与结果完全一样。

我什至不认为后者更具可读性。

所以我一定想念一些东西。它是什么?


问题答案:

这个想法是要快速失败。例如,考虑这个愚蠢的类:

public class Foo {
    private final String s;

    public Foo(String s) {
        this.s = s;
    }

    public int getStringLength() {
        return s.length();
    }
}

假设您不想允许使用null值s。(否则getStringLength将抛出NPE)。照原样讲课,到您发现null它的时候,已经太晚了-
很难找到谁把它放在那里。罪魁祸首很可能是完全不同的一类,而这种Foo情况本来可以在很久以前就建成。现在,您必须对代码库进行梳理,以找出谁可能在其中输入了null值。

相反,想象一下这个构造函数:

public Foo(String s) {
    this.s = checkNotNull(s);
}

现在,如果有人把一个null在那里,你会发现 马上 -你就会有堆栈跟踪指向正是你走错了电话。


另一个有用的时间是,如果要在执行可以修改状态的操作之前检查参数。例如,考虑此类计算其获得的所有字符串长度的平均值的类:

public class StringLengthAverager {
    private int stringsSeen;
    private int totalLengthSeen;

    public void accept(String s) {
        stringsSeen++;
        totalLengthSeen += s.length();
    }

    public double getAverageLength() {
        return ((double)totalLengthSeen) / stringsSeen;
    }
}

调用accept(null)将引发NPE抛出-
但在stringsSeen增加之前不会发生。这可能不是您想要的;作为类的用户,我可能希望,如果它不接受null,那么如果您传递null,则其状态应该保持不变(换句话说:调用应该失败,但不应使对象无效)。显然,在此示例中,您还可以通过s.length()在递增之前获取来解决此问题stringsSeen,但是您可以看到对于更长且涉及更多的方法,首先检查所有参数是否有效,然后再修改状态可能是有用的:

    public void accept(String s) {
        checkNotNull(s); // that is, s != null is a precondition of the method

        stringsSeen++;
        totalLengthSeen += s.length();
    }