17370845950

Mule ESB如何使用DataWeave转换XML
Mule ESB 使用 DataWeave 转换 XML 的核心是通过 Transform Message 组件编写脚本,解析输入 XML 为 Map/List 结构后映射为目标格式,需注意命名空间声明、属性语法(@key)、重复节点遍历(.*element)、default 和 if (field?) 处理空值,以及 writeAttributes 和 indent 控制输出。

Mule ESB 使用 DataWeave 转换 XML,核心是通过 Transform Message 组件编写 DataWeave 脚本,将输入 XML 解析为 DataWeave 内部的 Map/List 结构,再映射为目标 XML 格式。关键在于理解 XML 输入的结构、正确使用命名空间、以及控制输出 XML 的格式(如根元素、属性、CDATA 等)。

解析输入 XML:自动推断与显式声明

DataWeave 默认能自动识别并解析传入的 XML(如来自 HTTP Listener 或 File Connector 的 payload),将其转为嵌套对象。若 XML 含命名空间,需在脚本开头显式声明,否则字段可能无法访问:

%dw 2.0
output application/xml
ns soap http://schemas.xmlsoap.org/soap/envelope/
ns ns0 http://example.com/order
---
{
  soap#Envelope: {
    soap#Body: {
      ns0#OrderResponse: {
        ns0#OrderId: payload.soap#Envelope.soap#Body.ns0#OrderResponse.ns0#OrderId
      }
    }
  }
}

说明:

  • ns 声明必须与原始 XML 中的 namespace URI 完全一致
  • 访问带命名空间的节点时,用 nsName#ElementName 语法
  • 若输入 XML 无命名空间,可省略 ns 声明,直接用 payload.root.child

构建输出 XML:控制结构与格式

输出 XML 的结构由右侧映射表达式决定。DataWeave 支持设置根元素名、添加属性、生成 CDATA、控制缩进等:

%dw 2.0
output application/xml writeAttributes = true, indent = true
---
{
  "Order": {
    "@id": payload.order.id, // 输出为属性:
    "Customer": payload.order.customer.name,
    "Items": {
      "Item": payload.order.items.*item map ((item, index) -> {
        "Sku": item.sku,
        "Quantity": item.quantity
      })
    }
  }
}

说明:

  • @key 语法生成 XML 属性(如 @id
  • .*element 遍历同名重复子节点(XML 中常见)
  • writeAttributes = true 确保属性被写出;indent = true 提高可读性
  • 若需 CDATA 包裹文本,用 ![CDATA[...]] 字面量(DataWeave 2.4+)

处理常见 XML 特性:空值、默认值与条件节点

XML 转换常需处理缺失字段、空元素或按条件包含节点。DataWeave 提供简洁语法:

%dw 2.0
output application/xml
---
{
  "Response": {
    "Status": payload.status default "OK",
    "Message": payload.message,
    "Details": if (payload.details?) {
      {
        "Code": payload.details.code,
        "Description": payload.details.description
      }
    } else null
  }
}

说明:

  • default 为字段提供备选值,避免 null 导致错误
  • if (payload.field?) 检查字段是否存在(比 != null 更安全)
  • 返回 null 时,对应 XML 节点将被跳过(不会输出空标签)
  • 若需输出空标签 ,显式写 "Field": ""

调试与验证技巧

转换出错时,优先检查三类问题:

  • 输入 payload 是否确实是 XML?用 Logger 打印 payloadattributes.headers.'content-type' 确认类型
  • 命名空间 URI 是否拼写一致?大小写、末尾斜杠均敏感
  • 是否误用 . 访问重复节点?XML 中 AB 对应 payload.*item,不是 payload.item
  • 在 Anypoint Studio 中启用 DataWeave Debugger,逐行查看变量值和类型