XSLT如何定义命名模板？（命名.定义.模板.XSLT...）

在XSLT中，命名模板通过<xsl:template name="...">定义，配合<xsl:call-template>调用，实现逻辑复用与模块化，适用于需多次调用、参数化处理或与XML结构无关的任务，如格式化、通用函数和复杂条件封装，提升代码可维护性。

xslt如何定义命名模板？

在XSLT中，定义命名模板的核心方式是使用

<xsl:template>

元素，并为其赋予一个独特的

name

属性。这就像你在编程语言里定义一个函数或子程序一样，你可以随时通过它的名字来调用它，而不必依赖于XML源文档的特定结构或上下文。它提供了一种强大的机制，用于实现代码的复用、模块化以及执行那些不直接与输入XML节点匹配相关的逻辑。解决方案

要定义一个命名模板，你需要在XSLT样式表的顶层（或者在其他模板内部，但通常推荐在顶层以保持清晰）使用

<xsl:template>

标签，并添加一个

name

属性。这个

name

属性的值就是你用来调用这个模板的标识符。

例如，如果你想创建一个模板来格式化日期，你可以这样定义：

<xsl:template name="formatDate">
  <xsl:param name="inputDate"/>
  <!-- 这里是日期格式化的逻辑 -->
  <xsl:value-of select="substring($inputDate, 1, 4)"/>
  <xsl:text>-</xsl:text>
  <xsl:value-of select="substring($inputDate, 5, 2)"/>
  <xsl:text>-</xsl:text>
  <xsl:value-of select="substring($inputDate, 7, 2)"/>
</xsl:template>

然后，在你的XSLT样式表的任何地方，当你需要使用这个日期格式化功能时，你就可以通过

<xsl:call-template>

元素来调用它，并传递相应的参数：

<someElement>
  <xsl:call-template name="formatDate">
    <xsl:with-param name="inputDate" select="/root/item/dateField"/>
  </xsl:call-template>
</someElement>

这种模式的便利性在于，它将特定的处理逻辑封装起来，使得代码更易于管理和维护。你可以想象，如果你的XSLT变得非常庞大，到处都是重复的日期格式化代码，那会是多么令人头疼的事情。命名模板就是解决这类问题的利器。

命名模板与匹配模板：何时选用，如何区分？

这确实是个常见的问题，很多人刚接触XSLT时会在这里感到困惑。简单来说，命名模板和匹配模板虽然都用

<xsl:template>

定义，但它们的触发机制和使用场景是截然不同的。

匹配模板（Match Templates），顾名思义，是通过

match

属性来定义规则的。它们的核心思想是“响应式”的：当XSLT处理器遍历源XML文档时，如果遇到一个节点与某个模板的

match

属性定义的模式相符，那么这个模板就会被隐式地“激活”并执行。这通常是通过

<xsl:apply-templates>

指令来驱动的。匹配模板是XSLT进行结构转换的基石，它让你可以将XML输入结构映射到不同的输出结构。比如，

match="/"

会匹配根节点，

match="book"

会匹配所有名为

book

的元素。它们是基于XML文档的“事件驱动”模型。

命名模板（Named Templates）则完全不同。它们不关心源XML文档的结构，也不会被隐式触发。它们更像是传统编程语言中的“函数”或“子例程”。你必须通过

<xsl:call-template name="yourTemplateName"/>

指令显式地去调用它们。它们是“命令式”的，你告诉XSLT处理器“现在，执行这个名为XX的逻辑”。

何时选用？

选择匹配模板：当你需要将源XML的结构转换为另一种结构时。例如，将XML数据渲染成HTML表格，或者将一个复杂的XML结构简化成另一个XML结构。你的转换逻辑紧密依赖于输入XML的节点层次和内容。这是XSLT最核心，也最常用的功能。
选择命名模板：
- 复用性：当一段处理逻辑需要在样式表的不同位置被多次调用，并且这段逻辑与当前处理的XML节点上下文没有强绑定关系时。比如上面提到的日期格式化、字符串处理、通用计算等。
- 模块化：将复杂的转换任务分解成更小、更易于管理的逻辑单元。这有助于提高代码的可读性和可维护性。
- 参数化处理：当你的逻辑需要接受外部参数，而不是仅仅依赖于当前节点的值时。
- 非结构性生成：当你需要生成一些与源XML结构无关的输出内容时，比如生成一个固定的页眉、页脚，或者根据某些条件生成一段报告摘要。

