|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 上一个软件包 下一个软件包 | 框架 无框架 | |||||||||
请参见：
描述
| 接口摘要 | |
|---|---|
| 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。
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 上一个软件包 下一个软件包 | 框架 无框架 | |||||||||
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。