XSLT 是一種基於規則的格式轉換語言。在許多人眼裡,它的功能就是將一種格式的 xml 文件轉換成另外一種格式的 XML 文件,僅此而已。不過,事實真是這樣嗎?
其實 XSLT 能夠做的事情很多,絕對超乎你的想象。除了格式轉換,XSLT 還能完成一些看起來和格式轉換完全無關的工作。比如說文件訪問或者是數據庫查詢等等。而這一切都要歸功於 XSLT 擴展(XSLT Extension)。
根據 XSLT 1.0 的規范,符合標准的 XSLT 引擎應該支持 XSLT 擴展。也就是允許用戶自定義 XSLT 的擴展元素(extension elements)和函數(extension functions)。今天我們所看到的主流 XSLT 引擎都按照國際標准,提供了自己的擴展方式。而開源軟件中的 saxaon 和 xalan,在這方面走得更遠。
Saxon 和 xalan 都是基於 java 開發的 XSLT 引擎,為它們編寫擴展自然也基於 Java。一般只要以下 3 步就可以完成一個擴展了。
1. 編寫一個 Java 類,在這個類裡面設計好擴展功能,並以靜態方法的形式提供給XSLT 引擎調用。
2. 在 XSLT 文件中,聲明一個自定義的命名空間(namespace),該命名空間指出了類的位置
3. 在 XSLT 文件中,在適當的地方,調用擴展即可。
接下來讓我們看個具體的例子。
foo_txt.xml 是一個待處理的 XML 文件,其中包含了<filename>和<content>兩個元素。現在希望通過 XSLT 處理後,能將 <content> 的內容寫入名稱為 <filename> 的文件中。
圖表 1:foo_txt.XML
<?XML version="1.0"?>
<document>
<filename>foo.txt</filename>
<content>Hello,World!</content>
</document>
由於這裡牽涉到針對文件的操作,因此這個任務必須通過功能擴展來完成。讓我們對照著前文提到的 3 步法,來看看 saxon 是怎麼來做的。
圖表 2:foo_txt_saxon.xsl
<?XML version="1.0"?>
<xsl:stylesheet version="1.0"
XMLns:xsl="http://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>
圖表 2
第一步,應該是提供用戶編寫的自定義Java類。由於篇幅關系,這裡不再給出源碼,請看本文的參考部分,在那裡提供了源碼下載。
第二步,在XSLT文件開始,通過"XMLns:user='Java:com.pear.utils.FileUtil'"命令,我們定義了一個命名空間。
最後,在處理XML節點的過程中,我們通過"user:output"成功地調用了用戶自定義擴展函數。從而在XSLT中實現了文件寫入功能。
看了saxon的做法之後,如果依樣畫葫蘆的對xalan也來一遍,那麼就太沒意思了。幸虧xalan提供了一套更有趣的方法。
先直接看看xalan版本的處理文件吧。
圖表 3:foo_txt_xalan.xsl
<?XML version="1.0"?>
<xsl:stylesheet version="1.0"
XMLns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:xalan="http://XML.apache.org/xalan"
XMLns:user="http://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>
注意到它和saxon的版本有什麼不同嗎?對了,很明顯,用戶自定義的函數直接在處理文件中就實現了。而且是用Javascript來完成的。那麼好處在哪兒呢?答案很簡單,就是開發人員可以拋開Java的編譯環境,直接設計自己的 XSLT 功能擴展了。
除了開發語言換成了Javascript 外,其它流程和 saxon 的版本還是挺像的。所以就不再詳細解釋了。
不過值得一提的是,光有javascript還是不夠的。在 xalan 版本中,細心的人一定會發現,真正起作用的部分,實際上是一個名字為 PrintWriter 的 java 類。也就是說 Javascript 實際上只是一個流程控制者,正是依靠著 Java sdk 強大的類庫,XSLT 才能如虎添翼,去完成不可能的任務。
那麼是不是只有自己寫擴展才能解決問題呢?答案當然是否定的。saxon和xalan早就為我們預制了很多公用的擴展功能。我們只要采用拿來主義就可以了。下面我以數據庫擴展為例,進一步向你展示XSLT擴展的魅力。
采用 saxon 引擎時,我們引入了幾個新的 XSLT 擴展元素,例如 sql:connect,sql:query。通過這些擴展元素,我們可以連接數據庫,並執行查詢。
比如在下例中,我們可以利用 saxon 提供的 sql 擴展去訪問 Informix 數據庫。步驟如下:首先我們利用sql:connect建立和數據庫的連接,連接使用的參數預先已經定義好了。
其次,我們用sql:query進行查詢。查詢的字段和查詢的條件,均以參數的形式出現。
查詢成功之後,利用標准的XSLT元素進行格式解析,並生成Html格式的表格。
最後,通過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 XMLns:xsl="http://www.w3.org/1999/XSL/Transform"
version="1.0"
XMLns:sql="Java:/net.sf.saxon.sql.SQLElementFactory"
XMLns:saxon="http://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" as="java:Java.sql.Connection"
XMLns:Java="http://saxon.sf.Net/Java-type">
<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"/>
<xsl:text>
</xsl:text>
</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-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>
采用xalan引擎時,流程和saxon差不多,不過它還是使用擴展函數來完成數據連接和查詢的功能。
foo_sql_xalan_query.xsl
<?XML version="1.0"?>
<xsl:stylesheet XMLns:xsl="http://www.w3.org/1999/XSL/Transform"
version="1.0"
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"/>
<xsl:text>
</xsl:text>
</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>
saxon和xalan都是通過jdbc連接數據庫的,所以讀者如果手頭沒有informix,只要更換不同的數據庫驅動,以及對應的數據庫連接參數,就可以在自己的機器上檢驗效果了。
以上的這些案例只是揭開了XSLT擴展的神秘面紗,至於怎麼去發掘它的潛力,就留給富有創造力的讀者去完成吧。