Интерфейс ProcessingEnvironment

public interface ProcessingEnvironment

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

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