Začínáme

APT na platformě Eclipse

Modul plug-in APT přidává do platformy Eclipse podporu zpracování anotací Java 5, a to spouštěním procesorů anotací, které používají rozhraní API zrcadlení v rámci Eclipse.

Tyto procesory anotací se spouštějí při psaní v Eclipse a poskytují chyby a varování přímo v editoru a dále vytvářejí artefakty normálního sestavení tak, jako byste v příkazovém řádku spouštěli nástroj APT společnosti Sun.

Podrobnější informace o práci modulu plug-in naleznete na webové stránce projektu JDT-APT.

Zapnutí zpracování anotací

Kompilátor vlastního projektu musíte mít zkonfigurován pro použití shody na úrovni Java 5.0. Tato konfigurace se provádí v předvolbách pod položkou Java->Kompilátor:

Snímek obrazovky se stránkou předvoleb kompilátoru

Dále musíte aktivovat zpracování anotací použitím položky Java->Kompilátor->Zpracování anotací:

Snímek obrazovky se stránkou vlastností Zpracování anotací

V tomto dialogovém okně můžete podle potřeby zadat rovněž adresář generovaného zdroje a poskytnout nezbytné volby procesoru.

Poznámka: "-Aclasspath" a "-Asourcepath" platforma Eclipse automaticky předává všem vašim procesorům a proto tyto informace zde není zapotřebí zadávat.

Přidávání procesorů anotací

Procesory anotací můžete přidávat do svého projektu použitím položky Java->Kompilátor->Zpracování anotací->Cesta k továrně:

Snímek obrazovky se stránkou vlastností Cesta k továrně

Cesta k továrně a ovládání zdroje

Cesta k továrně se shoduje s cestou ke třídě ve způsobu, kterým spolupracuje s ovládáním zdroje. Chcete-li se vyhnout výskytu staticky zadaných cest k souborům JAR továrny, použijte buď soubory JAR relativní k projektu pomocí tlačítka "Přidat soubory Jar...", nebo použijte proměnnou cesty ke třídě pomocí tlačítka "Přidat proměnnou..." .

Volby procesoru a ovládání zdroje

Může se vyskytnou potřeba použití cest na místě voleb předávaných vlastním procesorům anotací. Díky vyhnutí se staticky kódovaným absolutním cestám lze opět sdílet vlastní konfiguraci ovládání zdroje.

Pro tento účel podporujeme proměnné cesty ke třídě v rámci voleb procesoru. Proměnné musejí být odděleny na obou stranách znakem procenta a musí jít o první segment cesty.

Je-li tedy FOO proměnná cesty ke třídě, která odkazuje na d:/foo, pak cesta %FOO%/bar.txt bude interpretována jako d:/foo/bar.txt. Interpretace cesty ke třídě závisí na existenci proměnné cesty ke třídě; pokud neexistuje, bude do voleb prostředí přidán literálový řetězec. Nicméně soubor bar.txt (z našeho příkladu) nemusí existovat.

Vyhrazená proměnná ROOT má speciální význam: Jde o kořen pracovního prostoru, který zavádí prostředek projektu. Pokud je tedy například quux názvem projektu, pak cesta %ROOT%/quux bude interpretována jako absolutní cesta quux a %ROOT%/quux/.classpath bude interpretována jako absolutní cestak k quux/.classpath. Při použití proměnné ROOT musí první segment cesty skutečně existovat: V rámci příkladu tedy musí existovat projekt quux, nicméně .classpath existovat nemusí.