java – 在方法参数中使用NotNull注释

前端之家收集整理的这篇文章主要介绍了java – 在方法参数中使用NotNull注释前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。
我刚刚开始使用 Java 8的@NotNull注释,并获得一些意想不到的结果.

我有一个这样的方法

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

我写了一个JUnit测试,通过参数的searchList的null值.我期待发生某种类型的错误,但是它似乎就像注释不在那里一样.这是预期的行为吗?从我的理解,这是允许你跳过编写样板空检查代码.

对@NotNull应该做什么的解释将不胜感激.

解决方法

@Nullable和@NotNull自己不做任何事情.它们应该作为文档工具.

@Nullable注释提醒您在以下情况下需要引入NPE检查:

>可以返回null的调用方法.
>取消引用可以为null的变量(字段,局部变量,参数).

实际上,@NotNull注释是一个明确的合同,声明如下:

>一个方法不应该返回null.
>变量(像字段,局部变量和参数)不能保持空值.

例:

而不是写作:

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

您可以使用

public void setX(
    @NotNull
    final Object aX )
{
...
}

猜你在找的Java相关文章