W3C home > Mailing lists > Public > www-ws-desc@w3.org > July 2005

soap:header extensibility with mU primer example

From: David Orchard <dorchard@bea.com>
Date: Tue, 12 Jul 2005 15:48:28 -0700
Message-ID: <32D5845A745BFB429CBDBADA57CD41AF1117A60B@ussjex01.amer.bea.com>
To: <www-ws-desc@w3.org>
A proposed section for the Primer if people accept the example and


Additional  Additional mandatory elements in header.


A primary motivation for soap:mustUnderstand is to enable a client to
ensure that a service understands a soap header block that the client
sends.  Imagine that the reservation interface is controlled by a 3rd
party such as a travel consortium.  The travel consortia decides to make
the NumberOfGuests a soap header block rather than part of the body,
perhaps on the initial version or a subsequent version.  There are a
variety of reasons for this.  The extension could be handled in a well
factored design at the service by a specialized piece of software.   A
3rd party specifying the header blocks is why Web Service specifications
will often require that the mustUnderstand flag is set to true. 


The binding using mustUnderstand is:


<operation ref="tns:opCheckAvailability">


         <wsoap:header wsoap:mustUnderstand="true"




Any client that uses the new interface will set the soap:mustUnderstand
attribute in the message.  If the service receiving the messages does
not understand the extension, it will fault.





Received on Tuesday, 12 July 2005 22:48:33 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:54:55 UTC