JSON'dan XML'e Dönüştürücü

JSON'dan XML'e Dönüştürme Nedir ve Nasıl Çalışır?

// 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>

Temel Özellikler

Örnekler

{"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"}}}}

Nasıl Kullanılır

1. 1

   JSON'unuzu Yapıştırın

   JSON verilerinizi yukarıdaki giriş alanına girin veya yapıştırın. Bir örnek denemek için 'Örnek yükle' düğmesine de tıklayabilirsiniz — API yanıt nesnesi, dizi yükü veya @_ niteliklerini ve #text kullanan nesne.

2. 2

   Canlı XML Çıktısını Görün

   XML çıktı panelinde anında görünür. Tek anahtarlı nesneler anahtarlarını kök olarak kullanır; çok anahtarlı nesneler içine sarılır; @_ önekli anahtarlar nitelik olur; diziler tekrarlanan alt öğeler üretir. Gerekirse girinti (2 veya 4 boşluk) ayarlayın.

3. 3

   Kopyalayın veya İndirin

   XML'i panoya almak için Kopyala'ya veya .xml dosyası olarak kaydetmek için İndir'e tıklayın. Sonucu doğrulamak veya yeniden biçimlendirmek için XML Biçimlendirici'ye yapıştırın.

Yaygın Dönüştürme Tuzakları

// 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'

Yaygın Kullanım Senaryoları

SOAP ve Eski XML Web Servislerini Çağırma

JSON yükünü uygulamanızda oluşturun, XML'e dönüştürün ve SOAP uç noktasına POST isteği gönderin. Bu, elle XML dizisi oluşturmayı önler ve eski servis için serileştirmeniz gereken ana kadar verilerle yerel JSON yapısıyla çalışmanızı sağlar.

XML Yapılandırma Dosyaları Oluşturma

Spring, Maven, Ant, Tomcat ve Android, XML yapılandırma formatları kullanır. Yapılandırma verilerini JSON olarak oluşturun veya dönüştürün — diff almak ve sürüm kontrolü için daha kolay — ardından dağıtım için XML'e dönüştürün.

Site Haritası ve RSS Besleme XML Üretme

İçerik yönetim sistemleri ve statik site oluşturucuları çoğunlukla sayfa meta verilerini JSON olarak saklar. Arama motorlarına göndermek veya içeriği besleme okuyucularına sendike etmek için bu meta verileri sitemap.xml veya RSS besleme XML'ine dönüştürün.

Kurumsal Veri Entegrasyonu (EDI / ERP / CRM)

ERP sistemleri (SAP, Oracle), CRM platformları ve EDI ağları yaygın olarak XML biçiminde veri alışverişi yapar. Özel XML serileştirici oluşturmadan bu sistemleri beslemek için modern REST API'lerden gelen JSON dışa aktarmalarını XML'e dönüştürün.

Android Kaynak Dosyaları

Android dize kaynakları, düzen kısıtlamaları ve manifest girdileri XML'dir. JSON veri kaynaklarından programatik olarak kaynak dosyaları oluşturun veya güncelleyin ve Android derleme sistemi için gereken XML formatına dönüştürün.

SVG ve Vektör Grafik Oluşturma

SVG, XML'dir. SVG yapısını JSON verisi olarak oluşturun — yollar, şekiller, renkler, dönüşümler — ardından web, baskı veya vektör düzenleme araçları için geçerli SVG dosyaları üretmek üzere XML'e dönüştürün.

Teknik Ayrıntılar

RFC 8259 Uyumlu JSON Ayrıştırma

JSON girişi, tam RFC 8259 uyumlu tarayıcının yerel JSON.parse() işlevi kullanılarak ayrıştırılır. En iyi çaba konumuyla (satır ve sütun) doğru sözdizimi hata mesajları sağlar ve tüm JSON veri türlerini işler: dizeler, sayılar, boolean değerler, null, diziler ve nesneler.

Özel Özyinelemeli JSON'dan XML'e Serileştirici

