Elemen Header SOAP

Header SOKAP yang boleh dipilih mengandungi maklumat header.

Elemen Header SOAP

Header SOKAP yang boleh dipilih boleh mengandungi maklumat khusus penggunaan aplikasi (seperti pengesahan, pembayaran, dll). Jika header elemen disediakan, maka ia mesti menjadi anak pertama elemen Envelope.

Keterangan:Sub elemen langsung semua Header elemen mesti adalah ruang nama yang sah.

<?xml version="1.0"?>
<soap:Envelope
xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding"
<soap:Header>
<m:Trans
xmlns:m="http://www.codew3c.com/transaction/"
soap:mustUnderstand="1">234</m:Trans>
</soap:Header>
...
...
</soap:Envelope>

Contoh di atas mengandungi header yang mempunyai elemen "Trans" yang bernilai 234, nilai atribut "mustUnderstand" elemen ini adalah "1".

SOKAP diwakili di ruang namenya asal ("http://www.w3.org/2001/12/soap-envelope") dengan tiga atribut. Tiga atribut ini adalah: actor, mustUnderstand serta encodingStyle. Atribut yang diwakili di dalam header SOKAP ini boleh ditakrifkan bagaimana container boleh menangani pesan SOKAP.

Atribut actor

Dengan melintasi jalur pesan melalui berbagai titik akhir, pesan SOKAP boleh disebarkan dari pengirim kepada penerima. Bukan semua bahagian pesan SOKAP direncanakan untuk dihala kepada titik akhir akhirnya, namun, dari sudut pandang lain, mungkin direncanakan untuk dihala kepada satu atau beberapa titik akhir di jalur pesan.

SOKAP Kaki actor boleh digunakan untuk menghala Header elemen kepada titik akhir yang khusus.

Sintaks

soap:actor="URI"

Contoh

<?xml version="1.0"?>
<soap:Envelope
xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding"
<soap:Header>
<m:Trans
xmlns:m="http://www.codew3c.com/transaction/"
soap:actor="http://www.codew3c.com/appml/">
234
</m:Trans>
</soap:Header>
...
...
</soap:Envelope>

Properti mustUnderstand

Properti mustUnderstand SOAP dapat digunakan untuk menandai apakah item judul untuk penerima yang akan mengolahnya adalah wajib atau pilihan.

Jika Anda menambahkan "mustUnderstand="1" ke beberapa anak elemen Header, ia dapat menunjukkan bahwa penerima yang mengolah header ini harus mengakui elemen ini. Jika penerima ini tidak dapat mengakui elemen ini, maka harus menghentikan pengolahan header ini.

Sintaks

soap:mustUnderstand="0|1"

Contoh

<?xml version="1.0"?>
<soap:Envelope
xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding"
<soap:Header>
<m:Trans
xmlns:m="http://www.codew3c.com/transaction/"
soap:mustUnderstand="1">
234
</m:Trans>
</soap:Header>
...
...
</soap:Envelope>

Properti encodingStyle

Properti encodingStyle SOAP telah dijelaskan di bab sebelumnya.