JSON-WSP

الموسوعة الحرة

JSON-WSP هو بروتوكول خدمة ويب يستخدم JSON لوصف الخدمة والطلبات والاستجابات. [ 1 ]

ملخص

لقد استلهم تصميمه من JSON-RPC ، ولكن عدم وجود مواصفات لوصف الخدمة مع توثيق في JSON-RPC أدى إلى تصميم JSON-WSP.

يُستخدم تنسيق الوصف في JSON-WSP بنفس طريقة استخدام لغة وصف خدمات الويب (WSDL) في SOAP أو لغة وصف الواجهات (IDL) في بنية وسيط طلب الكائنات المشتركة (CORBA)، وهو وصف الأنواع والأساليب المستخدمة في خدمة معينة. كما يصف العلاقات بين الأنواع (أي الأنواع المتداخلة) ويحدد الأنواع المتوقعة كوسائط للأساليب والأنواع التي يتوقع المستخدم استلامها كقيم مُعادة من الأساليب. وأخيرًا، يتيح الوصف إمكانية إضافة توثيق على مستوى الخدمة والأسلوب والمعاملات والقيمة المُعادة.

يتم التواصل بين العملاء وخادم JSON-WSP باستخدام طلبات واستجابات HTTP POST [ 2 ] ، مع كائنات JSON كبيانات من نوع المحتوى application/json. [ 3 ]

تحديد

يتكون JSON-WSP من أربعة مواصفات لكائنات JSON:

مواصفةوصف
وصفمواصفات وصف الخدمة (مثل WSDL ). تصف هذه المواصفات الطرق، ومعاملات الطرق، والأنواع، وأنواع الإرجاع. كما تدعم توثيق المستخدم على مستويات الخدمة والطرق والمعاملات.
طلبمواصفات طلبات JSON. تتضمن هذه المواصفات معلومات حول الطريقة المراد استدعاؤها وجميع وسائط استدعاء هذه الطريقة. يجب أن تتوافق وسائط الطلب مع تعريف المعلمات الخاص بالطريقة نفسها الموضحة في وصف JSON-WSP المقابل.
إجابةمواصفات استجابات JSON. يحتوي كائن الاستجابة على نتيجة استدعاء دالة خدمة. يجب أن يلتزم نوع الإرجاع بنوع الإرجاع المحدد لنفس الدالة في وصف JSON-WSP المقابل.
عيبمواصفات استجابات أخطاء JSON. يحتوي كائن الخطأ على رمز خطأ وسلسلة نصية توضح الخطأ. تُحدد معلومات الخطأ ما إذا كان الخطأ قد حدث من جانب العميل أو الخادم. اعتمادًا على إطار عمل خدمة الخادم، يمكن استخراج معلومات أكثر تفصيلًا، مثل اسم الملف ورقم السطر الذي حدث فيه الخطأ.

مراجع

  1. ↑ "مواصفات لغة ECMAScript لعام 2017" (ملف PDF) . Ecma-international.org . مؤرشف من النسخة الأصلية (ملف PDF) بتاريخ 12 أبريل 2015. تم الاطلاع عليه بتاريخ 28 يناير 2018 .
  2. ↑ روي، فيلدينغ؛ جوليان، ريشكه (2014). فيلدينغ، ر؛ ريشكه، ج (محرران). "بروتوكول نقل النص التشعبي (HTTP/1.1): الدلالات والمحتوى" . Tools.ietf.org . doi : 10.17487/RFC7231 . S2CID 14399078. تاريخ الاسترجاع: 28 يناير 2018 . 
  3. ↑ "RFC 4627" . مؤرشف من الأصل بتاريخ 17-07-2011 . تم الاطلاع عليه بتاريخ 14-02-2011 .