Anteckningsbearbetning

Anteckningsprocessorer är verktygsprogram som kan generera ytterligare Java-kod eller andra filer och skapa problemmarkörer som är baserade på Java 5 (JSR-175)-anteckningar. Processorer kan baseras på Java 5 Mirror API eller Java 6-anteckningsbearbetnings-API. På sidan Anteckningsbearbetning kan du ange inställningar som ska gälla alla processorer i ett projekt eller en arbetsyta. Sidan Fabrikssökväg anger vilka processorer som är aktiva, och du kan konfigurera enskilda processorer på sidan.

Aktivera anteckningsbearbetning

Anteckningsbearbetningen är som standard inaktiv. Du måste aktivera den genom att markera kryssrutan för varje projekt som behöver den. Du behöver bara aktivera anteckningsbearbetningen i ett projekt för att anteckningsprocessorer ska användas på projektets kod. Själva förekomsten av anteckningar i kod, innebär inte att anteckningsbearbetning är nödvändig, t.ex. anteckningarna @Deprecated och @Override kräver normalt inte bearbetning.

Aktivera bearbetning i redigerare

När alternativet är aktivt, kommer bearbetningar att utföras så fort ändringar görs i Java-redigeraren, liksom när projektet byggs. Om processorerna aktiveras i redigeraren kan de skapa fel och varningar medan du skriver. Processorer kan t.ex. markera ett oriktigt anteckningsvärde för att visa på ett semantiskt problem som kompilatorn inte ensam kan upptäcka. En del anteckningsprocessorer är långsamma och kommer i konflikt med redigeraren när de körs. I sådana fall kan avaktivering av alternativet förbättra redigerarens prestanda. Processorerna kommer fortfarande att köras när projektet byggs. Det här alternativet gäller inte Java 6-anteckningsbearbetningar som Eclipse (för närvarande) endast kan köra under ett bygge.

Genererad källkatalog

Filer genereras på en disk i förhållande till den specificerade katalogen. Katalogen har som standard namnet ".apt_generated", vilket, eftersom det börjar med "." gör att den filtreras ut i Paketutforskaren. Genererade filer har bituppsättningen "derived". Vid rensning kommer alla filer i den genererade källkatalogen att tas bort. Katalogen bör bara användas för filer som genererats av processorer. Placera inga manuellt skapade filer i denna katalog och använd inte en redan befintlig katalog som den genererade källkatalogen.

Processoralternativ

Alternativ som anges här blir tillgängliga via gränssnittet AnnotationProcessorEnvironment (för Java 5-processorer) eller ProcessingEnvironment (för Java 6-processorer). Processorerna får automatiskt tillgång till vissa alternativ. Att ange dem i dialogrutan har ingen effekt, eftersom de automatiskt tillhandahållna värdena åsidosätter alla värden som anges i dialogrutan. De automatiserade alternativen beskrivs här. Mer information om processoralternativ finns i avsnittet om indatadialogrutan Processoralternativ.