issue 6720 - proposal

Ashok wrote:
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
- - - - - - - - - - - - - - - - - - - - - 
Section 6.1 of WS-MEX says ...

"... The metadata associated with a service endpoint may be available as
multiple metadata resources. As a result, the metadata returned by the Get
request to a metadata resource's endpoint may be limited to a particular
metadata type (@Dialect) and identifier (@Identifier).

The representation of a metadata resource MAY be a mex:Metadata element or 
any
other document format (e.g. [XML Schema: Structures], [XML Schema: 
Datatypes],
[WSDL 1.1], [WS-Policy]) for which a mex:MetadataSection/@Dialect has been
defined."

I don't understand what this says.  Why don't we say, instead "A 
WS-Transfer
GET on a EPR returns the metadata element (child) of the EPR?"
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
- - - - - - - - - - - - - - - - - - - - - 

I don't think T.Get() returns the metadata element of the EPR - it might 
not even have one.  I think the issue here is the
first paragraph but for a different reason than what Ashok is mentioning. 
To me the issue is the part where it says
that it "may be limited to a particular metadata type and identifier". The 
"may" seems wrong to me.  It seems like it needs to
be a "MUST".  Since T.Get() can only ever return one dialect/identifier 
combo I don't see where the variability that a "may"
offers could ever be used.  I think it could be reworded like this:

"...The metadata associated with a service endpoint MAY be available as 
multiple metadata resources.  In response to a Transfer Get request, each 
of these metadata resources MUST return the representation of a single 
metadata unit associated with a particular metadata type (@Dialect) and 
identifier (@Identifier)."

I don't think the 2nd paragraph is necessary at all as its just repeating 
what the rest of the spec says.

thanks
-Doug
______________________________________________________
STSM |  Standards Architect  |  IBM Software Group
(919) 254-6905  |  IBM 444-6905  |  dug@us.ibm.com
The more I'm around some people, the more I like my dog.

Received on Thursday, 9 July 2009 05:48:09 UTC