JSON to XML コンバーター

JSON to XML変換とは何ですか？どのように機能しますか？

// Convert JSON to XML in Node.js using fast-xml-parser
import { XMLBuilder } from 'fast-xml-parser';

const data = {
  catalog: {
    product: {
      '@_id': 'P01',
      '@_category': 'electronics',
      name: 'Wireless Headphones',
      price: {
        '@_currency': 'USD',
        '#text': '79.99'
      }
    }
  }
};

const builder = new XMLBuilder({
  attributeNamePrefix: '@_',   // @_ keys become XML attributes
  textNodeName: '#text',       // #text key becomes element text content
  ignoreAttributes: false,     // process @_ attribute keys
  format: true,                // pretty-print with indentation
  indentBy: '  ',              // 2-space indent
});

const xml = builder.build(data);
console.log(xml);
// <catalog>
//   <product id="P01" category="electronics">
//     <name>Wireless Headphones</name>
//     <price currency="USD">79.99</price>
//   </product>
// </catalog>

主な機能

サンプル

{"user":{"id":42,"name":"Alice Kim","email":"alice@example.com","role":"admin","address":{"city":"Seoul","country":"KR"}}}

[{"id":1,"name":"Widget A","price":9.99},{"id":2,"name":"Widget B","price":14.99},{"id":3,"name":"Widget C","price":4.49}]

{"catalog":{"product":{"@_id":"P01","@_category":"electronics","name":"Wireless Headphones","price":{"@_currency":"USD","#text":"79.99"}}}}

使い方

1. 1

   JSONを貼り付ける

   上の入力フィールドにJSONデータを入力または貼り付けてください。「サンプルを読み込む」をクリックして、APIレスポンスオブジェクト、配列ペイロード、または @_ 属性と #text を使用したオブジェクトのサンプルを試すこともできます。

2. 2

   ライブXML出力を確認する

   XMLは即座に出力パネルに表示されます。単一キーのオブジェクトはそのキーをルートとして使用します。複数キーのオブジェクトは でラップされます。@_ プレフィックス付きキーは属性になります。配列は繰り返す子要素になります。必要に応じてインデント（2または4スペース）を調整してください。

3. 3

   コピーまたはダウンロード

   「コピー」をクリックしてXMLをクリップボードに取得するか、「ダウンロード」をクリックして.xmlファイルとして保存してください。結果をバリデートまたは再整形するには、XMLフォーマッターに貼り付けてください。

よくある変換ミス

// Input: { "status": 200, "data": { "id": 1 } }
// Output: <root><status>200</status><data><id>1</id></data></root>
// Root is <root> — may not match your schema

// Wrap in a named key to control the root element
// Input: { "response": { "status": 200, "data": { "id": 1 } } }
// Output: <response><status>200</status><data><id>1</id></data></response>

// Input: [{ "id": 1 }, { "id": 2 }]
// Output: <root><item><id>1</id></item><item><id>2</id></item></root>
// Tag names are generic

// Wrap in a named key for meaningful tag names
// Input: { "products": [{ "id": 1 }, { "id": 2 }] }
// Output: <root><products><id>1</id></products><products><id>2</id></products></root>
// Each array element reuses the key name "products" as its tag

// Input: { "tag": { "id": "42", "name": "Alice" } }
// Output: <tag><id>42</id><name>Alice</name></tag>  ← id is a child element

// Use @_ prefix for attributes
// Input: { "tag": { "@_id": "42", "name": "Alice" } }
// Output: <tag id="42"><name>Alice</name></tag>  ← id is an attribute

// Input: { "price": { "@_currency": "USD", "value": "29.99" } }
// Output: <price currency="USD"><value>29.99</value></price>
// Text is a child element, not text content

// Use #text for element text content
// Input: { "price": { "@_currency": "USD", "#text": "29.99" } }
// Output: <price currency="USD">29.99</price>  ← text content

// JSON key starts with digit — invalid XML element name
// Input: { "1stItem": "value" }
// Output: <1stItem>value</1stItem>  ← invalid XML

// Use a valid XML element name
// Input: { "firstItem": "value" }
// Output: <firstItem>value</firstItem>  ← valid XML

// JSON: { "query": "name = 'Alice' & role = 'admin'" }
// Converter outputs: <query>name = 'Alice' &amp; role = 'admin'</query>
// If double-processed: &amp;amp; — consumer is re-escaping

// Converter output is correct — consume it as XML, not as a raw string
// <query>name = 'Alice' &amp; role = 'admin'</query>
// XML parser decodes to: name = 'Alice' & role = 'admin'

よくある使用場面

SOAPおよびレガシーXML Webサービスの呼び出し

アプリケーション内でJSONペイロードを構築し、XMLに変換して、SOAPエンドポイントにPOSTします。これにより手作業でXML文字列を構築することを避け、レガシーサービスへのシリアライズが必要になる瞬間まで、ネイティブなJSON構造でデータを扱えます。

