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

  4. システムプロパティ

DataWeave システムプロパティ

プロパティ 説明

com.mulesoft.dw.buffered_char_sequence.enabled

内部の ​BufferedCharSequence​ 改善を有効にするか、無効にするかを制御します。このプロパティが ​true​ に設定されると、DataWeave は大きな項目 (1.5M 超) をメモリに読み込みません。DataWeave はこれらの項目をチャンクで読み取ります。この機能はパフォーマンスを抑えてメモリ不足エラーを防止します。

  • 型: Boolean​

  • デフォルト: true​

com.mulesoft.dw.buffersize

処理された入力および出力を保持するために DataWeave で使用するメモリ内の入力バッファおよび出力バッファのサイズ (バイト単位) を設定します。DataWeave では、このサイズを超えるペイロードは一時ファイル ​dw-buffer-index-${count}.tmp​ および ​dw-buffer-output-${count}.tmp​ に保存されます。​DataWeave のメモリ管理​を参照してください。

  • 型: Number​ (バイト)

  • デフォルト: 8192​ バイト (8 KB)

com.mulesoft.dw.coercionexception.verbose

デフォルトでは、型強制に失敗したデータに関する詳細を型強制例外に追加します。このプロパティが ​false​ に設定されている場合、追加のメタデータは表示されません。

  • 型: Boolean​

  • デフォルト: true​

com.mulesoft.dw.date_minus_back_compatibility

このプロパティが ​true​ に設定されている場合、2.3.0 で変更された ​時間の加算と減算動作を復元します。

  • 型: Boolean​

  • デフォルト: false​

使用可能な言語レベル: 2.3、2.4

例:

%dw 2.0
output application/dw
---
|2019-10-01| - |2018-09-23|

  • In DataWeave 2.3.0, the expression returns PT8952H.

  • In DataWeave 2.2.0, the expression returns P1Y8D.

com.mulesoft.dw.directbuffer.disable

DataWeave でオフヒープメモリ (デフォルト) またはヒープメモリのどちらを使用するかを制御します。DataWeave では、内部バッファにはオフヒープメモリが使用されます。このため、少量のメモリのみを搭載するシステムでは、問題が発生する可能性があります。​DataWeave のメモリ管理​を参照してください。

  • 型: Boolean​

  • デフォルト: false​

com.mulesoft.dw.dump_files

実験的機能​: このプロパティが ​true​ に設定されている場合、入力コンテキストと失敗したスクリプトをフォルダーにダンプします。この動作により、失敗したスクリプトとスクリプトを失敗させたデータを追跡できます。これは、受け取った入力データが有効であることを確認するのに特に役立ちます。多くの場合、上流コンポーネントで無効なデータが生成されると、間違ったスクリプトは失敗します。

  • 型: Boolean​

  • デフォルト: false​

com.mulesoft.dw.dump_files​ は​実験的機能​であり、DataWeave の将来のバージョンで変更または削除される場合があります。​「DataWeave スクリプトが失敗した場合のトラブルシューティング」​を参照してください。

com.mulesoft.dw.dump_folder

実験的機能​: com.mulesoft.dw.dump_files​ が ​true​ に設定されている場合にファイルをダンプするパスを指定します。

  • 型: String​

  • デフォルト: java.io.tmpdir​ (システムプロパティ値)

com.mulesoft.dw.dump_folder​ は​実験的機能​であり、DataWeave の将来のバージョンで変更または削除される場合があります。​「DataWeave スクリプトが失敗した場合のトラブルシューティング」​を参照してください。

com.mulesoft.dw.dumper_fill_stacktrace

実験的機能​: com.mulesoft.dw.dump_files​ が ​true​ に設定されている場合、dumper 例外の StackTrace を追加します。

  • 型: Boolean​

  • デフォルト: false​

com.mulesoft.dw.dumper_fill_stacktrace​ は​実験的機能​であり、DataWeave の将来のバージョンで変更または削除される場合があります。DataWeave スクリプトが失敗した場合のトラブルシューティングを参照してください。

com.mulesoft.dw.error_value_length

ユーザーに表示する例外メッセージの最大長を設定します。メッセージはこの最大長で切り捨てられます。この設定は、長い例外メッセージを回避するのに役立ちます。

  • 型: Number​

  • デフォルト: 80​

com.mulesoft.dw.indexsize

インデックス付けされたリーダーで使用するメモリ内のページの最大サイズ (バイト単位) を設定します。

  • 型: Number​

  • デフォルト: 1572864​

com.mulesoft.dw.javaSqlDateToDate