你可以把匹配模板想象成一个厨师，他根据你提供的食材（XML节点）来烹饪（转换）。而命名模板则像厨房里的一些工具，比如切菜机、搅拌器，你可以随时拿来用，给它输入一些东西，它就完成特定的工作，不一定非要和正在处理的食材直接关联。

如何向命名模板传递参数并处理返回值？

向命名模板传递参数是其强大功能的核心，它让模板变得更加灵活和通用。至于“返回值”，XSLT的处理方式可能和传统编程语言有些不同，但概念上是类似的。

传递参数：

当你通过

<xsl:call-template>

调用一个命名模板时，你可以使用一个或多个

<xsl:with-param>

子元素来传递参数。每个

<xsl:with-param>

需要一个

name

属性来指定参数的名称，以及一个

select

属性来指定参数的值（可以是XPath表达式，也可以是字面量）。

在被调用的命名模板内部，你需要使用

<xsl:param>

元素来声明并接收这些参数。

<xsl:param>

也需要一个

name

属性来匹配传入的参数名。你还可以为它提供一个

select

属性，作为参数的默认值，如果调用时没有传入这个参数，就会使用默认值。

看一个例子，我们来创建一个计算两个数之和的命名模板：

<!-- 定义一个计算和的命名模板 -->
<xsl:template name="calculateSum">
  <xsl:param name="num1" select="0"/> <!-- 默认值0 -->
  <xsl:param name="num2" select="0"/> <!-- 默认值0 -->
  <xsl:value-of select="$num1 + $num2"/>
</xsl:template>

<!-- 在其他地方调用它并传递参数 -->
<result>
  The sum is:
  <xsl:call-template name="calculateSum">
    <xsl:with-param name="num1" select="10"/>
    <xsl:with-param name="num2" select="25"/>
  </xsl:call-template>
</result>

<!-- 也可以从XML节点获取值传递 -->
<xsl:variable name="valA" select="/data/valueA"/>
<xsl:variable name="valB" select="/data/valueB"/>
<anotherResult>
  Dynamic sum:
  <xsl:call-template name="calculateSum">
    <xsl:with-param name="num1" select="$valA"/>
    <xsl:with-param name="num2" select="$valB"/>
  </xsl:call-template>
</anotherResult>

在这个例子中，

calculateSum

模板接收

num1

和

num2

两个参数，并输出它们的和。

处理“返回值”：

XSLT的模板本质上是生成“结果树片段”（Result Tree Fragment, RTF）或者说，它们是“输出”内容。它没有像JavaScript或Python函数那样，通过

return

关键字返回一个单一的、类型明确的值。当一个模板被调用时，它所产生的所有输出（文本、元素、属性等）就是它的“结果”。

如果你想捕获一个命名模板的输出并将其用作另一个XPath表达式的一部分，你可以将模板的调用封装在一个

<xsl:variable>

或

<xsl:param>

中。

<xsl:template name="getFormattedName">
  <xsl:param name="firstName"/>
  <xsl:param name="lastName"/>
  <xsl:value-of select="concat($firstName, ' ', $lastName)"/>
</xsl:template>

<!-- 捕获模板的输出到变量中 -->
<xsl:variable name="fullName">
  <xsl:call-template name="getFormattedName">
    <xsl:with-param name="firstName" select="'John'"/>
    <xsl:with-param name="lastName" select="'Doe'"/>
  </xsl:call-template>
</xsl:variable>

<output>
  Hello, <xsl:value-of select="$fullName"/>!
</output>

在这里，

fullName

变量会包含

getFormattedName

模板生成的所有内容，即

"John Doe"

。需要注意的是，在XSLT 1.0中，

