javax.lang.model.element

接口
异常
用于 Java 编程语言的模型元素的接口。

请参见:
          描述

接口摘要
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 指示遇到一个未知种类的元素。
 

软件包 javax.lang.model.element 的描述

用于 Java 编程语言的模型元素的接口。

当在注释处理的上下文中使用时,必须返回要表示的元素的准确模型。因为这是一个语言模型,所以源代码提供相关构造的基准(引用)表示形式,而不是 executable 输出(如类文件)中的表示形式。executable 输出可作为创建建模元素的基础。不过,将源代码转换为 executable 输出的过程中可能不允许恢复源代码表示形式的某些方面。例如,无法从类文件恢复带有 source retention 的注释,并且类文件无法提供源位置信息。某一元素上的修饰符在某些情况下可能有所不同,这些情况包括:

  • 某个类或接口上的 strictfp
  • 某个参数上的 final
  • 类和接口上的 protectedprivatestatic
此外,类文件中的复合构造方法(例如,用来实现嵌套类的存取方法和用来实现协变返回的 bridge 方法)是此模型以外的转换产物。

进行注释处理期间,必然会在不完整或错误的程序上进行操作;但是,有关所得模型特性的保证更少。如果源代码在语法结构上不是很好,则可能会提供一个模型作为实现问题的质量。如果某一程序在语法上是有效的,但在其他某些方面有问题,则返回模型包含的信息不得少于程序中所有方法正文被 "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

从以下版本开始:
1.6