首页
/ 正文

XSLT 转换（保姆级教程）

更新时间: 2025-04-06 12:22:02

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;

《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前，星球内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习，欢迎点击围观

在数据处理和文档生成领域，XSLT 转换是一项核心技能。它如同一把精密的瑞士军刀，能够将结构化的 XML 数据灵活地转换为 HTML、JSON、CSV 等多种格式，满足不同场景的需求。无论是构建动态网站、处理业务数据，还是开发自动化文档工具，掌握 XSLT 转换技术都能显著提升开发效率。本文将从基础概念到实战案例，逐步解析这一技术的原理与应用，帮助开发者快速上手并深入理解其价值。

什么是 XSLT 转换？

XSLT（Extensible Stylesheet Language Transformations）是一种基于 XML 的语言，用于将 XML 文档转换为其他格式。想象它像一位“翻译官”：输入的 XML 是原始语言，XSLT 是翻译规则，最终输出则是目标语言（如 HTML 或纯文本）。其核心逻辑是通过 XPath（XML 路径语言）定位 XML 节点，再通过模板（Template）定义转换规则。

为什么需要 XSLT 转换？

数据标准化：将不同来源的 XML 数据统一为一致格式。
跨平台兼容：XML 是通用的数据交换标准，XSLT 可适配多种输出格式。
可维护性：通过集中管理 XSLT 文件，避免重复编写转换逻辑。

XSLT 转换的三大核心概念

1. XML 文档：原始数据源

XML（可扩展标记语言）以标签形式组织数据，例如：

<?xml version="1.0" encoding="UTF-8"?>  
<books>  
  <book id="1">  
    <title>Design Patterns</title>  
    <author>Gamma et al.</author>  
    <price>39.99</price>  
  </book>  
  <book id="2">  
    <title>Clean Code</title>  
    <author>Robert C. Martin</author>  
    <price>29.99</price>  
  </book>  
</books>

这段 XML 描述了两本书的信息，但直接展示给用户时可能不够直观。

2. XSLT 模板：转换规则

XSLT 文件定义如何将 XML 转换为其他格式。例如，将上述 XML 转换为 HTML 表格：

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

  <!-- 匹配根节点 <books> -->  
  <xsl:template match="/books">  
    <html>  
      <body>  
        <table border="1">  
          <tr>  
            <th>Title</th>  
            <th>Author</th>  
            <th>Price</th>  
          </tr>  
          <!-- 遍历每个 <book> 节点 -->  
          <xsl:apply-templates select="book"/>  
        </table>  
      </body>  
    </html>  
  </xsl:template>  

  <!-- 匹配 <book> 节点 -->  
  <xsl:template match="book">  
    <tr>  
      <td><xsl:value-of select="title"/></td>  
      <td><xsl:value-of select="author"/></td>  
      <td><xsl:value-of select="price"/></td>  
    </tr>  
  </xsl:template>  

</xsl:stylesheet>

通过 match 属性定位 XML 节点，apply-templates 和 value-of 指令提取数据，最终生成 HTML 表格。

3. XSLT 处理器：执行转换

XSLT 本身是声明式语言，需依赖处理器（如 Saxon、.NET 的 XslCompiledTransform）或编程语言的库（如 Python 的 lxml）执行转换。例如，使用命令行工具 xsltproc：

xsltproc books.xsl books.xml -o output.html

XSLT 转换的典型应用场景

场景 1：将 XML 转换为 HTML

如前例所示，XSLT 可将 XML 数据渲染为交互式网页。开发者可通过 CSS 和 JavaScript 增强 HTML 的样式和功能。

场景 2：数据格式转换

假设需要将 XML 转换为 JSON，可通过 XSLT 生成符合 JSON 语法的字符串：

<xsl:template match="/">  
  {  
    "books": [  
      <xsl:for-each select="books/book">  
        {  
          "title": "<xsl:value-of select="title"/>",  
          "author": "<xsl:value-of select="author"/>",  
          "price": <xsl:value-of select="price"/>  
        }<xsl:if test="position() != last()">,</xsl:if>  
      </xsl:for-each>  
    ]  
  }  
</xsl:template>

通过 for-each 循环遍历节点，并用 position() 函数控制逗号分隔符，确保 JSON 格式正确。