Ayrıştırmanın ardından özel özyinelemeli serileştirici JSON ağacında yürür. @_ ile başlayan nesne anahtarları, üst öğede XML niteliği olarak yayılır. #text anahtarı, öğenin metin içeriği olarak yayılır. Düz nesne anahtarları alt öğe olur. Dizi değerleri tekrarlanan aynı adlı kardeş öğeler üretir. Metin içeriği ve nitelik değerlerindeki özel karakterler (<, >, &, ", ') kendi XML varlık referanslarına kaçış karakteriyle belirtilir.

Kök Normalleştirme

XML tam olarak bir kök öğe gerektirdiğinden serileştirici, belgeyi oluşturmadan önce kök normalleştirme uygular: tek anahtarlı nesneler anahtarı kök olarak kullanır; çok anahtarlı nesneler ve üst düzey diziler yapay sarıcısı alır. Bu, çıktının giriş şeklinden bağımsız olarak her zaman iyi biçimli XML olmasını sağlar.

%100 Tarayıcı Tabanlı — Yükleme Yok, Sunucu Yok

Tüm işlem tarayıcınızın JavaScript motorunda gerçekleşir. Hiçbir veri hiçbir noktada ağ üzerinden iletilmez. 200KB'ı aşan girişler, yoğun serileştirme sırasında tarayıcının yanıt vermeye devam etmesini sağlamak için otomatik olarak canlı moddan manuel moda (açık bir Dönüştür tıklaması gerektirir) geçer.

En İyi Uygulamalar

Tek Anahtarlı Nesneyle Kök Öğeyi Denetleyin

Anlamlı XML üretmenin en temiz yolu, üst düzey JSON'unuzun tek anahtarlı bir nesne olmasını ve bu anahtarın istenen kök öğe adı olmasını sağlamaktır. Çok anahtarlı veriyi tek adlandırılmış anahtarın altında sararak genel sarıcısı yerine anlam bakımından anlamlı bir kök elde edersiniz.

Nitelik Yoğun XML için @_ ve #text Kullanın

Hedef XML şemanız çok sayıda nitelik kullanıyorsa (yapılandırma dosyalarında, SVG'de ve SOAP zarflarında yaygındır), dönüştürmeden önce JSON'unuzu @_ önekli anahtarlar ve #text kullanacak şekilde yeniden şekillendirin. Ortaya çıkan XML, sonraki işleme gerek kalmadan hedef şemayla tam olarak eşleşir.

Anlamlı Etiket Adları için Dizileri Adlandırılmış Nesnelere Sarın

Üst düzey dizi, her öğe için sabit değişmez ad olarak 'ın kullanıldığı genel ... kalıbını üretir. Diziyi adlandırılmış bir anahtar altında sararak — { "products": [...] } — kök sarıcısı altında tekrarlanan öğeleri (anahtar adı her dizi öğesi için yeniden kullanılır) elde edersiniz. Bu, neredeyse her zaman bir şema tarafından ayrıştırılacak veya doğrulanacak XML için tercih edilir.

Çıktıyı XML Biçimlendirici ile Doğrulayın

Dönüştürdükten sonra, XML çıktısını XML Biçimlendirici'ye yapıştırarak iyi biçimliliği doğrulayın, girintiyi kontrol edin ve herhangi bir yapısal sorunu bir sonraki servise göndermeden veya sürüm kontrolüne kaydetmeden önce tespit edin.

Dönüştürmeden Önce JSON Anahtarlarını Temizleyin

XML öğe adları harf veya alt çizgiyle başlamalı; boşluk veya çoğu özel karakter içermemelidir. JSON anahtarlarınız harici bir kaynaktan (veritabanı sütun adı, API alan adı veya kullanıcı girdisi) geliyorsa, hatalı biçimli çıktıdan kaçınmak için dönüştürmeden önce XML adı geçerliliği açısından denetleyin.

Sıkça Sorulan Sorular