Introduzione

APT in Eclipse

Il plugin APT aggiunge i supporto per l'elaborazione dell'annotazione Java 5 a Eclipse, eseguendo i processori delle annotazioni scritti per utilizzare i Mirror APIs in Eclipse.

Questi processori delle annotazioni verranno attivati quando si immetteranno dati in Eclipse, visualizzando gli errori e gli avvisi direttamente nell'editor, e producendo risorse di generazione normali, come se si stesse eseguendo lo strumento apt di Sun dalla riga comandi.

Per ulteriori informazioni sul funzionamento del plugin, fare riferimento alla pagina JDT-APT project web site.

Attivazione dell'elaborazione delle annotazioni

Il compilatore del progetto deve essere configurato nelle preferenze affinché utilizzi il livello di compatibilità Java 5.0, in Java->Compilatore:

Screenshot of Compiler preference page

Quindi sarà necessario abilitare l'elaborazione delle annotazioni in Java->Compilatore->Elaborazione annotazione:

Screenshot of Annotation Processing properties page

In questa finestra è anche possibile specificare la directory di origine generata, e fornire le opzioni di elaborazione necessarie.

Nota: le opzioni "-Aclasspath" e "-Asourcepath" vengono trasmesse automaticamente a tutti i processori da Eclipse, quindi non è necessario specificarle.

Aggiunta dei processori delle annotazioni

È possibile aggiungere i processori delle annotazioni al progetto in Java->Compilatore->Elaborazione annotazioni->Percorso factory:

Screenshot of Factory Path properties page

Percorso factory e controllo origine

Il percorso factory è simile al percorso classi quando interagisce con il controllo origine. Per evitare percorsi codificati per i jar del factory, è possibile utilizzare i jar relativi al progetto scegliendo "Aggiungi Jar..." o utilizzando una variabile di percorso classi scegliendo "Aggiungi variabile..." ...'.

Opzioni del processore e controllo origine

Potrebbe essere necessario utilizzare i percorsi a causa di alcune opzioni trasmesse ai processori delle annotazioni. Anche in questo caso, per evitare la codifica di percorsi assoluti, sarà possibile condividere la configurazione nel controllo origine.

Per consentire questa condivisione, le variabili del percorso classi sono supportate nelle opzioni del processore. Le variabili devono essere delimitate su entrambe le estremità da %, e devono essere il primo segmento di un percorso.

Di conseguenza, se FOO è una variabile di percorso classi che indica d:/foo, %FOO%/bar.txt verrà risolto in d:/foo/bar.txt. La risoluzione del percorso classi dipende dall'esistenza della variabile del percorso classi; se non esiste, verrà aggiunta una stringa di base alle opzioni dell'ambiente. Tuttavia, non è necessario che bar.txt (in questo esempio) esista.

La variabile riservata ROOT ha un significato speciale: si trova nella cartella principale dello spazio di lavoro, ed introduce una risorsa di progetto. Quindi, ad esempio, se quux è il nome di un progetto, %ROOT%/quux si risolve nel percorso assoluto di quux e % ROOT%/quux/.classpath si risolve nel percorso assoluto di quux/.classpath. Quando si utilizza ROOT, il primo segmento del percorso deve già esistere: nell'esempio, il quux del progetto deve esistere, ma non è necessario che esista anche .classpath.