XML設定ファイルの生成

Spring、Maven、Ant、Tomcat、AndroidはすべてXML設定フォーマットを使用します。設定データをJSONで生成または変換します — 差分確認やバージョン管理が容易 — その後デプロイのためにXMLに変換します。

サイトマップとRSSフィードXMLの生成

コンテンツ管理システムや静的サイトジェネレーターはページメタデータをJSONで保存することが多いです。そのメタデータをsitemap.xmlやRSSフィードXMLに変換して、検索エンジンに送信したりフィードリーダーにコンテンツをシンジケーションしたりします。

エンタープライズデータ統合（EDI / ERP / CRM）

ERPシステム（SAP、Oracle）、CRMプラットフォーム、EDIネットワークは一般的にXMLでデータをやり取りします。モダンなREST APIからのJSONエクスポートをXMLに変換して、カスタムXMLシリアライザーを構築せずにこれらのシステムに対応します。

Androidリソースファイル

Androidの文字列リソース、レイアウト制約、マニフェストエントリはすべてXMLです。JSONデータソースからリソースファイルをプログラム的に生成または更新し、Androidビルドシステムに必要なXMLフォーマットに変換します。

SVGおよびベクターグラフィックスの生成

SVGはXMLです。SVG構造をJSONデータとして構築します — パス、形状、色、変換 — その後XMLに変換してWebやプリント、ベクター編集ツール向けの有効なSVGファイルを生成します。

技術的詳細

RFC 8259準拠のJSON解析

JSON入力はブラウザのネイティブJSON.parse()を使用して解析されます。RFC 8259に完全準拠しており、位置情報（行番号と列番号のベストエフォート）を含む正確な構文エラーメッセージを提供し、文字列、数値、ブール値、null、配列、オブジェクトのすべてのJSONデータ型を処理します。

カスタム再帰JSON to XMLシリアライザー

解析後、カスタム再帰シリアライザーがJSONツリーを走査します。@_ で始まるオブジェクトキーは親要素のXML属性として出力されます。#text キーは要素のテキスト内容として出力されます。プレーンなオブジェクトキーは子要素になります。配列値は繰り返す同名の兄弟要素を生成します。テキスト内容と属性値の特殊文字（<、>、&、"、'）はXMLエンティティ参照にエスケープされます。

ルート正規化

XMLは正確に1つのルート要素を必要とするため、シリアライザーはドキュメント構築前にルート正規化を適用します：単一キーのオブジェクトはそのキーをルートとして使用し、複数キーのオブジェクトとトップレベルの配列には合成 ラッパーが追加されます。これにより入力の形状に関わらず出力が常に整形されたXMLであることを保証します。

100%ブラウザベース — アップロードなし、サーバーなし

すべての処理はブラウザのJavaScriptエンジンで実行されます。いかなる時点でもデータはネットワーク経由で送信されません。200KBを超える入力はライブモードから手動モードへ自動的に切り替わります（明示的な「変換」クリックが必要）。ブラウザのレスポンスを維持し、重いシリアライゼーション中にメインスレッドがブロックされるのを防ぐためです。

ベストプラクティス

単一キーのオブジェクトでルート要素を制御する

意味のあるXMLを生成する最もクリーンな方法は、トップレベルのJSONを希望のルート要素名をキーとする単一キーのオブジェクトにすることです。複数キーのデータを1つの名前付きキーの下でラップすることで、汎用的な ラッパーではなくセマンティクス的に意味のあるルートが得られます。

属性の多いXMLには @_ と #text を使用する

ターゲットのXMLスキーマが多くの属性を使用する場合（設定ファイル、SVG、SOAPエンベロープで一般的）、変換前にJSONを @_ プレフィックスキーと #text を使用するように整形してください。結果のXMLは後処理なしにターゲットスキーマと正確に一致します。

意味のあるタグ名のために配列を名前付きオブジェクトでラップする

トップレベルの配列は汎用的な ... パターンを生成します。ここで は固定リテラル名です。配列を名前付きキーの下でラップすることで — { "products": [...] } — 繰り返す 要素（キー名が各配列要素に再使用）が ラッパーの下に生成されます。これにより意味のあるタグ名が得られ、スキーマで解析またはバリデートされるXMLではほぼ常に好ましい形式です。

XMLフォーマッターで出力をバリデートする

変換後、XMLの出力を XMLフォーマッター に貼り付けて整形性をバリデートし、インデントを確認し、XMLをダウンストリームサービスに送信したりバージョン管理にコミットしたりする前に構造上の問題を特定してください。

変換前にJSONキーをサニタイズする

XML要素名はアルファベットまたはアンダースコアで始まり、スペースやほとんどの特殊文字を含むことはできません。JSONキーが外部ソース（データベースカラム名、APIフィールド名、ユーザー入力）から来ている場合は、不正な出力を避けるために変換前にXML名の有効性を確認してください。

よくある質問