Dataweave2 语法教程

DataWeave 是 MuleSoft 的数据语言，专门用于数据转换和映射。在 MuleSoft 的 Anypoint Platform 中，它是数据集成的一部分。下面是一个 DataWeave 语法教程，涵盖基本的语法和用法。

基本语法

DataWeave 脚本分为三个部分：%dw 声明、output 指令和数据转换表达式。

%dw 2.0
output application/json
---
{
  message: "Hello, World!"
}

• %dw 2.0：指定 DataWeave 版本。

• output application/json：指定输出格式。

• ---：表示数据转换表达式的开始。

数据类型

DataWeave 支持多种数据类型，包括：

• String

• Number

• Boolean

• Array

• Object

• Null

示例

%dw 2.0
output application/json
---
{
  string: "Hello",
  number: 123,
  boolean: true,
  array: [1, 2, 3],
  object: { key: "value" },
  nullValue: null
}

操作符

算术操作符

• + 加
• - 减
• * 乘
• / 除
• % 取模

逻辑操作符

• && 和
• || 或
• ! 非

比较操作符

• == 等于
• != 不等于
• < 小于
• > 大于
• <= 小于等于
• >= 大于等于

示例

%dw 2.0
output application/json
---
{
  addition: 1 + 2,
  multiplication: 3 * 4,
  comparison: 5 > 3,
  logical: true && false
}

函数

DataWeave 提供了丰富的内置函数，可以进行各种数据转换操作。

常用函数

• sizeOf：返回数组或字符串的长度。
• upper：将字符串转换为大写。
• lower：将字符串转换为小写。
• trim：移除字符串两端的空白字符。
• joinBy：将数组元素用指定字符连接成字符串。

示例

%dw 2.0
output application/json
---
{
  size: sizeOf("Hello"),
  upper: upper("hello"),
  lower: lower("HELLO"),
  trimmed: trim("  hello  "),
  joined: joinBy(["a", "b", "c"], "-")
}

数组和对象操作

映射 (map)

map 函数用于将数组中的每个元素转换为另一个值。

%dw 2.0
output application/json
---
[1, 2, 3] map ((item) -> item * 2)

过滤 (filter)

filter 函数用于过滤数组中的元素。

%dw 2.0
output application/json
---
[1, 2, 3, 4, 5] filter ((item) -> item % 2 == 0)

访问对象属性

可以通过点符号或方括号访问对象属性。

%dw 2.0
output application/json
---
{
  obj: { a: 1, b: 2 },
  valueA: payload.obj.a,
  valueB: payload.obj["b"]
}

条件语句

if-else

可以使用 if-else 进行条件判断。

%dw 2.0
output application/json
---
{
  result: if (sizeOf("hello") > 3) "long" else "short"
}

match

match 语句类似于 switch-case 结构。

%dw 2.0
output application/json
---
{
  sizeCategory: sizeOf("hello") match {
    case size when size < 5 -> "small"
    case size when size < 10 -> "medium"
    else -> "large"
  }
}

完整示例

1. xml转Json

将 XML 数据转换为 JSON，并进行一些数据处理。

输入数据 (XML)

<orders>
    <order>
        <id>1</id>
        <item>Apple</item>
        <quantity>5</quantity>
    </order>
    <order>
        <id>2</id>
        <item>Banana</item>
        <quantity>10</quantity>
    </order>
</orders>

DataWeave 脚本

%dw 2.0
output application/json
---
payload.orders order map {
  orderId: order.id,
  product: upper(order.item),
  amount: order.quantity as Number
}

输出数据 (JSON)

[
  {
    "orderId": "1",
    "product": "APPLE",
    "amount": 5
  },
  {
    "orderId": "2",
    "product": "BANANA",
    "amount": 10
  }
]

2. 数组合并

假设有以下 JSON 对象，其中包含用户信息和用户语文成绩的数组：

输入数据

{
  "users": [
    { "id": 1, "name": "Alice" },
    { "id": 2, "name": "Bob" },
    { "id": 3, "name": "Charlie" }
  ],
  "scores": [
    { "userId": 1, "chinese": 85 },
    { "userId": 2, "chinese": 90 },
    { "userId": 3, "chinese": 78 }
  ]
}

DataWeave 脚本

下面是 DataWeave 脚本，通过用户 ID 匹配两个数组，并将结果整合成一个新的 JSON 数组：

%dw 2.0
output application/json
var users = payload.users
var scores = payload.scores
---
users map (user) -> {
  id: user.id,
  name: user.name,
  chinese: (scores filter ((score) -> score.userId == user.id)).chinese[0] // 提取匹配的语文成绩
}

输出数据

[
  {
    "id": 1,
    "name": "Alice",
    "chinese": 85
  },
  {
    "id": 2,
    "name": "Bob",
    "chinese": 90
  },
  {
    "id": 3,
    "name": "Charlie",
    "chinese": 78
  }
]