Re: Proposed renamings

Is there any keyword other than <interfaceBinding> that we could 
use to help alleviate the confusion between a WSDL binding and a 
SOAP binding?

A SOAP binding specifies how to (physically) transport a SOAP 
message over an undertlying protocol. A WSDL binding specifies 
how abstract messages are serialized and what protocol is used. 
It does not in itself indicate how the messages are physically 
transported. The terms are different, but complementary, and 
apply to different layers. I have seen so much confusion between 
the two, even on W3C mailing lists, that I would be keen to name 
them differently.

Jean-Jacques.

Philippe Le Hegaret wrote:
> [I thought I sent these yesterday but don't see it in the archives, so
> sending it again]
> 
> I've got an action item to start a proposal on renaming elements and/or
> attributes in WSDL 1.2. This proposal is based on the latest WSDL 1.2
> drafts and the requirements document. I'll keep track of sub-sequa=ente
> proposals
> 
> - portType
>  The requirements document has the following:
>  [[
>  Interface (AKA Port Type)
>   [Definition: A logical grouping of operations. An Interface represents
>   an abstract Web Service type, independent of transmission protocol and
>   data format.]
>  ]]
>  http://www.w3.org/TR/2002/WD-ws-desc-reqs-20021028/#normDefs
> 
> In 2.4.2 XML Representation of Port Type Component:
> http://www.w3.org/TR/2003/WD-wsdl12-20030124/#PortType_XMLRep
> 
>  A [local name] of portType
> 
>  would read
> 
>  A [local name] of interface
> 
> -  EndPoint (AKA Port)
>  The requirements document has the following:
>  [[
>  EndPoint (AKA Port)
>   [Definition: An association between a fully-specified InterfaceBinding
>   and a network address, specified by a URI [IETF RFC 2396], that may be
>   used to communicate with an instance of a Web Service. An EndPoint
>   indicates a specific location for accessing a Web Service using a
>   specific protocol and data format.]
>  ]]
>  http://www.w3.org/TR/2003/WD-wsdl12-20030124/#Port_XMLRep
> 
> In 2.11.2 XML Representation of Port Component
> 
>  A [local name] of port
>  
>  would read
> 
>  A [local name] of endPoint
> 
> 
> We may also do the following but, if we don't, I'll recommend changing
> the glossary of our requirements document.
> 
> - binding
>  The requirements document has the following:
>  [[
>  InterfaceBinding
>   [Definition: An association between an Interface, a concrete protocol
>   and/or a data format. An InterfaceBinding specifies the protocol
>   and/or data format to be used in transmitting Messages defined by the
>   associated Interface.]
>  ]]
>  http://www.w3.org/TR/2002/WD-ws-desc-reqs-20021028/#normDefs
> 
> In 2.7.2 XML Representation of Binding Component
> In http://www.w3.org/TR/2003/WD-wsdl12-20030124/#Binding_XMLRep 
> 
>  A [local name] of binding
>  
>  would read
> 
>  A [local name] of interfaceBinding
>  
> 
> 

Received on Friday, 28 February 2003 03:58:53 UTC