JSONからXMLへ

例：繰り返し要素

入力：

{ "users": [ { "name": "Alice" }, { "name": "Bob" } ] }

出力：

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <users>
    <name>Alice</name>
  </users>
  <users>
    <name>Bob</name>
  </users>
</root>

例：配列ラッパー

「配列を<item>で包む」戦略を使用した同じ入力：

<root>
  <users>
    <item>
      <name>Alice</name>
    </item>
    <item>
      <name>Bob</name>
    </item>
  </users>
</root>

タイプマッピング

属性と要素の違い

XMLでは、属性（<user id="1">）と子要素（<user><id>1</id></user>）を区別します。コンバーターはデフォルトで子要素を使います。子要素は往復変換でも情報が失われません。下流のXMLで属性が必要な場合は、キーの接頭辞の規約を使ってください：

• JSONキー@idは親要素上でXML属性id="..."として設定されます。
• JSONキー#textが親要素のテキスト内容となります。

これらの規約は、最も一般的なJSONからXMLへの変換標準であるBadgerFishおよびParkerのマッピングに基づいています。

エスケープ規則

• < -> <
• > -> >
• & -> &
• " → "（属性値において）
• ' → '（任意）
• UTF-8のバイトはそのまま保持され、XMLプロログで宣言されます。

よくある間違い

• ルートレベルのJSON配列。 XMLでは単一のルート要素が必要です。コンバーターはその配列を<root>（またはユーザーが選択した名称）で表現します。
• 数値キー。 JSONの{"1": "a"}は有効です。XML要素名は数字で始めることができません。コンバーターは数字の前にアンダースコア（_1）を付けるか、カスタムマッピングを定義できるようにします。
• 混合配列。 [1, "two", { "x": true }]には明確なマッピングが存在しません。これは通常、JSONデータを変換する前に正規化が必要であることを意味します。
• 大容量のドキュメント。 XMLは記述が詳細なため、10MBのJSONデータが20～30MBのXMLデータに変換されることがあります。非常に大きなデータ量に対してはストリーミング変換を検討してください。