Sunday, December 16, 2012

SOAP Header's 'MustUnderstand' Attribute

This is an attribute that applies to SOAP headers.
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
     xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
     soapenv:mustUnderstand="1">
   ...
</wsse:Security>
If the value of it is "true" or 1, it tells the SOAP processor that processing should not continue if that header cannot be recognized. That it's a must to understand the header.

If fails to understand, an error should be returned and all the processing already done for that SOAP request should be rolledback.

If it is "false" or 0, even if the processor can't understand that particular header, rest of the message will be processed.

Ref:
[1] http://wso2.org/library/tutorials/understand-famous-did-not-understand-mustunderstand-header-s-error
[2] http://www.w3schools.com/soap/soap_header.asp

No comments: