Elemen SOAP Header

Header SOAP yang bersangkutan mengandung informasi header.

Elemen SOAP Header

Header SOAP yang bersangkutan dapat mengandung informasi khusus aplikasi (seperti autentikasi, pembayaran, dll). Jika header disediakan, maka itu harus menjadi anak pertama elemen Envelope.

Keterangan:Semua elemen anak Header harus berada dalam 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 mengandung header yang memiliki elemen "Trans" dengan nilai 234, dan nilai atribut "mustUnderstand" elemen ini adalah "1".

SOAP mendefinisikan tiga atribut dalam ruang nama standar ("http://www.w3.org/2001/12/soap-envelope"). Tiga atribut ini adalah: actor, mustUnderstand, dan encodingStyle. Atribut yang didefinisikan di dalam header SOAP ini dapat menentukan bagaimana kontainer memproses pesan SOAP.

Atribut actor

Dengan melalui jalur pesan yang melintasi berbagai titik akhir, pesan SOAP dapat disebarkan dari pengirim ke penerima. Bukan semua bagian pesan SOAP direncanakan untuk dikirim ke titik akhir akhirnya, namun, dari sudut pandang lain, mungkin diharapkan dikirim ke satu atau beberapa titik akhir jalur pesan.

Atribut actor SOAP dapat digunakan untuk mengalihkan Header elemen ke sebuah titik akhir khusus.

Syarat

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 mengelolanya adalah wajib atau pilihan.

Jika Anda menambahkan "mustUnderstand="1" ke salah satu elemen anak Header, itu dapat menunjukkan bahwa penerima yang mengelola header ini harus mengakui elemen ini. Jika penerima ini tidak dapat mengakui elemen ini, maka harus menghentikan pengelolaan header saat mengelola header ini.

Syarat

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 dijelaskan di bagian sebelumnya.