當你想把 XML 資料轉換成固定寬度的純文字字串——這正好是 XSLT 比較不擅長的工作——或者想在 XML 檔裡執行某種文字替換時,該怎麼辦?在這些超出 XSLT 原生能力的情況下,你可以直接在你的 XSLT 處理器裡呼叫 Java 函式來完成。
我看過有人用 VBScript、JScript 之類的指令碼語言(搭配微軟的解析器)來做特殊處理,但如何用 Java 來達成同樣目的,就不是那麼顯而易見了。簡單來說,做法是透過 XML 命名空間(namespace),在 XSLT 處理器中呼叫 Java 函式。Java 與 XSLT 的結合,為打造穩健的應用程式提供了強而有力的手段。
命名空間是一種透過統一資源識別符(URI)來修飾 XSL 中元素與屬性名稱的機制。舉例來說,常見的 XSL 元素需要加上 xsl 前綴,而這個前綴是透過 XSLT 命名空間 URI 來宣告的:
XMLns:xsl="https://www.w3.org/1999/XSL/Transform"
但你並不局限於 XSLT 命名空間,完全可以自由宣告自己的命名空間,用來標示自訂的 XSLT 標籤與範圍。
要呼叫外部函式,必須使用自訂的命名空間前綴,例如 mynspace:function();其中前綴 mynspace 必須關聯到一個命名空間 URI,例如:
xmlns:myspace="d:///XMLprogs/mynamespace"
一般的 Java 綁定,會用命名空間 URI 來標示 Java 類別函式的位置。以本文範例所用的 Xalan XSLT 處理器(版本 1.2.2)而言,命名空間 URI 必須採 URI-stem/packagename 的形式。如果你用的是 XT,命名空間則應寫成:
xmlns:mynspace="d://XMLprogs/mynamespace.myclassname"
在這種情況下,你就能在 XSLT 程式碼中呼叫來自 myclassname 的 Java 函式。
以下說明如何在 XSLT 樣板(template)內部綁定以 Java 撰寫的外部函式:
舉例來說,下列樣式表元素包含了一個自訂命名空間宣告:
<?XML version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="https://www.w3.org/1999/XSL/Transform" xmlns:myspace="d://XMLprogs/mynamespace">
宣告這個命名空間之後,就能存取該類別的任何靜態方法,像这样:
<xsl:variable name="funvalue" select="mynspace:classname.function()"/>
如果方法不是靜態的,就必須先呼叫類別的建構子,例如:
<xsl:variable name="funvalue" select="mynspace.classname.new()"/>
<?XML version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="https://www.w3.org/1999/XSL/Transform" xmlns:java="d://XMLprogs/mynamespace" exclude-result-prefixes="Java">
此處的 Java 套件「mynamespace」必須放在「d://XMLprogs」目錄中。
注意:善用可選屬性 xsl:exclude-result-prefixes,可以防止 Java 命名空間被寫進結果文件裡。
<xsl:template match="/">
<Html>
<body>
<p>
<xsl:value-of select="Java:DateClass.displayDate()"/>
</p>
</body>
</Html>
</xsl:template>
以上 XSLT 程式碼中,<xsl:value-of select="Java:DateClass.displayDate()"/> 這行呼叫了位於 mynamespace 套件、名為 DateClass 之類別的靜態方法 displayDate()。
利用這項技術,你可以呼叫任何 Java 類別方法——包含那些需要參數的方法——而參數則來自你的 XSLT 樣板。
本文相關程式碼:date.xsl
<?XML version="1.0" encoding="UTF-8" ?>
<xsl:stylesheet version="1.0" xmlns:xsl="https://www.w3.org/1999/XSL/Transform" xmlns:java="d://XMLprogs/mynamespace" exclude-result-prefixes="Java">
<xsl:template match="/">
<Html>
<body>
<p>
<xsl:value-of select="Java:DateClass.displayDate()" />
</p>
</body>
</Html>
</xsl:template>
</xsl:stylesheet>
DateClass.Java
package mynamespace;
import Java.util.Date;
public class DateClass{
public static String displayDate(){
Date d = new Date();
return d.toString();
}
}
要運行這些程式碼,需要: