مدقق XML / XSD

كيف يعمل مدقّق XML / XSD

ما الذي تفعله الأداة

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

مثال: التحقق من كتالوج الكتب

ضع في الاعتبار مخطط XSD هذا الذي يتطلب أن تكون للكتب معرّفات صحيحة من نوع عدد صحيح وأسعار عشرية:

<xs:element name="book">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="title" type="xs:string"/>
            <xs:element name="price" type="xs:decimal"/>
          </xs:sequence>
          <xs:attribute name="id" type="xs:integer" use="required"/>
        </xs:complexType>
      </xs:element>

XML غير صالح مثل <book id="abc"><price>not-a-number</price></book>سيفشل في التحقق مع أخطاء قيود النوع لكل من سمة المعرّف وعنصر السعر.

حالات الاستخدام الشائعة

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

محرك التحقق والقيود

تستخدم هذه الأداة libxml2 عبر ربط libxmljs لـ Node.js، مما يوفر توافقًا مع XML Schema 1.0. يعالج المدقّق المخططات بالكامل على جانب الخادم لأسباب أمنية ولا يجلب موارد خارجية أو يحل عمليات الاستيراد المعتمدة على الشبكة. تتم تعطيل معالجة الكيانات الخارجية (XXE) للسلامة. تعمل عمليات include وimport في المخطط فقط إذا تم توفير جميع المخططات المشار إليها ضمن محتوى XSD الرئيسي.

• الوصول إلى الشبكة:محظور لأسباب أمنية
• استيراد المخططات:يجب أن يكون ضمنيًا (inline)، دون حل خارجي
• الكيانات الخارجية:معطّلة (حماية XXE)
• حدود المعالجة:تُطبّق حدود حجم معقولة

المعالجة على جانب الخادم مقابل المعالجة على جانب العميل

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