在方法参数中使用NotNull注释

Question

public List<Found> findStuff(@NotNull List<Searching> searchingList) {
    ... code here ...
}

我编写了一个JUnit测试，为参数searchingList传入null值。我原以为会发生某种类型的错误，但结果好像注释不在那里一样。这是意料之中的行为吗？根据我的理解，这是允许您跳过编写样板空校验代码。

如果能解释一下@NotNull到底应该做什么，将会非常感谢。

Answer 1

@nullable和@notnull本身不执行任何操作。它们应该充当文档工具。

@nullable注释提醒您在以下情况下引入NPE检查的必要性：

1. 调用可以返回NULL的方法。
2. 取消引用可以为空的变量（字段、局部变量、参数）。

null

/**
 * @param aX should not be null
 */
public void setX(final Object aX ) {
    // some code
}

public void setX(@NotNull final Object aX ) {
    // some code
}

此外，@NotNull经常由ConstraintValidator检查（例如在spring和hibernate中）。

@NotNull注释本身不执行任何验证，因为注释定义不提供任何ConstraintValidator类型引用。

有关更多信息,请参阅：

null