Начало работы

APT в Eclipse

Модуль APT реализует поддержку обработки аннотаций Java 5. В его состав входят процессоры приложений, пользующиеся API Mirror Eclipse.

Процессоры аннотаций вызываются по мере ввода текста программы в Eclipse. Они выдают сообщения об ошибках и предупреждения непосредственно в редакторе, а также создают обычные артефакты компоновки точно так же, как если бы вы инструмент Sun apt был запущен из командной строки.

Дополнительные сведения об этом модуле можно найти на сайте проекта JDT-APT.

Включение обработки аннотаций

Прежде всего нужно выбрать режим соответствия стандарту Java 5.0 в параметрах компилятора в окне Java->Компилятор:

Иллюстрация страницы параметров Компилятора

Затем нужно включить обработку аннотаций в окне Java->Компилятор>Обработка аннотаций:

Иллюстрация страницы параметров Обработка аннотаций

В этом окне можно также указать каталог для создаваемого исходного кода и другие опции процессора аннотаций.

Примечание: Eclipse автоматически передает опции "-Aclasspath" и "-Asourcepath" во все процессоры аннотаций, поэтому данные опции указывать не нужно.

Добавление процессоров аннотаций

Для добавления процессоров аннотаций к проекту нужно выбрать Java->Компилятор->Обработка аннотаций->Путь к фабрике:

Иллюстрация страницы параметров Путь к фабрике

Путь к фабрике и управление исходным кодом

Путь к фабрике интерпретируется примерно так же, как переменная classpath. Если вы не хотите указывать глобальные файлы jar фабрики, можно указать файлы jar для конкретного проекта. Для этого нужно нажать кнопку "Добавить jar..." или добавить соответствующий каталог в переменную classpath с помощью кнопки "Добавить переменную...".

Опции процессора и управление исходным кодом

В некоторых опциях компилятора нужно указывать пути к определенным каталогам и файлам. Если вы не будете указывать абсолютные пути, можно будет пользоваться одной и той же конфигурацией для управления исходным кодом во всех проектах.

Для этого предусмотрена возможность использовать переменную classpath в опциях процессора. Вокруг переменной должны быть указаны символы процентов (%), и она должна находиться в начале пути.

Например, если FOO - переменная classpath, указывающая на каталог d:/foo, выражение %FOO%/bar.txt будет указывать на файл d:/foo/bar.txt. Если переменная classpath задана, подставляется ее значение, а если нет - пустая строка. В то же время файл bar.txt из примера выше не обязательно должен существовать.

Зарезервированная переменная ROOT всегда указывает на корневой каталог рабочей области ресурса проекта. Например, если проекту присвоено имя quux, выражение %ROOT%/quux будет задавать абсолютный путь к quux, а %ROOT%/quux/.classpath - абсолютный путь к quux/.classpath. В выражениях с переменной ROOT первый сегмент пути должен существовать, то есть, в примере выше должен существовать проект quux, однако .classpath может и не существовать.