XSLT如何定义命名模板？

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

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

name

解决方案

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

name

name

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

  
  
  
  -
  
  -
  

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

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

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

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

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

match

match

match="/"

match="book"

book

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

何时选用？

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

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

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

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

传递参数：

当你通过

name

select

X-Node企业快速建站1.0.6.0801

特色介绍： 1、ASP+XML+XSLT开发，代码、界面、样式全分离，可快速开发 2、支持语言包，支持多模板，ASP文件中无任何HTML or 中文 3、无限级分类，无限级菜单，自由排序 4、自定义版头（用于不规则页面） 5、自动查找无用的上传文件与空目录，并有回收站，可删除、还原、永久删除 6、增强的Cache管理，可单独管理单个Cache 7、以内存和XML做为Cache，兼顾性能与消耗 8、

下载

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

name

select

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

   
   
  




  The sum is:
  
    
    
  






  Dynamic sum:
  
    
    
  

在这个例子中，

calculateSum

num1

num2

处理“返回值”：

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

return

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

  
  
  




  
    
    
  



  Hello, !

在这里，

fullName

getFormattedName

"John Doe"

$fullName

exslt:node-set()

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

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

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

实际应用场景：

1. 统一格式化逻辑： 想象一个电子商务网站，你需要以统一的方式显示商品价格、日期、用户地址。与其在每个显示这些信息的模板中重复写格式化逻辑，不如创建一个

   formatPrice

   、

   formatDate

   或

   formatAddress

   的命名模板。这样，一旦格式要求变更，你只需要修改一个地方。
2. 通用工具函数： XSLT内置的函数虽然不少，但总有不够用的时候。你可以创建自己的“函数库”，比如一个

   trimString

   （去除字符串两端空白）、

   toCamelCase

   （转驼峰命名）、

   splitString

   （按分隔符拆分字符串）等命名模板。这些模板可以接受参数并生成处理后的字符串或节点集。
3. 复杂条件判断或业务规则封装： 有时，一个输出元素的生成依赖于多个复杂的条件判断。与其把一堆

   xsl:if

   和

   xsl:choose

   散落在主模板中，不如将这些判断逻辑封装到一个命名模板里。例如，一个

   determineProductStatus

   模板，根据库存、订单状态、促销信息等返回一个产品的状态描述。
4. 生成标准输出组件： 比如一个网站的页眉、页脚、导航菜单或者一个报告的固定部分。这些内容可能在多个页面或报告中出现，并且结构相对固定，但可能需要根据当前上下文（如用户权限、页面名称）微调。命名模板可以很好地处理这种需求。
5. 调试和日志记录： 在开发阶段，你可能需要打印一些中间变量的值或者输出一些调试信息。你可以创建一个

   logMessage

   命名模板，它接收一个消息字符串和级别，然后将其输出到特定的位置，或者在调试模式下才输出。

最佳实践：

1. 清晰的命名规范： 给你的命名模板起一个描述性强、易于理解的名字。例如，

   formatCurrency

   比

   fmtCur

   要好，

   generateReportHeader

   比

   genHdr

   更明确。这对于团队协作和长期维护至关重要。
2. 单一职责原则： 尽量让每个命名模板只做一件事，并把它做好。一个模板如果既格式化日期又计算价格，那它就可能变得难以维护和复用。保持模板的职责单一，有助于提高其内聚性。
3. 合理使用参数： 不要过度参数化，也不要硬编码应该参数化的值。思考哪些数据是模板每次调用可能变化的，就将其设计为参数。对于那些极少变化或全局性的配置，可以考虑使用全局变量。
4. 默认值与健壮性： 为

   xsl:param

   提供合理的默认值。这能让你的模板在调用方没有提供某个参数时也能正常工作，增加了模板的健壮性。同时，在模板内部对传入的参数进行简单的校验，例如判断是否为空，可以避免一些运行时错误。
5. 注释和文档： 尤其对于复杂的命名模板，务必添加清晰的注释，说明其功能、参数的含义、预期输入和输出。这对于其他人（包括未来的你）理解和使用模板至关重要。
6. 避免过度嵌套： 命名模板之间可以相互调用，但这不意味着你应该创建深层次的调用链。过度的嵌套会使逻辑难以追踪和调试。
7. 平衡使用命名模板和匹配模板： 不要试图用命名模板解决所有问题。XSLT的强大之处在于其基于模式匹配的转换能力。对于处理XML结构的任务，匹配模板往往是更自然、更简洁的选择。命名模板是匹配模板的有力补充，两者结合使用才能发挥XSLT的最大效能。

通过遵循这些原则，你将能够构建出结构清晰、功能强大且易于维护的XSLT样式表，即使面对复杂的转换需求也能游刃有余。