XML to JSON (xml-to-json)
XML to JSON ポリシーは、API のコンテキスト・ペイロードを Extensible Markup Language (XML) 形式から JavaScript Object Notation (JSON) 形式に変換するために使用します。
制約事項: XML to JSON ポリシーは、DataPower® Gateway にのみ使用できます。
概要
XML to JSON ポリシーでは、BadgerFish に基づく単純な規則を使用して、API コンテキスト・ペイロードが XML から JSON に変換されます。XML コンテンツは、属性と名前空間を含めて保持されます。追加の構成は不要です。いくつかの例を含む BadgerFish 規則について詳しくは、BadgerFish を参照してください。
このポリシーを以下の API フローに付加できます。
- REST
- SOAP
組み込みポリシーをフローに追加するために API 定義を作成する場合は、API Designer アセンブリー・ビューを使用します。
このポリシーは、変換を実行する必要があるポイントのフローに付加する必要があります。例えば、XML 形式の要求を JSON 形式の要求に変換する必要がある場合は、このポリシーを要求フローに付加します。
ポリシーは、message.body のコンテキストが存在する場合は message.body から入力を読み取り、存在しない場合は request.body から入力を読み取って、message.body に出力を書き込みます。
プロパティー
以下の表に、このポリシーのプロパティーをリストします。表には、プロパティーが必須かどうか、入力用の有効な値とデフォルト値、および値のデータ型が示されています。
プロパティー・ラベル | 必須 | 説明 | データ型 |
---|---|---|---|
タイトル | はい | ポリシーのタイトル。 デフォルト値は、xml-to-json です。 |
ストリング |
説明 | いいえ | ポリシーの説明。 | ストリング |
例
例えば、以下の単純な XML オブジェクト
<a>hello</a>
は、次のようになります。{ "a": { "$" : "hello" } }
1 つの属性が指定された以下の XML オブジェクト
<a type="world">hello</a>
は、次のようになります。{ "a": { "$" : "hello", "@type" : "world" } }