XSLT 的第一个版本有很大的局限性，只能有一个输入和一个输出（虽然可以有多个模板文件）。该标准的第 2 版仍然要求一个输入，但是输出系统更加灵活了。现在可以使用 xsl:result-document 指令产生多个输出文件。这一新的标签有两个重要属性，如表 1 所示。
表 1. xsl:result-document 属性
| 属性 |
说明 |
href |
输出文件的文件名或者完全限定的 URL |
format |
使用的格式名，如对应 xsl:output 指令中所定义的 |
为了试验该指令，我设计了一个输入 XML 文件，包括一组测试结果（参见清单 1）。
清单 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>
|
这段 XML 非常简单。每个测试运行中都有一组带有 pass 标记的指定测试，用以说明测试是否成功。
为每个测试创建一个文件
首先为每个测试结果创建一个文件，XSL 模板如清单 2 所示。
清单 2. 为每个测试创建文件的代码
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet
xmlns:xsl="http://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" /> <!-- Creating -->
<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 格式，那么还需要定义类型 html 的第二个指定格式。我在 xsl:result-document 标签中使用这种格式。
然后使用 xsl:for-each 循环遍历 testrun 标签。在每个标签中使用 variable 标签创建一个新的 $filename 变量，将输出目录名（output1）、 运行名和扩展名 .html 合成一个路径。
然后我使用 value-of 标签和 $filename 变量告诉用户正在创建的文件。再用 xsl:result-document 标签打开新文档输出 HTML。清单 3 显示了运行上述数据文件时的结果。
清单 3. 运行示例数据文件的结果（使用 Saxon）
Creating output1/test1.html
Creating output1/test2.html
Creating output1/test3.html
|
获得更好的结果
xsl:result-document 标签的内容按照与模板其他部分相同的方式计算似乎有点不可思议，但确实如此。模板上下文中的所有变量都可以使用。
作为一个例子，我修改了 xsl:result-document 标签中的代码，以便提供关于测试结果的更多信息（参见清单 4）。
清单 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 所示。
清单 5. 改进的 HTML 输出结果
<html>
<head>
<meta http-equiv="Content-Type"
content="text/html; charset=UTF-8">
<title>Test results - test1</title>
</head>
<body>
<!-- Run: test1-->
<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）。
清单 6. 创建索引文件的代码
<!-- Creating the index -->
<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 显示了得到的索引文件。
清单 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 指令可以将一个 XSL 模板从单个数据源输出到多个文件中。这种功能在 XSLT 1.x 属于非标准扩展，为 XSLT 模板创造者打开了新的机会之窗。
