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

RE: soap:header extensibility with mU primer example

From: Jonathan Marsh <jmarsh@microsoft.com>
Date: Wed, 13 Jul 2005 10:59:31 -0700
Message-ID: <7DA77BF2392448449D094BCEF67569A5083516D5@RED-MSG-30.redmond.corp.microsoft.com>
To: "David Orchard" <dorchard@bea.com>, <www-ws-desc@w3.org>
Sorry Dave, but we don't find this motivation very compelling.  This
seems like the clumsiest way imaginable to introduce an incompatible
version.  We have a variety of other mechanisms that could be employed,
including introducing a new name for the new operation, introducing a
new endpoint, or adding an app-level version identifier into the message
body with appropriate failure semantics.  If this is the best motivation
you can come up with, we would rather see the mU capability removed.

 

Speaking for Microsoft not as chair,

Jonathan

 

________________________________

From: www-ws-desc-request@w3.org [mailto:www-ws-desc-request@w3.org] On
Behalf Of David Orchard
Sent: Tuesday, July 12, 2005 3:48 PM
To: www-ws-desc@w3.org
Subject: soap:header extensibility with mU primer example

 

A proposed section for the Primer if people accept the example and
motivation.

 

Additional 5.2.5.4.  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">

       <input>

         <wsoap:header wsoap:mustUnderstand="true"
element="tns:NumberOfGuests"/>

       </input>

    </operation>

 

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.

 

Cheers,

Dave

 

 
Received on Wednesday, 13 July 2005 18:00:32 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 7 December 2009 10:58:36 GMT