场景 3：数据聚合与过滤

若需从 XML 中提取特定数据，例如筛选价格低于 30 美元的书籍：

<xsl:template match="book[price < 30]">  
  <div>  
    <p>Title: <xsl:value-of select="title"/></p>  
    <p>Price: <xsl:value-of select="price"/></p>  
  </div>  
</xsl:template>

通过 XPath 表达式 book[price < 30] 实现条件匹配，仅转换符合条件的节点。

XSLT 转换的核心语法详解

1. 模板匹配（Template Matching）

XSLT 通过 <xsl:template> 定义规则，match 属性指定目标节点：

<xsl:template match="book">  
  <!-- 转换逻辑 -->  
</xsl:template>

若需匹配多个节点，可用 | 分隔：

<xsl:template match="book|author">  
  <!-- 适用于 <book> 和 <author> 的通用逻辑 -->  
</xsl:template>

2. 节点选择与遍历

XPath 是 XSLT 的“导航系统”，支持以下操作：

层级选择：book/title 选择所有直接子节点 <title>。
谓词过滤：book[@id='1'] 选择 id 属性为 1 的 <book>。
轴遍历：ancestor:: 定位祖先节点，following-sibling:: 定位兄弟节点。

3. 变量与参数

通过 <xsl:variable> 和 <xsl:param> 存储中间结果或接收外部输入：

<xsl:variable name="totalPrice" select="sum(//book/price)"/>  
<xsl:template match="/">  
  Total Price: <xsl:value-of select="$totalPrice"/>  
</xsl:template>

4. 条件判断与循环

使用 <xsl:if>、<xsl:choose> 实现条件逻辑，用 <xsl:for-each> 遍历节点集合：

<xsl:for-each select="books/book">  
  <xsl:if test="price > 30">  
    <div>Expensive book: <xsl:value-of select="title"/></div>  
  </xsl:if>  
</xsl:for-each>

进阶技巧：提升 XSLT 转换效率

1. 模板优先级与模式匹配

当多个模板匹配同一节点时，XSLT 根据模式的“具体性”选择优先级：

match="book" 的优先级低于 match="book[@id]"。

可通过 priority 属性显式指定优先级：

<xsl:template match="book" priority="1"/>

2. 使用键（Key）加速查询

若需频繁查询特定节点，定义键可提高性能：

<xsl:key name="bookById" match="book" use="@id"/>  
<!-- 后续通过 key() 函数引用 -->  
<xsl:value-of select="key('bookById', '1')/title"/>

3. 模板继承与模式覆盖

通过 xsl:import 和 xsl:include 组合多个 XSLT 文件，实现代码复用：

<xsl:import href="common-templates.xsl"/>  
<xsl:include href="specific-logic.xsl"/>

常见问题与解决方案

问题 1：转换后输出格式混乱

原因：XML/HTML 的空格和换行可能被保留，导致显示异常。
解决：在 XSLT 中添加 xml:space="preserve" 或使用 disable-output-escaping 属性：

<xsl:template match="text()">  
  <xsl:value-of select="." disable-output-escaping="yes"/>  
</xsl:template>

问题 2：XPath 表达式无法匹配节点

原因：XML 命名空间（Namespace）未正确声明。
解决：在 XSLT 中声明命名空间前缀，并在 XPath 中使用：

<xsl:stylesheet  
    xmlns:xsl="http://www.w3.org/1999/XSL/Transform"  
    xmlns:ns="http://example.com/ns"  
    exclude-result-prefixes="ns">  

  <xsl:template match="ns:book">  
    <!-- 匹配带有命名空间的节点 -->  
  </xsl:template>  

</xsl:stylesheet>

问题 3：动态生成元素名称或属性

原因：XSLT 默认不允许动态构造标签名。
解决：使用 xsl:element 和 xsl:attribute：

<xsl:element name="{concat('div', @type)}">  
  <xsl:attribute name="class">  
    <xsl:value-of select="@class"/>  
  </xsl:attribute>  
  <!-- 内容 -->  
</xsl:element>

实战案例：构建动态价格列表

需求：根据 XML 数据生成带过滤功能的 HTML 页面

输入 XML（`products.xml`）

