1. Homepage
  2. DataWeave (2.2)
  3. DataWeave リファレンス

  4. DataWeave の演算子

DataWeave の演算子

DataWeave 2.2 は Mule 4.2 と互換性があり、Mule 4.2 にバンドルされています。 このバージョンの Mule は、拡張サポートが終了する 2023 年 5 月 2 日にその すべてのサポート​が終了しました。

このバージョンの Mule を使用する CloudHub には新しいアプリケーションをデプロイできなくなります。許可されるのはアプリケーションへのインプレース更新のみになります。

標準サポートが適用されている最新バージョンの Mule 4 にアップグレード​することをお勧めします。これにより、最新の修正とセキュリティ機能強化を備えたアプリケーションが実行されます。

DataWeave 2.0 は、いくつかの数学演算子、等価演算子、比較演算子、論理演算子、先頭追加演算子、追加演算子、フローコントロール演算子、スコープ演算子をサポートしています。 開始する前に、DataWeave バージョン 2 は Mule 4 アプリケーションを対象とすることに注意してください。Mule 3 アプリケーションの場合、Mule 3.9 ドキュメントの​「DataWeave の演算子」​を参照してください。他の Mule バージョンの場合は、Mule Runtime の目次のバージョンセレクターを使用できます。

数学演算子

DataWeave 2.0 は、ほとんどの一般的な数学演算子をサポートしています。

演算子 説明

​+

加算。

​-

減算。

​*

乗算。

​/​

除算。

(-)​ および ​(+)​ 演算子では、数値の操作に加えて、配列、オブジェクト、日付など、複雑なデータ構造も操作できます。

次の例では、さまざまなデータ型で数学演算子を使用します。

ソース
%dw 2.0
output application/json
---
{ "mathOperators" : [
    { "2 + 2" : (2 + 2) },
    { "2 - 2" : (2 - 2) },
    { "2 * 2" : (2 * 2) },
    { "2 / 2" : (2 / 2) },
    { "[1,2,3] - 1 + 4" : [1,2,3] - 1 + 4},
    { "{a:1, b:2, c:3} - 'a' " : {a:1, b:2, c:3} - "a"},
    { "|2021-03-02T10:39:59| - |P1D| + |PT3H|" : |2021-03-02T10:39:59| - |P1D| + |PT3H|}
  ]
}
出力
{
  "mathOperators": [
    { "2 + 2": 4 },
    { "2 - 2": 0 },
    { "2 * 2": 4 },
    { "2 / 2": 1 },
    { "[1,2,3] - 1 + 4": [2,3,4] },
    { "{a:1, b:2, c:3} - 'a' ": {"b": 2, "c": 3} },
    { "|2021-03-02T10:39:59| - |P1D| + |PT3H|": "2021-03-01T13:39:59" }]
}

いくつかの DataWeave 関数は数値を操作します。たとえば、​sum​、​mod​ (剰余)、​avg​ (平均) などがあります。

等価演算子と比較演算子

DataWeave 2.0 は、次の等価演算子と比較演算子をサポートしています。

演算子 説明

​<

次の値より小さい。

​>

次の値より大きい。

​<=

次の値以下。

​>=

次の値以上。

​==

次の値と等しい。

​~=

値の型が異なる場合、等価演算子は、1 つの値をもう 1 つの値の型に強制変換しようとします。

論理演算子​ ​not​ を使用することで、これらの演算子を否定することができます。

次の例では、比較演算子を使用します。

ソース
%dw 2.0
output application/json
---
{ "relational" : [
    { "1 < 1" : (1 < 1) },
    { "1 > 2" : (1 > 2) },
    { "1 <= 1" : (1 <= 1) },
    { "1 >= 1" : (1 >= 1) }
  ]
}
出力
{ "relational": [
    { "(1 < 1)": false },
    { "(1 > 2)": false },
    { "(1 <= 1)": true },
    { "(1 >= 1)": true }
  ]
}

比較演算子のオペランドの型が異なる場合は、DataWeave は右側のオペランドを左側のオペランドの方に強制変換します。 たとえば、式 ​"123" > 12​ では、​12​ (数値型) が ​"12"​ (文字列型) に強制変換され、各文字列値が辞書的順序で比較されます。 式 ​123 > "12"​ では、文字列値 ​"12"​ が数値 ​12​ に強制変換され、数値が比較されます。

次の例では、等価演算子を使用しています。

