dokumen WSDL
Dokumen WSDL hanyalah dokumen XML yang ringkas.
Ia mengandungi satu siri takrifan yang menerangkan perkhidmatan web.
Struktur dokumen WSDL
Dokumen WSDL menggunakan elemen utama ini untuk menerangkan perkhidmatan web:
| 元素 | 定义 |
|---|---|
| <portType> | web service 执行的操作 |
| <message> | web service 使用的消息 |
| <types> | web service 使用的数据类型 |
| <binding> | web service 使用的通信协议 |
Struktur utama dokumen WSDL adalah serupa dengan ini:
<jenis>
, takrif jenis data.....
</types>
<mesej>
, takrifan data yang dikomunikasikan....
</message>
<portType>
, set operasi......
</portType>
<mengikat>
, protokol dan spesifikasi format data....
</binding>
</definitions>
Dokumen WSDL boleh mengandungi elemen lain, seperti elemen sambungan dan Elemen perkhidmatan yang menggabungkan definisi beberapa perkhidmatan web ke dalam satu dokumen WSDL.
Port WSDL Elemen
<portType> ialah elemen WSDL yang paling penting.
Ia boleh menerangkan perkhidmatan web, operasi yang boleh dilakukan dan mesej yang berkaitan.
Elemen <portType> boleh dibandingkan dengan pustaka fungsi (atau modul atau kelas) dalam bahasa pengaturcaraan tradisional.
Mesej WSDL Elemen
<mesej> mentakrifkan elemen data bagi sesuatu operasi.
Setiap mesej terdiri daripada satu atau lebih bahagian. Komponen ini boleh dibandingkan dengan parameter panggilan fungsi dalam bahasa pengaturcaraan tradisional. Elemen
Jenis WSDL
<types> mentakrifkan jenis data yang digunakan oleh perkhidmatan web.
Untuk neutraliti platform maksimum, WSDL menggunakan sintaks Skema XML untuk menentukan jenis data. Elemen
WSDL Bindings
<binding> mentakrifkan format mesej dan butiran protokol untuk setiap port.
Contoh WSDL
Ini ialah coretan ringkas dokumen WSDL:
, <part name="term" type="xs:string"/>
</message>
<message name="getTermResponse">
, <part name="value" type="xs:string"/>
</message>
<portType name="glossaryTerms">
, <nama operasi="getTerm">
' <input message="getTermRequest"/>
' <output message="getTermResponse"/>
, </operation>
</portType>
Dalam contoh ini, elemen <portType> mentakrifkan "glossaryTerms" sebagai nama port dan "getTerm" sebagai nama operasi. Operasi
"getTerm" mempunyai mesej input bernama "getTermRequest", dan mesej output bernama "getTermResponse". Elemen
<message> mentakrifkan bahagian setiap mesej, serta jenis data yang berkaitan.
Berbanding dengan pengaturcaraan tradisional, glossaryTerms ialah perpustakaan fungsi dan "getTerm" ialah fungsi dengan parameter input "getTermRequest" dan parameter pulangan getTermResponse.
