延伸點綱目

延伸是外掛程式用來新增特性到平台的主要機制。無法任意建立延伸。它 們是使用延伸點定義的明確規格來宣告。

每一個延伸必須符合它要延伸的延伸點的規格  每一個延伸點定義的 屬性和期望值必須由一個延伸宣告。這個資訊保存在平台外掛程式登錄中。延伸點從登錄提供查詢這些值,所以一定要確定外掛程式有提供預期的資訊。

以最基礎形式而言,延伸點宣告是很簡單的。它定義延伸點的 ID 和名稱。延伸點所預期的其他資訊是該延伸點的特定資訊而且記錄在其他地方。(關於平台延伸點定義的資訊,請參閱 Platform Extension Point Reference 。)

參考文件很有用,但是它不啟用任何以程式計設的方式說明以驗證延伸的規格。 因為這個原因,PDE 引入延伸點綱目,該綱目以適合自動處理的格式說明延伸點。

按照 W3C 規格的定義,延伸點綱目是有效的 XML 綱目。 不過,完整的 XML 綱目規格很複雜,而且這個特定用法並不需要。 因為這個原因,PDE 只使用一個 XML 綱目特性子集。每一個延伸點綱目都 是有效的 XML 綱目,但是 PDE 沒有使用所有可用的特性。

延伸點綱目的優點

使用 PDE 延伸點 XML 綱目來說明延伸點有許多優點:

  1. 延伸點文法允許正式表示元素、屬性和類型。 工具可以使用這個資訊驗證延伸或在建立延伸時提供協助。
  2. XML 綱目提供類似 Java 原始檔中的 Javadoc 的文件附註。 這個機制連結有效元素和屬性的短提示文到這些元素和屬性的宣告。 保持文件同步更容易,因為移除屬性也會移除屬性的文件。不需要更新參考 文件。
  3. 可以產生參考文件。PDE 提供一個工具,該工具追蹤延伸點綱目的變 更並快速地更新參考文件。
  4. 您可以提供關於處理綱目的工具可以使用的延伸點的其他 Meta 資料。 PDE 使用這個機制新增有關元素和屬性的其餘資訊。 例如,如果一個屬性標示成 "Java",那麼在設定這個屬性的值時 PDE 可以透過與 Java 平台特性交談提供協助。

PDE XML 綱目支援的限制

PDE 使用一個小型 XML 綱目子集。在這個特定情況中使用完整的 XML 綱目特性集可能太過誇張。 此子集允許幾乎從 DTD 到綱目的 1->1 對映,但沒有 DTD 限制。 下列是 PDE 延伸點綱目的主要限制:

  1. 只允許廣域元素宣告。
  2. 只允許本端屬性宣告。無法宣告廣域屬性。
  3. 支援下列組合:所有序列選項群組
  4. 沒有廣域類型支援。必須宣告類型並立即使用。
  5. 屬性只能有 stringboolean 類型。
  6. 如果屬性是 string 類型,那麼只支援列舉限制。

如果使用這些限制撰寫 XML 綱目,您會發現結果檔非常類似定義相同文法的對等 DTD。 綱目的優點位於附註內(文件和 Meta 資料)。 另一個優點是 XML 綱目本身是以 XML 撰寫,所以更容易處理和讀取。

上述清單僅供參考。 建議您使用 PDE 綱目編輯器(此編輯器產生正確檔案)定義 XML 綱目。

 
Copyright IBM Corporation and others 2000, 2003