建立好視覺化程式外掛程式之後,您就已準備好,可以開始更新它的 plugin.xml 檔。
如果要更新視覺化程式外掛程式的 plugin.xml 檔,請執行下列動作:
- 開啟要編輯的 plugin.xml 檔。
- 在 <runtime> 標示之後,緊接著加入下列標示。
請注意,我們使用的日期和時間範例是參照明確的視覺化自訂標示 (VCT)。
<requires>
<import plugin="com.ibm.etools.webedit.core"/>
</requires>
<extension point="com.ibm.etools.webedit.core.visualCustomTag">
<vtaglib uri="/WEB-INF/lib/sample.jar">
<vtag name="date"
class="com.ibm.etools.webedit.vct.sample.DateTimeTagVisualizer"
description="Dynamically outputs current date and time"/>
</vtaglib>
</extension>
在上述範例中,您利用 <requires> 和 <import> 元素來指定視覺化程式外掛程式需要哪些其他外掛程式。
之後,您匯入了 com.ibm.etools.webedit.core 外掛程式,且利用 <extension> 元素來指定這個外掛程式要提供什麼。
這個外掛程式會連接至 <extension> 元素的 point 屬性所指定的延伸點。
<vtaglib> 元素類似於 <taglib>,用來指定可用的 VCT。
<vtaglib> 元素的 URI 屬性是 VCT 的 ID。
當 Page Designer 發現自訂標示時,它會尋找宣告自訂標示的 taglib 指引。
它會取得 taglib 指引的 URI 屬性值,且會試圖比對它和 <vtaglib> 元素的 URI 屬性。
當找到相符者時,會利用這個外掛程式來視覺化自訂標示。
因此,<vtaglib> 元素之 URI 屬性的值必須與 JSP 頁面的 taglib 指引所指定的 URI 值相同,視覺化程式才能運作。
<vtag> 元素指定 VCT 的名稱和視覺化程式 Java™ 類別。
在範例中,標示是 date,所執行的視覺化程式是 com.ibm.etools.webedit.vct.sample.DateTimeTagVisualizer。
您可以在 description 屬性中寫一些註解。
- 在建立 JSP 檔之前,您必須先新增其他外掛程式。
- 從功能表列中,選取。這時會出現喜好設定頁面。
- 從清單中,選取。按一下不在工作區中,再按一下確定。
- 更新 Java 類別路徑來併入匯入的外掛程式類別:org.apache.xerces 和 com.ibm.etools.webedit.core。
- 用滑鼠右鍵按一下套件瀏覽器中的外掛程式專案。
從蹦現功能表中,選取更新類別路徑。這時會開啟 Java 類別路徑對話框。
- 按一下完成。這時會更新外掛程式專案的 Java 類別路徑來併入這兩個外掛程式。
現在,您已準備好,可以開始在 JSP 頁面中使用視覺化自訂標示。