Интерфейс ProcessingEnvironment

public interface ProcessingEnvironment

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

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