null以外のnull可否アノテーションの意味を作る

Question

nullable、つまりNonNullとNullableに関するアノテーションを正しく使用する方法については明確ではありません。
私は、次のようなもので、本当に快適ではないです：

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

1）は、非感守備null以外とコードを宣言することですか？
2）このようなアノテーションを使用する最も効果的な方法は何ですか？例えば。例として
- ビルダーパターンを使用するときにそれらをどのように使用するのですか？
- 実装する具体的なクラスのインタフェースを定義するとき？クラスを実装するメソッドにもアノテーションが含まれているか、それとも想定されていますか？
3）上のスニペットでは、非NULL とを空ではないと定義する方法はありますか？

Answer 1

今私は調査する適切な時間があった、これは私が見つけたものです。 @NonNullアノテーションを使用しながら

1）

それはまだ守備コーディングする完璧な意味があります。パラメータに@NonNullアノテーションがあるため、実行時にnullを渡すことができます。例えば、のようなデータクラスで：

class DataClass { 
    @NonNull private String notNullString; 

    public DataClass() { notNullString = null; } 

    public String toString() { return notNullString; } 
} 

あなたは@NonNull変数にnullを代入しているが、toString()を呼び出すとnullを返しますIDE will warn。これを回避するには、why you're null-checking a @NonNull variableを要求するIDEの警告、PreConditions.checkNotNull(T)を使用する傾向があります - example codeを参照してください。

2）

コメント欄で述べたように、個人的に私はnullが期待値であるか否かをガイダンスとしてアノテーションを使用。ビルダーパターン内でこれが使用されているという確かな例は見つかりませんが、予期しないnullの値がNullPointerExceptionになるように、をbuild()メソッドで使用して強制することができます。

具体的なクラスについては、あなた次第ですが、個人的には一貫性のために追加します。

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