註解處理器是一些公用程式,它們可以產生其他 Java 程式碼或其他檔案,並根據 Java 5 (JSR-175) 註解來產生問題標記。 這些處理器可能是以 Java 5 Mirror API 或 Java 6 註釋處理 API 為基礎。「註解處理」喜好設定窗格可配置適用於專案或工作區中的所有處理器的喜好設定。 Factory 路徑喜好設定窗格可指定啟用哪些處理器,也可配置個別的處理器。
依預設,註解處理是關閉的,您必須針對每個需要註解處理的專案來勾選這個框,才能開啟它。
只有在專案的程式碼需要註解處理器作業時,您才需要在專案中啟用註解處理。
只是在程式碼中含有註解,並不表示需要註解處理;例如,@Deprecated 和 @Override 註解通常便不需要處理。
如果啟用這個選項,每當在 Java 編輯器中進行變更及建置專案時,處理器都會執行。 讓處理器能夠在編輯器中執行,可使處理器在您輸入時能夠產生提出的錯誤和警告。例如,處理器會在不正確的註釋值加上紅色彎曲線,以指出編譯器無法獨自探索到的語意問題。不過,部分註釋處理器的速度相當慢,若在編輯器中執行,則會妨礙編輯器的可用性。 在此狀況下,停用此選項可以改進編輯器的效能。 每當建置專案時,處理器仍會執行。這個選項不適用於 Java 6 註釋處理器,Eclipse 目前只能在建置期間執行它們。
檔案會在相對於指定目錄的磁碟上產生。這個目錄依預設命名為 ".apt_generated",由於其開頭是 '.',因此會從「套件瀏覽器」視圖中過濾掉。產生的檔案會設定 "derived" 位元;當清除專案時,在產生的來源目錄下衍生的所有檔案都將會遭到移除。建議只在這個目錄中存放處理器所產生的檔案;請勿將任何手動建立的檔案放在此目錄下,也不要以現存的目錄作為產生的來源目錄。
這裡輸入的選項可透過 AnnotationProcessorEnvironment 介面(適用於 Java 5 處理器)或 ProcessingEnvironment 介面(適用於 Java 6 處理器)來使用。有些選項會自動提供給 Java 5 處理器;在這個對話框輸入這些選項沒有作用,因為自動提供的值會置換這裡所設定的任何值。 這裡說明自動選項。如需處理器選項的詳細資訊,請參閱處理器選項輸入對話框主題。