- From: Doug Davis via cvs-syncmail <cvsmail@w3.org>
- Date: Sat, 07 Nov 2009 04:17:29 +0000
- To: public-ws-resource-access-notifications@w3.org
Update of /w3ccvs/WWW/2002/ws/ra/edcopies In directory hutz:/tmp/cvs-serv31809 Modified Files: wsmex.html wsmex.xml Log Message: 8199 Index: wsmex.xml =================================================================== RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wsmex.xml,v retrieving revision 1.71 retrieving revision 1.72 diff -u -d -r1.71 -r1.72 --- wsmex.xml 7 Nov 2009 00:28:56 -0000 1.71 +++ wsmex.xml 7 Nov 2009 04:17:27 -0000 1.72 @@ -218,20 +218,23 @@ <eg>(01) <s11:Envelope (02) xmlns:s11='http://schemas.xmlsoap.org/soap/envelope/' (03) xmlns:wsa='http://www.w3.org/2005/08/addressing'> -(04) <s11:Header> -(05) <wsa:Action> -(06) http://www.w3.org/&wsmex.nsprefix;/ws-tra/Get -(07) </wsa:Action> -(08) <wsa:To>http://services.example.org/stockquote/metadata</wsa:To> -(09) <wsa:ReplyTo> -(10) <wsa:Address>http://client.example.org</wsa:Address> -(11) </wsa:ReplyTo> -(12) <wsa:MessageID> -(13) urn:uuid:1cec121a-82fe-41da-87e1-3b23f254f128 -(14) </wsa:MessageID> -(15) </s11:Header> -(16) <s11:Body /> -(17) </s11:Envelope></eg> +(04) xmlns:wst='http://www.w3.org/&wstra.nsprefix;/ws-tra'> +(05) <s11:Header> +(06) <wsa:Action> +(07) http://www.w3.org/&wsmex.nsprefix;/ws-tra/Get +(08) </wsa:Action> +(09) <wsa:To>http://services.example.org/stockquote/metadata</wsa:To> +(10) <wsa:ReplyTo> +(11) <wsa:Address>http://client.example.org</wsa:Address> +(12) </wsa:ReplyTo> +(13) <wsa:MessageID> +(14) urn:uuid:1cec121a-82fe-41da-87e1-3b23f254f128 +(15) </wsa:MessageID> +(16) </s11:Header> +(17) <s11:Body> +(18) <wst:Get/> +(19) </s11:Body> +(20) </s11:Envelope></eg> </example> <p> @@ -257,107 +260,110 @@ (03) xmlns:wsa='http://www.w3.org/2005/08/addressing' (04) xmlns:mex='http://www.w3.org/&wsmex.nsprefix;/ws-mex' (05) xmlns:wsp='http://www.w3.org/ns/ws-policy' -(06) xmlns:wsdl='http://schemas.xmlsoap.org/wsdl/'> -(07) <s11:Header> -(08) <wsa:Action> -(09) http://www.w3.org/&wsmex.nsprefix;/ws-tra/GetResponse -(10) </wsa:Action> -(11) <wsa:To>http://client.example.org</wsa:To> -(12) <wsa:RelatesTo> -(13) urn:uuid:1cec121a-82fe-41da-87e1-3b23f254f128 -(14) </wsa:RelatesTo> -(15) </s11:Header> -(16) <s11:Body> -(17) <mex:Metadata> -(18) <mex:MetadataSection Dialect='http://schemas.xmlsoap.org/wsdl/'> -(19) <wsdl:definitions -(20) name='StockQuote' -(21) targetNamespace='http://services.example.org/stockquote' -(22) xmlns:tns='http://services.example.org/stockquote' -(23) xmlns:msgs='http://services.example.org/stockquote/schemas' -(24) xmlns:wsoap='http://schemas.xmlsoap.org/wsdl/soap/' -(25) xmlns:xs='http://www.w3.org/2001/XMLSchema'> -(26) <wsdl:import -(27) namespace='http://services.example.org/stockquote' -(28) location='http://services.example.org/stockquote/schemas' /> -(29) <wsdl:portType name='StockQuotePortType'> -(30) <wsdl:operation name='GetLastTradePrice'> -(31) <wsdl:input message='msgs:GetLastTradePriceInput' -(32) name='GetLastTradePriceInput'/> -(33) <wsdl:output message='msgs:GetLastTradePriceOutput' -(34) name='GetLastTradePriceOutput'/> -(35) </wsdl:operation> -(36) </wsdl:portType> -(37) <wsdl:binding name='StockQuoteBinding' -(38) type='tns:StockQuotePortType'> -(39) <wsp:PolicyReference -(40) URI='http://services.example.org/stockquote/policy' /> -(41) <wsoap:binding style='document' -(42) transport='http://schemas.xmlsoap.org/soap/http'/> -(43) <wsdl:operation name='GetLastTradePrice'> -(44) <wsoap:operation soapAction='http://services.example.org/stockquote/GetLastTradePrice' /> -(45) <wsdl:input name='GetLastTradePriceInput'> -(46) <wsoap:body use='literal'/> -(47) </wsdl:input> -(48) <wsdl:output name='GetLastTradePriceOutput'> -(49) <wsoap:body use='literal'/> -(50) </wsdl:output> -(51) </wsdl:operation> -(52) </wsdl:binding> -(53) <wsdl:service name='StockQuoteService'> -(54) <wsdl:port name='StockQuotePort' -(55) binding='tns:StockQuoteBinding' > -(56) <wsoap:address -(57) location='http://services.example.org/stockquote' /> -(58) </wsdl:port> -(59) </wsdl:service> -(60) </wsdl:definitions> -(61) </mex:MetadataSection> -(62) <mex:MetadataSection -(63) Dialect='http://www.w3.org/2001/XMLSchema' -(64) Identifier='http://services.example.org/stockquote/schemas'> -(65) <mex:Location> -(66) http://services.example.org/stockquote/schemas -(67) </mex:Location> -(68) </mex:MetadataSection> -(69) <mex:MetadataSection -(70) Dialect='http://www.w3.org/ns/ws-policy' -(71) Identifier='http://services.example.org/stockquote/policy'> -(72) <mex:MetadataReference> -(73) <wsa:Address> -(74) http://services.example.org/stockquote/policy -(75) </wsa:Address> -(76) </mex:MetadataReference> -(77) </mex:MetadataSection> -(78) </mex:Metadata> -(79) </s11:Body> -(80) </s11:Envelope></eg> +(06) xmlns:wst='http://www.w3.org/&wsmex.nsprefix;/ws-tra' +(07) xmlns:wsdl='http://schemas.xmlsoap.org/wsdl/'> +(08) <s11:Header> +(09) <wsa:Action> +(10) http://www.w3.org/&wsmex.nsprefix;/ws-tra/GetResponse +(11) </wsa:Action> +(12) <wsa:To>http://client.example.org</wsa:To> +(13) <wsa:RelatesTo> +(14) urn:uuid:1cec121a-82fe-41da-87e1-3b23f254f128 +(15) </wsa:RelatesTo> +(16) </s11:Header> +(17) <s11:Body> +(18) <wst:GetResponse> +(19) <mex:Metadata> +(20) <mex:MetadataSection Dialect='http://schemas.xmlsoap.org/wsdl/'> +(21) <wsdl:definitions +(22) name='StockQuote' +(23) targetNamespace='http://services.example.org/stockquote' +(24) xmlns:tns='http://services.example.org/stockquote' +(25) xmlns:msgs='http://services.example.org/stockquote/schemas' +(26) xmlns:wsoap='http://schemas.xmlsoap.org/wsdl/soap/' +(27) xmlns:xs='http://www.w3.org/2001/XMLSchema'> +(28) <wsdl:import +(29) namespace='http://services.example.org/stockquote' +(30) location='http://services.example.org/stockquote/schemas' /> +(31) <wsdl:portType name='StockQuotePortType'> +(32) <wsdl:operation name='GetLastTradePrice'> +(33) <wsdl:input message='msgs:GetLastTradePriceInput' +(34) name='GetLastTradePriceInput'/> +(35) <wsdl:output message='msgs:GetLastTradePriceOutput' +(36) name='GetLastTradePriceOutput'/> +(37) </wsdl:operation> +(38) </wsdl:portType> +(39) <wsdl:binding name='StockQuoteBinding' +(40) type='tns:StockQuotePortType'> +(41) <wsp:PolicyReference +(42) URI='http://services.example.org/stockquote/policy' /> +(43) <wsoap:binding style='document' +(44) transport='http://schemas.xmlsoap.org/soap/http'/> +(45) <wsdl:operation name='GetLastTradePrice'> +(46) <wsoap:operation soapAction='http://services.example.org/stockquote/GetLastTradePrice' /> +(47) <wsdl:input name='GetLastTradePriceInput'> +(48) <wsoap:body use='literal'/> +(49) </wsdl:input> +(50) <wsdl:output name='GetLastTradePriceOutput'> +(51) <wsoap:body use='literal'/> +(52) </wsdl:output> +(53) </wsdl:operation> +(54) </wsdl:binding> +(55) <wsdl:service name='StockQuoteService'> +(56) <wsdl:port name='StockQuotePort' +(57) binding='tns:StockQuoteBinding' > +(58) <wsoap:address +(59) location='http://services.example.org/stockquote' /> +(60) </wsdl:port> +(61) </wsdl:service> +(62) </wsdl:definitions> +(63) </mex:MetadataSection> +(64) <mex:MetadataSection +(65) Dialect='http://www.w3.org/2001/XMLSchema' +(66) Identifier='http://services.example.org/stockquote/schemas'> +(67) <mex:Location> +(68) http://services.example.org/stockquote/schemas +(69) </mex:Location> +(70) </mex:MetadataSection> +(71) <mex:MetadataSection +(72) Dialect='http://www.w3.org/ns/ws-policy' +(73) Identifier='http://services.example.org/stockquote/policy'> +(74) <mex:MetadataReference> +(75) <wsa:Address> +(76) http://services.example.org/stockquote/policy +(77) </wsa:Address> +(78) </mex:MetadataReference> +(79) </mex:MetadataSection> +(80) </mex:Metadata> +(81) </wst:GetResponse> +(82) </s11:Body> +(83) </s11:Envelope></eg> </example> <p> The message of <specref ref="GetResponse"/> is a <bibref ref ='WS-Transfer'/> response message to the request of <specref ref="GetRequest"/>. The content - of the <kw>[Body]</kw> (lines 16-79) is a mex:Metadata element with + of the <kw>[Body]</kw> (lines 17-82) is a mex:Metadata element with metadata - about the Web service endpoint (lines 17-78). The mex:Metadata + about the Web service endpoint (lines 19-80). The mex:Metadata contains three Metadata Sections. The first Metadata Section - (lines 18-61) contains the <bibref ref ='WSDL11'/> of the Web - service endpoint. The second Metadata Section (lines 62-68) contains + (lines 20-63) contains the <bibref ref ='WSDL11'/> of the Web + service endpoint. The second Metadata Section (lines 64-70) contains the location of the XML Schemas <bibref ref ='XMLSchema1'/>, <bibref ref ='XMLSchema2'/> used by the WSDL document. The schemas can be retrieved through an HTTP GET request at the identified URL - (lines 65-67). The third Metadata Section (lines 69-77) contains - the <bibref ref ='AddrCore'/> endpoint reference (lines 72-75) of + (lines 67-69). The third Metadata Section (lines 71-79) contains + the <bibref ref ='AddrCore'/> endpoint reference (lines 74-77) of a <bibref ref ='WS-Transfer'/> resource the representation of which is a <bibref ref ='wspolicy'/> document as indicated by the Dialect attribute (line 70). The WS-Policy document is the - same as the one indicated in the WSDL document (lines 39-40). + same as the one indicated in the WSDL document (lines 41-42). </p> <p> 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 72-76 of + mex:MetadataReference element in lines 74-78 of <specref ref="GetResponse"/>, some endpoints MAY choose to support explicit request for metadata. <specref ref="GetMexReq"/> illustrates a sample GetMetadata request @@ -421,29 +427,31 @@ (13) </wsa:RelatesTo> (14) </s11:Header> (15) <s11:Body> -(16) <mex:Metadata> -(17) <mex:MetadataSection -(18) Dialect='http://www.w3.org/ns/ws-policy' -(19) Identifier='http://services.example.org/stockquote/policy'> -(20) <wsp:Policy> -(21) <wsp:ExactlyOne> -(22) <!-- Policy alternatives --> -(23) </wsp:ExactlyOne> -(24) </wsp:Policy> -(25) </mex:MetadataSection> -(26) </mex:Metadata> -(27) </s11:Body> -(28) </s11:Envelope></eg> +(16) <mex:GetMetadataResponse> +(17) <mex:Metadata> +(18) <mex:MetadataSection +(19) Dialect='http://www.w3.org/ns/ws-policy' +(20) Identifier='http://services.example.org/stockquote/policy'> +(21) <wsp:Policy> +(22) <wsp:ExactlyOne> +(23) <!-- Policy alternatives --> +(24) </wsp:ExactlyOne> +(25) </wsp:Policy> +(26) </mex:MetadataSection> +(27) </mex:Metadata> +(28) </mex:GetMetadataResponse> +(29) </s11:Body> +(30) </s11:Envelope></eg> </example> <p> Lines 8-10 in <specref ref="GetMexRes"/> indicate this message is a response to a GetMetadata request, and lines 11-13 indicate that it is a response to the request in <specref ref="GetMexReq"/>. Lines - 16-26 contain a single Metadata Section (lines 17-25); line 18 + 17-26 contain a single Metadata Section (lines 18-26); line 19 indicates that the metadata in this section is of type, or - Dialect, WS-Policy while line 19 identifies a specific policy - document. Line 22 would have contained the policy expressions for the + Dialect, WS-Policy while line 20 identifies a specific policy + document. Line 23 would have contained the policy expressions for the Web service endpoint to which the GetMetadata request of <specref ref="GetMexReq"/> was directed. </p> @@ -2502,6 +2510,13 @@ <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=8168">8168</loc> </td> </tr> + <tr> + <td> 2009/11/06 </td> + <td> DD </td> + <td> Added resolution of issue + <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=8199">8199</loc> + </td> + </tr> </tbody> </table> </div1> Index: wsmex.html =================================================================== RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wsmex.html,v retrieving revision 1.81 retrieving revision 1.82 diff -u -d -r1.81 -r1.82 --- wsmex.html 7 Nov 2009 00:28:56 -0000 1.81 +++ wsmex.html 7 Nov 2009 04:17:27 -0000 1.82 @@ -61,11 +61,11 @@ 9 <a href="#ImplicitWSDL">Exposing WSDL for Operations Implicitly Defined by a Policy Assertion</a><br/> 10 <a href="#Security">Security Considerations</a><br/> 11 <a href="#metadata">WS-Metadata Exchange Metadata</a><br/> - 11.1 <a href="#iddiv2_1_1477">MetadataExchange Assertion</a><br/> + 11.1 <a href="#iddiv2_1_1481">MetadataExchange Assertion</a><br/> 12 <a href="#Acknowledgements">Acknowledgements</a><br/> 13 <a href="#References">References</a><br/> - 13.1 <a href="#iddiv2_1_1541">Normative References</a><br/> - 13.2 <a href="#iddiv2_1_1714">Informative References</a><br/> + 13.1 <a href="#iddiv2_1_1545">Normative References</a><br/> + 13.2 <a href="#iddiv2_1_1718">Informative References</a><br/> </p> <h3><a name="appendices" id="appendices"/>Appendices</h3><p class="toc">A <a href="#Appendix-A">XML Schema</a><br/> B <a href="#Appendix-B">WSDL</a><br/> @@ -140,20 +140,23 @@ <div class="exampleHeader"><a name="GetRequest" id="GetRequest"/>Example 2-1: Sample Get request message</div><div class="exampleInner"><pre>(01) <s11:Envelope (02) xmlns:s11='http://schemas.xmlsoap.org/soap/envelope/' (03) xmlns:wsa='http://www.w3.org/2005/08/addressing'> -(04) <s11:Header> -(05) <wsa:Action> -(06) http://www.w3.org/2009/09/ws-tra/Get -(07) </wsa:Action> -(08) <wsa:To>http://services.example.org/stockquote/metadata</wsa:To> -(09) <wsa:ReplyTo> -(10) <wsa:Address>http://client.example.org</wsa:Address> -(11) </wsa:ReplyTo> -(12) <wsa:MessageID> -(13) urn:uuid:1cec121a-82fe-41da-87e1-3b23f254f128 -(14) </wsa:MessageID> -(15) </s11:Header> -(16) <s11:Body /> -(17) </s11:Envelope></pre></div></div><p> +(04) xmlns:wst='http://www.w3.org/2009/09/ws-tra'> +(05) <s11:Header> +(06) <wsa:Action> +(07) http://www.w3.org/2009/09/ws-tra/Get +(08) </wsa:Action> +(09) <wsa:To>http://services.example.org/stockquote/metadata</wsa:To> +(10) <wsa:ReplyTo> +(11) <wsa:Address>http://client.example.org</wsa:Address> +(12) </wsa:ReplyTo> +(13) <wsa:MessageID> +(14) urn:uuid:1cec121a-82fe-41da-87e1-3b23f254f128 +(15) </wsa:MessageID> +(16) </s11:Header> +(17) <s11:Body> +(18) <wst:Get/> +(19) </s11:Body> +(20) </s11:Envelope></pre></div></div><p> The sample request message of <a href="#GetRequest">Example 2-1</a> is a <a href="#WS-Transfer">[WS-Transfer]</a> request for the retrieval of a resource's representation. In this case, the requested representation @@ -169,102 +172,105 @@ (03) xmlns:wsa='http://www.w3.org/2005/08/addressing' (04) xmlns:mex='http://www.w3.org/2009/09/ws-mex' (05) xmlns:wsp='http://www.w3.org/ns/ws-policy' -(06) xmlns:wsdl='http://schemas.xmlsoap.org/wsdl/'> -(07) <s11:Header> -(08) <wsa:Action> -(09) http://www.w3.org/2009/09/ws-tra/GetResponse -(10) </wsa:Action> -(11) <wsa:To>http://client.example.org</wsa:To> -(12) <wsa:RelatesTo> -(13) urn:uuid:1cec121a-82fe-41da-87e1-3b23f254f128 -(14) </wsa:RelatesTo> -(15) </s11:Header> -(16) <s11:Body> -(17) <mex:Metadata> -(18) <mex:MetadataSection Dialect='http://schemas.xmlsoap.org/wsdl/'> -(19) <wsdl:definitions -(20) name='StockQuote' -(21) targetNamespace='http://services.example.org/stockquote' -(22) xmlns:tns='http://services.example.org/stockquote' -(23) xmlns:msgs='http://services.example.org/stockquote/schemas' -(24) xmlns:wsoap='http://schemas.xmlsoap.org/wsdl/soap/' -(25) xmlns:xs='http://www.w3.org/2001/XMLSchema'> -(26) <wsdl:import -(27) namespace='http://services.example.org/stockquote' -(28) location='http://services.example.org/stockquote/schemas' /> -(29) <wsdl:portType name='StockQuotePortType'> -(30) <wsdl:operation name='GetLastTradePrice'> -(31) <wsdl:input message='msgs:GetLastTradePriceInput' -(32) name='GetLastTradePriceInput'/> -(33) <wsdl:output message='msgs:GetLastTradePriceOutput' -(34) name='GetLastTradePriceOutput'/> -(35) </wsdl:operation> -(36) </wsdl:portType> -(37) <wsdl:binding name='StockQuoteBinding' -(38) type='tns:StockQuotePortType'> -(39) <wsp:PolicyReference -(40) URI='http://services.example.org/stockquote/policy' /> -(41) <wsoap:binding style='document' -(42) transport='http://schemas.xmlsoap.org/soap/http'/> -(43) <wsdl:operation name='GetLastTradePrice'> -(44) <wsoap:operation soapAction='http://services.example.org/stockquote/GetLastTradePrice' /> -(45) <wsdl:input name='GetLastTradePriceInput'> -(46) <wsoap:body use='literal'/> -(47) </wsdl:input> -(48) <wsdl:output name='GetLastTradePriceOutput'> -(49) <wsoap:body use='literal'/> -(50) </wsdl:output> -(51) </wsdl:operation> -(52) </wsdl:binding> -(53) <wsdl:service name='StockQuoteService'> -(54) <wsdl:port name='StockQuotePort' -(55) binding='tns:StockQuoteBinding' > -(56) <wsoap:address -(57) location='http://services.example.org/stockquote' /> -(58) </wsdl:port> -(59) </wsdl:service> -(60) </wsdl:definitions> -(61) </mex:MetadataSection> -(62) <mex:MetadataSection -(63) Dialect='http://www.w3.org/2001/XMLSchema' -(64) Identifier='http://services.example.org/stockquote/schemas'> -(65) <mex:Location> -(66) http://services.example.org/stockquote/schemas -(67) </mex:Location> -(68) </mex:MetadataSection> -(69) <mex:MetadataSection -(70) Dialect='http://www.w3.org/ns/ws-policy' -(71) Identifier='http://services.example.org/stockquote/policy'> -(72) <mex:MetadataReference> -(73) <wsa:Address> -(74) http://services.example.org/stockquote/policy -(75) </wsa:Address> -(76) </mex:MetadataReference> -(77) </mex:MetadataSection> -(78) </mex:Metadata> -(79) </s11:Body> -(80) </s11:Envelope></pre></div></div><p> +(06) xmlns:wst='http://www.w3.org/2009/09/ws-tra' +(07) xmlns:wsdl='http://schemas.xmlsoap.org/wsdl/'> +(08) <s11:Header> +(09) <wsa:Action> +(10) http://www.w3.org/2009/09/ws-tra/GetResponse +(11) </wsa:Action> +(12) <wsa:To>http://client.example.org</wsa:To> +(13) <wsa:RelatesTo> +(14) urn:uuid:1cec121a-82fe-41da-87e1-3b23f254f128 +(15) </wsa:RelatesTo> +(16) </s11:Header> +(17) <s11:Body> +(18) <wst:GetResponse> +(19) <mex:Metadata> +(20) <mex:MetadataSection Dialect='http://schemas.xmlsoap.org/wsdl/'> +(21) <wsdl:definitions +(22) name='StockQuote' +(23) targetNamespace='http://services.example.org/stockquote' +(24) xmlns:tns='http://services.example.org/stockquote' +(25) xmlns:msgs='http://services.example.org/stockquote/schemas' +(26) xmlns:wsoap='http://schemas.xmlsoap.org/wsdl/soap/' +(27) xmlns:xs='http://www.w3.org/2001/XMLSchema'> +(28) <wsdl:import +(29) namespace='http://services.example.org/stockquote' +(30) location='http://services.example.org/stockquote/schemas' /> +(31) <wsdl:portType name='StockQuotePortType'> +(32) <wsdl:operation name='GetLastTradePrice'> +(33) <wsdl:input message='msgs:GetLastTradePriceInput' +(34) name='GetLastTradePriceInput'/> +(35) <wsdl:output message='msgs:GetLastTradePriceOutput' +(36) name='GetLastTradePriceOutput'/> +(37) </wsdl:operation> +(38) </wsdl:portType> +(39) <wsdl:binding name='StockQuoteBinding' +(40) type='tns:StockQuotePortType'> +(41) <wsp:PolicyReference +(42) URI='http://services.example.org/stockquote/policy' /> +(43) <wsoap:binding style='document' +(44) transport='http://schemas.xmlsoap.org/soap/http'/> +(45) <wsdl:operation name='GetLastTradePrice'> +(46) <wsoap:operation soapAction='http://services.example.org/stockquote/GetLastTradePrice' /> +(47) <wsdl:input name='GetLastTradePriceInput'> +(48) <wsoap:body use='literal'/> +(49) </wsdl:input> +(50) <wsdl:output name='GetLastTradePriceOutput'> +(51) <wsoap:body use='literal'/> +(52) </wsdl:output> +(53) </wsdl:operation> +(54) </wsdl:binding> +(55) <wsdl:service name='StockQuoteService'> +(56) <wsdl:port name='StockQuotePort' +(57) binding='tns:StockQuoteBinding' > +(58) <wsoap:address +(59) location='http://services.example.org/stockquote' /> +(60) </wsdl:port> +(61) </wsdl:service> +(62) </wsdl:definitions> +(63) </mex:MetadataSection> +(64) <mex:MetadataSection +(65) Dialect='http://www.w3.org/2001/XMLSchema' +(66) Identifier='http://services.example.org/stockquote/schemas'> +(67) <mex:Location> +(68) http://services.example.org/stockquote/schemas +(69) </mex:Location> +(70) </mex:MetadataSection> +(71) <mex:MetadataSection +(72) Dialect='http://www.w3.org/ns/ws-policy' +(73) Identifier='http://services.example.org/stockquote/policy'> +(74) <mex:MetadataReference> +(75) <wsa:Address> +(76) http://services.example.org/stockquote/policy +(77) </wsa:Address> +(78) </mex:MetadataReference> +(79) </mex:MetadataSection> +(80) </mex:Metadata> +(81) </wst:GetResponse> +(82) </s11:Body> +(83) </s11:Envelope></pre></div></div><p> The message of <a href="#GetResponse">Example 2-2</a> is a <a href="#WS-Transfer">[WS-Transfer]</a> response message to the request of <a href="#GetRequest">Example 2-1</a>. The content - of the <b>[Body]</b> (lines 16-79) is a mex:Metadata element with + of the <b>[Body]</b> (lines 17-82) is a mex:Metadata element with metadata - about the Web service endpoint (lines 17-78). The mex:Metadata + about the Web service endpoint (lines 19-80). The mex:Metadata contains three Metadata Sections. The first Metadata Section - (lines 18-61) contains the <a href="#WSDL11">[WSDL11]</a> of the Web - service endpoint. The second Metadata Section (lines 62-68) contains + (lines 20-63) contains the <a href="#WSDL11">[WSDL11]</a> of the Web + service endpoint. The second Metadata Section (lines 64-70) contains the location of the XML Schemas <a href="#XMLSchema1">[XMLSchema - Part 1]</a>, <a href="#XMLSchema2">[XMLSchema - Part 2]</a> used by the WSDL document. The schemas can be retrieved through an HTTP GET request at the identified URL - (lines 65-67). The third Metadata Section (lines 69-77) contains - the <a href="#AddrCore">[WS-Addressing]</a> endpoint reference (lines 72-75) of + (lines 67-69). The third Metadata Section (lines 71-79) contains + the <a href="#AddrCore">[WS-Addressing]</a> endpoint reference (lines 74-77) of a <a href="#WS-Transfer">[WS-Transfer]</a> resource the representation of which is a <a href="#wspolicy">[WS-Policy]</a> document as indicated by the Dialect attribute (line 70). The WS-Policy document is the - same as the one indicated in the WSDL document (lines 39-40). + same as the one indicated in the WSDL document (lines 41-42). </p><p> 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 72-76 of + mex:MetadataReference element in lines 74-78 of <a href="#GetResponse">Example 2-2</a>, some endpoints MAY choose to support explicit request for metadata. <a href="#GetMexReq">Example 2-3</a> illustrates a sample GetMetadata request @@ -314,26 +320,28 @@ (13) </wsa:RelatesTo> (14) </s11:Header> (15) <s11:Body> -(16) <mex:Metadata> -(17) <mex:MetadataSection -(18) Dialect='http://www.w3.org/ns/ws-policy' -(19) Identifier='http://services.example.org/stockquote/policy'> -(20) <wsp:Policy> -(21) <wsp:ExactlyOne> -(22) <!-- Policy alternatives --> -(23) </wsp:ExactlyOne> -(24) </wsp:Policy> -(25) </mex:MetadataSection> -(26) </mex:Metadata> -(27) </s11:Body> -(28) </s11:Envelope></pre></div></div><p> +(16) <mex:GetMetadataResponse> +(17) <mex:Metadata> +(18) <mex:MetadataSection +(19) Dialect='http://www.w3.org/ns/ws-policy' +(20) Identifier='http://services.example.org/stockquote/policy'> +(21) <wsp:Policy> +(22) <wsp:ExactlyOne> +(23) <!-- Policy alternatives --> +(24) </wsp:ExactlyOne> +(25) </wsp:Policy> +(26) </mex:MetadataSection> +(27) </mex:Metadata> +(28) </mex:GetMetadataResponse> +(29) </s11:Body> +(30) </s11:Envelope></pre></div></div><p> Lines 8-10 in <a href="#GetMexRes">Example 2-4</a> indicate this message is a response to a GetMetadata request, and lines 11-13 indicate that it is a response to the request in <a href="#GetMexReq">Example 2-3</a>. Lines - 16-26 contain a single Metadata Section (lines 17-25); line 18 + 17-26 contain a single Metadata Section (lines 18-26); line 19 indicates that the metadata in this section is of type, or - Dialect, WS-Policy while line 19 identifies a specific policy - document. Line 22 would have contained the policy expressions for the + Dialect, WS-Policy while line 20 identifies a specific policy + document. Line 23 would have contained the policy expressions for the Web service endpoint to which the GetMetadata request of <a href="#GetMexReq">Example 2-3</a> was directed. </p></div></div><div class="div1"> @@ -992,7 +1000,7 @@ indicate a particular security mechanism used to protect the WS-MetadataExchange operations supported by this endpoint. </p><div class="div2"> -<h3><a name="iddiv2_1_1477" id="iddiv2_1_1477"/>11.1 MetadataExchange Assertion</h3><p> +<h3><a name="iddiv2_1_1481" id="iddiv2_1_1481"/>11.1 MetadataExchange Assertion</h3><p> The mechanism for indicating that a binding or endpoint conforms to the WS-MetadataExchange specification is through the use of the Web Services Policy - Framework <a href="#wspolicy">[WS-Policy]</a> and Web Services Policy - @@ -1070,7 +1078,7 @@ Yves Lafon (W3C). </p></div><div class="div1"> <h2><a name="References" id="References"/>13 References</h2><div class="div2"> -<h3><a name="iddiv2_1_1541" id="iddiv2_1_1541"/>13.1 Normative References</h3><dl><dt class="label"><a name="RFC2119" id="RFC2119"/>RFC 2119</dt><dd><a href="http://www.ietf.org/rfc/rfc2119.txt"><cite> +<h3><a name="iddiv2_1_1545" id="iddiv2_1_1545"/>13.1 Normative References</h3><dl><dt class="label"><a name="RFC2119" id="RFC2119"/>RFC 2119</dt><dd><a href="http://www.ietf.org/rfc/rfc2119.txt"><cite> Key words for use in RFCs to Indicate Requirement Levels </cite></a> , S. Bradner, Author. @@ -1137,7 +1145,7 @@ , P. Biron, A. Malhotra, Editors. World Wide Web Consortium (W3C), 28 October 2004. Available at <a href="http://www.w3.org/TR/xmlschema-2/">http://www.w3.org/TR/xmlschema-2/</a>.</dd></dl></div><div class="div2"> -<h3><a name="iddiv2_1_1714" id="iddiv2_1_1714"/>13.2 Informative References</h3><dl><dt class="label"><a name="WSSecureConversation" id="WSSecureConversation"/>WS-SecureConversation</dt><dd><a href="http://docs.oasis-open.org/ws-sx/ws-secureconversation/v1.4/os/ws-secureconversation-1.4-spec-os.doc"><cite> +<h3><a name="iddiv2_1_1718" id="iddiv2_1_1718"/>13.2 Informative References</h3><dl><dt class="label"><a name="WSSecureConversation" id="WSSecureConversation"/>WS-SecureConversation</dt><dd><a href="http://docs.oasis-open.org/ws-sx/ws-secureconversation/v1.4/os/ws-secureconversation-1.4-spec-os.doc"><cite> OASIS Standard, "Web Services Secure Conversation (WS-SecureConversation) 1.4" </cite></a> @@ -1365,4 +1373,5 @@ <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=7207">7207</a></td></tr><tr><td> 2009/11/05 </td><td> DD </td><td> Added resolution of issue <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=7912">7912</a></td></tr><tr><td> 2009/11/06 </td><td> DD </td><td> Added resolution of issue <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=8204">8204</a></td></tr><tr><td> 2009/11/06 </td><td> DD </td><td> Added resolution of issue - <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=8168">8168</a></td></tr></tbody></table></div></div></body></html> \ No newline at end of file + <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=8168">8168</a></td></tr><tr><td> 2009/11/06 </td><td> DD </td><td> Added resolution of issue + <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=8199">8199</a></td></tr></tbody></table></div></div></body></html> \ No newline at end of file
Received on Saturday, 7 November 2009 04:17:40 UTC