Erste Schritte

APT in Eclipse

Das APT-Plug-in fügt Eclipse Unterstützung für die Anmerkungsverarbeitung von Java 5 hinzu, indem Anmerkungsprozessoren ausgeführt werden, die für die Verwendung von Mirror APIs innerhalb von Eclipse geschrieben wurden.

Diese Anmerkungsprozessoren werden ausgelöst, wenn Sie innerhalb von Eclipse Eingaben vornehmen. Sie stellen Fehler und Warnungen direkt in den Editor und erzeugen normale Erstellungsartefakte, so als würden Sie das apt-Tool von Sun in der Befehlszeile ausführen.

Weitere Informationen zur Funktionsweise des Plug-ins finden Sie auf der Website zum JDT-APT-Projekt.

Anmerkungsverarbeitung aktivieren

Der Compiler des Projekts muss in den Benutzervorgaben unter 'Java->Compiler' so konfiguriert sein, dass er mit der Java 5.0-Stufe kompatibeln ist:

Screenshot der Benutzervorgabenseite für den Compiler

Anschließend müssen Sie die Anmerkungsverarbeitung unter 'Java->Compiler->Anmerkungsverarbeitung' aktivieren:

Screenshot der Eigenschaftenseite für die Anmerkungsverarbeitung

In diesem Dialogfenster können Sie ferner bei Bedarf das generierte Quellenverzeichnis angeben und alle notwendigen Prozessoroptionen zur Verfügung stellen.

Hinweis: Die Optionen "-Aclasspath" und "-Asourcepath" werden automatisch von Eclipse an alle Prozessoren übergeben, so dass Sie diese Optionen nicht zur Verfügung stellen müssen.

Anmerkungsprozessoren hinzufügen

Sie können Ihrem Projekt unter 'Java->Compiler->Anmerkungsverarbeitung->Factorypfad' Anmerkungsprozessoren hinzufügen:

Screenshot der Eigenschaftenseite für Factorypath

Factorypath und Quellcodeverwaltung

Der Factorypath ist dem Klassenpfad im Hinblick auf die Interaktion mit der Quellcodeverwaltung ähnlich. Um fest codierte Pfade zur Factory-JARs zu vermeiden, können Sie entweder projektbezogene JARs über die Schaltfläche "JARs hinzufügen..." oder eine Klassenpfadvariable über die Schaltfläche "Variable hinzufügen..." verwenden.

Prozessoroptionen und Quellcodeverwaltung

Sie müssen möglicherweise Pfade verwenden, da einige Optionen an Ihren Anmerkungsprozessor übergeben wurden. Wenn Sie jedoch das feste Codieren absoluter Pfade vermeiden, können Sie Ihre Konfiguration in der Quellcodeverwaltung gemeinsam nutzen.

Daher werden Klassenpfadvariable innerhalb von Prozessoroptionen unterstützt. Variablen müssen auf beiden Seiten durch % begrenzt werden und das erste Segment eines Pfades sein.

Wenn also FOO eine Klassenpfadvariable ist, die auf d:/foo zeigt, so wird %FOO%/bar.txt in d:/foo/bar.txt aufgelöst. Die Auflösung von Klassenpfaden hängt von der Existenz der Klassenpfadvariable ab. Wenn diese nicht vorhanden ist, wird die unformatierte Zeichenfolge den Umgebungsoptionen hinzugefügt. Die Datei bar.txt (in diesem Beispiel) muss jedoch nicht vorhanden sein.

Die reservierte Variable ROOT hat eine besondere Bedeutung. Es handelt sich um das Stammverzeichnis (Root) des Arbeitsbereichs, das eine Projektressource einführt. Wenn zum Beispiel quux der Name eines Projekts ist, so wird %ROOT%/quux in den absoluten Pfad von quux und % aufgelöst und ROOT%/quux/.classpath wird in den absoluten Pfad quux/.classpath aufgelöst. Bei der Verwendung von ROOT muss das erste Segment im Pfad tatsächlich vorhanden sein. In diesem Beispiel muss das Projekt quux vorhanden sein; .classpath muss jedoch nicht vorhanden sein.