Annotációfeldolgozás

Az annotáció feldolgozók olyan segédprogramok, melyek előállíthatnak kiegészítő Java kódot vagy egyéb fájlokat, illetve problémajelzőket készíthetnek a Java 5 (JSR-175) annotációk alapján. A feldolgozók a Java 5 tükrözés alkalmazás programozási felületeken vagy a Java 6 annotációfeldolgozási alkalmazás programozási felületeken alapulhatnak. Az Annotációfeldolgozás beállításpanel lehetővé teszi egy projekt vagy munkaterület minden feldolgozójára érvényes tulajdonságok beállítását. A Gyár útvonal gyár panel adja meg az engedélyezett feldolgozókat, illetve lehetővé teszi egyedi feldolgozók beállítását.

Annotációfeldolgozás engedélyezése

Az annotációfeldolgozás alapértelmezésben ki van kapcsolva, és minden ezt igénylő projekthez ki kell választani ezt a jelölőnégyzetet a bekapcsolásához. Csak akkor kell engedélyezni az annotációfeldolgozást egy projektben, ha az szükséges, hogy az annotációfeldolgozók működjenek a projekt kódján. Az annotációk puszta jelenléte a kódban még nem jelenti azt, hogy szükség van annotációfeldolgozásra; például a @Deprecated és az @Override annotációhoz általában nem szükséges feldolgozás.

Feldolgozás engedélyezése a szerkesztőben

Ha a beállítás engedélyezett, akkor a Java szerkesztőben tett módosításokkor, illetve a projekt összeépítésekor is futni fognak feldolgozók. Ha a feldolgozók futása a szerkesztőben engedélyezett, akkor képesek hibák és figyelmeztetések gépelés közbeni közreadására. A feldolgozók például vörös hullámvonallal jelölhetik a rossz annotáció értékeket, így jelezve egy olyan szemantikai problémát, amelyet a fordító önmagában nem fedezne fel. Ugyanakkor néhány annotációfeldolgozó annyira lassú, hogy a szerkesztőben történő futtatása ütközhet a szerkesztő használatával. Ebben az esetben a beállítás letiltása javíthatja a szerkesztő teljesítményét. A projekt összeépítésekor még így is futni fognak a feldolgozók. Ez a beállítás Java 6 annotációfeldolgozókra, amelyeket az Eclipse (egyelőre) csak összeépítés során tud futtatni, nem vonatkozik.

Előállított forrás könyvtár

A fájlok a megadott könyvtárhoz képest relatívan lesznek létrehozva a lemezen. Alapértelmezésben a könyvtár neve ".apt_generated", ami, mivel '.' karakterrel kezdődik, kiszűrésre kerül a Csomagböngésző nézetéből. Az előállított fájlok "származtatott" bitje be van állítva; a projekt tisztításakor az előállított forráskönyvtárban található összes származtatott fájl eltávolításra kerül. Ebben a könyvtárban ajánlott csak a feldolgozók által előállított fájlokat tárolni; ne helyezzen ide saját kezűleg előállított fájlokat, és ne használjon már meglévő könyvtárt az előállított forrás könyvtárként.

Feldolgozó beállításai

Az itt megadott beállítások az AnnotationProcessorEnvironment felületen (Java 5 feldolgozók esetén) vagy a ProcessingEnvironment felületen (Java 6 feldolgozók esetén) keresztül lesznek elérhetőek. Bizonyos beállítások a Java 5 feldolgozók számára automatikusan biztosítottak; megadásuknak ebben a párbeszédablakban nem lesz hatása, mivel az automatikusan biztosított értékek minden itt beállított értéket újradefiniálnak. Az automatikus beállítások leírása itt található. A feldolgozók beállításairól további információkat a Feldolgozó beállításai adatbeviteli párbeszédablak fejezetben talál.