DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
XSLT 2.0 一次輸出多個檔案:xsl:result-document 實戰
編輯:XML詳解     

XSLT 1.0 有個幾乎無解的硬限制:一份輸入,只能換來一份輸出(即使可以拆成多個樣式表檔)。到了 2.0,輸入仍然限定為一份,但輸出端徹底解放了——透過 xsl:result-document 指令,一次轉換就能吐出任意多個檔案。

先看兩個關鍵屬性

屬性說明
href輸出檔的檔名或完整 URL
format輸出名稱,對應 xsl:output 中所定義的格式

準備測試資料

為了實驗這個指令,我設計了一份包含測試結果的 XML。結構很單純:多個 testrun,每個 run 底下有一批 test,並以 pass 屬性標記成敗。

清單 1:輸入 XML

<?XML version="1.0" encoding="UTF-8"?>
<tests>
  <testrun run="test1">
    <test name="foo" pass="true" />
    <test name="bar" pass="true" />
    <test name="baz" pass="true" />
  </testrun>
  <testrun run="test2">
    <test name="foo" pass="true" />
    <test name="bar" pass="false" />
    <test name="baz" pass="false" />
  </testrun>
  <testrun run="test3">
    <test name="foo" pass="false" />
    <test name="bar" pass="true" />
    <test name="baz" pass="false" />
  </testrun>
</tests>

為每一輪測試產生一個檔案

清單 2:一輪測試一個 HTML 檔

<?XML version="1.0" encoding="UTF-8"?>
<xsl:stylesheet
  xmlns:xsl="https://www.w3.org/1999/XSL/Transform"
  version="2.0">

  <xsl:output method="text"/>
  <xsl:output method="html" indent="yes" name="Html"/>

  <xsl:template match="/">
    <xsl:for-each select="//testrun">
      <xsl:variable name="filename"
        select="concat('output1/', @run, '.Html')" />
      <xsl:value-of select="$filename" /> <!-- 印出正在建立的檔案 -->
      <xsl:result-document href="{$filename}" format="Html">
        <Html><body>
          <xsl:value-of select="@run"/>
        </body></Html>
      </xsl:result-document>
    </xsl:for-each>
  </xsl:template>
</xsl:stylesheet>

幾個細節值得留意。首先,stylesheet 的 version 必須設為 2.0,否則用不了 xsl:result-document。接著,樣式表本身的輸出型別設為 text;由於主輸出只是用來印出進度訊息,若希望各個衍生檔案是 HTML 格式,就必須另外用 name="Html" 定義一個具名輸出格式,再在 xsl:result-document 上以 format="Html" 引用它。

然後用 xsl:for-each 遍歷每個 testrun,以 variable 把「輸出目錄 + run 名稱 + .Html」拼成完整路徑,先印出檔名讓使用者知道發生了什麼事,最後由 xsl:result-document 開啟該檔案並寫入內容。

清單 3:以 Saxon 執行的結果

Creating output1/test1.Html
Creating output1/test2.Html
Creating output1/test3.Html

讓輸出更有料

xsl:result-document 內的內容會以與模板其他部分完全相同的方式求值——聽起來有點不可思議,但確實如此。模板上下文中所有可見的變數都能派上用場。既然如此,就把測試細節也寫進去吧。

清單 4:更完整的 HTML 輸出

<xsl:result-document href="{$filename}" format="Html">
  <Html><head>
    <title>Test results - <xsl:value-of select="@run"/></title>
  </head><body>
    <xsl:value-of select="@run"/> <!-- Run -->
    <table>
      <tr><td>Test</td><td>Pass</td></tr>
      <xsl:for-each select="test">
        <tr><td>
          <xsl:value-of select="@name" />
        </td><td>
          <xsl:value-of select="@pass" />
        </td></tr>
      </xsl:for-each>
    </table>
  </body></Html>
</xsl:result-document>

清單 5:改進後的輸出

<Html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>Test results - test1</title>
  </head>
  <body>
    <table>
      <tr><td>Test</td><td>Pass</td></tr>
      <tr><td>foo</td><td>true</td></tr>
      <tr><td>bar</td><td>true</td></tr>
      <tr><td>baz</td><td>true</td></tr>
    </table>
  </body>
</Html>

補上一份索引

檔案散成一堆之後,還需要一個入口。索引頁同樣用 xsl:result-document 產生,路徑直接寫死即可。

清單 6:產生索引檔

<!-- 建立索引 -->
<xsl:result-document href="output3/index.Html" format="Html">
  <Html><head><title>Test Index</title></head>
    <body>
      <xsl:for-each select="//testrun">
        <a href="{@run}.Html"><xsl:value-of select="@run" /></a><br/>
      </xsl:for-each>
    </body>
  </Html>
</xsl:result-document>

這段程式碼要放在「為每個測試案例產生 HTML」的 xsl:for-each 迴圈之後,以免索引先寫完卻還沒其他檔案可連。

清單 7:索引檔內容

<Html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>Test Index</title>
  </head>
  <body>
    <a href="test1.Html">test1</a><br>
    <a href="test2.Html">test2</a><br>
    <a href="test3.Html">test3</a><br>
  </body>
</Html>

結語

xsl:result-document 讓單一樣式表得以從單一資料來源,展開成一份結構完整的檔案集:多個明細頁加上一份索引頁。這在 XSLT 1.x 時代只能靠引擎專屬的非標準擴展硬做,如今已是標準的一部分,為樣式表作者開出了一扇新的機會之窗。

實務上要留意的是:href 指向的目錄必須事先存在,多數處理器不會替你建立路徑;另外若多執行緒同時跑轉換,固定檔名容易互相覆寫,必要時應把識別碼併入檔名。

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