使用延伸點綱目
您自己的外掛程式和其他外掛程式可以使用工作區中的外掛程式定義的延伸點。
如果已經為它定義延伸點綱目,那麼在建立新延伸時 PDE 可以提供協助。
這個協助包括:
- 提供新建蹦現功能表的選項以便只新增有效的子元素。
- 提供內容表的屬性資訊以便只設定有效屬性。
- 提供正確屬性內容編輯器,這些編輯器符合屬性類型(boolean、string 和
enumeration)。
- 提供特殊屬性類型的其他支援("java" 和 "resource"
)。
- 在內容表選取時使用狀態行顯示屬性的文件片段的第一個句子。
範例:使用「範例剖析器」女延伸點
使用先前定義的延伸點之前,我們仍需要定義預期的介面。
您可以在導覽器中選取 com.example.xyz 專案,
然後按
工具列按鈕,建立新的 Java 介面。
請務必將套件名稱設為 com.example.xyz,把介面名稱設為 IParser,然後再按完成。
接著再編輯介面,改成如下所示的內容:
package com.example.xyz;
public interface IParser {
/**
* 使用提供的模式執行剖析器 */
public void parse(int mode);
}
現在我們有延伸點、它的 XML 綱目以及必要介面。
一定要儲存所有開啟的編輯器。現在我們自己的外掛程式或其他外掛程式可
以提供給延伸點。
- 開啟 com.example.xyz 外掛程式的 Manifest 編輯器。
- 切換到「延伸」頁,按新建 > 延伸。
- 這時畫面上應該會出現一個選項 "com.example.xyz.parsers"。
請選取它,然後按完成。
- 選取剛剛新增的 "com.example.xyz.parsers" 元素,接著會出現新建 > 剖析器功能表。
(我們指定延伸點可以容納任何數目的「剖析器」元素。)
- 選取新的剖析器元素。
「延伸元素詳細資料」區段應該會顯示四個屬性:id、name、 class 和 mode。
選取屬性時,請注意狀態行如何顯示關於它們的簡短資訊。
這個資訊是直接來自延伸點綱目。
- 將 name 改為 "Default Parser"。
然後將 mode 改為 "manual。"
- 按一下「延伸元素詳細資料」區段中的類別超鏈結。
這時您會看到,PDE 完美的整合到 JDT 的「新建 Java 類別」精靈中,
並且使用綱目屬性,自動實作您的 IParser 介面。
建立類別時,請以 "com.example.xyz/src" 作為來源資料夾,
以 "com.example.xyz" 作為套件,並且以 DefaultParser 作為類別名稱。
然後按完成。
- 現在您應該已開啟 DefaultParser 類別的 Java 編輯器。
請注意它如何實作正確介面 (IParser) 而且已經有 "parse" 方
法的 Stub 實作。
請注意,如果您關閉編輯器,然後再按一下類別超鏈結,編輯器會重新開啟 DefaultParser 類別。
不過,只有找不到在類別屬性文字欄位中所指定的類別時,才會出現「新建 Java 類別」精靈,
其他時候,鏈結是在編輯器中開啟類別。
當您提供延伸點的完整 XML 綱目時,您會發現它讓 PDE 協助您的潛在使用
者而且避免他們犯錯。
