Come utilizzare NonNullByDefault su un pacchetto

Question

Il mio compilatore mi avvisa di A default nullness annotation has not been specified for the package. Sto usando Juno con Java 7.

Le statistiche della documentazione dovresti aggiungere @NonNullByDefault come opzione di pacchetto, ma non so cosa significhi.

Posso in qualche modo impostare NonNullByDefault per l'intero pacchetto? In Eclipse non posso fare clic destro su un pacchetto e dire add option o qualcosa di simile.

Oppure devo semplicemente aggiungere @NonNullByDefault a qualsiasi classe in un pacchetto e quindi è valido per tutti i bean in quel pacchetto? O devo creare qualche file di meta informazioni nel pacchetto per aggiungere opzioni di pacchetto? Devo essere cieco perché non riesco a trovare alcun aiuto online ....

Un piccolo esempio sarebbe fantastico.

Answer 1

Sommario:
Ottenere i consigli precedenti al lavoro non era intuitivo per me. Né era la soluzione reale che ho appena capito. Nel file package-info.java:
a. inserire l'annotazione SOPRA la dichiarazione del pacco
b. messo l'annotazione di importazione NonNullByDefault dopo la dichiarazione pacchetto

---

Dettagli:
Non so se io sono l'unica persona che ha letto le risposte di cui sopra e non riusciva a capire come ottenere questo lavoro. Così, tanto per essere più chiaro, ecco i (non ovvio né intuitivo) passaggi che ho svolto per arrivare a questo lavoro finalmente in Eclipse-Juno:

1. In Package Explorer, Goto il pacchetto Java radice che mostra l'avviso (messaggio di errore che inizia con "Un'annotazione di nullità predefinita non è stata specificata per il pacchetto ..." - per questo esempio, si supponga che il nome del pacchetto di "org.public_domain"
2. Sul pacchetto Java, attivare il tasto destro del mouse e selezionare l'opzione "Nuovo -> Pacchetto" - sì, so che il pacchetto esiste già, consideralo un'idiosincrasia dell'eclisse - non farà nulla al pacchetto esistente
3. Quando appare il "Nuovo Java Package" finestra di dialogo, selezionare la casella "Crea package-info.java" casella di controllo e cliccare su "Fine"

4. L'editor Java avranno ora un nuovo file denominato "pacchetto -Informazioni.java "visualizzato con il seguente contenuto:

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

5. Ora, riorganizzare il contenuto del file di simile a questa:

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

   ... o così ...

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

6. Goditi la meraviglia che è eclissi @NonNullByDefault

La mia sfida era capire che ero a mettere l'annotazione sopra la dichiarazione del pacchetto. E per inserire l'annotazione NonNullByDefault dopo la dichiarazione del pacchetto. Per me, non era intuitivo.

Spero che questo risparmi qualcun altro il tempo in cui ho finito di bruciare inseguendo questo particolare percorso.

Answer 2

Vedi le source code o JavaDocs:

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

E:

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

Answer 3

Se si vuole semplicemente sbarazzarsi di avvertimento e ignorare questa funzione perché non stai facendo uso di esso, si può semplicemente disattivare nelle preferenze di Eclipse:

Finestra> Preferenze> Java> Compiler > errori/avvisi> analisi Null> mancante '@NonNullByDefault' annotazione sulla confezione = [Ignora]