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 指向的目錄必須事先存在,多數處理器不會替你建立路徑;另外若多執行緒同時跑轉換,固定檔名容易互相覆寫,必要時應把識別碼併入檔名。