javax.lang.model.element

描述

javax.lang.model.element用於 Java 程式語言的模型元素的接口。

當在注釋處理的上下文中使用時，必須返回要表示的元素的準確模型。因為這是一個語言模型，所以原始碼提供相關構造的基準（引用）表示形式，而不是 executable 輸出（如類檔案）中的表示形式。executable 輸出可作為創建建模元素的基礎。不過，將原始碼轉換為 executable 輸出的過程中可能不允許恢復原始碼表示形式的某些方面。例如，無法從類檔案恢復帶有 sourceretention 的注釋，並且類檔案無法提供源位置信息。某一元素上的修飾符在某些情況下可能有所不同，這些情況包括：

某個類或接口上的 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。

摘要

接口摘要


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

基本介紹

描述

摘要

接口摘要

枚舉摘要

異常摘要

熱門詞條