- From: Doug Davis via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 05 Oct 2009 09:48:44 +0000
- To: public-ws-resource-access-notifications@w3.org
Update of /w3ccvs/WWW/2002/ws/ra/edcopies In directory hutz:/tmp/cvs-serv595 Modified Files: wsenum.html wsenum.xml Log Message: 6403, 6721 Index: wsenum.html =================================================================== RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wsenum.html,v retrieving revision 1.64 retrieving revision 1.65 diff -u -d -r1.64 -r1.65 --- wsenum.html 2 Oct 2009 15:50:32 -0000 1.64 +++ wsenum.html 5 Oct 2009 09:48:42 -0000 1.65 @@ -66,15 +66,17 @@ 4.8 <a href="#UnableToRenew">UnableToRenew</a><br/> 4.9 <a href="#UnusableEPR">UnusableEPR</a><br/> 5 <a href="#Security">Security Considerations</a><br/> -6 <a href="#policy">WS-Enumeration Policy Assertion(s)</a><br/> +6 <a href="#metadata">WS-Enumeration Metadata</a><br/> + 6.1 <a href="#iddiv2_1_1915">Enumeration Assertion</a><br/> 7 <a href="#acks">Acknowledgements</a><br/> 8 <a href="#refs">References</a><br/> - 8.1 <a href="#iddiv2_1_1879">Normative References</a><br/> - 8.2 <a href="#iddiv2_1_2052">Informative References</a><br/> + 8.1 <a href="#iddiv2_1_2007">Normative References</a><br/> + 8.2 <a href="#iddiv2_1_2193">Informative References</a><br/> </p> <h3><a name="appendices" id="appendices"/>Appendices</h3><p class="toc">A <a href="#schema">XML Schema</a><br/> B <a href="#WSDL">WSDL</a><br/> -C <a href="#changelog">Change Log</a><br/> +C <a href="#policyXSD">Enumeration Policy Schema</a><br/> +D <a href="#changelog">Change Log</a><br/> </p></div><hr/><div class="body"><div class="div1"> <h2><a name="intro" id="intro"/>1 Introduction</h2><p> There are numerous applications for which a @@ -240,6 +242,8 @@ Prefixes and XML namespaces used in this specification </caption><tbody><tr><th align="left"> Prefix </th><th align="left"> XML Namespace </th><th align="left"> Specification(s) </th></tr><tr><td> wsen </td><td><a href="http://www.w3.org/2009/09/ws-enu"> http://www.w3.org/2009/09/ws-enu + </a></td><td> This specification </td></tr><tr><td> wsenp </td><td><a href="http://www.w3.org/2009/09/ws-enp"> + http://www.w3.org/2009/09/ws-enp </a></td><td> This specification </td></tr><tr><td> s </td><td><a href="http://www.w3.org/2003/05/soap-envelope"> http://www.w3.org/2003/05/soap-envelope </a></td><td> SOAP 1.2 <a href="#SOAP121">[SOAP12]</a></td></tr><tr><td> s11 </td><td><a href="http://schemas.xmlsoap.org/soap/envelope/"> @@ -1239,13 +1243,90 @@ taken to ensure that minimal state is saved prior to any authenticating sequences. </p></li></ul></div><div class="div1"> -<h2><a name="policy" id="policy"/>6 WS-Enumeration Policy Assertion(s)</h2><p> +<h2><a name="metadata" id="metadata"/>6 WS-Enumeration Metadata</h2><p> An endpoint MAY indicate that it supports WS-Enumeration, or its features, - by including the WS-Enumeration Policy assertion(s) within its WSDL. By + by including the WS-Enumeration Policy assertion within its WSDL. By doing so the endpoint is indicating that the corresponding WS-Enumeration operations are supported by that endpoint even though they do not - explicitly appear in its WSDL. - </p></div><div class="div1"> + explicitly appear in its WSDL (i.e. retrievable by using a + WS-MetadataExchange GetMetadata with a Dialect URI of + http://schemas.xmlsoap.org/wsdl/). + </p><p> + An endpoint MAY choose to expose the WS-Enumeration WSDL by using the + following WS-MetadataExchange Dialect: + </p><table border="1"><tbody><tr><th align="left"> Dialect URI </th><th> @Identifier value </th></tr><tr><td> http://www.w3.org/2009/02/ws-tra/EnumerationWSDL </td><td> Not defined </td></tr></tbody></table><p> + The WS-Enumeration WSDL can be annotated to indicate any endpoint + specific metadata that might be needed by clients interacting with + this service. For example, the WSDL MAY have policy assertions that + indicate a particular security mechanism used to protect the + WS-Enumeration operations supported by this endpoint. + </p><div class="div2"> +<h3><a name="iddiv2_1_1915" id="iddiv2_1_1915"/>6.1 Enumeration Assertion</h3><p> + The mechanism for indicating that a binding or endpoint conforms to the + WS-Enumeration specification is through the use of the Web Services + Policy - Framework <a href="#wspolicy">[WS-Policy]</a> and Web Services Policy - + Attachment <a href="#wspolicyattach">[WS-Policy Attachment]</a> specifications. + </p><p> + This specification defines a policy assertion (wsenp:Enumeration). The + wsenp:Enumeration policy assertion applies to the endpoint policy subject. + </p><p> + For WSDL 1.1, these assertions may be attached to wsdl11:port or + wsdl11:binding. For WSDL 2.0, they may be attached to wsdl20:endpoint or + wsdl20:binding. A policy expression containing the wsenp:Enumeration + policy assertion MUST NOT be attached to a wsdl:portType or + wsdl20:interface. + </p><p> + The wsenp:Enumeration policy assertion is a nested policy container + assertion. The meaning of this assertion, when present in a policy + alternative, is that WS-Enumeration is required to communicate with the + subject. In order to indicate that the subject supports WS-Enumeration + but does not require its use, an additional policy alternative should + be provided which does not contain this assertion; the compact + authoring style for an optional policy assertion provided by WS-Policy + may be used. The wsp:Optional attribute, as a syntactic shortcut, can be + used with the wsenp:Enumeration assertion. This indicates two policy + alternatives, one which contains the policy assertion, and another + which does not. + </p><p> + The inclusion of this assertion implies support for the WS-Enumeration + specification. + </p><p> + The normative outline of this assertion is: + </p><div class="exampleOuter"><div class="exampleInner"><pre><wsenp:Enumeration [wsp:Optional="<em>xs:boolean</em>"]? ...> + <wsenp:FilterDialect ...> <em>xs:anyURI</em> </wsenp:FilterDialect> * + <wsenp:MaxExpires ...> <em>xs:duration</em> </wsenp:MaxExpires> ? + <wsenp:MaxTime ...> <em>xs:duration</em> </wsenp:MaxTime> ? + <wsenp:MaxElements ...> <em>xs:long</em> </wsenp:MaxElements> ? + <wsenp:MaxCharacters ...> <em>xs:long</em> </wsenp:MaxCharacters> ? + ... +</wsenp:Enumeration></pre></div></div><p> + The following describes additional, normative constraints on the + outline listed above: + </p><dl><dt class="label"> /wsenp:Enumeration </dt><dd><p> + A policy assertion that specifies that WS-Enumeration protocol MUST + be used when communicating with this endpoint. This assertion has + Endpoint Policy Subject. + </p></dd><dt class="label"> /wsenp:Enumeration/wsenp:FilterDialect </dt><dd><p> + When present, this parameter indicates support for the specified + Filter Dialect URI. + </p></dd><dt class="label"> /wsenp:Enumeration/wsenp:MaxExpires </dt><dd><p> + When present, this parameter indicates the maximum lifetime of + enumerations that this endpoint will support. Note: a value of + "PT0S" indicates that this endpoint supports enumerations with + an infinite lifetime. + </p></dd><dt class="label"> /wsenp:Enumeration/wsenp:MaxTime </dt><dd><p> + When present, this parameter indicates the maximum MaxTime value + supported by this endpoint. Note: a value of "PT0S" indicates that + this endpoint supports any duration value. + </p></dd><dt class="label"> /wsenp:Enumeration/wsenp:MaxElements </dt><dd><p> + When present, this parameter indicates the maximum MaxElements value + supported by this endpoint. The value specified MUST be greater + than zero. + </p></dd><dt class="label"> /wsenp:Enumeration/wsenp:MaxCharacters </dt><dd><p> + When present, this parameter indicates the maximum MaxCharacters + value supported by this endpoint. The value specified MUST be + greater than zero. + </p></dd></dl></div></div><div class="div1"> <h2><a name="acks" id="acks"/>7 Acknowledgements</h2><p> This specification has been developed as a result of joint work with many individuals and teams, @@ -1271,7 +1352,7 @@ Yves Lafon (W3C). </p></div><div class="div1"> <h2><a name="refs" id="refs"/>8 References</h2><div class="div2"> -<h3><a name="iddiv2_1_1879" id="iddiv2_1_1879"/>8.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_2007" id="iddiv2_1_2007"/>8.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. @@ -1312,7 +1393,12 @@ </cite></a> , A. Vedamuthu, et al., Editors. World Wide Web Consortium (W3C), 4 September 2007. - Available at <a href="http://www.w3.org/TR/ws-policy/">http://www.w3.org/TR/ws-policy/</a>.</dd><dt class="label"><a name="WSDL11" id="WSDL11"/>WSDL11</dt><dd><a href="http://www.w3.org/TR/2001/NOTE-wsdl-20010315"><cite> + Available at <a href="http://www.w3.org/TR/ws-policy/">http://www.w3.org/TR/ws-policy/</a>.</dd><dt class="label"><a name="wspolicyattach" id="wspolicyattach"/>WS-Policy Attachment</dt><dd><a href="http://www.w3.org/TR/ws-policy-attach"><cite> + W3C Recommendation, "Web Services Policy (WS-Policy) 1.5 - Attachment" + </cite></a> + , A. Vedamuthu, et al., Editors. + World Wide Web Consortium (W3C), 4 September 2007. + Available at <a href="http://www.w3.org/TR/ws-policy-attach">http://www.w3.org/TR/ws-policy-attach</a>.</dd><dt class="label"><a name="WSDL11" id="WSDL11"/>WSDL11</dt><dd><a href="http://www.w3.org/TR/2001/NOTE-wsdl-20010315"><cite> W3C Note, "Web Services Description Language (WSDL) 1.1" </cite></a> , E. Christensen, et al., Editors. @@ -1338,7 +1424,7 @@ , J. Clark, S. DeRose, Editors. World Wide Web Consortium (W3C), 16 November 1999. Available at <a href="http://www.w3.org/TR/xpath">http://www.w3.org/TR/xpath</a>.</dd></dl></div><div class="div2"> -<h3><a name="iddiv2_1_2052" id="iddiv2_1_2052"/>8.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_2193" id="iddiv2_1_2193"/>8.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> @@ -1718,7 +1804,20 @@ </wsdl:portType> </wsdl:definitions></pre></div></div></div><div class="div1"> -<h2><a name="changelog" id="changelog"/>C Change Log</h2><table border="1"><tbody><tr><th> Data </th><th> Author </th><th> Description </th></tr><tr><td> 2009/03/04 </td><td> DD </td><td> Added resolution of issue +<h2><a name="policyXSD" id="policyXSD"/>C Enumeration Policy Schema</h2><p> + A normative copy of the XML Schema description for the Enumeration + Policy assertion can be retrieved from the following address: + </p><div class="exampleOuter"><div class="exampleInner"><pre>http://www.w3.org/2009/09/ws-enu/EnumerationPolicy.xsd</pre></div></div><p> + A non-normative copy of the XML schema is listed below for convenience. + </p><div class="exampleOuter"><div class="exampleInner"><pre><wsenp:Enumeration [wsp:Optional="xs:boolean"]? ...> + <wsenp:FilterDialect ...> xs:anyURI </wsenp:FilterDialect> * + <wsenp:MaxExpires ...> xs:duration </wsenp:MaxExpires> ? + <wsenp:MaxTime ...> xs:duration </wsenp:MaxTime> ? + <wsenp:MaxElements ...> xs:long </wsenp:MaxElements> ? + <wsenp:MaxCharacters ...> xs:long </wsenp:MaxCharacters> ? + ... +</wsenp:Enumeration></pre></div></div></div><div class="div1"> +<h2><a name="changelog" id="changelog"/>D Change Log</h2><table border="1"><tbody><tr><th> Data </th><th> Author </th><th> Description </th></tr><tr><td> 2009/03/04 </td><td> DD </td><td> Added resolution of issue <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6391">6391</a></td></tr><tr><td> 2009/03/04 </td><td> DD </td><td> Added resolution of issue <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6519">6519</a></td></tr><tr><td> 2009/03/11 </td><td> DD </td><td> Added change log </td></tr><tr><td> 2009/03/11 </td><td> DD </td><td> Added resolution of issue <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6641">6641</a></td></tr><tr><td> 2009/03/11 </td><td> DD </td><td> Added resolution of issue @@ -1752,4 +1851,6 @@ <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6533">6533</a></td></tr><tr><td> 2009/09/23 </td><td> DD </td><td> Added resolution of issue <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6568">6568</a></td></tr><tr><td> 2009/09/30 </td><td> DD </td><td> Added resolution of issue <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=7716">7716</a></td></tr><tr><td> 2009/10/02 </td><td> DD </td><td> Added resolution of issue - <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=7426">7426</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=7426">7426</a></td></tr><tr><td> 2009/10/05 </td><td> DD </td><td> Added resolution of issues + <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6403">6403</a>, + <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6721">6721</a></td></tr></tbody></table></div></div></body></html> \ No newline at end of file Index: wsenum.xml =================================================================== RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wsenum.xml,v retrieving revision 1.57 retrieving revision 1.58 diff -u -d -r1.57 -r1.58 --- wsenum.xml 2 Oct 2009 15:50:32 -0000 1.57 +++ wsenum.xml 5 Oct 2009 09:48:42 -0000 1.58 @@ -392,6 +392,15 @@ <td> This specification </td> </tr> <tr> + <td> wsenp </td> + <td> + <loc href="http://www.w3.org/&wsenu.nsprefix;/ws-enp"> + http://www.w3.org/&wsenu.nsprefix;/ws-enp + </loc> + </td> + <td> This specification </td> + </tr> + <tr> <td> s </td> <td> <loc href="http://www.w3.org/2003/05/soap-envelope"> @@ -2270,16 +2279,178 @@ </ulist> </div1> - <div1 id="policy"> - <head>WS-Enumeration Policy Assertion(s)</head> + <div1 id="metadata"> + <head>WS-Enumeration Metadata</head> <p> An endpoint MAY indicate that it supports WS-Enumeration, or its features, - by including the WS-Enumeration Policy assertion(s) within its WSDL. By + by including the WS-Enumeration Policy assertion within its WSDL. By doing so the endpoint is indicating that the corresponding WS-Enumeration operations are supported by that endpoint even though they do not - explicitly appear in its WSDL. + explicitly appear in its WSDL (i.e. retrievable by using a + WS-MetadataExchange GetMetadata with a Dialect URI of + http://schemas.xmlsoap.org/wsdl/). + </p> + + <p> + An endpoint MAY choose to expose the WS-Enumeration WSDL by using the + following WS-MetadataExchange Dialect: + </p> + + <table border="1"> + <tbody> + <tr> + <th align="left"> Dialect URI </th> + <th> @Identifier value </th> + </tr> + <tr> + <td> http://www.w3.org/2009/02/ws-tra/EnumerationWSDL </td> + <td> Not defined </td> + </tr> + </tbody> + </table> + + <p> + The WS-Enumeration WSDL can be annotated to indicate any endpoint + specific metadata that might be needed by clients interacting with + this service. For example, the WSDL MAY have policy assertions that + indicate a particular security mechanism used to protect the + WS-Enumeration operations supported by this endpoint. </p> + + <div2> + <head>Enumeration Assertion</head> + + <p> + The mechanism for indicating that a binding or endpoint conforms to the + WS-Enumeration specification is through the use of the Web Services + Policy - Framework <bibref ref="wspolicy"/> and Web Services Policy - + Attachment <bibref ref="wspolicyattach"/> specifications. + </p> + + <p> + This specification defines a policy assertion (wsenp:Enumeration). The + wsenp:Enumeration policy assertion applies to the endpoint policy subject. + </p> + + <p> + For WSDL 1.1, these assertions may be attached to wsdl11:port or + wsdl11:binding. For WSDL 2.0, they may be attached to wsdl20:endpoint or + wsdl20:binding. A policy expression containing the wsenp:Enumeration + policy assertion MUST NOT be attached to a wsdl:portType or + wsdl20:interface. + </p> + + <p> + The wsenp:Enumeration policy assertion is a nested policy container + assertion. The meaning of this assertion, when present in a policy + alternative, is that WS-Enumeration is required to communicate with the + subject. In order to indicate that the subject supports WS-Enumeration + but does not require its use, an additional policy alternative should + be provided which does not contain this assertion; the compact + authoring style for an optional policy assertion provided by WS-Policy + may be used. The wsp:Optional attribute, as a syntactic shortcut, can be + used with the wsenp:Enumeration assertion. This indicates two policy + alternatives, one which contains the policy assertion, and another + which does not. + </p> + + <p> + The inclusion of this assertion implies support for the WS-Enumeration + specification. + </p> + + <p> + The normative outline of this assertion is: + </p> + + <example> + <eg><wsenp:Enumeration [wsp:Optional="<emph>xs:boolean</emph>"]? ...> + <wsenp:FilterDialect ...> <emph>xs:anyURI</emph> </wsenp:FilterDialect> * + <wsenp:MaxExpires ...> <emph>xs:duration</emph> </wsenp:MaxExpires> ? + <wsenp:MaxTime ...> <emph>xs:duration</emph> </wsenp:MaxTime> ? + <wsenp:MaxElements ...> <emph>xs:long</emph> </wsenp:MaxElements> ? + <wsenp:MaxCharacters ...> <emph>xs:long</emph> </wsenp:MaxCharacters> ? + ... +</wsenp:Enumeration></eg> + </example> + + <p> + The following describes additional, normative constraints on the + outline listed above: + </p> + + <glist> + + <gitem> + <label> /wsenp:Enumeration </label> + <def> + <p> + A policy assertion that specifies that WS-Enumeration protocol MUST + be used when communicating with this endpoint. This assertion has + Endpoint Policy Subject. + </p> + </def> + </gitem> + + <gitem> + <label> /wsenp:Enumeration/wsenp:FilterDialect </label> + <def> + <p> + When present, this parameter indicates support for the specified + Filter Dialect URI. + </p> + </def> + </gitem> + + <gitem> + <label> /wsenp:Enumeration/wsenp:MaxExpires </label> + <def> + <p> + When present, this parameter indicates the maximum lifetime of + enumerations that this endpoint will support. Note: a value of + "PT0S" indicates that this endpoint supports enumerations with + an infinite lifetime. + </p> + </def> + </gitem> + + <gitem> + <label> /wsenp:Enumeration/wsenp:MaxTime </label> + <def> + <p> + When present, this parameter indicates the maximum MaxTime value + supported by this endpoint. Note: a value of "PT0S" indicates that + this endpoint supports any duration value. + </p> + </def> + </gitem> + + <gitem> + <label> /wsenp:Enumeration/wsenp:MaxElements </label> + <def> + <p> + When present, this parameter indicates the maximum MaxElements value + supported by this endpoint. The value specified MUST be greater + than zero. + </p> + </def> + </gitem> + + <gitem> + <label> /wsenp:Enumeration/wsenp:MaxCharacters </label> + <def> + <p> + When present, this parameter indicates the maximum MaxCharacters + value supported by this endpoint. The value specified MUST be + greater than zero. + </p> + </def> + </gitem> + + </glist> + + </div2> </div1> <div1 id="acks"> @@ -2391,6 +2562,15 @@ World Wide Web Consortium (W3C), 4 September 2007. </bibl> + <bibl key="WS-Policy Attachment" id="wspolicyattach" + href="http://www.w3.org/TR/ws-policy-attach"> + <titleref> + W3C Recommendation, "Web Services Policy (WS-Policy) 1.5 - Attachment" + </titleref> + , A. Vedamuthu, et al., Editors. + World Wide Web Consortium (W3C), 4 September 2007. + </bibl> + <bibl key="WSDL11" id="WSDL11" href="http://www.w3.org/TR/2001/NOTE-wsdl-20010315"> <titleref> @@ -2872,6 +3052,34 @@ </example> </div1> + <div1 id="policyXSD"> + <head>Enumeration Policy Schema</head> + + <p> + A normative copy of the XML Schema description for the Enumeration + Policy assertion can be retrieved from the following address: + </p> + + <example> + <eg>http://www.w3.org/2009/09/ws-enu/EnumerationPolicy.xsd</eg> + </example> + + <p> + A non-normative copy of the XML schema is listed below for convenience. + </p> + + <example> + <eg><wsenp:Enumeration [wsp:Optional="xs:boolean"]? ...> + <wsenp:FilterDialect ...> xs:anyURI </wsenp:FilterDialect> * + <wsenp:MaxExpires ...> xs:duration </wsenp:MaxExpires> ? + <wsenp:MaxTime ...> xs:duration </wsenp:MaxTime> ? + <wsenp:MaxElements ...> xs:long </wsenp:MaxElements> ? + <wsenp:MaxCharacters ...> xs:long </wsenp:MaxCharacters> ? + ... +</wsenp:Enumeration></eg> + </example> + </div1> + <div1 id="changelog"> <head>Change Log</head> @@ -3125,6 +3333,14 @@ <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=7426">7426</loc> </td> </tr> + <tr> + <td> 2009/10/05 </td> + <td> DD </td> + <td> Added resolution of issues + <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6403">6403</loc>, + <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6721">6721</loc> + </td> + </tr> </tbody> </table> </div1>
Received on Monday, 5 October 2009 09:48:46 UTC