Kezdeti lépések

Az Eclipse APT

Az APT bedolgozó Java 5 jegyzetfeldolgozás támogatást biztosít az Eclipse számára, az Eclipse-ben található API tükrök használatára írt feljegyzésfeldolgozások használatával.

Ezek a feljegyzésfeldolgozók az Eclipse-ben gépelés során akitválódnak, közvetlenül a szerkesztőn belül biztosítják a hibajelzéseket és figyelmeztetéseket, illetve normális összeépítési termékeket, pontosan úgy, mintha a Sun APT eszközét használná a parancssorból.

A bedolgozó működésének további részleteit a JDT-APT projekt webhelyen találja.

A feljegyzésfeldolgozás bekapcsolása

A Java->Fordító menüpontban be kell állítania a projekt fordítóprogramját Java 5.0 szintű eggyüttműködésre.

Kép a Fordító beállítások oldalról

Ezután engedélyeznie kell a feljegyzésfeldolgozást a Java->Fordító->Feljegyzésfeldolgozás menüpontban:

Kép a Feljegyzésfeldolgozás adatlapról

Ezen a párbeszédpanelen kívánság szerint megadhatja az előállított forráskönyvtárat is, illetve megadhatja a szükséges feldolgozási beállításokat is.

Megjegyzés: Az "-Aclasspath" és "-Asourcepath" paraméterek automatikusan átadódnak az Eclipse minden feldolgozójának, így ezeket szükségtelen megadni.

Feljegyzésfeldolgozók hozzáadása

A Java->Fordító->Feljegyzésfeldolgozás>Gyár útvonal menüpontban adhat feljegyzésfeldolgozókat a projekthez:

Kép a Gyárútvonal adatlapról

Gyár útvonal és Forrásvezérlés

A gyár útvonal hasonlít az osztályútvonalhoz, amennyiben együttműködik a forrásvezérléssel. Hogy ne kelljen megadni útvonalakat a gyár JAR fájlokhoz, használhat projekt-relatív JAR fájlokat a "JAR fájlok hozzáadása..." gombbal, vagy osztályútvonal változót a "Változó hozzáadása..." gombbal.

Feldolgozó beállítások és Forrásvezérlés

Előfordulhat, hogy útvonalakat kell használnia a feljegyzésfeldolgozóknak átadott beállításokhoz. Ilyenkor is elkerülheti a megosztható abszolút útvonalak megadását a forrásvezérlésben.

Ehhez biztosítottak a feldolgozóbeállításokban az osztályútvonal változók. A változók mindkét oldalát % jel határolja, és az útvonal első szegmensének kell lenniük.

Így ha a FOO egy d:/foo helyre mutató osztályútvonal változó, akkor a %FOO%/bar.txt a d:/foo/bar.txt útvonalra lesz feloldva. A osztályútvonal feloldás az osztályútvonal változó létezésétől függ; ha nem létezik, akkor az eredeti karaktersorozat lesz hozzáadva a környezeti beállításokhoz. Azonban a példában szereplő bar.txt fájlnak nem szükséges léteznie.

A ROOT fenntartott változó speciális jelentéssel bír: ez a munkaterület gyökér, és egy projekt erőforrást vezet be. Így ha például quux egy projekt neve, akkor a %ROOT%/quux a quux abszolút útvonalára lesz feloldva, a %ROOT%/quux/.classpath pedig a quux/.classpath abszolút útvonalára. A ROOT változó használatakor az útvonal első szegmensének léteznie kell: ebben a példában a quux projektnek léteznie kell, de a .classpath útvonalnak már nem.