- From: Ram Jeyaraman <Ram.Jeyaraman@microsoft.com>
- Date: Mon, 7 Dec 2009 18:07:58 +0000
- To: Doug Davis <dug@us.ibm.com>, "public-ws-resource-access@w3.org" <public-ws-resource-access@w3.org>
- Message-ID: <503546C5699C1144BDEA0D0DFFE7F881181A355C@TK5EX14MBXC119.redmond.corp.microsoft.>
Looks good in general.
A specific comment on WS-Enumeration:
Ø @@ -1673,8 +1674,11 @@
If the data source terminates an enumeration
unexpectedly, the data source SHOULD send an EnumerationEnd SOAP
message to the endpoint reference indicated when the enumeration
- was created (see <specref ref="Enumerate"/>). The message MUST be of the
- following form:
+ was created (see <specref ref="Enumerate"/>).
+ Support for including the EndTo EPR in a Enumerate request message
+ (and implicitly the sending of the EnumerationEnd message) MUST
+ be supported by compliant data sources.
+ The message MUST be of the following form:
Suggest adding the highlighted sentence below:
If the data source terminates an enumeration unexpectedly, the data source SHOULD send an EnumerationEnd SOAP message to the endpoint reference indicated when the enumeration was created (see <specref ref="Enumerate"/>). This endpoint reference MUST refer to an endpoint that supports the EnumerationEndPortType portType. Support for including the EndTo EPR in a Enumerate request message (and implicitly the sending of the EnumerationEnd message) MUST be supported by compliant data sources. The message MUST be of the following form:
Thanks.
From: public-ws-resource-access-request@w3.org [mailto:public-ws-resource-access-request@w3.org] On Behalf Of Doug Davis
Sent: Tuesday, December 01, 2009 4:05 PM
To: public-ws-resource-access@w3.org
Subject: 8201 - please review
All,
attached is the cvs diff for the 8201 [1] updates. Please look them over and let me know if anything is wrong. I had to do some minor wordsmithing to some of the existing text in order to add the agreed to compliance sentence. Please note that while using the EndTo EPR (for eventing and enum) is optional, I assumed that the event source and data source MUST support a client including it.
For those who are not used to cvs, the lines that start with "-" are old/removed lines. Lines that start with "+" are new/added lines.
[1] http://www.w3.org/Bugs/Public/show_bug.cgi?id=8201
thanks
-Doug
______________________________________________________
STSM | Standards Architect | IBM Software Group
(919) 254-6905 | IBM 444-6905 | dug@us.ibm.com<mailto:dug@us.ibm.com>
The more I'm around some people, the more I like my dog.
----- Forwarded by Doug Davis/Raleigh/IBM on 12/01/2009 06:56 PM -----
Doug Davis via cvs-syncmail <cvsmail@w3.org<mailto:cvsmail@w3.org>>
Sent by: public-ws-resource-access-notifications-request@w3.org<mailto:public-ws-resource-access-notifications-request@w3.org>
12/01/2009 06:55 PM
To
public-ws-resource-access-notifications@w3.org<mailto:public-ws-resource-access-notifications@w3.org>
cc
Subject
WWW/2002/ws/ra/edcopies wsenum.xml,1.87,1.88 wseventing.xml,1.131,1.132 wsmex.xml,1.79,1.80 wst.xml,1.86,1.87
Update of /w3ccvs/WWW/2002/ws/ra/edcopies
In directory hutz:/tmp/cvs-serv13659
Modified Files:
wsenum.xml wseventing.xml wsmex.xml wst.xml
Log Message:
8201
Index: wst.xml
===================================================================
RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wst.xml,v
retrieving revision 1.86
retrieving revision 1.87
diff -u -d -r1.86 -r1.87
--- wst.xml 17 Nov 2009 22:05:23 -0000 1.86
+++ wst.xml 1 Dec 2009 23:55:29 -0000 1.87
@@ -465,12 +465,6 @@
by this specification.
</p>
- <p>
- A compliant SOAP Node that implements a resource MUST
- provide the Get operation as defined in this specification, and MAY provide
- the Put and Delete operations.
- </p>
-
</div2>
</div1>
@@ -479,8 +473,11 @@
<div2 id="Get">
<head>Get</head>
- <p>This specification defines one Web service operation (Get) for fetching a
-one-time snapshot of the representation of a resource.</p>
+ <p>
+ This specification defines one Web service operation (Get) for
+ fetching a one-time snapshot of the representation of a resource.
+ This operation MUST be supported by compliant WS-Transfer resources.
+ </p>
<p>The Get request message MUST be of the following form:</p>
<example>
<eg><kw>[Action]</kw>
@@ -661,8 +658,9 @@
<head>Put</head>
<p>
This specification defines one Web service operation (Put) for
- updating a resource by providing a replacement representation. A
- resource MAY accept updates that provide different XML
+ updating a resource by providing a replacement representation.
+ This operation MAY be supported by compliant WS-Transfer resources.
+ A resource MAY accept updates that provide different XML
representations than that returned by the resource; in such a
case, the semantics of the update operation is defined by
the resource.
@@ -885,8 +883,11 @@
</div2>
<div2 id="Delete">
<head>Delete</head>
- <p>This specification defines one Web service operation (Delete) for deleting
-a resource in its entirety.</p>
+ <p>
+ This specification defines one Web service operation (Delete) for
+ deleting a resource in its entirety.
+ This operation MAY be supported by compliant WS-Transfer resources.
+ </p>
<p>The Delete request message MUST be of the following form:</p>
<example>
<eg><kw>[Action]</kw>
@@ -1036,8 +1037,12 @@
<head>Resource Factory Operations</head>
<div2 id="Factory_Create">
<head>Create</head>
- <p>This specification defines one Web service operation (Create) for creating
- a resource and providing its initial representation. In some cases, the
+ <p>
+ This specification defines one Web service operation (Create) for
+ creating a resource and providing its initial representation.
+ This operation MAY be supported by compliant WS-Transfer resource
+ factories.
+ In some cases, the
initial representation MAY constitute the representation of a logical
constructor for the resource and can thus differ structurally from the
representation returned by Get or the one required by Put. This is because
@@ -2484,6 +2489,13 @@
<loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=8280">8280</loc>
</td>
</tr>
+ <tr>
+ <td> 2009/12/01 </td>
+ <td> DD </td>
+ <td> Added resolution of issue
+ <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=8201">8201</loc>
+ </td>
+ </tr>
</tbody>
</table>
</div1>
Index: wseventing.xml
===================================================================
RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wseventing.xml,v
retrieving revision 1.131
retrieving revision 1.132
diff -u -d -r1.131 -r1.132
--- wseventing.xml 17 Nov 2009 22:05:22 -0000 1.131
+++ wseventing.xml 1 Dec 2009 23:55:29 -0000 1.132
@@ -819,7 +819,9 @@
<p>
To create a subscription, a subscriber sends a Subscribe request message
- of the following form to an event source:
+ to an event source. This operation MUST be supported by
+ compliant event sources.
+ The message MUST be of the following form:
</p>
<example>
@@ -1375,13 +1377,11 @@
<head>Renew</head>
<p>
- To update the expiration for a subscription, subscription
- managers MUST support requests to renew subscriptions.
- </p>
-
- <p>
- To renew a subscription, the subscriber sends a request of the
- following form to the subscription manager:
+ To update, or renew, the expiration for a subscription, a
+ subscriber sends a Renew request message to the subscription
+ manager.
+ This operation MUST be supported by compliant subscription managers.
+ The Renew request message message MUST be of the following form:
</p>
<example>
@@ -1533,7 +1533,9 @@
<p>
To get the status of a subscription, the subscriber sends a
- request of the following form to the subscription manager:
+ GetStatus request message to the subscription manager.
+ This operation MUST be supported by compliant subscription managers.
+ The GetStatus request MUST be of the following form:
</p>
<example>
@@ -1681,8 +1683,9 @@
<p>
To explicitly delete a subscription, a subscriber
- sends a request of the following form to the subscription
- manager:
+ sends an Unsubscribe request message to the subscription manager.
+ This operation MUST be supported by compliant subscription managers.
+ The Unsubscribe request message MUST be of the following form:
</p>
<example>
@@ -1802,11 +1805,14 @@
<p>
If the event source terminates a subscription unexpectedly,
- SubscriptionEnd SOAP message SHOULD be sent to
+ a SubscriptionEnd SOAP message SHOULD be sent to
the endpoint reference indicated when the subscription was
created (see <specref ref="Subscribe"/>).
This endpoint reference MUST refer to an endpoint that supports the
- SubscriptionEndPortType portType.
+ SubscriptionEndPortType portType. Support for including the
+ EndTo EPR in a Subscribe request message
+ (and implicitly the sending of the SubscriptionEnd message)
+ MUST be supported by compliant event sources.
The message MUST be of the following form:
</p>
@@ -4674,6 +4680,13 @@
<loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=8285">8285</loc>
</td>
</tr>
+ <tr>
+ <td> 2009/12/01 </td>
+ <td> DD </td>
+ <td> Added resolution of issue
+ <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=8201">8201</loc>
+ </td>
+ </tr>
</tbody>
</table>
</div1>
Index: wsmex.xml
===================================================================
RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wsmex.xml,v
retrieving revision 1.79
retrieving revision 1.80
diff -u -d -r1.79 -r1.80
--- wsmex.xml 1 Dec 2009 22:23:50 -0000 1.79
+++ wsmex.xml 1 Dec 2009 23:55:29 -0000 1.80
@@ -781,7 +781,7 @@
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
- <specref ref="Get-Metadata"/>.
+ <specref ref="GetMetadata"/>.
</p>
<p>
@@ -914,7 +914,7 @@
</tr>
<tr>
<td> http://www.w3.org/&wsmex.nsprefix;/ws-mex/Dialects/ws-mex-all </td>
- <td> None. [Defined in this specification for use in GetMetadata requests. See <specref ref='Get-Metadata'/>.] </td>
+ <td> None. [Defined in this specification for use in GetMetadata requests. See <specref ref='GetMetadata'/>.] </td>
</tr>
</tbody>
</table>
@@ -1085,14 +1085,14 @@
</p>
</div2>
- <div2 id="Get-Metadata">
+ <div2 id="GetMetadata">
<head>Get Metadata</head>
<p>
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
+ This operation MAY be supported by compliant service endpoints.
+ Observe that, in the case where
a service endpoint is also a <bibref ref='WS-Transfer'/> resource,
the <bibref ref='WS-Transfer'/> Get operation allows requesters to
retrieve the resource representation associated with that endpoint
@@ -2511,6 +2511,13 @@
<loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=8203">8203</loc>
</td>
</tr>
+ <tr>
+ <td> 2009/12/01 </td>
+ <td> DD </td>
+ <td> Added resolution of issue
+ <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=8201">8201</loc>
+ </td>
+ </tr>
</tbody>
</table>
</div1>
Index: wsenum.xml
===================================================================
RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wsenum.xml,v
retrieving revision 1.87
retrieving revision 1.88
diff -u -d -r1.87 -r1.88
--- wsenum.xml 17 Nov 2009 21:00:39 -0000 1.87
+++ wsenum.xml 1 Dec 2009 23:55:29 -0000 1.88
@@ -630,7 +630,8 @@
<head>Enumerate</head>
<p>
- Data sources MUST support the Enumerate operation to start an enumeration.
+ This specification defines the Enumerate operation to start an enumeration.
+ This operation MUST be supported by compliant data sources.
A data source MAY provide other mechanisms for starting an enumeration and
receiving an enumeration context.
</p>
@@ -1053,9 +1054,10 @@
<head>Pull</head>
<p>
- The Pull operation is initiated by sending a
- Pull request message to the data source. The Pull request message
- MUST be of the following form:
+ The Pull operation is initiated by sending a Pull request message to
+ the data source.
+ This operation MUST be supported by compliant data sources.
+ The Pull request message MUST be of the following form:
</p>
<example>
@@ -1362,13 +1364,10 @@
<head>Renew</head>
<p>
- Data sources MUST support requests to renew
- enumerations.
- </p>
-
- <p>
- To renew an enumeration, the consumer sends a
- request of the following form to the data source:
+ To update, or renew, the expiration for an enumeration, a Renew
+ request message is sent to the data source.
+ This operation MUST be supported by compliant data sources.
+ The Renew request message MUST be of the following form:
</p>
<example>
@@ -1468,8 +1467,9 @@
<p>
To get the status of an enumeration, the
- consumer sends a request of the following form to the data
- source:
+ consumer sends a GetStatus request message to the data source.
+ This operation MUST be supported by compliant data sources.
+ The message MUST be of the following form:
</p>
<example>
@@ -1528,8 +1528,9 @@
<p>
The Release operation is initiated by sending a
- Release request message to the data source. The Release request
- message MUST be of the following form:
+ Release request message to the data source.
+ This operation MUST be supported by compliant data sources.
+ The Release request message MUST be of the following form:
</p>
<example>
@@ -1673,8 +1674,11 @@
If the data source terminates an enumeration
unexpectedly, the data source SHOULD send an EnumerationEnd SOAP
message to the endpoint reference indicated when the enumeration
- was created (see <specref ref="Enumerate"/>). The message MUST be of the
- following form:
+ was created (see <specref ref="Enumerate"/>).
+ Support for including the EndTo EPR in a Enumerate request message
+ (and implicitly the sending of the EnumerationEnd message) MUST
+ be supported by compliant data sources.
+ The message MUST be of the following form:
</p>
<example>
@@ -3493,6 +3497,13 @@
<loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=8280">8280</loc>
</td>
</tr>
+ <tr>
+ <td> 2009/12/01 </td>
+ <td> DD </td>
+ <td> Added resolution of issue
+ <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=8201">8201</loc>
+ </td>
+ </tr>
</tbody>
</table>
</div1>
Received on Monday, 7 December 2009 18:09:39 UTC