حوّل JSON إلى XML!

أدخل JSON لتحويله إلى XML! يدعم SOAP.
JSON
النتيجة
 

حوّل JSON إلى XML!

حوّل كائن JSON إلى مستند XML بمسافات بادئة. المفاتيح التي تبدأ بـ @ تصبح سمات، ومفتاح #text يصبح نص العنصر، والمصفوفات تكرّر عنصرًا بالاسم نفسه، فيكفي JSON عادي لوصف XML فيه سمات.

يناسب المواقف التي تحمل فيها البيانات بصيغة JSON لكن عليك إرسال XML: جسم طلب SOAP، أو خلاصة RSS أو sitemap، أو API قديم للدفع أو الشحن أو جهة حكومية لا يقبل إلا XML.

طريقة الاستخدام

  1. الصق JSON في خانة JSON. اجعل المستوى الأعلى كائنًا بمفتاح واحد، مثل {"rootName": {...}}، فيصبح ذلك المفتاح العنصر الجذري.
  2. حيث تحتاج إلى سمات، أضف مفاتيح تبدأ بـ @ مثل "@id": "1"؛ وللجمع بين السمات والمحتوى النصي استخدم مفتاح "#text".
  3. راجع المستند تحت النتيجة، بما فيه التصريح <?xml ...?>، ثم انسخه.

مثال

المدخلات (JSON)
{
  "rss": {
    "@version": "2.0",
    "channel": {
      "title": "Release notes",
      "item": [
        { "title": "v1.2 & fixes", "guid": { "@isPermaLink": "false", "#text": "r-12" } },
        { "title": "v1.3", "guid": { "@isPermaLink": "false", "#text": "r-13" } }
      ]
    }
  }
}
المخرجات (XML)
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
  <channel>
    <title>Release notes</title>
    <item>
      <title>v1.2 &amp; fixes</title>
      <guid isPermaLink="false">r-12</guid>
    </item>
    <item>
      <title>v1.3</title>
      <guid isPermaLink="false">r-13</guid>
    </item>
  </channel>
</rss>

أصبح @version و@isPermaLink سمتين، وأصبح #text الخاص بـ guid محتوى العنصر. وتُكتب المصفوفة item كعنصرين <item>، ويُهرَّب & في العنوان إلى &amp;.

الميزات المدعومة

  • يضيف التصريح <?xml version="1.0" encoding="UTF-8"?> ويستخدم مسافتين للإزاحة.
  • الكائن ذو المفتاح الواحد على المستوى الأعلى يستخدم ذلك المفتاح جذرًا؛ أما المفاتيح المتعددة أو المصفوفة على المستوى الأعلى فتُغلَّف في <root>، ويُكتب كل عنصر من المصفوفة على شكل <item>.
  • يهرّب & و< و> و" و' ككيانات (entities).
  • الأحرف غير المسموح بها في أسماء XML (المسافات وغيرها) تصبح _، والمفاتيح التي تبدأ برقم تحصل على _ في البداية: first name → first_name، 2nd → _2nd.
  • تُكتب قيم null كعناصر فارغة مثل <tag/>.
  • يستخدم الربط نفسه الذي تستخدمه أداة XML إلى JSON، فيمكن للبيانات الانتقال ذهابًا وإيابًا بين الأداتين دون أن يتغير شكلها.

حالات الاستخدام

بناء جسم طلب SOAP

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

نموذج أولي لخلاصة RSS أو sitemap

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

ملاحظات وقيود

  • المصفوفة الفارغة ([]) ليس فيها ما يُكرَّر فتختفي من الناتج.
  • تُكتب الأرقام والقيم المنطقية كنص، كما في <price>12.5</price>، دون معلومات أنواع XML Schema.
  • لا معالجة خاصة لمساحات الأسماء (namespaces)؛ قدّم بنفسك مفاتيح مثل "soap:Envelope" وسمة "@xmlns:soap" فتُخرج كما هي.
  • لا تُنتج أقسام CDATA؛ فالأحرف الخاصة تُهرَّب دائمًا ككيانات.
  • الكائن أو المصفوفة المستخدمة كقيمة لسمة تُكتب كسلسلة JSON.

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

كيف أحدد اسم العنصر الجذري؟

غلّف بياناتك في كائن بمفتاح واحد بالضبط، مثل {"order": {...}}. إن وُجدت عدة مفاتيح، أو كانت تلك القيمة الوحيدة مصفوفة، يُستخدم <root> بدلًا من ذلك.

كيف أنتج عدة عناصر بالاسم نفسه؟

أعطِ مصفوفة: {"tag": ["a", "b"]} يصبح <tag>a</tag><tag>b</tag>. ولغلاف <tags> حولها، استخدم {"tags": {"tag": [...]}}.

هل يمكن أن تحوي مفاتيح JSON مسافات أو أحرفًا غير إنجليزية؟

أحرف Unicode مثل العربية أو الكورية أو الأحرف ذات العلامات صالحة في أسماء XML وتُحفظ كما هي. أما المسافات و/ و@ في أي موضع غير البداية فتُستبدل بـ _، فتأكد من أن أسماء الوسوم تطابق ما يتوقعه المستقبِل.