请参见:
描述
接口摘要 | |
---|---|
AnnotationMirror | 表示一个注释。 |
AnnotationValue | 表示注释类型元素的值。 |
AnnotationValueVisitor<R,P> | 注释类型元素值的 visitor,使用 visitor 设计模式的变体。 |
Element | 表示一个程序元素,比如包、类或者方法。 |
ElementVisitor<R,P> | 程序元素的 visitor,使用 visitor 设计模式的样式。 |
ExecutableElement | 表示某个类或接口的方法、构造方法或初始化程序(静态或实例),包括注释类型元素。 |
Name | 字符的不可变序列。 |
PackageElement | 表示一个包程序元素。 |
TypeElement | 表示一个类或接口程序元素。 |
TypeParameterElement | 表示一般类、接口、方法或构造方法元素的形式类型参数。 |
VariableElement | 表示一个字段、enum 常量、方法或构造方法参数、局部变量或异常参数。 |
枚举摘要 | |
---|---|
ElementKind | 元素的 kind 。 |
Modifier | 表示程序元素(如类、方法或字段)上的修饰符。 |
NestingKind | 某一类型元素的嵌套种类 (nesting kind)。 |
异常摘要 | |
---|---|
UnknownAnnotationValueException | 指示遇到一个未知种类的注释值。 |
UnknownElementException | 指示遇到一个未知种类的元素。 |
用于 Java 编程语言的模型元素的接口。
当在注释处理的上下文中使用时,必须返回要表示的元素的准确模型。因为这是一个语言模型,所以源代码提供相关构造的基准(引用)表示形式,而不是 executable 输出(如类文件)中的表示形式。executable 输出可作为创建建模元素的基础。不过,将源代码转换为 executable 输出的过程中可能不允许恢复源代码表示形式的某些方面。例如,无法从类文件恢复带有 source retention 的注释,并且类文件无法提供源位置信息。某一元素上的修饰符在某些情况下可能有所不同,这些情况包括:
strictfp
final
protected
、private
和 static
进行注释处理期间,必然会在不完整或错误的程序上进行操作;但是,有关所得模型特性的保证更少。如果源代码在语法结构上不是很好,则可能会提供一个模型作为实现问题的质量。如果某一程序在语法上是有效的,但在其他某些方面有问题,则返回模型包含的信息不得少于程序中所有方法正文被 "throw new RuntimeException();"
替代时所包含的信息。如果某一程序引用缺失类型 XYZ,则返回模型包含的信息不得少于类型 XYZ 的声明被假定为 "class XYZ {}"
、"interface XYZ {}"
、"enum XYZ {}"
或 "@interface XYZ {}"
时所包含的信息。如果某一程序引用缺失类型 XYZ<K1, ... ,Kn>
,则返回模型包含的信息不得少于 XYZ 的声明被假定为 "class XYZ<T1, ... ,Tn> {}"
或 "interface XYZ<T1, ... ,Tn> {}"
时所包含的信息。
除非在特定实现中另行指定,否则此包中的方法所返回的集合应该是不能由调用者修改的,并且对于并发访问是不安全的。
除非另行指定,否则,如果给定一个 null
参数,此包中的方法将抛出 NullPointerException
。