Annotationsbehandling

Annotationsprocessorer er hjælpeprogrammer, der kan generere yderligere Java-kode eller andre filer samt fremstille problemmarkeringer baseret på Java 5-annotationer (JSR-175). Processorer kan være baseret på enten Java 5 Mirror API'er eller Annotationsbehandlings-API'er i Java 6. I indstillingsdelvinduet Annotationsbehandling kan du konfigurere indstillinger, der gælder for alle processorer i et projekt eller arbejdsområde. I delvinduet Indstillinger for fabrikssti vises de processorer, der er aktiveret, og de enkelte processorer kan konfigureres her.

Aktivér annotationsbehandling

Annotationsbehandling er som standard deaktiveret. Du kan aktivere annotationsbehandling for hvert projekt, der har brug for det, ved at vælge afkrydsningsfeltet. Det er kun nødvendigt at aktivere annotationsbehandling i et projekt for få annotationsprocessorer til at behandle projektets kode. At der findes annotationer i koden er ikke ensbetydende med, at annotationsbehandling er påkrævet. F.eks. kræves normalt ingen behandling af annotationerne @Deprecated og @Override.

Aktivér behandling i editor

Når denne indstilling er aktiveret, udføres processorer, hver gang der foretages ændringer i Java-editoren, og når projektet bygges. Når processorer aktiveres i editoren, kan de generere fejlmeddelelser og advarsler, mens du skriver. Processorer kan f.eks. sætte en rød bølgestreg under en forkert annotationsværdi for at angive et semantisk problem, som compileren ikke kan registrere alene. Dog er visse annotationsprocessorer så langsomme, at hvis de udføres i editoren, vil det påvirke editorens anvendelighed. I en sådan situation kan deaktivering af denne indstilling forbedre editorens ydeevne betydeligt. Processorer vil stadig blive udført, hver gang projektet bygges. Denne indstilling gælder ikke Java 6-annotationsprocessorer, som Eclipse (foreløbigt) kun kan udføre under bygning.

Genereret kildebibliotek

Filer genereres på disken i forhold til det angivne bibliotek. Som standard hedder dette bibliotek ".apt_generated". Fordi navnet starter med et '.', bortfiltreres det fra oversigten Package Explorer. Bitten "afledt" er angivet for genererede filer. Når der ryddes op i et projekt, vil alle afledte filer under det genererede kildebibliotek blive fjernet. Det anbefales kun at bruge biblioteket til filer, der genereres af processorer. Placér ikke manuelt oprettede filer i biblioteket, og brug ikke et bibliotek, der allerede findes, som genereret kildebibliotek.

Processorindstillinger

De indstillinger, der angives her, vil være tilgængelige via grænsefladen AnnotationProcessorEnvironment (for Java 5-processorer) eller grænsefladen ProcessingEnvironment (for Java 6-processorer). Visse indstillinger angives automatisk til Java 5-processorerne. Det har ingen virkning at indstille dem i denne dialogboks, da eventuelle værdier her tilsidesættes af de automatisk angivne værdier. De automatiske indstillinger er beskrevet her. Der findes flere oplysninger om processorindstillinger under emnet Dialogboksen Angiv processorindstilling.