在MuleSoft的数据集成场景中,XML是常用的数据交换格式,很多XML元素会携带属性信息,DataWeave提供了完善的能力来处理这些XML属性,无需额外编写复杂逻辑即可完成属性的读取、修改和新增操作。

读取XML元素的属性
DataWeave中解析XML后,元素的属性会被存放在@符号对应的对象中,通过元素名.@属性名的语法即可读取对应属性的值。下面是一个读取XML属性的示例,首先准备一段包含属性的XML输入数据:
<user id="1001" status="active">
<name>张三</name>
<age>25</age>
</user>
使用DataWeave读取该XML中user元素的id和status属性,代码如下:
%dw 2.0
output application/json
---
{
userId: payload.user.@id,
userStatus: payload.user.@status,
userName: payload.user.name
}
上述代码执行后输出的JSON结果为:
{
"userId": "1001",
"userStatus": "active",
"userName": "张三"
}
修改XML元素的属性
如果需要修改XML元素的属性值,只需要在DataWeave的XML输出结构中重新定义@对象即可,原有属性会被新的定义覆盖,不需要保留的属性可以不写入。下面的示例将上面XML中user的id修改为1002,status修改为inactive:
%dw 2.0
output application/xml
---
user @(id: "1002", status: "inactive"): {
name: payload.user.name,
age: payload.user.age
}
输出的XML结果为:
<user id="1002" status="inactive">
<name>张三</name>
<age>25</age>
</user>
新增XML元素的属性
新增属性和修改属性的语法一致,只需要在@对象中添加原来不存在的属性名和对应的值即可。下面的示例在原有user元素的基础上新增一个createTime属性:
%dw 2.0
output application/xml
---
user @(id: payload.user.@id, status: payload.user.@status, createTime: "2024-05-20"): {
name: payload.user.name,
age: payload.user.age
}
输出的XML结果会包含新增的createTime属性:
<user id="1001" status="active" createTime="2024-05-20">
<name>张三</name>
<age>25</age>
</user>
处理带命名空间的XML属性
如果XML元素使用了命名空间,属性读取的语法需要加上命名空间前缀,格式为元素名.@命名空间前缀#属性名。例如下面的带命名空间的XML:
<ns:user xmlns:ns="http://www.ippipp.com/user" ns:id="1001">
<ns:name>李四</ns:name>
</ns:user>
读取id属性的DataWeave代码如下:
%dw 2.0
output application/json
ns user = "http://www.ippipp.com/user"
---
{
userId: payload.user.@user#id,
userName: payload.user.name
}
输出结果为:
{
"userId": "1001",
"userName": "李四"
}
注意事项
- XML属性的值在DataWeave中默认会被解析为字符串类型,如果需要转换为其他类型,可以使用
as关键字进行类型转换,例如payload.user.@id as Number。 - 如果XML元素没有对应的属性,读取该属性会返回
null,开发时可以根据需要处理空值场景。 - 输出XML时,如果
@对象中定义的属性值为null,该属性不会被写入最终的XML结果中。