W3C home > Mailing lists > Public > www-ws-desc@w3.org > February 2004

RE: 2004-02-12 Action Item: Clarification to the OperationName feature

From: Jonathan Marsh <jmarsh@microsoft.com>
Date: Fri, 20 Feb 2004 16:42:54 -0800
Message-ID: <DF1BAFBC28DF694A823C9A8400E71EA202AACF3B@RED-MSG-30.redmond.corp.microsoft.com>
To: "Umit Yalcinalp" <umit.yalcinalp@oracle.com>, "WS Description List" <www-ws-desc@w3.org>

I'm not sure whether having the Operation Name in the message is always necessary, but putting that aside - what are the implications of a "required feature"?  Is the WSDL somehow invalid if it specifies:

  <feature uri="http://www.w3.org/TR/wsdl20/features/operationName" required="false"/>

?

Suppose my binding for an operation named for instance "Fred" has an extension

  <my:stick-operation-name-in-a-header wsdl:required="true"/>

with the obvious semantics, but whose specification doesn't tie this behavior in with the OpName feature URI.  How will you know whether the feature as been implemented?
 
What if I introduce an extension

  <my:override-operation-name-feature wsdl:required="true"/>

With the obvious semantics.  Is this type of extension disallowed?

"Required feature" is a new idea and I'd like to see more details of what you expect to happen.


___________________________________
From: www-ws-desc-request@w3.org [mailto:www-ws-desc-request@w3.org] On Behalf Of Umit Yalcinalp
Sent: Friday, February 20, 2004 3:28 PM
To: WS Description List
Subject: 2004-02-12 Action Item: Clarification to the OperationName feature

Folks, 

I was given an action item [1] to clarify the usage of OperationName feature [2], to clarify what is required and what must be specified in WSDL. 

Addendum to the Proposal: 

OperationName feature is a required feature for all WSDL descriptions. It is not specific to a binding since all bindings must implement this feature. Therefore, the feature is not required to be declared as shown below as it is assumed to be present in all descriptions:

<binding> 
   ...
   <feature uri="http://www.w3.org/TR/wsdl20/features/operationName" required="true"/>
</binding>

Note: This syntax may change per compositor syntax proposal [3]. 

There may be multiple ways to implement this feature. The proposal specifies a distinct method for implementing this feature by using a soap module for SOAP bindings. When the soap module specified by [2] is used as the implementation method, its use must be declared in WSDL as follows: 

<binding> 
     ...
     <wsoap:module uri="http://www.w3.org/TR/wsdl20/OperationDispatchModule" required="true"/>
</binding>

Note: The original proposal did not specify a URI for the SOAP module that has been specified here. 

The SOAP Action feature may also be engaged in the binding in addition to the OperationName feature as shown below:

<binding>
    ...
    <feature uri="http://www.w3.org/2003/05/soap/features/action/"/>
</binding>

In this case, the OperationName feature also specifies the value of the SOAP Action property as discussed in [2]. 

--umit


[1] http://lists.w3.org/Archives/Public/www-ws-desc/2004Feb/0076.html
[2] http://lists.w3.org/Archives/Public/www-ws-desc/2004Jan/0082.html
[3] http://lists.w3.org/Archives/Public/www-ws-desc/2004Jan/0153.html

-- 
Umit Yalcinalp                                  
Consulting Member of Technical Staff
ORACLE
Phone: +1 650 607 6154                          
Email: umit.yalcinalp@oracle.com
Received on Friday, 20 February 2004 19:42:58 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 5 February 2014 07:15:02 UTC