javax.lang.model.element (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM Platform
Standard Ed. 6

上一个软件包 下一个软件包

框架 无框架

软件包 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 常量、方法或构造方法参数、局部变量或异常参数。

接口摘要
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)。

枚举摘要
ElementKind	元素的 `kind`。
Modifier	表示程序元素（如类、方法或字段）上的修饰符。
NestingKind	某一类型元素的嵌套种类 (nesting kind)。

异常摘要

UnknownAnnotationValueException 指示遇到一个未知种类的注释值。

UnknownElementException 指示遇到一个未知种类的元素。

异常摘要
UnknownAnnotationValueException	指示遇到一个未知种类的注释值。
UnknownElementException	指示遇到一个未知种类的元素。

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

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

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

某个类或接口上的 strictfp
某个参数上的 final
类和接口上的 protected、private 和 static

此外，类文件中的复合构造方法（例如，用来实现嵌套类的存取方法和用来实现协变返回的 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

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM Platform
Standard Ed. 6

上一个软件包 下一个软件包

框架 无框架

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。