入門

Eclipse 中的 APT

APT 外掛程式藉由執行撰寫成在 Eclipse 內使用鏡映 API 的註解處理器,而在 Eclipse 中增加了 Java 5 註解處理支援。

當您在 Eclipse 內輸入時,會觸發這些註解處理器,它們會在編輯器內直接提供錯誤和警告,且會如同您是從指令行執行 Sun 的 Apt 工具一樣,產生正常的建置構件。

如需外掛程式如何運作的詳細資訊,您可以檢視 JDT-APT 專案網站

開啟註解處理

您必須在喜好設定中,在「Java -> 編譯器」之下,將專案的編譯器配置成使用 Java 5.0 層次標準:

「編譯器」喜好設定頁面的擷取畫面

之後,您必須在「Java -> 編譯器 -> 註解處理」之下,啟用註解處理。

「註解處理」內容頁面的擷取畫面

在這個對話框中,必要的話,您也可以指定產生的來源目錄,且可以提供任何必要的處理器選項。

附註:Eclipse 會將 "-Aclasspath" 和 "-Asourcepath" 選項自動傳給您的所有處理器,因此,您不需要提供它們。

新增註解處理器

您可以在「Java -> 編譯器 -> 註解處理 -> Factory 路徑」之下,將註解處理器加到專案中:

「Factory 路徑」內容頁面的擷取畫面

「Factory 路徑」和「來源控制」

Factory 路徑也類似於類別路徑,類似之處在於會與來源控制互動。 為了避免將 Factory JAR 路徑寫在程式中,您可以透過「新增 JAR...」按鈕來使用專案相對 JAR,也可以透過「新增變數」按鈕來使用類別路徑變數。

「處理器選項」和「來源控制」

您可能需要利用路徑來作為某些傳給註解處理器的選項。 同樣地,藉由避免將絕對路徑寫在程式中,您也可以在來源控制中共用您的配置。

為了做到這一點,我們支援在處理器選項中使用類別路徑變數。 變數兩端都必須用 % 來定界,且必須是路徑中的第一個區段。

因此,如果 FOO 是指向 d:/foo 的類別路徑變數,%FOO%/bar.txt 便會解析成 d:/foo/bar.txt。 類別路徑的解析會隨著類別路徑變數的存在而不同;如果不存在,便會將原始字串加到環境選項中。 不過,bar.txt(這個範例)不必存在。

保留的變數 ROOT 有特殊意義:它是工作區的根,用來引進專案資源。 因此比方說,如果專案名稱是 quux,%ROOT%/quux 便會解析成 quux 的絕對路徑,%ROOT%/quux/.classpath 會解析成 quux/.classpath 的絕對路徑。 當使用 ROO 時,路徑的第一個區段必須實際存在:在這個範例中,quux 專案必須存在,但 .classpath 不需要存在。