- From: Doug Davis via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 05 Oct 2009 15:18:25 +0000
- To: public-ws-resource-access-notifications@w3.org
Update of /w3ccvs/WWW/2002/ws/ra/edcopies
In directory hutz:/tmp/cvs-serv27107
Modified Files:
wsfrag.html wsfrag.xml
Log Message:
6407, 6721
Index: wsfrag.html
===================================================================
RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wsfrag.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -d -r1.18 -r1.19
--- wsfrag.html 2 Oct 2009 15:50:32 -0000 1.18
+++ wsfrag.html 5 Oct 2009 15:18:23 -0000 1.19
@@ -53,8 +53,8 @@
3.2 <a href="#Put">Put</a><br/>
3.3 <a href="#Delete">Delete</a><br/>
3.4 <a href="#Create">Create</a><br/>
-4 <a href="#iddiv1_1_754">Examples</a><br/>
- 4.1 <a href="#iddiv2_1_757">Examples</a><br/>
+4 <a href="#iddiv1_1_774">Examples</a><br/>
+ 4.1 <a href="#iddiv2_1_777">Examples</a><br/>
5 <a href="#QName">QName Expression Language</a><br/>
6 <a href="#XPathL1">XPath Level 1 Expression Language</a><br/>
7 <a href="#XPath10">XPath 1.0 Expression Language</a><br/>
@@ -63,13 +63,15 @@
8.2 <a href="#InvalidFragment">InvalidFragment</a><br/>
8.3 <a href="#InvalidExpression">InvalidExpression</a><br/>
8.4 <a href="#UnsupportedMode">UnsupportedMode</a><br/>
-9 <a href="#policy">WS-Fragment Policy Assertion(s)</a><br/>
+9 <a href="#metadata">WS-Fragment Metadata</a><br/>
+ 9.1 <a href="#iddiv2_1_1437">Fragment Assertion</a><br/>
10 <a href="#acks">Acknowledgements</a><br/>
11 <a href="#refs">References</a><br/>
- 11.1 <a href="#iddiv2_1_1427">Normative References</a><br/>
+ 11.1 <a href="#iddiv2_1_1493">Normative References</a><br/>
</p>
<h3><a name="appendices" id="appendices"/>Appendices</h3><p class="toc">A <a href="#Appendix_I__E2_80_93_XSD">XML Schema</a><br/>
-B <a href="#ChangeLog">Change Log</a><br/>
+B <a href="#policyXSD">Fragment Policy Schema</a><br/>
+C <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>
This specification extends the WS-Transfer specification and defines
@@ -123,6 +125,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> wsf </td><td><a href="http://www.w3.org/2009/09/ws-fra">http://www.w3.org/2009/09/ws-fra</a></td><td>
This specification
+ </td></tr><tr><td> wsf </td><td><a href="http://www.w3.org/2009/09/ws-fra">http://www.w3.org/2009/09/ws-frp</a></td><td>
+ This specification
</td></tr><tr><td> s </td><td> Either SOAP 1.1 or 1.2 </td><td> SOAP </td></tr><tr><td> s11 </td><td><a href="http://schemas.xmlsoap.org/soap/envelope/">http://schemas.xmlsoap.org/soap/envelope/</a></td><td><a href="#SOAP11">[SOAP11]</a></td></tr><tr><td> s12 </td><td><a href="http://www.w3.org/2003/05/soap-envelope">http://www.w3.org/2003/05/soap-envelope</a></td><td><a href="#SOAP121">[SOAP12]</a></td></tr><tr><td> wsa </td><td><a href="http://www.w3.org/2005/08/addressing">http://www.w3.org/2005/08/addressing</a></td><td><a href="#AddrCore">[WS-Addressing]</a></td></tr><tr><td> xs </td><td><a href="http://www.w3.org/2001/XMLSchema">http://www.w3.org/2001/XMLSchema</a></td><td>
XML Schema <a href="#XMLSchema1">[XMLSchema - Part 1]</a>, <a href="#XMLSchema2">[XMLSchema - Part 2]</a></td></tr><tr><td> wst </td><td><a href="http://www.w3.org/2009/09/ws-tra">http://www.w3.org/2009/09/ws-tra</a></td><td><a href="#WsTransfer">[WS-Transfer]</a></td></tr></tbody></table><p>
The working group intends to update the value of the Web Services
@@ -405,8 +409,8 @@
This specification does not extend the Create operation defined in
WS-Transfer.
</p></div></div><div class="div1">
-<h2><a name="iddiv1_1_754" id="iddiv1_1_754"/>4 Examples</h2><div class="div2">
-<h3><a name="iddiv2_1_757" id="iddiv2_1_757"/>4.1 Examples</h3><p>
+<h2><a name="iddiv1_1_774" id="iddiv1_1_774"/>4 Examples</h2><div class="div2">
+<h3><a name="iddiv2_1_777" id="iddiv2_1_777"/>4.1 Examples</h3><p>
In the following examples, and Expression Language definitions,
the following representation of a resource is used for
informational purposes:
@@ -824,13 +828,57 @@
</p><a name="Table6" id="Table6"/><table border="1" cellpadding="5"><tbody><tr><th align="left"><b>[Code]</b></th><td>s:Sender</td></tr><tr><th align="left"><b>[Subcode]</b></th><td>wst:UnsupportedMode</td></tr><tr><th align="left"><b>[Reason]</b></th><td>
The specified mode is not supported.
</td></tr><tr><th align="left"><b>[Detail]</b></th><td><em>The unsupported Mode.</em></td></tr></tbody></table></div></div><div class="div1">
-<h2><a name="policy" id="policy"/>9 WS-Fragment Policy Assertion(s)</h2><p>
+<h2><a name="metadata" id="metadata"/>9 WS-Fragment Metadata</h2><p>
An endpoint MAY indicate that it supports WS-Fragment, or its features,
- by including the WS-Fragment Policy assertion(s) within its WSDL. By
+ by including the WS-Fragment Policy assertion within its WSDL. By
doing so the endpoint is indicating that the corresponding WS-Fragment
- operations are supported by that endpoint even though they do not
- explicitly appear in its WSDL.
- </p></div><div class="div1">
+ features are supported by that endpoint.
+ </p><div class="div2">
+<h3><a name="iddiv2_1_1437" id="iddiv2_1_1437"/>9.1 Fragment Assertion</h3><p>
+ The mechanism for indicating that a binding or endpoint conforms to the
+ WS-Fragment 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 (wsfrp:Fragment). The
+ wsfrp:Fragment 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 wsfrp:Fragment
+ policy assertion MUST NOT be attached to a wsdl:portType or
+ wsdl20:interface.
+ </p><p>
+ The wsfrp:Fragment policy assertion is a nested policy container
+ assertion. The meaning of this assertion, when present in a policy
+ alternative, is that WS-Fragment is required to communicate with the
+ subject. In order to indicate that the subject supports WS-Fragment
+ 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 wsfrp:Fragment 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-Fragment
+ specification.
+ </p><p>
+ The normative outline of this assertion is:
+ </p><div class="exampleOuter"><div class="exampleInner"><pre><wsfrp:Fragment [wsp:Optional="<em>xs:boolean</em>"]? ...>
+ <wsfrp:Language ...> <em>xs:anyURI</em> </wsfrp:Language> *
+ ...
+</wsfrp:Fragment></pre></div></div><p>
+ The following describes additional, normative constraints on the
+ outline listed above:
+ </p><dl><dt class="label"> /wsfrp:Fragment </dt><dd><p>
+ A policy assertion that specifies that WS-Fragment protocol MUST
+ be used when communicating with this endpoint. This assertion has
+ Endpoint Policy Subject.
+ </p></dd><dt class="label"> /wsfrp:Fragment/wsfrp:Language </dt><dd><p>
+ When present, this parameter indicates support for the specified
+ Language IRI.
+ </p></dd></dl></div></div><div class="div1">
<h2><a name="acks" id="acks"/>10 Acknowledgements</h2><p>
This specification has been developed as a result of joint
work with many individuals and teams, including:
@@ -855,7 +903,7 @@
Yves Lafon (W3C).
</p></div><div class="div1">
<h2><a name="refs" id="refs"/>11 References</h2><div class="div2">
-<h3><a name="iddiv2_1_1427" id="iddiv2_1_1427"/>11.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_1493" id="iddiv2_1_1493"/>11.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.
@@ -896,7 +944,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="WsTransfer" id="WsTransfer"/>WS-Transfer</dt><dd><a href="http://www.w3.org/TR/ws-transfer"><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="WsTransfer" id="WsTransfer"/>WS-Transfer</dt><dd><a href="http://www.w3.org/TR/ws-transfer"><cite>
W3C Working Group Draft, "Web Services Transfer (WS-Transfer)1.1"
</cite></a>
, D. Davis, et al., Editors.
@@ -969,7 +1022,16 @@
</xs:element>
</xs:schema> </pre></div></div></div><div class="div1">
-<h2><a name="ChangeLog" id="ChangeLog"/>B Change Log</h2><table border="1"><tbody><tr><th> Data </th><th> Author </th><th> Description </th></tr><tr><td> 2009/08/01 </td><td> DD </td><td> Initial draft </td></tr><tr><td> 2009/08/18 </td><td> DD </td><td> Added resolution of issue
+<h2><a name="policyXSD" id="policyXSD"/>B Fragment Policy Schema</h2><p>
+ A normative copy of the XML Schema description for the Fragment
+ Policy assertion can be retrieved from the following address:
+ </p><div class="exampleOuter"><div class="exampleInner"><pre>http://www.w3.org/2009/09/ws-frp/FragmentPolicy.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><wsfrp:Fragment [wsp:Optional="xs:boolean"]? ...>
+ <wsfrp:Language ...> xs:anyURI </wsfrp:Language> *
+ ...
+</wsfrp:Fragment></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/08/01 </td><td> DD </td><td> Initial draft </td></tr><tr><td> 2009/08/18 </td><td> DD </td><td> Added resolution of issue
<a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=7206">7206</a></td></tr><tr><td> 2009/08/18 </td><td> DD </td><td> Added resolution of issue
<a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=7197">7197</a></td></tr><tr><td> 2009/08/18 </td><td> DD </td><td> Added resolution of issue
<a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=7270">7270</a></td></tr><tr><td> 2009/09/01 </td><td> DD </td><td> Added resolution of issue
@@ -977,4 +1039,6 @@
<a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6694">6694</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=7088">7088</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=7770">7770</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 issue
+ <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6407">6407</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: wsfrag.xml
===================================================================
RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wsfrag.xml,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -d -r1.19 -r1.20
--- wsfrag.xml 2 Oct 2009 15:50:32 -0000 1.19
+++ wsfrag.xml 5 Oct 2009 15:18:23 -0000 1.20
@@ -210,6 +210,15 @@
</td>
</tr>
<tr>
+ <td> wsf </td>
+ <td>
+ <loc href="http://www.w3.org/&wsfra.nsprefix;/ws-fra">http://www.w3.org/&wsfra.nsprefix;/ws-frp</loc>
+ </td>
+ <td>
+ This specification
+ </td>
+ </tr>
+ <tr>
<td> s </td>
<td> Either SOAP 1.1 or 1.2 </td>
<td> SOAP </td>
@@ -1609,16 +1618,100 @@
</div1>
- <div1 id="policy">
- <head>WS-Fragment Policy Assertion(s)</head>
+ <div1 id="metadata">
+ <head>WS-Fragment Metadata</head>
<p>
An endpoint MAY indicate that it supports WS-Fragment, or its features,
- by including the WS-Fragment Policy assertion(s) within its WSDL. By
+ by including the WS-Fragment Policy assertion within its WSDL. By
doing so the endpoint is indicating that the corresponding WS-Fragment
- operations are supported by that endpoint even though they do not
- explicitly appear in its WSDL.
+ features are supported by that endpoint.
</p>
+
+ <div2>
+ <head>Fragment Assertion</head>
+
+ <p>
+ The mechanism for indicating that a binding or endpoint conforms to the
+ WS-Fragment 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 (wsfrp:Fragment). The
+ wsfrp:Fragment 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 wsfrp:Fragment
+ policy assertion MUST NOT be attached to a wsdl:portType or
+ wsdl20:interface.
+ </p>
+
+ <p>
+ The wsfrp:Fragment policy assertion is a nested policy container
+ assertion. The meaning of this assertion, when present in a policy
+ alternative, is that WS-Fragment is required to communicate with the
+ subject. In order to indicate that the subject supports WS-Fragment
+ 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 wsfrp:Fragment 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-Fragment
+ specification.
+ </p>
+
+ <p>
+ The normative outline of this assertion is:
+ </p>
+
+ <example>
+ <eg><wsfrp:Fragment [wsp:Optional="<emph>xs:boolean</emph>"]? ...>
+ <wsfrp:Language ...> <emph>xs:anyURI</emph> </wsfrp:Language> *
+ ...
+</wsfrp:Fragment></eg>
+ </example>
+
+ <p>
+ The following describes additional, normative constraints on the
+ outline listed above:
+ </p>
+
+ <glist>
+
+ <gitem>
+ <label> /wsfrp:Fragment </label>
+ <def>
+ <p>
+ A policy assertion that specifies that WS-Fragment protocol MUST
+ be used when communicating with this endpoint. This assertion has
+ Endpoint Policy Subject.
+ </p>
+ </def>
+ </gitem>
+
+ <gitem>
+ <label> /wsfrp:Fragment/wsfrp:Language </label>
+ <def>
+ <p>
+ When present, this parameter indicates support for the specified
+ Language IRI.
+ </p>
+ </def>
+ </gitem>
+
+ </glist>
+
+ </div2>
</div1>
<div1 id="acks">
@@ -1728,6 +1821,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="WS-Transfer" id="WsTransfer"
href="http://www.w3.org/TR/ws-transfer">
<titleref>
@@ -1846,6 +1948,31 @@
</example>
</div1>
+ <div1 id="policyXSD">
+ <head>Fragment Policy Schema</head>
+
+ <p>
+ A normative copy of the XML Schema description for the Fragment
+ Policy assertion can be retrieved from the following address:
+ </p>
+
+ <example>
+ <eg>http://www.w3.org/2009/09/ws-frp/FragmentPolicy.xsd</eg>
+ </example>
+
+ <p>
+ A non-normative copy of the XML schema is listed below for convenience.
+ </p>
+
+ <example>
+ <eg><wsfrp:Fragment [wsp:Optional="xs:boolean"]? ...>
+ <wsfrp:Language ...> xs:anyURI </wsfrp:Language> *
+ ...
+</wsfrp:Fragment></eg>
+ </example>
+ </div1>
+
+
<div1 id="ChangeLog">
<head>Change Log</head>
@@ -1917,6 +2044,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 issue
+ <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6407">6407</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 15:18:32 UTC