URL エンコード形式

MIME タイプ: application/x-www-form-urlencoded

ID: urlencoded

URL エンコードデータはキー-値ペアのコレクションを表します。DataWeave はこれらの値を、各値を文字列として含むオブジェクトとして表します。

次の例は、URL エンコード形式の使用方法を示しています。

例: URL エンコードデータを DataWeave (dw) 形式で表す

次の例は、簡単な URL エンコードデータが DataWeave でどのように表されるかを示しています。

入力

この URL エンコードデータが DataWeave ソースへの入力ペイロードとして機能します。

name=Mariano&lastName=de+Achaval

ソース

DataWeave スクリプトは、URL エンコードされた入力ペイロードを DataWeave (dw) 形式および MIME タイプに変換します。

%dw 2.0
output application/dw
---
payload

出力

出力は、入力からのキー-値ペアのコレクションを含む DataWeave オブジェクトです。

{
    "name": "Mariano",
    "lastName": "de Achaval"
}

例: JSON オブジェクトから URL エンコードデータを生成

次の例は、URL エンコードデータの生成方法を示しています。

入力

この JSON オブジェクトが DataWeave ソースへの入力ペイロードとして機能します。

{
  "name": "Mariano"
}

ソース

DataWeave スクリプトは入力ペイロードの ​name​ キーの値を選択し、スクリプトの本文内のオブジェクトのすべての値を ​urlencoded​ 形式に変換します。

%dw 2.0
output urlencoded
---
{
    name: payload.name,
    age: 37
}

出力

出力は、DataWeave スクリプトの本文内のキー-値ペアから構築された URL エンコードデータです。

name=Mariano&age=37

例: キー-値ペアのコレクションから URL エンコードデータを生成

DataWeave スクリプトは、URL エンコードされた出力を生成します。

ソース

DataWeave スクリプトは、スクリプトの本文内にある JSON 入力の形式を URL エンコード形式に変換します。

%dw 2.0
output application/x-www-form-urlencoded
---
{
  "key" : "value",
  "key 1": "@here",
  "key" : "other value",
  "key 2%": null
}

出力

出力は、URL エンコード形式の入力データを示します。

key=value&key+1=%40here&key=other+value&key+2%25

例: URL エンコードデータをテキスト/プレーン形式に変換

次の例では、URL エンコードされた入力をテキスト/プレーン形式および MIME タイプに変換します。

ソース

DataWeave スクリプトは、URL エンコードデータを読み取って、選択されたキーの値を連結します。

%dw 2.0
var myData  read('key=value&key+1=%40here&key=other+value&key+2%25', 'application/x-www-form-urlencoded')
output text/plain
---
myData.*key[0] ++ myData.'key 1'

出力

出力はテキスト/プレーン形式です。

value@here

Configuration のプロパティ

DataWeave では、URL エンコード形式に対して次の設定プロパティがサポートされます。

リーダープロパティ (URL エンコードデータ用)

URL エンコードデータのリーダープロパティはありません。

ライター (URL エンコードデータ)

URL エンコード形式は、出力データを書き込むための指示を提供するプロパティを受け入れます。

パラメーター デフォルト 説明

bufferSize

Number

8192

ライターバッファのサイズ。

deferred

Boolean

false

true​ に設定すると、DataWeave は出力をデータストリームとして生成し、スクリプトの実行はそれがコンシュームされるまで延期されます。 有効な値は、​true​ または ​false​ です。

encoding

String

null

使用するライターのエンコード。

サポートされる MIME タイプ

URL エンコード形式では、次の MIME タイプがサポートされます。

MIME タイプ

application/x-www-form-urlencoded