Java NotNull 返回 Null

在 Java 中，我们经常使用注解 @NotNull 来确保方法或参数中的对象不是空值（null）。然而，在某些情况下我们仍然会遇到返回空值的情况。

什么是 NotNull

@NotNull 是 Java 中非常流行的一个注解，它通常用于方法或参数的声明中。它告诉编译器该方法或参数的类型不应该为 null。

public void doSomething(@NotNull String param) {
   // do something
}

在这个例子中，我们要求 param 参数不应该为 null。这将使编译器生成一个警告，如果在编译时检测到违反这个要求的行为，则会抛出一个异常。

NotNull 不适用于返回值

虽然 @NotNull 对于参数和方法是有用的，但它并不适用于返回值。换句话说，我们不能使用 @NotNull 来告诉编译器一个方法不会返回 null 值。

不过，你可以使用 @Nullable 注解来表示一个方法可能会返回 null：

@Nullable
public String generateString() {
    return null;
}

在这个例子中，我们告诉编译器，generateString 可能返回 null。

返回 NotNull

如果你想强制一个方法返回非空值，你可以使用 Objects.requireNonNull 方法，将其应用于返回值。

public String generateString() {
    String result = "Hello World";
    return Objects.requireNonNull(result, "Result cannot be null");
}

在这个例子中，我们使用方法 Objects.requireNonNull 确保返回值 result 不是 null。如果它是 null，将抛出一个 NullPointerException，并显示一条自定义的错误消息。

总结

Java 中的 @NotNull 注解可以确保方法或参数不是 null。然而，它并不适用于返回值。你可以使用 @Nullable 注解表示一个方法可能会返回 null。如果你想要强制一个方法返回非 null 值，你可以使用 Objects.requireNonNull 方法。