軟體套件 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
• 類別和介面上的 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