Yöntem argümanında NotNull Ek Açıklama kullanma

Question

Java 8 ile @NotNull ek açıklamasını kullanmaya ve bazı beklenmedik sonuçlar almaya başladım.

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

ben argümanı searchingList null değeri geçen bir JUnit test yazdım:

Böyle bir yöntem var. Bir tür hatanın gerçekleşmesini bekliyordum ama sanki orada bir açıklama yokmuş gibi geçti. Bu beklenen davranış mı? Anladığım kadarıyla, bu, kontrol plakası boş kontrol kodunu yazmanıza izin vermekti.

@NotNull'ın tam olarak ne yapması gerektiği ile ilgili bir açıklama büyük ölçüde takdir edilecektir.

Answer 1

@Nullable ve @NotNull hiçbir şeyi kendi başına yapmaz. Dokümantasyon araçları olarak hareket etmeleri gerekiyor.

1. boş dönebilirsiniz yöntemleri çağırma:

   @Nullable Notu zaman bir NPE çeki tanıtmak gerekliliği hatırlatır.

2. Boş bırakılamayan değişkenler (alanlar, yerel değişkenler, parametreler).
   1. bir yöntem boş dönmemesi:

   @NotNull Annotation

aşağıdaki ilan açık sözleşme, aslında vardır.
3. Bir değişken (alanlar, yerel değişkenler ve parametreler gibi) boş değer tutamaz.

örnek:

yazma yerine

: Eğer

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

Answer 2

SO @NotNull sadece etikettir ... bunu doğrulamak isterseniz kullanabilirsiniz

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

, o zaman, hazırda beklemedeki doğrulayıcı gibi bir şey kullanmalısınız jsr 303