Package javax.lang.model.element
for
循环或try
- finally
块的表示。 但是,接口可以模拟仅出现在方法体内的一些结构,例如局部变量和匿名类。 当在注释处理的上下文中使用时,必须返回所表示的元素的准确模型。 由于这是一种语言模型,源代码提供了所讨论的构造的基准(参考)表示,而不是类似于类文件的可执行输出中的表示。 可执行输出可以作为创建建模元素的基础。 但是,将源代码转换为可执行输出的过程可能不允许恢复源代码表示的某些方面。 例如,无法从类文件中恢复source retention的注释,并且类文件可能无法提供源位置信息。 参数名称可能无法从类文件中恢复。 从类文件创建的元素上的modifiers在某些情况下可能与源文件创建的相同声明的元素不同,包括:
- 类或接口上的
strictfp
- 参数号为
final
-
protected
,private
和static
的类和接口
在注释处理期间,必须对不完整或错误的程序进行操作; 但是,对所得模型的性质的保证较少。 如果源代码在语法上没有良好形成或者具有一些其他无法恢复的错误,而这些错误无法通过生成新类型而被删除,则可能会或可能不会提供模型作为实现质量问题。 如果程序在语法上有效但在某些其他方式上有误,则任何返回的模型必须具有的信息不会少于程序中的所有方法体被"throw new RuntimeException();"
替换的"throw new RuntimeException();"
。 如果一个程序是指缺少类型xyz,则返回模型必须包含不超过若类型XYZ三个声明被假定为是较少的信息"class Xyz {}"
, "interface Xyz {}"
, "enum Xyz {}"
,或"@interface Xyz {}"
。 如果程序引用缺失类型Xyz<K1, ... ,Kn>
,则返回的模型必须包含的信息不会少于假设"class Xyz<T1, ... ,Tn> {}"
的声明为"class Xyz<T1, ... ,Tn> {}"
或"interface Xyz<T1, ... ,Tn> {}"
除非在特定实现中另有规定,否则该包中的方法返回的集合应该是调用者不可修改的并且对于并发访问是不安全的。
除非另有说明,在此包中的方法将抛出一个NullPointerException
如果给一个null
说法。
- 从以下版本开始:
- 1.6
-
接口摘要 接口 描述 AnnotationMirror 表示注释。AnnotationValue 表示注释类型元素的值。AnnotationValueVisitor<R,P> 使用访问者设计模式的变体访问注释类型元素的值。Element 表示程序元素,例如模块,包,类或方法。ElementVisitor<R,P> 程序元素的访问者,以访问者设计模式的风格。ExecutableElement 表示类或接口的方法,构造函数或初始化程序(静态或实例),包括注释类型元素。ModuleElement 表示模块程序元素。ModuleElement.Directive 表示此模块声明中的指令。ModuleElement.DirectiveVisitor<R,P> 模块指令的访问者,以访问者设计模式的样式。ModuleElement.ExportsDirective 导出的模块包。ModuleElement.OpensDirective 一个打开的模块包。ModuleElement.ProvidesDirective 模块提供的服务的实现。ModuleElement.RequiresDirective 模块的依赖关系。ModuleElement.UsesDirective 对模块使用的服务的引用。Name 不可变的字符序列。PackageElement 表示包程序元素。Parameterizable 具有类型参数的元素的mixin接口。QualifiedNameable 具有限定名称的元素的mixin接口。TypeElement 表示类或接口程序元素。TypeParameterElement 表示泛型类,接口,方法或构造函数元素的正式类型参数。VariableElement 表示字段,枚举
常量,方法或构造函数参数,局部变量,资源变量或异常参数。 -
枚举摘要 Enum 描述 ElementKind 一个元素的kind
。Modifier 表示程序元素(例如类,方法或字段)上的修饰符。ModuleElement.DirectiveKind 指令的kind
。NestingKind 嵌套类型的元素。 -
异常摘要 异常 描述 UnknownAnnotationValueException 表示遇到了未知类型的注释值。UnknownDirectiveException 表示遇到了未知类型的模块指令。UnknownElementException 表示遇到了未知类型的元素。