Elementong Header ng SOAP

Ang opisitong Header element ng SOAP ay naglalaman ng impormasyon ng header.

Elementong Header ng SOAP

Ang opisitong Header element ng SOAP ay maaaring maglalaman ng mga aplikasyon na may专用信息 tungkol sa mensahe ng SOAP (tulad ng pagkumpirma, pagbabayad at iba pa). Kung ang Header element ay ibinigay, ito ay dapat ay ang unang anak ng envelope element.

Komento:Ang direktong mga anak ng Header element ay dapat ay may wastong namespace.

<?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>

Ang halimbawa na ito ay naglalaman ng isang header na may "Trans" element, na may halaga na 234, at ang halaga ng "mustUnderstand" ng element ay "1".

Ang SOAP ay nakadefinir sa mga default na namespace ("http://www.w3.org/2001/12/soap-envelope") ang tatlong atrubuto. Ang tatlong ito ay: actor, mustUnderstand at encodingStyle. Ang mga ito na nakadefinir sa header ng SOAP ay nagpapahintulot sa container upang iproseso ang mensahe ng SOAP.

Atributo ng actor

Sa pamamagitan ng paglalakad ng mensahe sa kahit anong path ng mensahe, ang mensahe ng SOAP ay maaaring magkalat mula sa isang nagpadala hanggang sa isang nagtanggap. Hindi lahat ng bahagi ng mensahe ng SOAP ay inaasahang ilipat sa huling endpoint ng mensahe ng SOAP, subalit, maaaring ilipat sa isang o ilang endpoint sa path ng mensahe.

Ang atrubuto ng actor ng SOAP ay maaaring gamitin upang inilagay ang Header element sa isang tiyak na endpoint.

Gramatika

soap:actor="URI"

Halimbawa

<?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>

Property ng mustUnderstand

Ang property ng mustUnderstand ng SOAP ay maaaring gamitin upang tukuyin kung ang header item ay sadyang dapat o opisyon ng tagapag-process.

Kung nagdagdag ka ng "mustUnderstand="1" sa anumang anak ng elemento ng Header, ito ay makakabigay ng signal na ang tagapag-process ng header na gagamitin ang elemento na ito ay dapat tanggapin. Kung ang tagapag-process ay hindi makatanggap ng elemento, dapat itong magiging walang epekto sa pagproseso ng header.

Gramatika

soap:mustUnderstand="0|1"

Halimbawa

<?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>

Property ng encodingStyle

Ang encodingStyle property ng SOAP ay naipaliwanag sa nakaraang section.