
本文详解如何在 xslt 3.0 中基于嵌套 map 和 array 数据结构,使用函数式语法(而非命令式循环)安全、简洁地提取字段并构造新数组,避免变量不可变性导致的常见陷阱。
本文详解如何在 xslt 3.0 中基于嵌套 map 和 array 数据结构,使用函数式语法(而非命令式循环)安全、简洁地提取字段并构造新数组,避免变量不可变性导致的常见陷阱。
XSLT 3.0 的变量是不可变的(immutable)——一旦声明并赋值,其内容无法修改。因此,您原始代码中试图在 内重复声明同名变量 来“累加”元素的做法,在语义上是无效的:每次声明都会创建一个作用域内全新变量,对外层 $myArray 完全无影响,最终 array:size($myArray) 返回 0,导致后续循环不执行,也解释了为何 "test" 字符串未被输出。
正确的做法是摒弃命令式思维,采用 XPath 3.1 的序列构造与高阶函数式表达。针对您的数据结构:
<variable name="input-map" select="
map {
'persons': [
map { 'name': 'John', 'age': 33, 'residence': 'Permanent' },
map { 'name': 'Peter', 'age': 36, 'residence': 'Temporary' }
]
}"></variable>
要提取所有 name 字段并构造成新数组,推荐使用 array{} 构造器 + 路径表达式展开:
<variable name="myArray" select="array{$input-map?persons?*?name}"></variable>
✅ 原理说明:
-
$input-map?persons获取 persons 数组(类型为array(map(*))); -
?*对数组中每个元素(即每个 person map)进行解包迭代; -
?name从每个 map 中安全提取name键对应的字符串值; -
array{...}将整个序列(('John', 'Peter'))直接封装为新数组。
该表达式简洁、高效、声明式,且完全符合 XSLT 3.0 函数式范式。
✅ 完整可运行示例
<stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" version="3.0"><output method="text"></output><template match="/"><!-- 模拟输入数据 --><variable name="input-map" select="
map {
'persons': [
map { 'name': 'John', 'age': 33, 'residence': 'Permanent' },
map { 'name': 'Peter', 'age': 36, 'residence': 'Temporary' }
]
}"></variable><!-- ✅ 正确:函数式构造新数组 --><variable name="namesArray" select="array{$input-map?persons?*?name}"></variable><!-- 输出验证 --><text>Names array contains </text><value-of select="array:size($namesArray)"></value-of><text> items:</text><text></text><for-each select="1 to array:size($namesArray)"><text> • Person name is: </text><value-of select="array:get($namesArray, .)"></value-of><text></text></for-each></template></stylesheet>
输出结果:
Names array contains 2 items: • Person name is: John • Person name is: Peter
⚠️ 注意事项与进阶提示
-
不要滥用
array:append()循环:虽然array:append($arr, $item)合法,但反复调用会生成大量中间数组,性能差且易出错(因忽略返回值)。 -
空值安全处理:若某些 person 可能缺失
name,改用?name => string()或?name => fn:if(., ., 'N/A')避免空序列中断。 -
类型明确性:
array{}构造器要求所有项类型兼容;若需强类型校验,可包裹as array(xs:string)。 -
扩展场景:如需同时提取
name和age组成复合数组(如array{map{'name':..., 'age':...}}),可写为array{$input-map?persons?* => map{ 'name': ?name, 'age': ?age }}。
掌握 array{} 与 ?*?key 的组合,是驾驭 XSLT 3.0 高级数据处理的关键一步——它让数组操作回归简洁、可靠与可读。










