This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 8292 - MEX: redundant discussions of WS-T/GetMetadata duality
Summary: MEX: redundant discussions of WS-T/GetMetadata duality
Status: CLOSED REMIND
Alias: None
Product: WS-Resource Access
Classification: Unclassified
Component: MetadataExchange (show other bugs)
Version: FPWD
Hardware: All All
: P2 normal
Target Milestone: ---
Assignee: Gilbert Pilz
QA Contact: notifications mailing list for WS Resource Access
URL:
Whiteboard:
Keywords: hasProposal
Depends on:
Blocks:
 
Reported: 2009-11-14 01:58 UTC by Gilbert Pilz
Modified: 2010-03-17 11:35 UTC (History)
1 user (show)

See Also:


Attachments
gil's proposal (443.70 KB, text/html)
2010-01-27 18:33 UTC, Doug Davis
Details

Description Gilbert Pilz 2009-11-14 01:58:46 UTC
Section 2.2 "Example" contains (above Example 2-3) the following:

"While the WS-Policy of the Web service endpoint could be retrieved using a WS-Transfer Get request directed to the endpoint identified by the mex:MetadataReference element in lines 74-78 of Example 2-2, some endpoints MAY choose to support explicit request for metadata."

This same concept (you can use WS-Transfer Get or mex:GetMetadata) is repeated several times throughout the rest of the spec:

Section 4 "Metadata Resources":

"A Web service endpoint MAY have one or more associated metadata resources. A Web service endpoint MAY also support direct retrieval of metadata by requesters using a GetMetadata operation directed to the Web service endpoint itself, as described in 6.2 Get Metadata."

Section 6.1 "WS-Transfer Get":

"To retrieve the representation of a metadata resource, a requester MAY send a [WS-Transfer] Get request message to the metadata resource's endpoint."

Section 6.2 "Get Metadata":

"A requester MAY send a GetMetadata request message to an endpoint to retrieve the metadata associated with that endpoint. A service endpoint MAY support the GetMetadata request. Observe that, in the case where a service endpoint is also a [WS-Transfer] resource, the [WS-Transfer] Get operation allows requesters to retrieve the resource representation associated with that endpoint (i.e. the "data"), while the GetMetadata operation can be used to retrieve that endpoint's metadata."

Section 7 "Metadata in Endpoint References" contains the following:

"6 Retrieving Metadata describes two mechanisms that allow requesters to retrieve ("pull metadata") Web services metadata from an endpoint (GetMetadata) or a metadata resource (WS-Transfer Get)."

Repeating the same concepts over and over makes the spec harder to read and creates the potential for inconsistencies.

General Proposal: Outline the concept once in an intro section then simply the operations in 6.1 and 6.2. Remove other mentions of the concept.
Comment 2 Doug Davis 2010-01-27 18:33:36 UTC
Created attachment 812 [details]
gil's proposal
Comment 3 Robert Freund 2010-01-27 18:35:53 UTC
resolved as proposed with the amendment that the sentence "A Web service endpoint MAY have one or more associated metadata resources". be retained