Zpracování anotací

Procesory anotací jsou obslužné programy, které mohou generovat přídavný kód Java nebo jiné soubory a vytvářet značkovače problémů na základě anotací Java 5 (JSR-175). Procesory lze vytvářet na základě rozhraní API Java 5 pro zrcadlení nebo na základě rozhraní API Java 6 pro zpracování anotací. Podokno předvoleb Zpracování anotací umožňuje provedení konfigurace předvoleb, které budou použity pro všechny procesory v projektu nebo v pracovním prostoru. Podokno předvoleb Cesta k továrně určuje aktivní procesory a umožňuje konfiguraci jednotlivých procesorů.

Povolit zpracování anotací

Zpracování anotací je při výchozím nastavení vypnuté, a proto je zapotřebí je pro jednotlivé projekty, které tuto funkci vyžadují zapnout označením tohoto zaškrtávacího pole. Zpracování anotací povolte pouze v případě, že chcete používat procesory anotací v kódu dotyčného projektu. Pouhá přítomnost anotací v kódu neznamená, že je zapotřebí zpracování anotací; například anotace @Deprecated a @Override obvykle nevyžadují zpracování.

Povolit zpracování v editoru

Když je tato volba zapnuta, spustí se procesory pokaždé, když se v editoru Java provedou změny a když se projekt sestaví. Povolení procesorů ke spouštění v editoru těmto procesorům umožňuje generování informací o chybách a výstrahy přímo při zápisu. Procesory například mohou červenou vlnovkou podtrhnout špatnou hodnotu anotace, a označit tak sémantický problém, který by samotný kompilátor nemohl zjistit. Některé procesory anotací jsou však natolik pomalé, že jejich spouštění v editoru koliduje s použitelností editoru. V takové situaci může vypnutí této volby zlepšit výkon editoru. Procesory se budou nadále spouštět při každém sestavení projektu.Tato volba se nepoužívá pro procesory anotací Java 6, které platforma Eclipse (nyní) může spouštět pouze během sestavení.

Adresář generovaného zdroje

Soubory budou vygenerovány na disku v umístění relativním k zadanému adresáři. Při výchozím nastavení tento adresář nese název ".apt_generated", a začíná tedy tečkou '.' - a proto je odfiltrován z pohledu Průzkumník balíků. Vygenerované soubory mají nastaven bit "odvozeno"; při úklidu souboru dojde k odebrání všech odvozených souborů ve zdrojové složce. Doporučujeme vám používat tento adresář pouze pro soubory vygenerované procesory; neukládejte do tohoto adresáře žádné ručně vytvořené soubory. Vyvarujte se použití stávajících adresářů pro ukládání vygenerovaných zdrojů.

Volba procesoru

Zde zadávané volby budou k dispozici prostřednictvím rozhraní AnnotationProcessorEnvironment (pro procesory Java 5) nebo rozhraní ProcessingEnvironment (pro procesory Java 6). Určité volby jsou procesorům Java 5 poskytovány automaticky. Zadávání těchto voleb v tomto dialogovém okně je zbytečné, protože automaticky poskytnuté hodnoty potlačí libovolné hodnoty nastavené na tomto místě. Automatické volby jsou popsány zde. Další informace o volbách procesorů jsou uvedeny v tématu Dialogové okno zadávání voleb procesoru.