設定すると、​java.sql.Date​ は DataWeave の ​Date​ 型にマップされます。​false​ の場合、​DateTime​ にマップされます。

  • 型: Boolean​

  • デフォルト: false​

使用可能な言語レベル: 2.4、2.5

com.mulesoft.dw.max_memory_allocation

オフヒープメモリプールの各スロットのサイズ (バイト単位) を設定します。DataWeave では、このサイズを超えるペイロードは一時ファイル ​dw-buffer-input-${count}.tmp​ および ​dw-buffer-output-${count}.tmp​ に保存されます。DataWeave メモリ管理を参照してください。

  • 型: Number​

  • デフォルト: 1572864​ (1.5 MB)

com.mulesoft.dw.memory_pool_size

メモリプールのスロットの数を設定します。DataWeave バッファでは、定義されたサイズ (​com.mulesoft.dw.memory_pool_size​ * ​com.mulesoft.dw.max_memory_allocation​) までプールのオフヒープメモリが使用されます。残りはヒープメモリを使用して割り当てられます。​DataWeave のメモリ管理​を参照してください。

  • 型: Number​

  • デフォルト: 60​

com.mulesoft.dw.multipart.defaultContentType

Content-Type​ が指定されていない場合に ​multipart/*​ 形式の部分で使用するデフォルトのコンテンツタイプを設定します。マルチパートリーダープロパティ ​defaultContentType​ も参照してください。​2021 年 8 月リリースの Mule 4.3.0-20210719 の DataWeave 2.3 (2.3.0-20210720) で導入されました。​

  • 型: String​

  • デフォルト: application/octet-stream​

com.mulesoft.dw.stacksize

スタックの最大サイズを設定します。関数の再帰が深すぎると、Stack Overflow などのエラーがスローされます。最大サイズ制限は 256 です。

  • 型: Number​

  • デフォルト: 256​

com.mulesoft.dw.track.cursor.close

true​ に設定されている場合、​CursorProvider#close()​ メソッドのコール元であるスタックトレースを追跡します。 このプロパティは、すでに閉じられているカーソルで ​CursorProvider#openCursor()​ がコールされた場合など、トラブルシューティング目的で使用します。

  • 型: Boolean​

  • デフォルト: false​

com.mulesoft.dw.valueSelector.selectsAlwaysFirst

true​ に設定されている場合、(要素が複数回出現する場合でも) 最初に出現する要素を返します。この動作を有効にすると、パフォーマンスが低下します。

  • 型: Boolean​

  • デフォルト: false​

次の例は、このプロパティにより制御される動作を示しています。(DataWeave スクリプトが XML 入力で動作することを前提とします)。

XML 入力:
<root>
  <users>
     <user>
       <lname>chibana</lname>
       <name>Shoki</name>
     </user>
     <user>
       <name>Shoki</name>
       <name>Tomo</name>
     </user>
  </users>
</root>
DataWeave スクリプト:
%dw 2.0
output application/json
---
{
    shokis: payload.root.users.*user map $.name
}

  • com.mulesoft.dw.valueSelector.selectsAlwaysFirst​ が ​true​ に設定されている場合、スクリプトは次の出力を返します。

    {
  "shokis": [
    "Shoki",
    "Shoki"
  ]
}

  • com.mulesoft.dw.valueSelector.selectsAlwaysFirst​ が ​false​ に設定されている場合、スクリプトは次の出力を返します。

    {
  "shokis": [
    "Shoki",
    "Tomo"
  ]
}

使用可能な言語レベル: 2.3、2.4

com.mulesoft.dw.xml_reader.honourMixedContentStructure

このプロパティが ​true​ に設定されている場合、DataWeave ではテキストを混在コンテンツと一緒に 1 つのテキスト項目にグループ化するのでなく、混在コンテンツ構造を保持します。

  • 型: Boolean​

  • デフォルト: false​

使用可能な言語レベル: 2.4

com.mulesoft.dw.xml_reader.parseDtd

このプロパティが ​true​ に設定されている場合、DataWeave で文書型宣言が解析されます。

  • 型: Boolean​

  • デフォルト: false​

使用可能な言語レベル: 2.5

com.mulesoft.dw.xml.supportDTD

DTD 処理を有効にするか無効にするかを制御します。このプロパティが ​false​ に設定されている場合、内部と外部の両方のサブセットの処理がスキップされます。このプロパティのデフォルトは、2021 年 5 月の DataWeave バージョン 2.3.0 のパッチを含む Mule バージョン 4.3.0-20210427 で ​true​ から ​false​ に変更されました。

  • 型: Boolean​

  • デフォルト: false