Package javax.lang.model.element
for循环或try-finally块。但是，这些接口可以模拟一些仅出现在方法体内的结构，如局部变量和匿名类。
在注解处理的上下文中使用时，必须返回所表示元素的准确模型。由于这是一个语言模型，源代码提供了所讨论构造的基准（参考）表示，而不是类文件等可执行输出中的表示。可执行输出可能用作创建建模元素的基础。然而，将源代码转换为可执行输出的过程可能无法恢复源代码表示的某些方面。例如，具有source retention的注解无法从类文件中恢复，类文件可能无法提供源位置信息。无法从类文件中恢复参数的名称。从类文件创建的元素上的修饰符在某些情况下可能与从源文件创建的相同声明的元素不同，包括：
- 类或接口上的
strictfp - 参数上的
final - 类和接口上的
protected、private和static
在注解处理期间，操作不完整或错误的程序是必要的；但是，关于生成模型的性质，没有太多的保证。如果源代码在语法上不完整或具有其他无法通过生成新类或接口来消除的错误，可能会或可能不会提供模型作为实现质量问题。如果类或接口的程序在语法上有效但在其他方面存在错误，任何返回的模型必须至少不会比如果程序中的所有方法体都被替换为"throw new RuntimeException();"时的信息少。如果程序引用缺失的类或接口Xyz，则返回的模型必须包含的信息至少不会比假定类或接口Xyz的声明为"class Xyz {}"、"interface Xyz {}"、"enum Xyz {}"、"@interface Xyz {}"或 "record Xyz {}"时的信息少。如果程序引用缺失的类或接口Xyz<K1, ... ,Kn>，则返回的模型必须包含的信息至少不会比假定Xyz的声明为"class Xyz<T1, ... ,Tn> {}"或"interface Xyz<T1, ... ,Tn> {}"时的信息少。
除非在特定实现中另有规定，此包中方法返回的集合应该被调用者视为不可修改且不安全以供并发访问。
除非另有规定，此包中的方法在给定null参数时将抛出NullPointerException。
- 参见Java语言规范：
-
6.1 声明
7.4 包声明
7.7 模块声明
8.1 类声明
8.3 字段声明
8.4 方法声明
8.5 成员类和接口声明
8.8 构造函数声明
9.1 接口声明
- 自版本：
- 1.6
- 另请参见：
-
ClassDescription表示一个注解。表示注解接口元素的值。注解接口元素值的访问者，使用访问者设计模式的变体。表示程序元素，如模块、包、类或方法。元素的
kind。ElementVisitor<R,P> 程序元素的访问者，采用访问者设计模式的风格。表示类或接口的方法、构造函数或初始化程序（静态或实例），包括注解接口元素。表示程序元素（如类、方法或字段）上的修饰符。表示模块程序元素。表示此模块声明中的指令。指令的kind。模块指令的访问者，采用访问者设计模式的风格。模块的导出包。模块的开放包。模块提供的服务的实现。模块的依赖关系。模块使用的服务的引用。一个不可变的字符序列。类型元素的嵌套类型。表示包程序元素。具有类型参数的元素的混合接口。具有限定名称的元素的混合接口。表示记录组件。表示类或接口程序元素。表示泛型类、接口、方法或构造函数元素的形式类型参数。表示遇到未知类型的注解值。表示遇到未知类型的模块指令。表示遇到未知类型的元素。表示字段、enum常量、方法或构造函数参数、局部变量、资源变量或异常参数。