DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
讓 XSLT 如虎添翼:深入解析 XSLT 擴展機制
編輯:XML詳解     

XSLT 不只是一台「格式轉換機」

提起 XSLT,多數人的第一印象是:這是一種以規則為基礎的轉換語言,工作就是把一份 XML 文件變成另一份 XML 文件。這樣的理解並沒有錯,卻嚴重低估了它的能耐。

事實上,XSLT 能做的事遠比「改寫標籤」多得多。文件系統的讀寫、資料庫的連線與查詢,這些看似與格式轉換毫不相干的任務,XSLT 都能勝任——關鍵在於一個常被忽略的機制:XSLT 擴展(XSLT Extension)。

擴展:XSLT 的逃生門

依據 XSLT 1.0 規範,合規的 XSLT 引擎必須支援擴展,也就是允許使用者自行定義擴展元素(extension elements)與擴展函數(extension functions)。當標準的指令不足以完成工作時,擴展機制就是那扇通往外部世界的門。

今天主流的 XSLT 引擎都依國際標準提供了各自的擴展方式,其中開源的 Saxon 與 Xalan 走得最遠。兩者都是 Java 實作的引擎,為它們撰寫擴展自然以 Java 為主軸,而流程大致只有三步:

  1. 撰寫一個 Java 類別,把擴展功能實作為靜態方法,供 XSLT 引擎呼叫。
  2. 在 XSLT 文件中宣告一個自訂的命名空間(namespace),指向該類別的位置。
  3. 在需要的地方直接呼叫該擴展函數。

實作練習:讓 XSLT 寫出檔案

以下是一個具體案例。假設待處理的 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 元素完全無能為力,只能求助於擴展。

Saxon 版本

圖表 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 版本:把程式碼寫進樣式表

如果 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 那套強大的標準類庫;腳本語言只是把它們串起來的黏著劑。

不必自己造輪子:現成的 SQL 擴展

那麼,是不是每次都得自己寫擴展?當然不必。Saxon 與 Xalan 早就預置了一批公用擴展,直接拿來用即可。以資料庫查詢為例,Saxon 提供了 sql:connect、sql:query、sql:close 等擴展元素,構成一條完整的生命週期:

  1. 以 sql:connect 建立連線,參數(驅動、連線字串、帳號、密碼)事先以 xsl:param 定義好。
  2. 以 sql:query 執行查詢,查詢的表名、欄位與條件同樣以參數傳入。
  3. 查詢結果會被轉為節點集,接著就能用最標準的 XSLT 語法把它渲染成 HTML 表格。
  4. 最後以 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 從單純的排版工具,變成能與外部世界互動的運算平台。至於要如何把這份能力發揮到極致,就留給充滿想像力的開發者了。

實務上仍要多留意兩點:其一,擴展會讓樣式表綁定特定引擎與執行環境,可攜性隨之下降;其二,資料庫連線字串若寫死在樣式表中,等於把憑證攤在明文裡,正式環境應改由外部參數注入。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved