تحويل JSON إلى XML
XML سليم البنية بلصقة واحدة

ما الذي تقدمه هذه الأداة عند تحويل JSON إلى XML

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

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

لذلك يتخذ التحويل الجيد بعض القرارات. وهذا المحول يتخذها بوضوح ويذكر كل واحد منها في جدول الفحوصات أسفل النتيجة. وبذلك تعرف دائمًا لماذا يبدو XML بهذا الشكل.

كيف يتحول JSON إلى عناصر XML

يصبح الكائن عنصرًا له عناصر أبناء، واحد لكل مفتاح. وتصبح القيمة البسيطة نصًا داخل عنصرها. أما القائمة فتعمل بشكل مختلف، لأن XML لا يعرف نوع القائمة. بدلًا من ذلك يتكرر العنصر ببساطة: مفتاح book يحمل ثلاثة عناصر يعطي ثلاثة عناصر book متتالية.

يمنحك مفتاحان خاصان تحكمًا أكبر. المفتاح الذي يبدأ بـ @، مثل @id، يصبح سمة على العنصر الأب. والمفتاح المسمى #text يصبح نص العنصر نفسه. ومعًا يتيحان لك كتابة أي شكل تقريبًا من XML انطلاقًا من JSON بسيط.

اختيار العنصر الجذر

لكل مستند XML عنصر خارجي واحد يحمل كل ما عداه. وعندما يكون في JSON مفتاح أعلى واحد، مثل {"catalog": {...}}، يصبح هذا المفتاح هو الجذر ولا تضيف الأداة شيئًا.

وعندما يبدأ JSON بقائمة أو بعدة مفاتيح، يضعه المحول داخل عنصر جذر نيابة عنك. اسمه الافتراضي root، لكن يمكنك كتابة أي اسم، مثل orders أو products. كما تحصل القائمة في المستوى الأعلى على عنصر item لكل مدخل، فيبقى كل سجل منفصلًا.

تحويل JSON إلى XML بأسماء وسوم آمنة

كثيرًا ما تخالف مفاتيح JSON قواعد تسمية XML. مفتاح مثل first name فيه مسافة، و2024 يبدأ برقم، وprice($) فيه رموز. أي واحد منها يجعل XML غير صالح، فيرفض المحلل في الطرف الآخر الملف كله.

لذلك يصلح المحول هذه الأسماء. سلسلة من المسافات أو الرموز تصبح شرطة سفلية واحدة، فيصبح first name بالشكل first_name ويصبح price($) بالشكل price. والرقم في البداية تسبقه شرطة سفلية، بينما تبقى حروف أي لغة كما هي. ثم يذكر المفاتيح التي غيّرها في الفحوصات، فلا يتغير اسم دون علمك. والقواعد التي يتبعها مأخوذة من مواصفة XML من W3C.

الأحرف الخاصة والتهريب

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

الحروف المشكّلة والرموز التعبيرية وكل أنظمة الكتابة تمر سليمة، لأن الأداة تكتب الملف بترميز UTF-8. والتعريف الاختياري في الأعلى يذكر ذلك بالضبط. أوقفه إذا كان XML سيوضع داخل مستند آخر.

سمات أم عناصر: أيهما تستخدم

كلاهما يحمل بيانات، لذلك يعتمد الاختيار في الغالب على ما يتوقعه النظام المستقبِل. وكقاعدة عامة، تناسب السمات المعلومات القصيرة عن عنصر، مثل المعرّف أو اللغة أو العملة. أما العناصر فتناسب المحتوى الحقيقي، وكل ما قد يتكرر أو يحمل بنية إضافية.

وتعمل مساحات الأسماء أيضًا. أضف مفتاحًا مثل @xmlns:g مع عنوان مساحة الأسماء، ثم استخدم مفاتيح ببادئة مثل g:price. يحتفظ المحول بهذه الأسماء كما هي، لأن النقطتين بين جزأين صالحين مسموحتان في XML. وبذلك تخرج خلاصات المنتجات والصيغ الأخرى التي تستخدم مساحات الأسماء جاهزة للاستخدام.

عندما يكون في JSON نفسه خطأ

يقرأ المحول JSON بصرامة وفق المعيار RFC 8259. الفاصلة الزائدة في النهاية أو علامة الاقتباس المفردة أو القوس الناقص توقف التحويل مع السطر والعمود بدقة. ونقرة على أرني المكان تضع المؤشر على المشكلة.

تحويل JSON إلى XML أونلاين للعمل الحقيقي

ما زال XML موجودًا في كل مكان خلف الكواليس. فالبنوك وبوابات الدفع تتبادله. وكثير من أنظمة الشحن والفوترة والجهات الحكومية لا تقبل غيره. كما أن خرائط المواقع وخلاصات RSS هي XML أيضًا، ولهذا يكتبه مولّد خريطة الموقع XML لدينا.

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