ソース
%dw 2.0
output application/dw
---
{ "equality" :
  [
    (1 == 1),
    (1 == 2),
    ("true" == true),
    ("true" ~= true),
    (['true'] ~= [true]),
    ('1' ~= 1)
  ]
}
出力
{
  equality: [ true, false, false, true, true, true ]
}

論理演算子

DataWeave 2.0 は、次の論理演算子をサポートしています。

演算子 説明

​not

入力の結果を否定します。​!​ も参照してください。

​!

入力の結果を否定します。​not​ も参照してください。​DataWeave 2.2.0 で導入されました。Mule 4.2 以降でサポートされます。​

​and

すべての入力の結果が true の場合は ​true​ を返し、それ以外の場合は ​false​ を返します。

​or

いずれかの入力の結果が true の場合は ​true​ を返し、それ以外の場合は ​false​ を返します。
not​ と ​!​ のセマンティクスは同じですが、優先順位は異なります。​not true or true​ は ​not (true or true)​ として実行されるため ​false​ を返しますが、​!true or true​ は ​true​ を返します。​!​ が最初の ​true​ にのみ適用されるためです。​!(true or true)​ は ​false​ を返します。

次の例では、論理演算子を使用します。

ソース
%dw 2.0
output application/json
var myArray = [1,2,3,4,5]
var myMap = myArray map not (($ mod 2) == 0)
---
{
  "not" : [
    "notTrue" : not true,
    "notFalse" : not false,
    "myMapWithNot" : myMap
  ],
  "and" : [
    "andTrueFalse" : true and false,
    "andIsTrue" : (1 + 1 == 2) and (2 + 2 == 4),
    "andIsFalse" : (1 + 1 == 2) and (2 + 2 == 2)
  ],
  "or" : [
    "orTrueFalse" : true or false,
    "orIsTrue" : (1 + 1 == 2) or (2 + 2 == 2),
    "orIsFalse" : (1 + 1 == 1) or (2 + 2 == 2)
  ],
  "!-vs-not" : [
	  "example-!" : (! true or true),
	  "example-not" : (not true or true)
  ]
}

myMap​ はリスト (​myArray​) 内の項目を反復処理し、剰余 (​mod​) 式が各項目に適用されたときに ​0​ と評価​されない​かどうかを決定します。

出力
{
  "not": [
    { "notTrue": false },
    { "notFalse": true },
    { "myMapWithNot": [ true, false, true, false, true ] }
  ],
  "and": [
    { "andTrueFalse": false },
    { "andIsTrue": true },
    { "andIsFalse": false }
  ],
  "or": [
    { "orTrueFalse": true },
    { "orIsTrue": true },
    { "orIsFalse": false }
  ],
  "!-vs-not": [
    { "example-!": true },
    { "example-not": false }
  ]
}

not​ は ​not (true)​ のような式では機能しますが、​not(true)​ (スペースなし) では機能しないことに注意してください。

論理演算子は組み合わせて使用することができます。次の例では、以下を使用します。

  • orNot​ 式で定義されている ​or not​。

  • andNot​ の ​and not​。

  • notWithAndNot​ の ​not​ および ​and not​。

例: 論理演算子を組み合わせた使用
%dw 2.0
output application/json
var orNot = if (1 + 1 == 4 or not 1 == 2) {"answer": "orNot - Condition met"}
             else {"answer": "nope"}
var andNot = if (1 + 1 == 2 and not 1 == 2) {"answer": "andNot - Condition met"}
             else {"answer": "nope"}
var notWithAndNot = if (not (1 + 1 == 2 and not 1 == 1)) {"answer": "notWithAndNot - Condition met"}
              else {"answer": "nope"}
---
{ "answers" :
  [
    orNot,
    andNot,
    notWithAndNot
  ]
}
出力
{
  "answers": [
    { "answer": "orNot - Condition met" },
    { "answer": "andNot - Condition met" },
    { "answer": "notWithAndNot - Condition met" }
  ]
}

例のすべての条件式が ​true​ に評価されるため、DataWeave は各 ​if​ ブロック内のコードを実行します。

配列用の先頭追加演算子、追加演算子、および削除加演算子

DataWeave 2.0 では、配列内に項目を追加および先頭に追加する演算子をサポートしています。

演算子 説明

​>>

演算子の左側のデータを右側の配列内の項目の先頭に追加します。たとえば、​1 >> [2]​ の結果は ​[ 1, 2 ]​ となり、配列内の ​2​ の前に ​1​ が追加されます。

​<<

