Процессоры аннотаций - это программы, создающие дополнительный код и дополнительные файлы Java, а также помечающие потенциальные ошибки в соответствии с аннотациями Java 5 (JSR-175). Процессоры могут быть либо на базе Java 5 Mirror APIs, либо обработки аннотаций API Java 6 . В окне параметров обработки аннотаций можно задать глобальные параметры, распространяющиеся на все процессоры в проекте или рабочей области. В панели параметров пути к фабрикам можно задать конфигурацию отдельных процессоров.
По умолчанию обработка аннотаций отключена. При необходимости ее нужно включать для каждого
проекта по отдельности. Обработку аннотаций нужно включать для того, чтобы процессоры аннотаций
обрабатывали код проекта. Само по себе наличие аннотаций в коде не значит, что они должны обрабатываться.
Например, аннотации @Deprecated и @Override обычно не требуют обработки.
Когда данная опция включена, процессоры запускаются каждый раз, когда в редакторе Java производятся изменения, а также каждый раз, когда компонуется проект. Включения процессоров в редакторе позволяет им, генерировать новые типы Java и добавлять уведомления об ошибках и предупреждения. Например, процессоры могут пометить красной тильдой неверное значение аннотации для того, чтобы указать на семантическую ошибку, которую сам компилятор не смог бы обнаружить. Однако, некоторые процессоры аннотаций настолько медленные, что их запуск в редакторе приводит к тому, что использовать его становится проблематичным. В такой ситуации отключение данной опции может увеличить скорость работы редактора. Процессоры все равно будут запускаться каждый раз при компоновке проекта.Данная опция неприменима к процессорам аннотаций Java 6, которые можно запустить с помощью Eclipse (в данный момент) только в процессе компоновки.
Файлы с исходным кодом будут создаваться в подкаталогах указанного каталога. По умолчанию этому каталогу присвоено имя ".apt_generated", который после запуска не показан в окне Структура пакетов. Для файлов, создаваемых процессорами аннотаций, устанавливается бит "derived" (производный файл). Все производные файлы удаляются из каталога исходного кода в процессе очистки. Рекомендуется хранить в этом каталоге только файлы, создаваемые процессорами, и не помещать в них никакие другие файлы. По этой же причине не следует указывать в данной опции существующий каталог, в котором уже есть какие-либо файлы.
Указанные здесь опции доступны посредством интерфейса AnnotationProcessorEnvironment (для процессоров Java 5) или интерфейса ProcessingEnvironment (для процессоров Java 6). Некоторые опции передаются процессорам Java 5 автоматически; и их изменение в этом окне не повлияет ни на что, поскольку у значений, подставляемых автоматически, приоритет выше, чем у значений, указанных в этом окне. Информация об автоматических опциях приведена в этом разделе. Дополнительные сведения об опциях процессоров приведены в разделе окно ввода опций процессоров.