<products>  
  <product category="Electronics">  
    <name>Laptop</name>  
    <price>999.99</price>  
  </product>  
  <product category="Books">  
    <name>Programming Book</name>  
    <price>29.99</price>  
  </product>  
  <!-- 更多商品... -->  
</products>

XSLT 文件（`filter.xsl`）

<xsl:stylesheet version="1.0"  
    xmlns:xsl="http://www.w3.org/1999/XSL/Transform">  

  <!-- 根模板：生成 HTML 结构 -->  
  <xsl:template match="/">  
    <html>  
      <body>  
        <h1>Product Filter</h1>  
        <select id="categoryFilter">  
          <option value="">All</option>  
          <xsl:for-each select="//product[not(preceding::product[@category=current()/@category])]">  
            <option><xsl:value-of select="@category"/></option>  
          </xsl:for-each>  
        </select>  
        <div id="productList">  
          <xsl:apply-templates select="products/product"/>  
        </div>  
      </body>  
    </html>  
  </xsl:template>  

  <!-- 商品项模板 -->  
  <xsl:template match="product">  
    <div class="product {lower-case(@category)}">  
      <h3><xsl:value-of select="name"/></h3>  
      <p>Price: $<xsl:value-of select="price"/></p>  
    </div>  
  </xsl:template>  

</xsl:stylesheet>

输出效果

转换后生成的 HTML 包含分类过滤下拉框和商品列表，用户可通过选择类别动态筛选内容。

总结

XSLT 转换是处理 XML 数据的强大工具，其核心在于通过模板和 XPath 精准控制数据流。从基础的节点匹配到高级的动态生成，开发者可通过分步实践逐步掌握其精髓。无论是构建数据中台、开发文档生成器，还是应对跨系统数据集成，XSLT 都能提供高效、可维护的解决方案。随着对 XSLT 的深入理解，开发者将能灵活应对更多复杂的转换需求，提升项目交付效率。

附录：XSLT 转换工具推荐
| 工具名称 | 适用场景 | 特点 |
|----------------|------------------------------|-------------------------------|
| Saxon | 高性能、支持 XSLT 3.0 | 开源且跨平台 |
| oXygen XML | 集成开发环境（IDE） | 提供调试和可视化设计功能 |
| XSLT Fiddle| 在线调试与分享 | 无需安装，适合快速测试 |

XSLT 转换（保姆级教程）

什么是 XSLT 转换？

为什么需要 XSLT 转换？

XSLT 转换的三大核心概念

1. XML 文档：原始数据源

2. XSLT 模板：转换规则

3. XSLT 处理器：执行转换

XSLT 转换的典型应用场景

场景 1：将 XML 转换为 HTML

场景 2：数据格式转换

场景 3：数据聚合与过滤

XSLT 转换的核心语法详解

1. 模板匹配（Template Matching）

2. 节点选择与遍历

3. 变量与参数

4. 条件判断与循环

进阶技巧：提升 XSLT 转换效率

1. 模板优先级与模式匹配

2. 使用键（Key）加速查询

3. 模板继承与模式覆盖

常见问题与解决方案

问题 1：转换后输出格式混乱

问题 2：XPath 表达式无法匹配节点

问题 3：动态生成元素名称或属性

实战案例：构建动态价格列表

需求：根据 XML 数据生成带过滤功能的 HTML 页面

输入 XML（products.xml）

XSLT 文件（filter.xsl）

输出效果

总结

最新发布

Rider 2025.1.1 最新破解版安装教程（附激活码~）

Clion 2025.1 最新激活码，破解版安装教程（至2099年~）

GoLand 2025.1 最新激活码，破解版安装教程（至2099年~）

PhpStorm 2025.1 最新破解版安装教程（附激活码~）

DataGrip 2025.1 最新激活码，破解版安装教程（至2099年~）

Webstorm 2025.1 最新激活码，破解版安装教程（至2099年~）

Pycharm 2025.1 最新激活码，破解版安装教程（至2099年~）

IDEA 2025.1 最新激活码，破解版安装教程（至2099年~）

Cursor @ 符号（千字长文）

POP3 协议（一文讲透）

输入 XML（`products.xml`）

XSLT 文件（`filter.xsl`）