- From: Doug Davis via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 13 May 2009 14:01:05 +0000
- To: public-ws-resource-access-notifications@w3.org
Update of /w3ccvs/WWW/2002/ws/ra/edcopies
In directory hutz:/tmp/cvs-serv20478
Modified Files:
wst.html wst.xml
Log Message:
6594, 6672, 6673
Index: wst.xml
===================================================================
RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wst.xml,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -d -r1.31 -r1.32
--- wst.xml 13 May 2009 00:27:31 -0000 1.31
+++ wst.xml 13 May 2009 14:01:03 -0000 1.32
@@ -471,8 +471,9 @@
<label> <kw>[Body]</kw>/wst:Get </label>
<def>
<p>
- This REQUIRED element MAY contain child elements that
- can be used for extensibility purposes.
+ This is a REQUIRED element that has no defined child element
+ content. However, it MAY include child element content as
+ defined by an extension(s).
</p>
</def>
</gitem>
@@ -488,7 +489,7 @@
<kw>[Body]</kw>
<wst:GetResponse ...>
- <emph>xs:any</emph>+
+ <emph>xs:any</emph>*
</wst:GetResponse></eg>
</example>
@@ -502,11 +503,10 @@
<label> <kw>[Body]</kw>/wst:GetResponse </label>
<def>
<p>
- This REQUIRED element MUST contain at least one child
- element - the representation of the resource. The
- presence of subsequent child elements is service-specific and
- MAY be controlled by the presence or extension-specific
- SOAP headers in the original request.
+ This REQUIRED element MUST have as its first child element,
+ an element that comprises the representation of the resource.
+ Additional extension elements MAY be included after the
+ element representing the resource.
</p>
</def>
</gitem>
@@ -604,7 +604,7 @@
<kw>[Body]</kw>
<wst:Put ...>
- <emph>xs:any</emph>+
+ <emph>xs:any</emph>*
</wst:Put></eg>
</example>
<p>
@@ -617,9 +617,10 @@
<label> <kw>[Body]</kw>/wst:Put </label>
<def>
<p>
- This REQUIRED element MUST contain at least one child element -
- the representation to be used for the update.
- All other children SHOULD be ignored by the service.
+ This REQUIRED element MUST have as its first child element,
+ an element that comprises the representation of the resource
+ that is to be replaced. Additional extension elements MAY
+ be included after the element representing the resource.
</p>
</def>
</gitem>
@@ -646,7 +647,7 @@
<kw>[Body]</kw>
<wst:PutResponse ...>
- <emph>xs:any</emph>?
+ <emph>xs:any</emph>*
</wst:PutResponse></eg>
</example>
<glist>
@@ -654,16 +655,16 @@
<label> <kw>[Body]</kw>/wst:PutResponse </label>
<def>
<p>
- This REQUIRED element MUST contain at least one child element
- (the current representation of the resource) if the updated
- representation differs from the representation sent in the
- Put request message.
- The presence of additional child elements which contain
- other information pertaining to the update is service-specific.
+ This REQUIRED element, if it contains any child elements,
+ MUST have as its first child element, an element that
+ comprises the representation of the resource that has been
+ updated. Additional extension elements MAY be included after
+ the element representing the resource.
</p>
<p>
- As an optimization and as a service to the requester, this
+ As an optimization and as a service to the requester,
+ if there are no extension elements this
element SHOULD be empty if the updated
representation does not differ from the representation sent in
the Put request message; that is, if the service accepted the
@@ -675,7 +676,7 @@
update request was successful in its entirety (assuming no
intervening mutating operations are performed). A service MAY
return the current representation of the resource as the
- initial child of the wst:PutResponse element even in this
+ child of the wst:PutResponse element even in this
case, however.
</p>
@@ -765,8 +766,9 @@
<label> <kw>[Body]</kw>/wst:Delete </label>
<def>
<p>
- This REQUIRED element MAY contain child elements that
- can be used for extensibility purposes.
+ This is a REQUIRED element that has no defined child element
+ content. However, it MAY include child element content as
+ defined by an extension(s).
</p>
</def>
</gitem>
@@ -789,7 +791,7 @@
<kw>[Body]</kw>
<wst:DeleteResponse ...>
- <emph>xs:any</emph>?
+ <emph>xs:any</emph>*
</wst:DeleteResponse></eg>
</example>
<glist>
@@ -797,8 +799,7 @@
<label> <kw>[Body]</kw>/wst:DeleteResponse </label>
<def>
<p>
- This REQUIRED element MAY contain a child element that
- can be used for extensibility purposes.
+ This REQUIRED element MAY contain extension elements.
</p>
</def>
</gitem>
@@ -901,14 +902,14 @@
<label> <kw>[Body]</kw>/wst:Create </label>
<def>
<p>
- If this REQUIRED element contains children then the first child
- MUST be the literal resource representation, a representation
- of the constructor for the resource, or other instructions for
- creating the resource. All other children SHOULD be ignored
- by the service.
- If this element does not
- contain any children then the resource will be created
- using default values.
+ This REQUIRED element MAY contain zero or more child elements.
+ If this element does not contain a child element then the
+ resource will be created using default values. The first
+ child element, if present, MUST be the literal resource
+ representation, a representation of the constructor for the
+ resource, or other instructions for creating the resource.
+ Additional extension elements MAY be included only after
+ the mandated first child element.
</p>
</def>
</gitem>
@@ -933,7 +934,7 @@
<kw>[Body]</kw>
<wst:CreateResponse ...>
<wst:ResourceCreated><emph>endpoint-reference</emph></wst:ResourceCreated>
- <emph>xs:any</emph>?
+ <emph>xs:any</emph>*
</wst:CreateResponse></eg>
</example>
<glist>
@@ -941,13 +942,13 @@
<label> <kw>[Body]</kw>/wst:CreateResponse </label>
<def>
<p>
- This REQUIRED element MUST contain, at a minimum,
- a resource reference (wst:ResourceCreated element)
- to the newly created resource.
+ This REQUIRED element MUST have as its first child element
+ an Endpoint Reference (wst:ResourceCreated element) to the
+ newly created resource.
</p>
<p>
- By default, a service MUST also return the current
+ A service MUST also return the current
representation of the new resource as the second child
of the wst:CreateResponse element if the
created representation logically differs from the
@@ -957,10 +958,7 @@
overridden with a different value during resource
creation. If default values are used to complete a resource
creation which were not present in the Create message, then
- this does not constitute a logical difference. The presence
- of additional child elements which contain other information
- pertaining to the result of the Create operation is
- service-specific.
+ this does not constitute a logical difference.
</p>
<p>
@@ -968,16 +966,22 @@
wst:CreateResponse element of the response message SHOULD be
empty, other than the ResourceCreated element, if the created
representation does not logically differ from the
- representation sent in the Create request message; that is,
+ representation sent in the Create request message and there
+ are no eextension elements; that is,
if the service accepted the new representation or
creation instructions verbatim. Such a response indicates
that the request was completely successful
(assuming no intervening mutating
operations are performed). A service MAY return the current
- representation of the resource as the initial child of the
+ representation of the resource as the second child of the
wst:CreateResponse element even in this case, however.
</p>
+ <p>
+ Additional extension elements MAY be included after the
+ element representing the resource.
+ </p>
+
</def>
</gitem>
@@ -1608,6 +1612,15 @@
<loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6433">6433</loc>
</td>
</tr>
+ <tr>
+ <td> 2009/05/13 </td>
+ <td> DD </td>
+ <td> Added resolution of issues
+ <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6672">6672</loc>,
+ <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6673">6673</loc>,
+ <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6594">6594</loc>
+ </td>
+ </tr>
</tbody>
</table>
</div1>
Index: wst.html
===================================================================
RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wst.html,v
retrieving revision 1.35
retrieving revision 1.36
diff -u -d -r1.35 -r1.36
--- wst.html 13 May 2009 00:27:31 -0000 1.35
+++ wst.html 13 May 2009 14:01:03 -0000 1.36
@@ -228,8 +228,9 @@
<em>xs:any</em>*
</wst:Get></pre></div></div><p>The following describes additional, normative constraints on the outline
listed above:</p><dl><dt class="label"><b>[Body]</b>/wst:Get </dt><dd><p>
- This REQUIRED element MAY contain child elements that
- can be used for extensibility purposes.
+ This is a REQUIRED element that has no defined child element
+ content. However, it MAY include child element content as
+ defined by an extension(s).
</p></dd></dl><p>A Get request MUST be targeted at the resource whose representation is
desired as described in <a href="#Notations_and_Terminology"><b>2 Terminology and Notation</b></a> of
this specification.</p><p>If the resource accepts a Get request, it MUST reply with a response of
@@ -238,16 +239,15 @@
<b>[Body]</b>
<wst:GetResponse ...>
- <em>xs:any</em>+
+ <em>xs:any</em>*
</wst:GetResponse></pre></div></div><p>
The following describes additional, normative constraints on the
outline listed above:
</p><dl><dt class="label"><b>[Body]</b>/wst:GetResponse </dt><dd><p>
- This REQUIRED element MUST contain at least one child
- element - the representation of the resource. The
- presence of subsequent child elements is service-specific and
- MAY be controlled by the presence or extension-specific
- SOAP headers in the original request.
+ This REQUIRED element MUST have as its first child element,
+ an element that comprises the representation of the resource.
+ Additional extension elements MAY be included after the
+ element representing the resource.
</p></dd></dl><p>
Other components of the outline above are not further constrained
by this specification.
@@ -321,14 +321,15 @@
<b>[Body]</b>
<wst:Put ...>
- <em>xs:any</em>+
+ <em>xs:any</em>*
</wst:Put></pre></div></div><p>
The following describes additional, normative constraints on the
outline listed above:
</p><dl><dt class="label"><b>[Body]</b>/wst:Put </dt><dd><p>
- This REQUIRED element MUST contain at least one child element -
- the representation to be used for the update.
- All other children SHOULD be ignored by the service.
+ This REQUIRED element MUST have as its first child element,
+ an element that comprises the representation of the resource
+ that is to be replaced. Additional extension elements MAY
+ be included after the element representing the resource.
</p></dd></dl><p>
A Put request MUST be targeted at the resource whose representation is
desired to be replaced, as described in
@@ -345,16 +346,16 @@
<b>[Body]</b>
<wst:PutResponse ...>
- <em>xs:any</em>?
+ <em>xs:any</em>*
</wst:PutResponse></pre></div></div><dl><dt class="label"><b>[Body]</b>/wst:PutResponse </dt><dd><p>
- This REQUIRED element MUST contain at least one child element
- (the current representation of the resource) if the updated
- representation differs from the representation sent in the
- Put request message.
- The presence of additional child elements which contain
- other information pertaining to the update is service-specific.
+ This REQUIRED element, if it contains any child elements,
+ MUST have as its first child element, an element that
+ comprises the representation of the resource that has been
+ updated. Additional extension elements MAY be included after
+ the element representing the resource.
</p><p>
- As an optimization and as a service to the requester, this
+ As an optimization and as a service to the requester,
+ if there are no extension elements this
element SHOULD be empty if the updated
representation does not differ from the representation sent in
the Put request message; that is, if the service accepted the
@@ -364,7 +365,7 @@
update request was successful in its entirety (assuming no
intervening mutating operations are performed). A service MAY
return the current representation of the resource as the
- initial child of the wst:PutResponse element even in this
+ child of the wst:PutResponse element even in this
case, however.
</p></dd></dl><p>Other components of the outline above are not further constrained by this
specification.</p><p>The following shows a sample SOAP envelope containing a Put request:</p><div class="exampleOuter"><div class="exampleInner"><pre><s:Envelope
@@ -428,8 +429,9 @@
<em>xs:any</em>*
</wst:Delete></pre></div></div><p>The following describes additional, normative constraints on the outline
listed above:</p><dl><dt class="label"><b>[Body]</b>/wst:Delete </dt><dd><p>
- This REQUIRED element MAY contain child elements that
- can be used for extensibility purposes.
+ This is a REQUIRED element that has no defined child element
+ content. However, it MAY include child element content as
+ defined by an extension(s).
</p></dd></dl><p>A Delete request MUST be targeted at the resource to be deleted as
described in <a href="#Notations_and_Terminology"><b>2 Terminology and Notation</b></a> of this
specification.</p><p>Implementations may respond with a fault message using the standard fault
@@ -442,10 +444,9 @@
<b>[Body]</b>
<wst:DeleteResponse ...>
- <em>xs:any</em>?
+ <em>xs:any</em>*
</wst:DeleteResponse></pre></div></div><dl><dt class="label"><b>[Body]</b>/wst:DeleteResponse </dt><dd><p>
- This REQUIRED element MAY contain a child element that
- can be used for extensibility purposes.
+ This REQUIRED element MAY contain extension elements.
</p></dd></dl><p>
Other components of the outline above are not further constrained
by this specification.
@@ -518,14 +519,14 @@
The following describes additional, normative constraints on the
outline listed above:
</p><dl><dt class="label"><b>[Body]</b>/wst:Create </dt><dd><p>
- If this REQUIRED element contains children then the first child
- MUST be the literal resource representation, a representation
- of the constructor for the resource, or other instructions for
- creating the resource. All other children SHOULD be ignored
- by the service.
- If this element does not
- contain any children then the resource will be created
- using default values.
+ This REQUIRED element MAY contain zero or more child elements.
+ If this element does not contain a child element then the
+ resource will be created using default values. The first
+ child element, if present, MUST be the literal resource
+ representation, a representation of the constructor for the
+ resource, or other instructions for creating the resource.
+ Additional extension elements MAY be included only after
+ the mandated first child element.
</p></dd></dl><p>A Create request MUST be targeted at a resource factory capable of
creating the desired new resource. This factory is distinct from the resource
being created (which by definition does not exist prior to the successful
@@ -540,13 +541,13 @@
<b>[Body]</b>
<wst:CreateResponse ...>
<wst:ResourceCreated><em>endpoint-reference</em></wst:ResourceCreated>
- <em>xs:any</em>?
+ <em>xs:any</em>*
</wst:CreateResponse></pre></div></div><dl><dt class="label"><b>[Body]</b>/wst:CreateResponse </dt><dd><p>
- This REQUIRED element MUST contain, at a minimum,
- a resource reference (wst:ResourceCreated element)
- to the newly created resource.
+ This REQUIRED element MUST have as its first child element
+ an Endpoint Reference (wst:ResourceCreated element) to the
+ newly created resource.
</p><p>
- By default, a service MUST also return the current
+ A service MUST also return the current
representation of the new resource as the second child
of the wst:CreateResponse element if the
created representation logically differs from the
@@ -556,23 +557,24 @@
overridden with a different value during resource
creation. If default values are used to complete a resource
creation which were not present in the Create message, then
- this does not constitute a logical difference. The presence
- of additional child elements which contain other information
- pertaining to the result of the Create operation is
- service-specific.
+ this does not constitute a logical difference.
</p><p>
As an optimization and as a service to the requestor, the
wst:CreateResponse element of the response message SHOULD be
empty, other than the ResourceCreated element, if the created
representation does not logically differ from the
- representation sent in the Create request message; that is,
+ representation sent in the Create request message and there
+ are no eextension elements; that is,
if the service accepted the new representation or
creation instructions verbatim. Such a response indicates
that the request was completely successful
(assuming no intervening mutating
operations are performed). A service MAY return the current
- representation of the resource as the initial child of the
+ representation of the resource as the second child of the
wst:CreateResponse element even in this case, however.
+ </p><p>
+ Additional extension elements MAY be included after the
+ element representing the resource.
</p></dd><dt class="label"><b>[Body]</b>/wst:CreateResponse/wst:ResourceCreated </dt><dd><p>
This required element MUST contain a resource reference for the
newly created resource. This resource reference, represented
@@ -966,4 +968,7 @@
<a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6648">6648</a></td></tr><tr><td> 2009/04/20 </td><td> DD </td><td> Added resolution of issue
<a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6730">6730</a></td></tr><tr><td> 2009/04/22 </td><td> KW </td><td> Added resolution of issue
<a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6739">6739</a></td></tr><tr><td> 2009/05/12 </td><td> DD </td><td> Added resolution of issue
- <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6433">6433</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=6433">6433</a></td></tr><tr><td> 2009/05/13 </td><td> DD </td><td> Added resolution of issues
+ <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6672">6672</a>,
+ <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6673">6673</a>,
+ <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6594">6594</a></td></tr></tbody></table></div></div></body></html>
\ No newline at end of file
Received on Wednesday, 13 May 2009 14:01:15 UTC