محوّل JSON إلى XML

ما هو تحويل JSON إلى 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 فوراً في لوحة الإخراج. الكائنات بمفتاح واحد تستخدم مفتاحها كجذر؛ الكائنات بمفاتيح متعددة تُلفّ في ؛ المفاتيح المسبوقة بـ @_ تصبح سمات؛ المصفوفات تصبح عناصر فرعية مكررة. اضبط المسافة البادئة (مسافتان أو 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 القديمة

ابنِ حمولة JSON في تطبيقك، وحوّلها إلى XML، وأرسلها بطريقة POST إلى نقطة نهاية SOAP. هذا يتجنب بناء سلاسل XML يدوياً ويتيح لك العمل مع البيانات في بنية JSON أصلية حتى لحظة الحاجة إلى تسلسلها للخدمة القديمة.

توليد ملفات إعداد XML

تستخدم Spring وMaven وAnt وTomcat وAndroid تنسيقات إعداد XML. ولّد أو حوّل بيانات الإعداد كـ JSON — أسهل للمقارنة والتحكم في الإصدارات — ثم حوّل إلى XML للنشر.

إنتاج XML لخرائط المواقع وتغذيات RSS

أنظمة إدارة المحتوى ومولّدات المواقع الثابتة كثيراً ما تخزّن بيانات الصفحات كـ JSON. حوّل تلك البيانات إلى XML لـ sitemap أو تغذية RSS لإرسالها إلى محركات البحث أو توزيع المحتوى على قارئات التغذية.

تكامل بيانات المؤسسات (EDI / ERP / CRM)

أنظمة ERP (SAP وOracle) ومنصات CRM وشبكات EDI كثيراً ما تتبادل البيانات بـ XML. حوّل تصديرات JSON من واجهات REST الحديثة إلى XML لإطعام هذه الأنظمة دون بناء مسلسل XML مخصص.

ملفات موارد Android

موارد نصوص Android وقيود التخطيط وإدخالات Manifest كلها XML. ولّد أو حدّث ملفات الموارد برمجياً من مصادر بيانات JSON وحوّل إلى تنسيق XML المطلوب لنظام بناء Android.

توليد SVG والرسومات المتجهة

SVG هو XML. ابنِ بنية SVG كبيانات JSON — مسارات وأشكال وألوان وتحويلات — ثم حوّل إلى XML لإنتاج ملفات SVG صالحة للويب أو الطباعة أو أدوات التحرير المتجهية.

تفاصيل تقنية

تحليل JSON متوافق مع RFC 8259

يُحلَّل مدخل JSON باستخدام JSON.parse() الأصلي في المتصفح، المتوافق بالكامل مع RFC 8259. يوفر رسائل خطأ دقيقة في الصياغة تتضمن معلومات الموضع بأفضل جهد ممكن (رقم السطر والعمود)، ويتعامل مع جميع أنواع بيانات JSON: السلاسل النصية والأرقام والقيم المنطقية وnull والمصفوفات والكائنات.

مسلسل JSON إلى XML تكراري مخصص

بعد التحليل، يستعرض مسلسل تكراري مخصص شجرة JSON. مفاتيح الكائنات التي تبدأ بـ @_ تُصدَر كسمات XML على العنصر الأب. مفتاح #text يُصدَر كمحتوى نص العنصر. مفاتيح الكائنات العادية تصبح عناصر فرعية. قيم المصفوفات تُنتج عناصر متجاورة مكررة بالاسم نفسه. الأحرف الخاصة (< و> و& و" و') في محتوى النص وقيم السمات تُهرَّب إلى مراجع كيانات XML.

تطبيع عنصر الجذر

لأن XML يتطلب عنصر جذر واحداً بالضبط، يطبّق المسلسل تطبيع عنصر الجذر قبل بناء المستند: الكائنات بمفتاح واحد تستخدم المفتاح كجذر؛ الكائنات بمفاتيح متعددة والمصفوفات على المستوى الأعلى تحصل على غلاف مُنشأ تلقائياً. هذا يضمن أن الإخراج دائماً XML مُصاغ بشكل سليم بغض النظر عن شكل المدخل.

100% قائم على المتصفح — بدون رفع ملفات أو خادم

تتم جميع المعالجة في محرك JavaScript في متصفحك. لا تُنقَل أي بيانات عبر الشبكة في أي وقت. تتحول المدخلات الأكبر من 200 كيلوبايت تلقائياً من الوضع المباشر إلى الوضع اليدوي (مطلوب نقر «تحويل» صريح) للحفاظ على استجابة المتصفح أثناء التسلسل الثقيل.

أفضل الممارسات

تحكم في عنصر الجذر بكائن بمفتاح واحد

أنظف طريقة لإنتاج XML ذي معنى هي التأكد من أن JSON على المستوى الأعلى كائن بمفتاح واحد يكون مفتاحه اسم عنصر الجذر المطلوب. تغليف البيانات متعددة المفاتيح تحت مفتاح مسمى واحد يمنحك جذراً ذا معنى دلالي بدلاً من الغلاف العام .

استخدم @_ و#text لـ XML الثقيل بالسمات

إذا كان مخطط XML المستهدف يستخدم سمات كثيرة (شائع في ملفات الإعداد وSVG ومغلفات SOAP)، أعد تشكيل JSON لاستخدام مفاتيح مسبوقة بـ @_ و#text قبل التحويل. سيُطابق XML الناتج المخطط المستهدف بدقة دون معالجة لاحقة.

لفّ المصفوفات في كائنات مسماة للحصول على أسماء وسوم ذات معنى

المصفوفة على المستوى الأعلى تُنتج نمط ... العام، حيث اسم ثابت. تغليف المصفوفة تحت مفتاح مسمى — { "products": [...] } — يُنتج عناصر مكررة (يُعاد استخدام اسم المفتاح لكل عنصر مصفوفة) تحت غلاف . هذا يمنحك اسم وسم ذا معنى مجالي وهو دائماً مفضل لـ XML الذي سيُحلَّل أو يُتحقق منه بمخطط.

تحقق من الإخراج باستخدام منسّق XML

بعد التحويل، الصق إخراج XML في منسّق XML للتحقق من صياغته السليمة والتحقق من المسافات البادئة وتحديد أي مشاكل هيكلية قبل إرسال XML إلى خدمة تالية أو الالتزام به في التحكم بالإصدارات.

طهّر مفاتيح JSON قبل التحويل

يجب أن تبدأ أسماء عناصر XML بحرف أو شرطة سفلية ولا تحتوي على مسافات أو معظم الأحرف الخاصة. إذا كانت مفاتيح JSON الخاصة بك تأتي من مصدر خارجي (اسم عمود قاعدة بيانات أو اسم حقل API أو مدخل مستخدم)، راجعها للتحقق من صلاحية اسم XML قبل التحويل لتجنب الإخراج المشوّه.

الأسئلة الشائعة