WSDL Documentation

وثيقة WSDL هي مجرد وثيقة XML بسيطة.

تحتوي على مجموعة من التعريفات لوصف خدمة الويب.

بنية وثيقة WSDL

يستخدم وثيقة WSDL هذه العناصر الرئيسية لوصف خدمة الويب:

العمود تعريف
<portType> العمليات التي تنفذها خدمة الويب
<message> الرسائل المستخدمة في خدمة الويب
<types> أنواع البيانات المستخدمة في خدمة الويب
<binding> بروتوكول التواصل المستخدم في خدمة الويب

يكون بنية وثيقة WSDL الرئيسية مثل هذا:

<definitions>
<types>
   تعريف أنواع...
</types>
<message>
   تعريف رسالة...
</message>
<portType>
   تعريف بور...
</portType>
<binding>
   تعريف ربط...
</binding>
</definitions>

يمكن أن تحتوي وثيقة WSDL على عناصر أخرى مثل عنصر extension، وأيضاً عنصر service، والذي يمكن أن يجمع تعريفات عدة خدمات ويب في وثيقة WSDL واحدة.

للحصول على ملخص شامل للنحو، يرجى زيارة WSDL Syntax هذا الفصل.

WSDL Port

<portType> العمود هو العنصر الأكثر أهمية في WSDL.

يصف هذا العنصر خدمة الويب، العمليات القابلة للتنفيذ، والرسائل ذات الصلة.

يمكن مقارنة عنصر <portType> بلوحة مكتبات في لغة البرمجة التقليدية (أو مكتبة أو فئة).

رسائل WSDL

<message> العمود يحدد عناصر البيانات للعمليات.

كل رسالة تتكون من جزء واحد أو أكثر. يمكن مقارنة هذه الأجزاء بمتغيرات دالة في لغات البرمجة التقليدية.

أنواع WSDL

<types> العمود يحدد أنواع البيانات المستخدمة في خدمة الويب.

لتحقيق أقصى قدر من الحياد التكنولوجي، يستخدم WSDL لغة XML Schema لتحديد أنواع البيانات.

مصطلحات WSDL

<binding> العمود لكل بورت يعرف نموذج الرسائل وتفاصيل البروتوكول.

WSDL Instance

This is a simplified fragment of a WSDL document:

<message name="getTermRequest">
   <part name="term" type="xs:string"/>
</message>
<message name="getTermResponse">
   <part name="value" type="xs:string"/>
</message>
<portType name="glossaryTerms">
  <operation name="getTerm">
        <input message="getTermRequest"/>
        <output message="getTermResponse"/>
  </operation>
</portType>

In this example,<portType> Element define "glossaryTerms" as a certainPortname, define "getTerm" as a certainOperationname.

The operation "getTerm" has a named "getTermRequest"Input Message, and a named "getTermResponse"Output Message.

<message> Elements can define each message'sComponent, as well as related data types.

In contrast to traditional programming, glossaryTerms is a library, and "getTerm" is a function with input parameter "getTermRequest" and return parameter getTermResponse.