异常教程

XSLT <xsl:when> 元素（手把手讲解）

更新时间:

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

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 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（可扩展样式表语言转换）是一个不可或缺的工具。它允许开发者通过声明式编程的方式，将 XML 文档转换为 HTML、文本或其他格式。而 <xsl:when> 元素作为 XSLT 条件判断的核心组成部分，能够帮助开发者根据特定条件执行不同的逻辑分支。

本文将从基础概念出发，逐步深入探讨 <xsl:when> 的语法、用法、实际案例以及进阶技巧。无论是刚接触 XSLT 的编程新手，还是希望优化代码逻辑的中级开发者，都能从中获得实用的指导。

<xsl:when> 的基础语法与作用

1. 与 <xsl:choose> 的协同工作

在 XSLT 中，<xsl:when> 通常与 <xsl:choose> 和 <xsl:otherwise> 配合使用，形成类似其他编程语言中 switch-case 的结构。其基本语法如下：

<xsl:choose>  
    <xsl:when test="condition1">  
        <!-- 当 condition1 为真时执行的代码 -->  
    </xsl:when>  
    <xsl:when test="condition2">  
        <!-- 当 condition2 为真时执行的代码 -->  
    </xsl:when>  
    <xsl:otherwise>  
        <!-- 当所有条件均不满足时执行的代码 -->  
    </xsl:otherwise>  
</xsl:choose>

比喻说明：可以将 <xsl:choose> 想象成一个交通信号灯控制器，每个 <xsl:when> 是一个特定的信号灯颜色（如红灯、绿灯），而 <xsl:otherwise> 则是默认的“黄灯”。当某个条件成立时，对应的分支就会“亮起”，执行相应的操作。

2. 条件表达式与 XPath 的结合

<xsl:when> 的 test 属性接受一个 XPath 表达式，用于判断条件是否成立。例如：

<xsl:when test="@status = 'active'">  
    <!-- 处理状态为 active 的节点 -->  
</xsl:when>

这里的 @status = 'active' 是一个典型的 XPath 表达式，用于检查当前节点的 status 属性值是否等于字符串 "active"。

关键点：

  • XPath 表达式可以包含逻辑运算符（如 and、or）、比较运算符（如 =, !=, <, >）等。
  • 条件可以涉及节点的属性、文本内容，甚至通过路径导航访问父节点或子节点。

实战案例：使用 <xsl:when> 处理订单状态

案例背景

假设有一个 XML 文档 orders.xml，记录了订单的状态信息：

<orders>  
    <order id="001" status="pending">  
        <product>Computer</product>  
        <price>999.00</price>  
    </order>  
    <order id="002" status="completed">  
        <product>Monitor</product>  
        <price>299.00</price>  
    </order>  
    <order id="003" status="canceled">  
        <product>Keyboard</product>  
        <price>49.99</price>  
    </order>  
</orders>

我们的目标是将订单状态转换为更用户友好的文本，例如：

  • pending → "等待处理"
  • completed → "已发货"
  • canceled → "已取消"

XSLT 转换代码

<xsl:template match="order">  
    <div class="order">  
        <p>订单号：{@id}</p>  
        <p>商品：{product}</p>  
        <p>价格：{price}</p>  
        <p>状态：  
            <xsl:choose>  
                <xsl:when test="@status = 'pending'">等待处理</xsl:when>  
                <xsl:when test="@status = 'completed'">已发货</xsl:when>  
                <xsl:when test="@status = 'canceled'">已取消</xsl:when>  
                <xsl:otherwise>未知状态</xsl:otherwise>  
            </xsl:choose>  
        </p>  
    </div>  
</xsl:template>

运行结果：

  • 对于 id="001" 的订单，状态将显示为“等待处理”；
  • 对于 id="002" 的订单，状态将显示为“已发货”；
  • 对于 id="003" 的订单，状态将显示为“已取消”。

进阶技巧：灵活运用 <xsl:when>

1. 多条件组合与优先级

在同一个 <xsl:choose> 块中，多个 <xsl:when> 条件会按照顺序依次判断。第一个满足条件的分支会被执行，其余分支将被跳过。

示例：

