Интерфейс ProcessingEnvironment

public interface ProcessingEnvironment

Фреймворк инструментария для обработки аннотаций предоставит процессору аннотаций объект, реализующий этот интерфейс, чтобы процессор мог использовать средства, предоставляемые фреймворком, для создания новых файлов, сообщения об ошибках и поиска других утилит.

Третьи стороны могут захотеть предоставить расширяющие обертки вокруг объектов средств из этого интерфейса, например, расширение Filer, которое позволяет нескольким процессорам координировать запись одного исходного файла. Для этого, чтобы процессоры, работающие в контексте, где их побочные эффекты через API могут быть видны друг другу, инфраструктура инструментария должна предоставлять соответствующие объекты средств, которые являются .equals, Filers, которые являются .equals, и так далее. Кроме того, вызов инструментария должен иметь возможность быть настроенным таким образом, чтобы с точки зрения работающих процессоров аннотаций, по крайней мере, выбранный подмножество вспомогательных классов рассматривалось как загруженное одним и тем же загрузчиком классов. (Поскольку объекты средств управляют общим состоянием, реализация класса-обертки должна знать, обернут ли ранее тот же базовый объект средства или нет.)

Методы

getOptions

Map<String,String> getOptions()

Возвращает:

опции, специфичные для процессора, переданные инструменту

getMessager

Messager getMessager()

Возвращает messager, используемый для отчёта об ошибках, предупреждениях и других сообщениях.

Возвращает:

messager

getFiler

Filer getFiler()

Возвращает фильтр, используемый для создания новых исходных, class или вспомогательных файлов.

Возвращает:

фильтр

getElementUtils

Elements getElementUtils()

Возвращает реализацию некоторых утилит для работы с элементами

Возвращает:

утилиты элементов

getTypeUtils

Types getTypeUtils()

Возвращает реализацию некоторых утилит для работы с типами.

Возвращает:

утилиты типов

getSourceVersion

SourceVersion getSourceVersion()

Возвращает версию исходного кода, которой должны соответствовать все созданные исходные и class файлы.

Возвращает:

версия исходного кода, которой должны соответствовать созданные исходные и class файлы

См. также:

Processor.getSupportedSourceVersion()

getLocale

Locale getLocale()

Возвращает текущий locale или null, если locale не задан. Locale может использоваться для предоставления локализованных сообщений.

Возвращает:

текущий locale или null, если locale не задан