compact3

javax.annotation.processing

Interface ProcessingEnvironment

public interface ProcessingEnvironment

注释处理工具框架将 provide an annotation processor with an object implementing this interface使处理器可以使用框架提供的设施来写入新的文件，报告错误信息，并找到其他公用事业。

第三方可能提供的价值从这个界面添加设施周围物体的包装，如Filer扩展，允许多个处理器协调书写了一个源文件。使这对处理器运行在上下文中，它们的副作用可以通过API相互可见，工具的基础设施必须提供相应的设备对象，.equals，Filers，.equals，等等。此外，工具调用必须能够被配置成这样，从运行注释处理器的角度来看，至少所选择的辅助类的子集被视为由同一类装载器加载。（由于设备对象管理共享状态，包装类的实现必须知道同一个基础设施对象是否已被包过。）

从以下版本开始：

一点六

方法摘要

Modifier and Type	Method and Description
Elements	getElementUtils() 返回用于操作元素的一些实用方法的实现
Filer	getFiler() 返回文件用于创建新的源类，或辅助文件。
Locale	getLocale() 返回当前的区域设置或 null如果没有现场效果。
Messager	getMessager() 返回用于报告错误，鬼使神差的警告，以及其他注意事项。
Map<String,String>	getOptions() 返回传递给注释处理工具的处理器特定选项。
SourceVersion	getSourceVersion() 返回源版本生成的任何 source和 class文件应符合。
Types	getTypeUtils() 返回操作类型的一些实用方法的实现。

方法详细信息

getOptions

Map<String,String> getOptions()

返回传递给注释处理工具的处理器特定选项。选项以从选项名称到选项值的映射形式返回。对于没有价值的期权，在Map的相应值 null。

有关如何通过处理器特定选项的详细信息，请参阅特定工具基础架构的文档。例如，一个命令行执行可能由前缀与已知的弦"-A"区分处理器特定的选项；其他工具的实现可能遵循不同的规则或提供替代机制。一个给定的实现也可以提供实现特定的方法找到选项传递到工具，除了处理器特定的选项。

结果

处理器特定的选项传递给该工具

getMessager

Messager getMessager()

返回用于报告错误，鬼使神差的警告，以及其他注意事项。

结果

的信使

getFiler

Filer getFiler()

返回文件用于创建新的源类，或辅助文件。

结果

滤波器

getElementUtils

Elements getElementUtils()

返回用于操作元素的一些实用方法的实现

结果

元工具

getTypeUtils

Types getTypeUtils()

返回操作类型的一些实用方法的实现。

结果

型公用事业

getSourceVersion

SourceVersion getSourceVersion()

返回源版本生成的任何 source和 class文件应符合。

结果

生成源文件和类文件的源版本应符合

另请参见：

Processor.getSupportedSourceVersion()

getLocale

Locale getLocale()

返回当前的区域设置或 null如果没有现场效果。现场可以被用来提供本地化的 messages。

结果

当前的区域或 null如果没有现场效果