您可以使用兩種方法開啟延伸點綱目編輯器:依產品建立新延伸點或開啟現存的 延伸點綱目。依慣例,新綱目的名稱與含有 .exsd 副檔名的延伸點 ID 同名。 它們存放在外掛程式目錄樹中的 schema 目錄。
在 PDE 建立新延伸點時,也會建立起始綱目檔而且會開啟綱目編輯器供您編輯。 您可以立即定義綱目或關閉它,等以後再定義它。 製作完整延伸點綱目可讓 PDE 對延伸點的使用者提供自動協助。
PDE 綱目編輯器依據與外掛程式 Manifest 編輯器相同的概念。它有兩個表單 頁面和一個程式碼頁面。因為 XML 綱目是細節而且它的來源形式很難令人 讀懂,所以您應該使用表單頁面執行大部分編輯。對於閱讀結果程式碼來說,程式碼頁面很有用。
我們先前已建立「範例剖析器」延伸點和起始綱目。 現在可以移至專案的 schema 資料夾並按兩下 parsers.exsd 檔案來 開啟綱目。這樣會開啟綱目編輯器。
我們要執行下列作業:
每一個延伸點綱目以 "extension" 元素的宣告為開頭。 我們會新增稱名為 "parser" 的 XML 元素。
目前為止,綱目編輯器應如下:
現在我們要新增另一個屬性,該屬性從離散的選項清單選取值。這表示我們需要建立基礎 string 類型的列舉限制。另外,我們會設定屬性的預設值。
限制對話框應如下:
關閉對話框時,變更 "use" 屬性成為 "default",變更 "value" 屬性成為 "always "。這樣會建立預設值。請注意:當您輸入這個值時狀態行會顯示 錯誤訊息,因為它限制有效值為三個列舉選項。 結束輸入之後,錯誤訊息會消失,因為 "always" 是有效值。
現在我們已定義所有元素和屬性,接下來我們需要定義文法。 我們的目標是定義 "extension" 元素可以有任何數目的 "parser" 元素作為子項。
定義文法之後,文法區段下面的 DTD 近似值說明在 DTD 中選取的 元素的文法會呈現什麼外觀。提供這個資訊來協助比較偏好使用 DTD 而不是 XML 綱目的開發人員。
現在我們已定義有效元素、屬性和文法,我們需要提供關於延伸點 的部分資訊。 有兩種綱目文件片段類型:
綱目處理的「定義」頁面提供第一個片段類型。 選取元素和屬性時,您可以在「說明」區段新增關於它們的短提示文。 預期的格式是程式 HTML(Javadoc 也相同)而且會如實複製文字到最終參考文件。
現在我們必須提供延伸點本身的短提示文說明。 為了提供該說明,我們切換至「文件」頁面:
使用這個延伸點插入其他剖析器。
實際上剖析器並沒有作用 - 我們只是使用它們作為延伸點綱目範例。
下列是延伸點用法的範例:
<p>
<pre>
<extension point="com.example.xyz.parsers">
<parser
id="com.example.xyz.parser1"
name="Sample Parser 1"
class="com.example.xyz.SampleParser1">
</parser>
</extension>
</pre>
</p>
接著請按套用。
需要延伸這個延伸點的外掛程式必須實作
<samp>com.example.xyz.IParser</samp> 介面。
XYZ 外掛程式提供了剖析器的預設實作。
接著請按套用。附註:提供範例時必須採取特殊考量。 通常 PDE 會將提供的文字視為程式 HTML 而且將換行和空格只當作一個字元(例如 ,可忽略的空格)。 以一般文字來說我們期望這種情形,但是當提供範例時則非常令人困擾,因為範例外 觀要求美觀,所以跳欄和垂直對齊就很重要。 PDE 有這個狀況的折衷方案:如果它偵測到 HTML 標示 <pre>,那麼它會依現 狀使用內容(保留全部字元而不修改)直到看到關閉標示 </pre> 為止。 這就是為什麼我們能提供類似上述的範例,而且有信心它在最終參考文件中會有很美 的外觀。
當您輸入文件時您可能已注意到編輯器「概要」視圖中有愈來愈多元素獲得 "pen" 影像套印格式。 這個小型指示器告訴您有問題的元素有一些相關的文字 - 這是檢查文件是否 有遺漏的快速方法。
完成文件之後,我們就可以查看參考文件。做法有兩種。在您工作期間, 您可以從蹦現功能表選取「預覽參考文件」項目,來預覽參考文件。 另外,您可以設定 PDE 喜好設定(喜好設定>外掛程式開發>編譯器,位在「綱目」標籤之下), 來自動根據每一個綱目檔變更,建立參考文件。 不管建立它的方法為何,這個範例的結果文件看起來像這樣。