演算子の右側のデータを左側の配列内の項目に追加します。たとえば、​[1] << 2​ の結果は ​[ 1, 2 ]​ となり、配列内の ​1​ の後に ​2​ が追加されます。

​+

演算子の右側のデータを左側の配列内の項目に追加します。たとえば、​[1] + 2​ の結果は ​[ 1, 2 ]​ となり、配列内の ​1​ の後に ​2​ が追加されます。配列は、常に演算子の左側になります。

​-

配列から、サポートされる型の指定された要素を削除します。

次の例では、配列での prepend、append、remove 演算子の使用を示します。

%dw 2.0
output application/json
---
{
  "prepend-append" : [
  	 // Array on right side when prepending.
     { "prepend" : 1 >> [2] },
     { "prepend-number" : 1 >> [1] },
     { "prepend-string" : "a" >> [1] },
     { "prepend-object" : { "a" : "b"} >> [1] },
     { "prepend-array" : [1] >> [2, 3] },
     { "prepend-binary" : (1 as Binary) >> [1] },
     { "prepend-date-time" : |23:57:59Z| >> [ |2017-10-01| ] },
  	 // Array is on left side when appending.
     { "append-number" : [1] << 2 },
     { "append-string" : [1] << "a" },
     { "append-object" : [1] << { "a" : "b"} },
     { "append-array" : [1,2] << [1, 2, 3] },
     { "append-binary" : [1] << (1 as Binary) },
     { "append-date-time" : [ |2017-10-01| ] << |23:57:59Z| },
     { "append-object-to-array" : [1,2] << {"a" : "b"} },
     { "append-array-to-array1" : ["a","b"] << ["c","d"] },
     { "append-array-to-array2" : [["a","b"],["c","d"]] << ["e","f"] },
     // + always appends within the array
     { "append-with-+" : [1] + 2 },
     { "append-with-+" : [2] + 1 },
     { "removeNumberFromArray" : ( [1,2,3] - 2 ) },
     { "removeObjectFromArray" : ( [ {a : "b"}, {c : "d"} , { e : "f"} ] - { c : "d"} ) }
  ]
}
出力
{
  "prepend-append": [
    { "prepend": [ 1, 2 ] },
    { "prepend-number": [ 1, 1 ] },
    { "prepend-string": [ "a", 1 ] },
    { "prepend-array": [ [ 1 ], 2, 3 ] },
    { "prepend-object": [ { "a": "b" }, 1 ] },
    { "prepend-binary": [ "\u0001", 1 ] },
    { "prepend-date-time": [ "23:57:59Z", "2017-10-01" ] },
    { "append-number": [ 1, 2 ] },
    { "append-string": [ 1, "a" ] },
    { "append-object": [ 1, { "a": "b" } ] },
    { "append-array": [ 1, 2, [ 1, 2, 3 ] ] },
    { "append-binary": [ 1, "\u0001" ] },
    { "append-date-time": [ "2017-10-01", "23:57:59Z" ] },
    { "append-object-to-array": [ 1, 2, { "a": "b" } ] },
    { "append-array-to-array1": [ "a", "b", ["c","d"] ] },
    { "append-array-to-array2": [ ["a","b"], ["c","d"], ["e","f"] ] },
    { "append-with-+": [ 1, 2] },
    { "append-with-+": [ 2, 1] },
    { "removeNumberFromArray": [ 1, 3 ] },
    { "removeObjectFromArray": [ { "a": "b" }, { "e": "f" } ] }
  ]
}

スコープ演算子とフローコントロール演算子

DataWeave 2.0 は、式のフローとスコープを制御する演算子をサポートしています。

Table 1. スコープ変数
演算子 説明

​do

スコープを作成します。このスコープ内で、新しい変数、関数、アノテーション、または名前空間を宣言し、使用できます。構文は、​---​ で区切られたヘッダーと本文で構成されるという点でマッピングに似ています。このヘッダーはすべての宣言を定義する場所であり、本文は式の結果です。例については​「do」​と​「例: ローカル DataWeave 変数」​を参照してください。

​using

​do​ に置き換えられました。後方互換性のためにのみサポートされています。
Table 2. フローコントロール演算子
演算子 説明

​if else

​if​ 演算子は条件式を評価し、条件式が true の場合のみ、​if​ の下の値を返します。それ以外の場合、​else​ の下の式を返します。各 ​if​ 式に、対応する ​else​ 式が必要です。例については​「if else」​を参照してください。

​else if

​else if​ を組み込むと、​else​ 演算子によって if-else 構造内での式をまとめてチェーニングできます。例については​「else if」​を参照してください。