理解非空和可空性注释

Question

我不清楚我们如何正确使用有关可为空的注释，即 NonNull 和 Nullable。
我对以下内容不太满意：

public void foo(@NonNull ArrayList<CustomObject> list) {  
   CustomObject o = list.get(0);  //etc
}  

1) 防御性地声明非空和代码是没有意义的吗？
2）使用此类注释的最有效方法是什么？例如。举个例子
- 使用构建器模式时应该如何使用它们或
- 定义具体类的接口来实现时？实现类的方法应该也包含注解还是假定它？
3）在上面的sn-p中有没有办法定义非空和非空？

Answer 1

现在我有适当的时间进行调查，这就是我发现的。

1)

在使用 @NonNull 注释时仍然进行防御性编码是非常有意义的。仅仅因为参数有@NonNull 注解，null 仍然可以在运行时传递。例如，使用如下数据类：

class DataClass {
    @NonNull private String notNullString;

    public DataClass() { notNullString = null; }

    public String toString() { return notNullString; }
}

您将null 分配给@NonNull 变量的IDE will warn，但调用toString() 将返回null。为了解决这个问题，以及询问why you're null-checking a @NonNull variable 的IDE 警告，Google 倾向于使用PreConditions.checkNotNull(T) - 请参阅example code。

2)

正如 cmets 中提到的，我个人使用注释来指导 null 是否为预期值。我找不到在构建器模式中使用的任何可靠示例，但您可能可以通过在 build() 方法中使用 checkNotNull() 来强制执行此操作，以便任何意外的 null 值抛出 NullPointerException。

至于具体的类，由你决定，但我个人会添加它们以保持一致性。

3)

鉴于上述情况，我会这样做：

public void foo(@NonNull ArrayList<CustomObject> list) {
    checkNotNull(list, "List is null!");
    if (!list.isEmpty()) {  
        CustomObject o = list.get(0);  //etc
    }
}