Kom godt i gang

APT i Eclipse

APT-plugin'en tilføjer understøttelse af Java 5-annotationsbehandling til Eclipse ved at køre annotationsprocessorer, der er skrevet til at bruge spejl-API'er i Eclipse.

Disse annotationsprocessorer udløses derefter, når du skriver i Eclipse, og leverer fejl og advarsler direkte i editoren. De producerer almindelige bygartefakter på samme måde, som hvis du udførte Sun's APT-værktøj fra kommandolinjen.

Du kan få flere oplysninger om, hvordan plugin'en fungerer, på JDT-APT-projektets websted.

Aktivér annotationsbehandling

Projektets compiler skal være konfigureret til at anvende Java-overholdelse på 5.0-niveau i indstillingerne under Java->Compiler:

Skærmbillede, der viser siden med compilerindstillinger

Derefter skal du aktivere annotationsbehandling under Java->Compiler->Annotationsbehandling:

Skærmbillede af egenskabssiden Annotationsbehandling

I dialogboksen kan du også angive det genererede kildebibliotek og eventuelle nødvendige processorindstillinger.

Bemærk: Indstillingerne "-Aclasspath" og "-Asourcepath" overføres automatisk til alle processorerne af Eclipse, så det er ikke nødvendigt at angive dem.

Tilføj annotationsprocessorer

Du kan tilføje annotationsprocessorer til projektet under Java->Compiler->Annotationsbehandling->Fabrikssti:

Skærmbillede af egenskabssiden Fabrikssti

Fabrikssti og kildekontrol

Fabriksstien fungerer på samme måde som classpath med hensyn til den måde, den arbejder med kildekontrol. For at undgå at angive stier til fabriks-JAR'er som faste værdier kan du enten bruge projektspecifikke JAR'er via knappen "Tilføj JAR-filer..." eller bruge en classpath-variabel via "Tilføj variabel...".

Processorindstillinger og kildekontrol

Du har måske brug for at anvende stier som nogle af de indstillinger, der overføres til annotationsprocessorerne. Hvis du også her undgår at angive absolutte stier som faste værdier, kan du dele konfigurationen i kildekontrol.

Det opnår via understøttelse af classpath-variabler i processorindstillinger. Før og efter variabler skal stå et procenttegn (%), og en variabel skal være første segment i en sti.

Eksempel: Hvis FOO er en classpath-variabel, der peger på d:/foo, opløses %FOO%/bar.txt til d:/foo/bar.txt. Classpath-opløsning forudsætter, at classpath-variablen findes. Hvis den ikke findes, tilføjes den ubehandlede streng til miljøindstillingerne. Det er dog ikke nødvendigt, at bar.txt (i dette eksempel) findes.

Den reserverede variabel ROOT har her en særlig betydning. Det er roden af arbejdsområdet og indleder en projektressource. Hvis quux f.eks. er navnet på et projekt, opløses %ROOT%/quux til den absolutte sti for quux, og %ROOT%/quux/.classpath opløses til den absolutte sti for quux/.classpath. Når ROOT bruges, skal det første segment i stien eksistere. I eksemplet skal projektet quux eksistere, men .classpath behøver ikke allerede at eksistere.