异常教程
XSLT document() 函数（长文讲解）
💡一则或许对你有用的小广告
欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论
- 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于
Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;- 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;
截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观
前言
在 XML（可扩展标记语言）与 XSLT（可扩展样式表语言转换）的开发中，document() 函数是一个常被低估却极其强大的工具。它允许开发者在 XSLT 样式表中动态加载并引用外部 XML 文档，从而实现跨文件的数据整合与逻辑扩展。无论是构建复杂的报表系统、动态生成多语言内容，还是将分散的配置信息合并到单一输出中，document() 函数都能提供简洁高效的解决方案。
对于编程初学者而言，理解这一函数的语法与应用场景可能略显抽象；而对中级开发者来说，掌握其进阶技巧（如动态路径、错误处理等）则能显著提升开发效率。本文将通过循序渐进的方式，结合实际案例与代码示例，深入解析 XSLT document() 函数的核心功能与最佳实践。
一、XSLT document() 函数的基础用法
1.1 函数定义与核心语法
document() 函数的基本语法如下：
document([href?, node-set?])
其中：
href是可选参数，指定要加载的外部 XML 文档的路径或 URI。node-set是可选的上下文节点集，用于在特定节点范围内解析文档（较少使用）。
当调用 document() 时，XSLT 处理器会根据提供的路径加载目标文档，并返回一个包含其节点的树形结构。
1.2 第一个示例：加载外部文档
假设我们有两个 XML 文件：
books.xml（主文档，包含书籍列表）：<library> <book id="1"> <title>Effective XSLT</title> <author>Author A</author> </book> </library>prices.xml（外部文档，包含价格信息）：<prices> <price book-id="1" value="49.99"/> </prices>
我们希望通过 XSLT 将两者的数据合并，生成包含价格的 HTML 输出。此时，document() 函数可用于引用 prices.xml：
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:template match="/library">
<html>
<body>
<table>
<tr>
<th>Title</th>
<th>Author</th>
<th>Price</th>
</tr>
<xsl:apply-templates select="book"/>
</table>
</body>
</html>
</xsl:template>
<xsl:template match="book">
<tr>
<td><xsl:value-of select="title"/></td>
<td><xsl:value-of select="author"/></td>
<!-- 使用 document() 引用外部文档 -->
<td>
<xsl:value-of select="document('prices.xml')/prices/price[@book-id = current()/@id]/@value"/>
</td>
</tr>
</xsl:template>
</xsl:stylesheet>
运行结果：
<table>
<tr>
<td>Effective XSLT</td>
<td>Author A</td>
<td>49.99</td>
</tr>
</table>
1.3 路径解析规则
document() 的 href 参数支持以下路径类型：
- 绝对路径：如
file:///C:/data/prices.xml。 - 相对路径：相对于主 XML 文档的位置。例如，若主文档在
C:/projects/library/books.xml，则prices.xml可能位于同一目录。 - URI：如
http://example.com/prices.xml（需网络权限）。
注意：路径的正确性是关键。若路径错误或文档不存在，XSLT 处理器将返回空节点集，可能导致输出缺失数据。
二、高级应用场景与技巧
2.1 动态路径与变量绑定
在实际开发中，外部文档的路径可能需要动态生成，例如根据用户输入或配置文件指定。此时，可以结合 XSLT 的变量（variable）或参数（parameter）实现路径的灵活性：
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<!-- 定义变量存储外部文档路径 -->
<xsl:variable name="pricePath" select="'prices.xml'"/>
<xsl:template match="book">
<td>
<xsl:value-of select="document($pricePath)/prices/price[@book-id = current()/@id]/@value"/>
</td>
</xsl:template>
</xsl:stylesheet>
2.2 合并多个文档
若需同时引用多个外部文档，可多次调用 document() 函数：
<xsl:template match="book">
<td>
<!-- 合并 prices.xml 和 ratings.xml 的数据 -->
<xsl:value-of select="
document('prices.xml')/prices/price[@book-id = current()/@id]/@value
|| ' (Rating: '
|| document('ratings.xml')/ratings/rating[@book-id = current()/@id]/@score
|| ')'
"/>
</td>
</xsl:template>
2.3 处理文档内的特定节点
若外部文档结构复杂，可通过 XPath 表达式定位子节点：
<!-- prices.xml 结构示例 -->
<prices>
<category name="books">
<price book-id="1" value="49.99"/>
</category>
</prices>
<!-- XSLT 中的引用 -->
<xsl:value-of select="
document('prices.xml')/prices/category[@name='books']/price[@book-id = current()/@id]/@value
"/>
三、注意事项与最佳实践
3.1 性能优化
频繁调用 document() 可能导致性能问题，尤其是当文档较大或路径动态变化时。可通过以下方式优化：
- 缓存机制：若多个模板需引用同一文档，可在样式表顶部通过变量加载一次，后续复用。
<xsl:variable name="pricesDoc" select="document('prices.xml')"/> ... <xsl:value-of select="$pricesDoc/prices/price[@book-id = current()/@id]/@value"/> - 最小化文档粒度：确保外部文档仅包含必要的数据，避免加载冗余内容。
3.2 错误处理与容错
当外部文档无法访问或路径错误时，XSLT 默认会静默返回空节点。为避免数据丢失，可通过条件判断提供默认值：
<xsl:variable name="price" select="
document('prices.xml')/prices/price[@book-id = current()/@id]/@value
"/>
<td>
<xsl:choose>
<xsl:when test="$price">
<xsl:value-of select="$price"/>
</xsl:when>
<xsl:otherwise>
<span style="color:red">价格信息缺失</span>
</xsl:otherwise>
</xsl:choose>
</td>
3.3 安全性与权限控制
- 路径验证：避免直接使用用户输入的路径，防止文件遍历攻击（如
../../secret.xml）。 - 网络文档限制：若需加载远程资源（如
http://），确保服务器配置允许网络访问，并验证资源来源可信性。
四、实际案例：构建多语言支持的网站
4.1 需求背景
假设我们正在开发一个支持多语言的网站，内容分为两部分：
- 内容结构：存储在
content.xml中，定义页面布局和静态文本。 - 语言包：存储在
lang/en.xml、lang/zh.xml等文件中，提供不同语言的文本。
4.2 XML 结构示例
content.xml：
<page>
<section id="header">
<text key="welcome"/>
</section>
</page>
lang/en.xml：
<translation lang="en">
<text key="welcome">Welcome to our website!</text>
</<translation>
lang/zh.xml：
<translation lang="zh">
<text key="welcome">欢迎来到我们的网站！</text>
</<translation>
4.3 XSLT 实现多语言切换
通过 document() 函数动态加载对应语言包，并根据参数选择语言：
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<!-- 接收语言参数 -->
<xsl:param name="language" select="'en'"/>
<!-- 加载语言包 -->
<xsl:variable name="langDoc" select="document(concat('lang/', $language, '.xml'))"/>
<!-- 匹配文本节点 -->
<xsl:template match="text">
<xsl:variable name="key" select="@key"/>
<xsl:value-of select="$langDoc//text[@key = $key]"/>
</xsl:template>
</xsl:stylesheet>
输出结果：
- 当
$language = 'en'：<p>Welcome to our website!</p> - 当
$language = 'zh'：<p>欢迎来到我们的网站！</p>
五、总结与展望
XSLT document() 函数为开发者提供了一种灵活且强大的跨文档数据整合能力。通过掌握其基础语法、动态路径、错误处理等技巧，开发者可以高效地构建复杂的数据转换逻辑，例如多语言支持、配置文件合并或动态内容生成。
在实际开发中，需注意路径安全、性能优化和容错机制，以确保系统的健壮性。随着 XML 在配置管理、数据交换等领域的持续应用，document() 函数仍将是 XSLT 开发者工具箱中的核心工具之一。
希望本文能帮助读者从零开始理解并熟练运用这一功能，进一步探索 XSLT 的更多可能性。