@ParametersAreNonnullByDefault có áp dụng cho các giá trị trả về phương thức không?

Question

Các documentation for @ParametersAreNonnullByDefault nói rằng:

chú thích này có thể được áp dụng cho một gói, lớp hoặc phương pháp để chỉ ra rằng phương pháp thông số trong yếu tố đó là nonnull theo mặc định trừ khi ...

Tôi không xem xét kiểu trả về/giá trị của phương thức là tham số của nó. Nó chỉ là một phần của chữ ký của nó, vì vậy đây là loại mơ hồ đối với tôi.

Java tutorial for methods dường như giống như tôi.

---

Như Joachim Sauer chỉ ra cho tôi trong phần ý kiến ​​của answer, tên @ParametersAreNonnullByDefault (thông số) của mình nên đã ghi rõ cho tôi rằng chú thích này không áp dụng cho các loại trở lại phương pháp/giá trị . Tôi bị mù! :) Cảm ơn Joachim!

Trong điều kiện này, tôi chỉ có thể nói rằng @EverythingIsNonnullByDefault sẽ tồn tại ở mọi nơi. :)

Answer 1

Tôi không thấy lý do tại sao @ParametersAreNonnullByDefault nên áp dụng cho giá trị trả lại.

Answer 2

Không, @ParametersAreNonnullByDefault chỉ áp dụng cho các tham số của phương thức - giá trị mà nó chấp nhận từ người gọi (giữa các dấu ngoặc đơn). Phương pháp này vẫn miễn phí để trả lại giá trị null.

Đây là lớp kết hợp cả ba nơi bạn có thể áp dụng @Nonnull, mặc dù trong mã của chúng tôi, tôi vẫn sử dụng ba chú thích riêng biệt, một trong số đó được cung cấp bởi JSR-305.

package com.sample; 

import java.lang.annotation.Documented; 
import java.lang.annotation.ElementType; 
import java.lang.annotation.Retention; 
import java.lang.annotation.RetentionPolicy; 

import javax.annotation.meta.TypeQualifierDefault; 

/** 
* This annotation can be applied to a package, class or method to indicate that all 
* class fields and method parameters and return values in that element are nonnull 
* by default unless overridden. 
*/ 
@Documented 
@Nonnull 
@TypeQualifierDefault({ElementType.FIELD, ElementType.METHOD, ElementType.PARAMETER}) 
@Retention(RetentionPolicy.RUNTIME) 
public @interface EverythingIsNonnullByDefault { 
}