$fullName

是一个结果树片段，不能直接在所有XPath函数中使用。但在XSLT 2.0及更高版本中，RTF被提升为序列，使用起来更加灵活。如果需要在XSLT 1.0中对RTF进行进一步处理，通常需要使用

exslt:node-set()

这样的扩展函数将其转换为节点集。

所以，理解XSLT的“返回值”是它生成的内容，而不是一个简单的数据类型，这点很重要。

命名模板在复杂XSLT项目中的实际应用场景与最佳实践

在大型或复杂的XSLT项目中，命名模板的价值才真正凸显出来。它们不仅仅是简单的代码复用工具，更是构建可维护、可扩展和易于理解的样式表的关键。

实际应用场景：

统一格式化逻辑：想象一个电子商务网站，你需要以统一的方式显示商品价格、日期、用户地址。与其在每个显示这些信息的模板中重复写格式化逻辑，不如创建一个
```
formatPrice
```
、
```
formatDate
```
或
```
formatAddress
```
的命名模板。这样，一旦格式要求变更，你只需要修改一个地方。
通用工具函数： XSLT内置的函数虽然不少，但总有不够用的时候。你可以创建自己的“函数库”，比如一个
```
trimString
```
（去除字符串两端空白）、
```
toCamelCase
```
（转驼峰命名）、
```
splitString
```
（按分隔符拆分字符串）等命名模板。这些模板可以接受参数并生成处理后的字符串或节点集。
复杂条件判断或业务规则封装：有时，一个输出元素的生成依赖于多个复杂的条件判断。与其把一堆
```
xsl:if
```
和
```
xsl:choose
```
散落在主模板中，不如将这些判断逻辑封装到一个命名模板里。例如，一个
```
determineProductStatus
```
模板，根据库存、订单状态、促销信息等返回一个产品的状态描述。
生成标准输出组件：比如一个网站的页眉、页脚、导航菜单或者一个报告的固定部分。这些内容可能在多个页面或报告中出现，并且结构相对固定，但可能需要根据当前上下文（如用户权限、页面名称）微调。命名模板可以很好地处理这种需求。
调试和日志记录：在开发阶段，你可能需要打印一些中间变量的值或者输出一些调试信息。你可以创建一个
```
logMessage
```
命名模板，它接收一个消息字符串和级别，然后将其输出到特定的位置，或者在调试模式下才输出。

最佳实践：

清晰的命名规范：给你的命名模板起一个描述性强、易于理解的名字。例如，
```
formatCurrency
```
比
```
fmtCur
```
要好，
```
generateReportHeader
```
比
```
genHdr
```
更明确。这对于团队协作和长期维护至关重要。
单一职责原则：尽量让每个命名模板只做一件事，并把它做好。一个模板如果既格式化日期又计算价格，那它就可能变得难以维护和复用。保持模板的职责单一，有助于提高其内聚性。
合理使用参数：不要过度参数化，也不要硬编码应该参数化的值。思考哪些数据是模板每次调用可能变化的，就将其设计为参数。对于那些极少变化或全局性的配置，可以考虑使用全局变量。
默认值与健壮性：为
```
xsl:param
```
提供合理的默认值。这能让你的模板在调用方没有提供某个参数时也能正常工作，增加了模板的健壮性。同时，在模板内部对传入的参数进行简单的校验，例如判断是否为空，可以避免一些运行时错误。
注释和文档：尤其对于复杂的命名模板，务必添加清晰的注释，说明其功能、参数的含义、预期输入和输出。这对于其他人（包括未来的你）理解和使用模板至关重要。
避免过度嵌套：命名模板之间可以相互调用，但这不意味着你应该创建深层次的调用链。过度的嵌套会使逻辑难以追踪和调试。
平衡使用命名模板和匹配模板：不要试图用命名模板解决所有问题。XSLT的强大之处在于其基于模式匹配的转换能力。对于处理XML结构的任务，匹配模板往往是更自然、更简洁的选择。命名模板是匹配模板的有力补充，两者结合使用才能发挥XSLT的最大效能。