提起 XSLT,多數人的第一印象是:這是一種以規則為基礎的轉換語言,工作就是把一份 XML 文件變成另一份 XML 文件。這樣的理解並沒有錯,卻嚴重低估了它的能耐。
事實上,XSLT 能做的事遠比「改寫標籤」多得多。文件系統的讀寫、資料庫的連線與查詢,這些看似與格式轉換毫不相干的任務,XSLT 都能勝任——關鍵在於一個常被忽略的機制:XSLT 擴展(XSLT Extension)。
依據 XSLT 1.0 規範,合規的 XSLT 引擎必須支援擴展,也就是允許使用者自行定義擴展元素(extension elements)與擴展函數(extension functions)。當標準的指令不足以完成工作時,擴展機制就是那扇通往外部世界的門。
今天主流的 XSLT 引擎都依國際標準提供了各自的擴展方式,其中開源的 Saxon 與 Xalan 走得最遠。兩者都是 Java 實作的引擎,為它們撰寫擴展自然以 Java 為主軸,而流程大致只有三步:
以下是一個具體案例。假設待處理的 XML 檔 foo_txt.xml 裡有 <filename> 與 <content> 兩個元素,我們希望在轉換後,把 <content> 的內容寫進以 <filename> 命名的檔案中。
圖表 1:foo_txt.xml
<?XML version="1.0"?> <document> <filename>foo.txt</filename> <content>Hello,World!</content> </document>
這個任務涉及檔案寫入,標準 XSLT 元素完全無能為力,只能求助於擴展。
圖表 2:foo_txt_saxon.xsl
<?XML version="1.0"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="https://www.w3.org/1999/XSL/Transform"
xmlns:user="Java:com.pear.utils.FileUtil">
<xsl:template match="document">
<xsl:value-of select="user:output(string(filename),string(content))"/>
</xsl:template>
</xsl:stylesheet>
三個步驟在這裡一目了然:第一步是提供自訂的 Java 類別 com.pear.utils.FileUtil(因篇幅關係不列原始碼);第二步透過 xmlns:user="Java:com.pear.utils.FileUtil" 宣告命名空間, Saxon 會把 Java: 前綴視為載入類別的線索;第三步在 xsl:value-of 的 select 屬性中呼叫 user:output,檔案寫入功能於是在 XSLT 裡完成了。
如果 Xalan 也只是照抄一遍,那就太無趣了。它提供了一套更靈活的玩法。
圖表 3:foo_txt_xalan.xsl
<?XML version="1.0"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="https://www.w3.org/1999/XSL/Transform"
xmlns:xalan="https://xml.apache.org/xalan"
xmlns:user="https://www.mac.home">
<xalan:component prefix="user" functions="output">
<xalan:script lang="Javascript">
function output(filename, content) {
var a = new java.io.PrintWriter(filename);
a.print(content);
a.close();
return "Finished!";
}
</xalan:script>
</xalan:component>
<xsl:template match="document">
<xsl:value-of select="user:output(string(filename),string(content))"/>
</xsl:template>
</xsl:stylesheet>
差別在哪裡?自訂函數直接寫在樣式表裡,而且用的是 JavaScript。好處很直接:開發者不必開 Java 編譯環境、不必打包 JAR,就能替 XSLT 加上新能力,迭代速度大幅加快。
不過別誤會,JavaScript 在這裡真正扮演的是「流程控制者」。真正動手做事的,是 java.io.PrintWriter 這個 Java 類別。也就是說,XSLT 之所以能完成不可能的任務,靠的仍是 Java SDK 那套強大的標準類庫;腳本語言只是把它們串起來的黏著劑。
那麼,是不是每次都得自己寫擴展?當然不必。Saxon 與 Xalan 早就預置了一批公用擴展,直接拿來用即可。以資料庫查詢為例,Saxon 提供了 sql:connect、sql:query、sql:close 等擴展元素,構成一條完整的生命週期:
sql:connect 建立連線,參數(驅動、連線字串、帳號、密碼)事先以 xsl:param 定義好。sql:query 執行查詢,查詢的表名、欄位與條件同樣以參數傳入。sql:close 關閉連線,收尾。foo_sql_query.xml
<?XML version="1.0"?> <query> <table>FOO</table> <columns>username,birthdate</columns> <condition/> </query>
foo_sql_saxon_query.xsl
<?XML version="1.0"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="https://www.w3.org/1999/XSL/Transform"
xmlns:sql="java:/net.sf.saxon.sql.SQLElementFactory"
xmlns:saxon="https://saxon.sf.net/"
extension-element-prefixes="saxon sql">
<xsl:param name="driver" select="'com.informix.jdbc.IfxDriver'"/>
<xsl:param name="database"
select="'jdbc:informix-sqli://192.168.0.1:5000/testDB:INFORMIXSERVER=pcsnet;user=pcs;password=abc'"/>
<xsl:param name="user" select="'pcs'"/>
<xsl:param name="passWord" select="'abc'"/>
<xsl:template match="/">
<xsl:variable name="connection">
<sql:connect driver="{$driver}" database="{$database}"
user="{$user}" password="{$passWord}"/>
</xsl:variable>
<Html>
<HEAD>Table of <xsl:value-of select="/query/table"/></HEAD>
<BODY>
<TABLE border="1">
<xsl:variable name="dbtable">
<sql:query connection="$connection" table="{/query/table}"
column="{/query/columns}"/>
</xsl:variable>
<TR>
<xsl:if test="string-length(/query/columns) > 0">
<xsl:call-template name="getcolumns">
<xsl:with-param name="columns" select="/query/columns"/>
</xsl:call-template>
</xsl:if>
</TR>
<xsl:apply-templates select="$dbtable/row-set/row"/>
</TABLE>
</BODY>
</Html>
<sql:close connection="$connection"/>
</xsl:template>
<!-- 以遞迴切分逗號分隔的欄位清單,產生表頭 -->
<xsl:template name="getcolumns">
<xsl:param name="columns"/>
<xsl:if test="string-length($columns) > 0">
<TH>
<xsl:choose>
<xsl:when test="contains($columns,',' )">
<xsl:value-of select="substring-before($columns,',')"/>
</xsl:when>
<xsl:otherwise><xsl:value-of select="$columns"/></xsl:otherwise>
</xsl:choose>
</TH>
<xsl:call-template name="getcolumns">
<xsl:with-param name="columns" select="substring-after($columns,',')"/>
</xsl:call-template>
</xsl:if>
</xsl:template>
<xsl:template match="row">
<TR><xsl:apply-templates select="col"/></TR>
</xsl:template>
<xsl:template match="col">
<TD><xsl:value-of select="text()"/></TD>
</xsl:template>
</xsl:stylesheet>
Xalan 的做法不同,它選擇用擴展函數而非擴展元素來完成同樣的事,核心類別是 org.apache.xalan.lib.sql.XConnection。
foo_sql_xalan_query.xsl
<?XML version="1.0"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="https://www.w3.org/1999/XSL/Transform"
xmlns:sql="org.apache.xalan.lib.sql.XConnection"
extension-element-prefixes="sql">
<xsl:param name="driver" select="'com.informix.jdbc.IfxDriver'"/>
<xsl:param name="database"
select="'jdbc:informix-sqli://192.168.0.1:5000/testDB:INFORMIXSERVER=pcsnet;user=pcs;password=abc'"/>
<xsl:variable name="query">
select <xsl:value-of select="/query/columns"/>
from <xsl:value-of select="/query/table"/>
</xsl:variable>
<xsl:template match="/">
<xsl:variable name="connection" select="sql:new($driver,$database)"/>
<Html>
<HEAD>Table of <xsl:value-of select="/query/table"/></HEAD>
<BODY>
<TABLE border="1">
<xsl:variable name="table" select="sql:query($connection, $query)"/>
<TR>
<xsl:for-each select="$table/sql/metadata/column-header">
<TH><xsl:value-of select="@column-label"/></TH>
</xsl:for-each>
</TR>
<xsl:apply-templates select="$table/sql/row-set"/>
</TABLE>
</BODY>
</Html>
<xsl:variable name="close" select="sql:close($connection)"/>
</xsl:template>
<xsl:template match="row-set">
<xsl:apply-templates select="row"/>
</xsl:template>
<xsl:template match="row">
<TR><xsl:apply-templates select="col"/></TR>
</xsl:template>
<xsl:template match="col">
<TD><xsl:value-of select="text()"/></TD>
</xsl:template>
</xsl:stylesheet>
兩套引擎都是走 JDBC 連線,所以手邊沒有 Informix 也無妨——換一個驅動類別與對應的連線字串,就能在自己的環境中驗證效果。
這些案例只是掀開了 XSLT 擴展的一角。它讓 XSLT 從單純的排版工具,變成能與外部世界互動的運算平台。至於要如何把這份能力發揮到極致,就留給充滿想像力的開發者了。
實務上仍要多留意兩點:其一,擴展會讓樣式表綁定特定引擎與執行環境,可攜性隨之下降;其二,資料庫連線字串若寫死在樣式表中,等於把憑證攤在明文裡,正式環境應改由外部參數注入。