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. 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.
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.
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', d. h. es wird in der Sicht 'Paket-Explorer' herausgefiltert. Für die generierten Dateien ist das Ableitungsbit ('derived') gesetzt. Bei einer Bereinigung 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.
Die hier eingegebenen Optionen stehen über die Schnittstelle 'AnnotationProcessorEnvironment' für die Verarbeitungsfunktionen zur Verfügung. Bestimmte Optionen werden den 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.