Jak korzystać z NonNullByDefault na opakowaniu

Question

Mój kompilator ostrzega mnie przed A default nullness annotation has not been specified for the package. Używam Juno z Javą 7.

Statystyki dokumentacji, do których należy dodać @NonNullByDefault jako opcję pakietową, ale nie wiem, co to oznacza.

Czy mogę w jakiś sposób ustawić NonNullByDefault dla całego pakietu? W Eclipse nie mogę kliknąć prawym przyciskiem myszy na pakiet i powiedzieć add option lub coś podobnego.

Czy mogę po prostu dodać @NonNullByDefault do dowolnej klasy w pakiecie, a następnie jest ona ważna dla wszystkich ziaren w tym pakiecie? Czy muszę utworzyć plik metainformacji w pakage, aby dodać opcje pakietu? Muszę być ślepy, ponieważ nie mogę znaleźć żadnej pomocy online ...

Mały przykład byłby świetny.

Answer 1

Podsumowanie:
Uzyskanie powyższej porady do pracy nie był intuicyjny do mnie. Nie znalazłem też rozwiązania, które właśnie wymyśliłem. W pliku package-info.java:
a. wpisz adnotację POWYŻEJ deklaracji paczki
b. umieścić adnotację import NonNullByDefault po ogłoszeniu pakietu

---

szczegóły:
ja nie wiem, czy jestem jedyną osobą, która przeczytać powyższe odpowiedzi i nie mógł dowiedzieć się, jak uzyskać to pracujący. Więc, po prostu być bardzo jasne, oto (nieoczywiste ani intuicyjne) kroki zrobiłem, aby uzyskać to, by w końcu pracować w Eclipse Juno:

1. w opakowaniu Explorer goto pakiet Java główny przedstawiający ostrzeżenia (lub błąd) wiadomość rozpoczynająca się od "Domyślna adnotacja o wartości null nie została określona dla pakietu ..." - w tym przykładzie należy założyć nazwę pakietu "org.public_domain"
2. W pakiecie Java aktywuj kliknij prawym przyciskiem myszy i wybierz opcję "Nowość -> Pakiet" - tak, wiem, że twoja paczka już istnieje, rozważ to idiosynkrazę zaćmienia - nie zrobi nic z twoim istniejącym pakietem
3. Kiedy pojawi się „Pakiet New Java” dialogowe, zaznacz „Tworzenie package-info.java” pole wyboru i kliknij przycisk „Zakończ”

4. edytor Java mają teraz nowy plik zatytułowany "pakiet -info.java "wyświetlane o następującej treści:

   /** 
   * 
   */ 
   /** 
   * @author xyz 
   * 
   */ 
   package org.public_domain; 
   

5. Teraz zmienić zawartość pliku, aby wyglądać tak:

   /** 
   * 
   */ 
   /** 
   * @author xyz 
   * 
   */ 
   @NonNullByDefault 
   package org.public_domain; 
   import org.eclipse.jdt.annotation.NonNullByDefault; 
   

   ... albo tak ...

   /** 
   * 
   */ 
   /** 
   * @author xyz 
   * 
   */ 
   @org.eclipse.jdt.annotation.NonNullByDefault 
   package org.public_domain; 
   

6. Ciesz się niesamowitością, jaką jest zaćmienie @NonNullByDefault

Moim wyzwaniem było zorientowanie się, że jestem do umieścić adnotację POWYŻEJ deklaracji paczki. I do umieść import adnotacji NonNullByDefault PO deklaracji paczki. Dla mnie to nie było intuicyjne.

Mam nadzieję, że to oszczędza komuś innemu czas, który skończyłem, podpalając tę ​​konkretną ścieżkę.

Answer 2

Zobacz source code lub Javadocs:

Note that for applying an annotation to a package a file by the name 
package-info.java is used. 

oraz:

@Target({PACKAGE,TYPE,METHOD,CONSTRUCTOR}) 

Answer 3

Jeśli chcesz po prostu pozbyć się ostrzeżenia i ignorować tę funkcję, ponieważ nie jesteś wykorzystanie niego, można go po prostu wyłączyć w preferencjach Eclipse:

Okno> Preferencje> Jawa> Compiler > Błędy/Ostrzeżenia> analiza Null> Missing '@NonNullByDefault' adnotacji na opakowaniu = [Ignore]