MuleSoft DataWeave如何处理XML属性

在DataWeave中显式生成xml属性需用@前缀声明字段（如@id: “123”），动态属性名须用[(“key”)]语法，空属性需用条件展开过滤，且属性与同名子元素不可共存。

如何在DataWeave中显式生成XML属性

DataWeave默认把对象字段渲染为XML子元素，**要生成属性（Attribute），必须用 @ 前缀声明**。这是最常被忽略的语法门槛——没加 @，再怎么写字段名都不会变成属性。

例如，想让 ，必须写成：

%dw 2.0 %output application/xml --- person: {   @id: "123" }

注意：@id 是固定写法，不能写成 @"id" 或 @'id'；值可以是字符串、变量或表达式，但不能是对象或数组（否则会报错）。

• @ 只作用于当前层级的直接字段，不支持嵌套路径（如 @address.city 无效）
• 多个属性并列时，直接平铺写，比如 {@id: "123", @type: "user"}
• 属性名若含连字符（如 xml:lang），需用双引号包裹：@'xml:lang': "en"

如何动态生成XML属性名（带命名空间或计算名）

当属性名本身来自变量或需拼接时，必须用方括号 [] + 字符串插值，@ 不能直接跟变量名。

比如，输入 payload 中有 payload.attrName = "status" 和 payload.attrValue = "active"，要生成 ：

%dw 2.0 %output application/xml --- item: {   [(payload.attrName)]: payload.attrValue }

关键点：[(payload.attrName)] 是动态键语法，等价于 javaScript 的 computed Property；@ 仅用于静态属性名，不可用于此场景。

• 命名空间属性如 xmlns:xsi：写成 @'xmlns:xsi': "http://www.w3.org/2001/XMLSchema-instance"
• 空属性（如 required=""）可直接赋空字符串：@required: ""
• 若属性名含非法标识符字符（空格、冒号、点），必须用单引号或双引号包裹键名

如何避免属性与子元素混淆（常见错误根源）

一个字段既带 @ 又带普通键名，DataWeave 会报错；更隐蔽的问题是：**同名属性和子元素共存时，后者会被忽略且无提示**。

错误示例（看似合理，实则只保留属性，id 子元素消失）：

person: {   @id: "123",   id: "duplicate" // ← 这行不会出现在输出中 }

正确做法：严格区分用途。属性存元数据（ID、type、lang），内容存子元素（name, email）。

• 检查输出时用 %output application/xml indent=true 确保可读性，避免“看不见的丢失”
• 用 write(payload, "application/xml") 在日志中打印中间结果，验证属性是否真被写入
• 如果源是XML且含属性，读取时也需用 @ 访问，例如 payload.person.@id

处理带默认值或条件属性（跳过空属性）

和跳过空标签同理，**空属性（@id: NULL 或 @id: ""）仍会输出为 id=""，这不是你想要的**。必须显式过滤。

推荐写法：用条件展开（() 括号语法）+ when 判断值存在且非空：

%dw 2.0 %output application/xml --- person: {   ( @id: payload.id ) when payload.id != null and payload.id != "",   name: payload.name }

说明：() 表示可选片段，内部表达式只在 when 为 true 时参与构建；比 if-else 更轻量，适合长结构中局部控制。

• 别用 default 处理属性——@id: payload.id default null 不起作用
• 对数字型属性（如 @version: 2），注意 null 和 0 区分，判断时用 payload.version? and payload.version != 0 要谨慎
• csv转XML时，若某列为空，对应属性应整体跳过，而不是留空字符串

属性不是“附加装饰”，而是XML语义的一部分；DataWeave里它和子元素走的是两套解析/生成逻辑，混用就掉坑里。最稳妥的做法：先画出目标XML结构，再逐个字段决定用 @ 还是裸键名，最后用条件展开兜底空值。