Annotasjonsbehandlere er hjelpeprogrammer som kan genererer ytterligere Java-kode eller andre filer, og produsere problemmerker, basert på Java 5- (JSR-175)-annotasjoner. Behandlerne kan bygge på Java 5-speil-APIer eller APIer for Java 6-annotasjonsbehandling. Preferanseruten for annotasjonsbehandling tillater konfigurasjon av preferanser som gjelder alle behandlere i et prosjekt eller arbeidsområde. Preferanseruten Factory-bane angir hvilke behandlere som er aktivert, og tillater konfigurering av individuelle behandlere.
Annotasjonsbehandling er som standard
slått av, og den må slås på ved å merke av i denne avmerkingsboksen for hvert prosjekt som
trenger det. Det er bare nødvendig å
aktivere annotasjonsbehandling i et prosjekt hvis du vil at annotasjonsbehandlerne skal fungere på dette
prosjektets kode. At det finnes annotasjoner
i koden, betyr ikke at det er nødvendig med annotasjonsbehandling. For eksempel
krever ikke annotasjonene
@Deprecated og @Override behandling.
Nå dette alternativet er aktiver, vil behandlerne kjøres hver gang det gjøres endringer i Java-redigeringsprogrammet, og hver gang prosjektet bygges. Aktivering av behandlere for kjøring i redigeringsprogrammet gjør det mulig for dem å generere feilmeldinger og varsler idet du skriver. For eksempel kan behandlere rødmerke en feil annotasjon for å påpeke et semantisk problem som maskinen alene ikke kan oppdage. Noen annotasjonsbehandlere er imidlertid så trege at det å kjøre dem i redigeringsprogrammet kan påvirke bruken av redigeringsprogrammet. I så fall kan deaktivering av dette alternativet bedre redigeringsprogrammets ytelse. Behandlerne vil fortsatt bli kjørt når prosjektet bygges. Dette alternativet gjelder ikke for Java 6-annotasjonsbehandlere, som Eclipse (foreløpig) ikke kan kjøre under bygging.
Filer blir generert på disk, relativt til den oppgitte katalogen. Som standard har denne katalogen navnet ".apt_generated", som siden det begynner med '.', gjør at det blir filtrert ut av en Pakkeutforsker-visning. Genererte filer har bitsettet "derived". Når det ryddes i et prosjekt, blir alle avledede filer under den genererte kildekatalogen fjernet. Det anbefales at denne katalogen bare brukes for filer som er generert av behandlere. Ikke plasser manuelt opprettede filer under denne katalogen, og ikke bruk en allerede eksisterende katalog som generert kildekatalog.
Alternativer som oppgis her blir tilgjengelige for behandlerne via grensesnittet AnnotationProcessorEnvironment (for Java 5-prosessorer) eller ProcessingEnvironment (for Java 6-prosessorer). Noen alternativer blir automatisk tilgjengelige for behandlerne. Det har ingen effekt å legge dem inn i denne dialogboksen, siden de automatisk oppgitte verdiene overstyrer eventuelle verdier som er oppgitt her. De automatiske alternativene er beskrevet her. Du finner flere opplysninger om behandleralternativer i emnet om inndatadialogboks for behandleralternativ.