Anmerkungsverarbeitung

Anmerkungsverarbeitungsfunktionen sind Dienstprogramme, die zusätzlichen Java-Code oder andere Dateien generieren und Fehlermarkierungen erzeugen können, die auf Java 5-Anmerkungen (JSR-175) basieren. Verarbeitungsfunktionen können entweder auf Java 5 Mirror-APIs oder auf Java 6-APIs zur Anmerkungsverarbeitung basieren. Die Benutzervorgabenseite für Anmerkungsverarbeitung ermöglicht das Konfigurieren von Benutzervorgaben, die für alle Verarbeitungsfunktionen in einem Projekt oder einem Arbeitsbereich gelten. Die Benutzervorgaben für Factorypfad geben an, welche Verarbeitungsfunktionen aktiviert sind und ermöglichen das Konfigurieren einzelner Verarbeitungsfunktionen.

Anmerkungsverarbeitung aktivieren

Standardmäßig ist die Anmerkungsverarbeitung inaktiviert, d. h. sie muss über dieses Markierungsfeld für jedes Projekt aktiviert werde, für das sie erforderlich ist. Wenn die Anmerkungsverarbeitung für ein Projekt aktiviert ist, werden Anmerkungsfunktionen auf den Code dieses Projekts angewendet. Das Vorhandensein von Anmerkungen im Code bedeutet nicht unbedingt, dass Anmerkungsverarbeitung erforderlich ist. Beispielsweise wird für die Anmerkungen @Deprecated und @Override in der Regel nicht unbedingt Anmerkungsverarbeitung benötigt.

Verarbeitung in Editor aktivieren

Wenn diese Option aktiviert ist, werden Verarbeitungsfunktionen immer ausgeführt, wenn im Java-Editor Änderungen vorgenommen werden und wenn das Projekt erstellt wird. Wenn Verarbeitungsfunktionen für die Ausführung im Editor aktiviert werden, können diese während der Eingabe als Ergänzung Fehler und Warnungen generieren. Verarbeitungsfunktionen können beispielsweise einen falschen Anmerkungswert mit einer geschlängelten Linie versehen, um einen semantischen Fehler anzuzeigen, den der Compiler alleine nicht erkennen kann. Einige Anmerkungsverarbeitungsfunktionen sind jedoch so langsam, dass ihre Ausführung im Editor den Bedienungskomfort des Editors verringert. In einer solchen Situation kann die Inaktivierung dieser Option die Leistung des Editors verbessern. Verarbeitungsfunktionen werden weiterhin immer ausgeführt, wenn das Projekt bereits erstellt ist. Diese Option gilt nicht für Java 6-Anmerkungsverarbeitungsfunktionen, die Eclipse (bisher) nur während eines Builds ausführen kann.

Generiertes Quellenverzeichnis

Die generierten Dateien werden auf dem Datenträger mit Bezug auf das angegebene Verzeichnis gespeichert. Standardmäßig trägt dieses Verzeichnis den Namen ".apt_generated", das mit '.' anfängt und daher in der Ansicht 'Paket-Explorer' herausgefiltert wird. Für die generierten Dateien ist das Ableitungsbit ("derived") gesetzt. Bei der Bereinigung eines Projekts werden alle abgeleiteten Dateien im generierten Quellenverzeichnis entfernt. Es wird empfohlen, dieses Verzeichnis nur für Dateien zu verwenden, die von Verarbeitungsfunktionen generiert wurden. Speichern Sie in diesem Verzeichnis keine manuell erstellten Dateien, und verwenden Sie kein bereits vorhandenes Verzeichnis als generiertes Quellenverzeichnis.

Optionen für Verarbeitungsfunktionen

Die hier eingegebenen Optionen stehen über die Schnittstelle 'AnnotationProcessorEnvironment' (für Java 5-Verarbeitungsfunktionen) oder über die Schnittstelle 'ProcessingEnvironment' (für Java 6-Verarbeitungsfunktionen) zur Verfügung. Bestimmte Optionen werden den Java 5-Verarbeitungsfunktionen automatisch zur Verfügung gestellt. Die Eingabe solcher Optionen in diesem Dialog bleibt wirkungslos, weil die automatisch vorgegebenen Werte die hier angegebenen Werte außer Kraft setzen. Die automatisch vorgegebenen Optionen sind hier beschrieben. Weitere Informationen zu Optionen für Verarbeitungsfunktionen finden Sie im Abschnitt über den Eingabedialog der Optionen für Verarbeitungsfunktionen.