<xsl:choose>  
    <xsl:when test="@priority &gt; 5 and @type = 'urgent'">高优先级紧急任务</xsl:when>  
    <xsl:when test="@priority &gt; 5">高优先级任务</xsl:when>  
    <xsl:when test="@type = 'urgent'">普通紧急任务</xsl:when>  
    <xsl:otherwise>常规任务</xsl:otherwise>  
</xsl:choose>

分析：

  • 如果 priority > 5 且 type="urgent"，则执行第一个 <xsl:when>；
  • 如果仅满足 priority > 5，则执行第二个分支；
  • 如果仅满足 type="urgent"，则执行第三个分支；
  • 其他情况则进入 <xsl:otherwise>。

2. 嵌套 <xsl:choose> 实现复杂逻辑

当条件判断层级较多时，可以通过嵌套 <xsl:choose> 结构实现多维度的逻辑分支。

示例：

<xsl:choose>  
    <xsl:when test="@category = 'electronics'">  
        <xsl:choose>  
            <xsl:when test="@price &gt; 1000">高端电子产品</xsl:when>  
            <xsl:otherwise>普通电子产品</xsl:otherwise>  
        </xsl:choose>  
    </xsl:when>  
    <xsl:otherwise>其他商品</xsl:otherwise>  
</xsl:choose>

性能优化与常见问题

1. 避免重复计算

在 <xsl:when> 的条件表达式中，避免对同一节点进行重复的复杂查询。例如，可以先将结果存储为变量：

<xsl:variable name="status" select="@status" />  
<xsl:choose>  
    <xsl:when test="$status = 'pending'">...</xsl:when>  
    <!-- 其他分支 -->  
</xsl:choose>

2. 处理缺失的属性或节点

如果条件依赖的属性或节点可能不存在，可以使用 boolean() 函数或 exists() 函数进行安全判断：

<xsl:when test="boolean(@status)">  
    <!-- 当 status 属性存在时执行 -->  
</xsl:when>

3. 错误示例：忽略 <xsl:otherwise>

错误代码：

<xsl:choose>  
    <xsl:when test="@type = 'book'">...</xsl:when>  
</xsl:choose>

问题：若 @type 的值不是 "book"，则 <xsl:choose> 将不会输出任何内容，可能导致逻辑漏洞。建议始终添加 <xsl:otherwise> 处理默认情况。

XSLT <xsl:when> 的应用场景

1. 数据格式转换

在将 XML 转换为 HTML 时，可以根据节点类型动态生成不同的 HTML 标签。例如：

<xsl:choose>  
    <xsl:when test="node()/@type = 'header'">  
        <h2><xsl:value-of select="."/></h2>  
    </xsl:when>  
    <xsl:when test="node()/@type = 'list'">  
        <ul><xsl:apply-templates select="item"/></ul>  
    </xsl:when>  
</xsl:choose>

2. 动态样式控制

通过条件判断为不同数据项添加 CSS 类：

<div class="product {  
    <xsl:choose>  
        <xsl:when test="@discount &gt; 0">on-sale</xsl:when>  
        <xsl:otherwise>regular</xsl:otherwise>  
    </xsl:choose>  
}">  
    <!-- 产品详情 -->  
</div>

3. 错误处理与容错

在解析不确定的 XML 数据时，可以使用 <xsl:when> 进行数据验证：

<xsl:choose>  
    <xsl:when test="number(@price)">  
        <p>价格：{@price}</p>  
    </xsl:when>  
    <xsl:otherwise>  
        <p>价格无效</p>  
    </xsl:otherwise>  
</xsl:choose>

总结

通过本文的讲解，我们深入理解了 XSLT <xsl:when> 元素的核心功能、语法结构以及实际应用场景。从基础条件判断到复杂逻辑嵌套，再到性能优化与容错处理，开发者可以灵活运用这一工具实现 XML 到其他格式的高效转换。

无论是构建动态的 HTML 页面、生成数据报告，还是进行 XML 数据的规范化处理，<xsl:when> 都是 XSLT 工具箱中不可或缺的利器。希望本文能帮助你在实际开发中更好地掌握这一技术，提升 XML 处理的效率与代码质量。

（全文约 1800 字）

最新发布

查看更多文章