public interface ProcessingEnvironment
第三方可能希望提供周围设施对象的增值包装从这个接口,例如Filer
扩展,允许多处理器协调写出一个源文件。 为了实现这一点,在上下文中运行的处理器,其中通过API它们的副作用可能是彼此可见,该工具基础设施必须提供相应的设施对象.equals
, Filer
S中的.equals
,等等。 另外,必须能够配置工具调用,使得从正在运行的批注处理器的角度来看,至少所选择的辅助类子集被视为由同一类加载器加载。 (由于设备对象管理共享状态,包装类的实现必须知道相同的基础设施对象是否已被包装。)
Modifier and Type | Method and Description |
---|---|
Elements |
getElementUtils()
返回一些用于操作元素的实用方法的实现
|
Filer |
getFiler()
返回用于创建新的源,类或辅助文件的文件管理器。
|
Locale |
getLocale()
如果没有语言环境有效,则返回当前语言环境或
null 。
|
Messager |
getMessager()
返回用于报告错误,警告和其他通知的信使。
|
Map<String,String> |
getOptions()
返回传递给注解处理工具的处理器特定选项。
|
SourceVersion |
getSourceVersion()
|
Types |
getTypeUtils()
返回一些用于对类型进行操作的实用方法的实现。
|
Map<String,String> getOptions()
null
。
有关如何传递处理器特定选项的详细信息,请参阅特定工具基础架构的文档。 例如,命令行实现可以通过将处理器特定的选项前缀到已知的字符串(如"-A"
; 其他工具实现可以遵循不同的约定或提供替代机制。 给定的实现还可以提供实现特定的方法来查找传递给工具的选项以及处理器特定的选项。
Messager getMessager()
Filer getFiler()
Elements getElementUtils()
Types getTypeUtils()
SourceVersion getSourceVersion()
Processor.getSupportedSourceVersion()