XSLT 3.0的新特性在数据映射中的应用

map{} 和 Array{} 是 XSLT 3.0 的第一类数据类型，非语法糖；需声明命名空间、设 method=”json”、显式类型转换，并依赖支持 XSLT 3.0 的处理器。

map{} 和 array{} 是 json 输出的底层构造器，不是语法糖

很多人以为 map{} 和 array{} 只是写起来方便的快捷写法，其实它们是 XSLT 3.0 引入的**第一类数据类型**，和 xs:String 或 xs:Integer 同级。你在模板中返回一个 map{}，XSLT 处理器（如 Saxon）会把它当作“待序列化的 JSON 对象”，而不是 xml 节点树。

• 必须配合
  才能触发自动 JSON 序列化；仅用 map{} 但输出设为 xml 或 text，结果是空或报错
• 嵌套完全合法：map{'users': array{$root/user ! map{'id': xs:integer(@id), 'active': xs:Boolean(@active)}}}
• 键名必须是字符串字面量或 xs:string 类型值，map{@name: 'Alice'} 会失败——@name 是 untyped atomic，需显式转成 string(@name)

从 XML 到 JSON 的映射，本质是结构投影而非文本拼接

老式 XSLT 1.0 常用 {"name":" + + "} 拼 JSON，这极易出错：引号没转义、NULL 值漏判、中文乱码。XSLT 3.0 的正确做法是把 XML 节点“投射”为 map/array 结构，让序列化器负责编码。

• 空元素或缺失属性要用 ?default 防止键丢失：'hobbies': $user/hobbies ? array{.//hobby ! string()}
• 数值/布尔需显式类型转换，否则全变成字符串：'age': xs:integer($user/@age)，'verified': xs:boolean($user/@verified)
• 中文、emoji 直接写进 value 即可，Saxon 9.8+ 默认 UTF-8 输出，无需额外配置

必须声明命名空间才能使用 map/array 构造函数

这是最常被忽略的兼容性陷阱。Saxon（包括 HE 免费版）要求你显式声明 map 和 array 的命名空间，否则 map{} 会被解析为无效函数调用，报错类似 XPST0017: Unknown function map{}。

• 缺 xmlns:map=... 或 xmlns:array=... → 编译失败
• 只声明其中一个 → 另一个构造函数不可用
• 版本必须是 version="3.0"，写成 "3" 或 "3.1" 在部分处理器（如旧版 Saxon）上不认

不是所有环境都支持 XSLT 3.0 —— Biztalk 和浏览器是重灾区

visual studio Code 的逻辑应用扩展、azure Logic apps（标准版）和 Saxon-HE 9.8+ 都支持；但 BizTalk Server 默认只启用了 XSLT 1.0 引擎，浏览器（chrome/firefox/edge）至今仍只内置 XSLT 1.0 支持。

• BizTalk 中若要启用 XSLT 3.0，必须手动配置转换引擎为 Saxon:registered: 或 Saxon 9 HE，并在 GAC 注册对应 DLL
• 浏览器里跑 XSLT 3.0？不行。XML + XSLT 页面会静默失败或回退到 1.0 行为
• 验证是否真在用 3.0：加一行 ，输出应为 3.0

XSLT 3.0 的 map/array 真正价值不在“能写 JSON”，而在于把数据映射从字符串操作升级为类型安全的结构投影——但前提是处理器、命名空间、类型转换三者全部对齐，漏掉任意一环，得到的都不是 JSON，而是报错或无效输出。