RE: Comment on Fragment Identifiers

"Jonathan Marsh" <[email protected]>
Newsgroups gmane.comp.web.services.description
Message-ID <009601c7255c$f3594000$3401a8c0@DELLICIOUS>
Sorry, not the first time I've messed up the capitalization - the
{direction} token is an enumeration of "in" and "out" (note lack of
capitalization!), and I really need to double-check which property values
are capitalized and which aren't before putting fingers to keyboard...

<input> maps to {direction} = "in".  <output> maps to {direction} = "out".
But as Amy says, when you can have multiple messages in a single direction
within a MEP, {direction} is insufficient to identify them.  {message label}
provides a unique token for messages within a MEP with which to identify
them.

This is not terribly obvious from a cursory read of the spec because of our
defaulting rules, that will automatically map {message label} to "In" or
"Out" for the MEPs we define, so it looks to the casual user like the
<input> is causing {message label} = "In" when in fact what's happening
under the covers is a little more sophisticated and general-purpose.

Jonathan Marsh - http://www.wso2.com - http://auburnmarshes.spaces.live.com
 
> -----Original Message-----
> From: Amelia A Lewis [mailto:[email protected]]
> Sent: Thursday, December 21, 2006 2:58 PM
> To: Paul Cotton
> Cc: [email protected]; [email protected]; [email protected];
> [email protected]; [email protected]
> Subject: Re: Comment on Fragment Identifiers
> 
> Not replying for the group, but I believe that I understand the question
> and the mistaken assumption within it.  :-)
> 
> On Thu, 21 Dec 2006 14:44:42 -0800
> Paul Cotton <[email protected]> wrote:
> >We are wondering why the designators use "in" and "our" given that the
> >actual WSDL message labels are "input" and "output"?
> 
> In fact, we do not use "in" or "out".  We use the messageLabel specified
> in the message exchange pattern.  In part two, all of the message labels
> in all of the message exchange patterns are restricted to the set "In" and
> "Out" (note capitalization).  In the particular example cited, which
> relies on the in-out pattern, there are two messages, one labelled "In"
> and one labelled "Out".
> 
> "input" and "output" are nowhere used as message labels.  They are the
> local names of element information items in the WSDL 2.0 syntax.  These
> element information items are not referenced in the syntax of component
> designators, although as a class, they can be identified with the
> combination of .interfaceMessageReference() with their unique identifiers
> (ticketAgent/reserveFlight/In and ticketAgent/reserveFlight/Out in the
> example).
> 
> >Was this a conscious decision of the WSDL WG?
> 
> Yes.  There may be more than one [input] element information item or more
> than one [output] element information item in an interface operation in a
> valid WSDL, but all of the {messageLabel} properties of all of the
> {interfaceMessageReference} components of an interface operation MUST be
> unique.
> 
> >This apparent discrepancy can be seen in the examples in Appendix C.2
> >of the WSDL 2.0 Candidate Recommendation [1].
> >[1] http://www.w3.org/TR/2006/CR-wsdl20-20060327/#Iri-ref-ex
> 
> I hope that the above explanation clarifies matters.  It may behoove us to
> make some sort of explanation of this sort publicly available, as it
> appears to be on its way to being a FAQ.
> 
> Amy!
> --
> Amelia A. Lewis
> Senior Architect
> TIBCO/Extensibility, Inc.
> [email protected]
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.