- From: Doug Davis via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 24 Mar 2009 01:00:26 +0000
- To: public-ws-resource-access-notifications@w3.org
Update of /w3ccvs/WWW/2002/ws/ra/edcopies
In directory hutz:/tmp/cvs-serv8304
Modified Files:
wseventing.html wseventing.xml
Log Message:
issue 6666
Index: wseventing.xml
===================================================================
RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wseventing.xml,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -d -r1.23 -r1.24
--- wseventing.xml 23 Mar 2009 19:38:29 -0000 1.23
+++ wseventing.xml 24 Mar 2009 01:00:23 -0000 1.24
@@ -807,24 +807,18 @@
</p>
<example>
- <eg><s:Envelope ...>
- <s:Header ...>
- <wsa:Action>
- http://www.w3.org/2009/02/ws-evt/Subscribe
- </wsa:Action>
+ <eg><kw>[Action]</kw>
+ http://www.w3.org/2009/02/ws-evt/Subscribe
+
+<kw>[Body]</kw>
+ <wse:Subscribe ...>
+ <wse:EndTo><emph>endpoint-reference</emph></wse:EndTo> ?
+ <wse:Delivery Mode="<emph>xs:anyURI</emph>"? ><emph>xs:any</emph></wse:Delivery>
+ <wse:Format Name="<emph>xs:anyURI</emph>"? ><emph>xs:any*</emph></wse:Format>
+ <wse:Expires>(<emph>xs:dateTime</emph> | <emph>xs:duration</emph>)</wse:Expires> ?
+ <wse:Filter Dialect="<emph>xs:anyURI</emph>"? > <emph>xs:any</emph> </wse:Filter> ?
...
- </s:Header>
- <s:Body ...>
- <wse:Subscribe ...>
- <wse:EndTo><emph>endpoint-reference</emph></wse:EndTo> ?
- <wse:Delivery Mode="<emph>xs:anyURI</emph>"? ><emph>xs:any</emph></wse:Delivery>
- <wse:Format Name="<emph>xs:anyURI</emph>"? ><emph>xs:any*</emph></wse:Format>
- <wse:Expires>(<emph>xs:dateTime</emph> | <emph>xs:duration</emph>)</wse:Expires> ?
- <wse:Filter Dialect="<emph>xs:anyURI</emph>"? > <emph>xs:any</emph> </wse:Filter> ?
- ...
- </wse:Subscribe>
- </s:Body>
-</s:Envelope></eg>
+ </wse:Subscribe></eg>
</example>
<p>
@@ -834,17 +828,7 @@
<glist>
<gitem>
- <label> /s:Envelope/s:Header/wsa:Action </label>
- <def>
- <p>
- If a SOAP Action URI is used in the binding for SOAP, the
- value indicated herein MUST be used for that URI.
- </p>
- </def>
- </gitem>
-
- <gitem>
- <label> /s:Envelope/s:Body/*/wse:EndTo </label>
+ <label> <kw>[Body]</kw>/wse:Subscribe/wse:EndTo </label>
<def>
<p>
Where to send a SubscriptionEnd message if the
@@ -867,7 +851,7 @@
</gitem>
<gitem>
- <label> /s:Envelope/s:Body/*/wse:Delivery </label>
+ <label> <kw>[Body]</kw>/wse:Subscribe/wse:Delivery </label>
<def>
<p>
A delivery destination for notification messages, using
@@ -878,7 +862,7 @@
</gitem>
<gitem>
- <label> /s:Envelope/s:Body/*/wse:Delivery/@Mode </label>
+ <label> <kw>[Body]</kw>/wse:Subscribe/wse:Delivery/@Mode </label>
<def>
<p>
The delivery mode to be used for notification messages
@@ -901,11 +885,12 @@
<gitem>
<label>
- /s:Envelope/s:Body/*/wse:Delivery/@Mode="http://www.w3.org/2009/02/ws-evt/DeliveryModes/Push"
+ <kw>[Body]</kw>/wse:Subscribe/wse:Delivery/@Mode="http://www.w3.org/2009/02/ws-evt/DeliveryModes/Push"
</label>
<def>
<p>
- Value of /s:Envelope/s:Body/*/wse:Delivery MUST contain at least
+ Value of <kw>[Body]</kw>/wse:Subscribe/wse:Delivery MUST contain at
+ least
the single element, wse:NotifyTo, that contains the endpoint reference
to which notification messages should be sent. The value of this
element is not constrained for other delivery modes.
@@ -914,7 +899,7 @@
</gitem>
<gitem>
- <label> /s:Envelope/s:Body/*/wse:Format </label>
+ <label> <kw>[Body]</kw>/wse:Subscribe/wse:Format </label>
<def>
<p>
The delivery format to be used for notification messages sent in
@@ -934,7 +919,7 @@
</gitem>
<gitem>
- <label> /s:Envelope/s:Body/*/wse:Format@Name="http://www.w3.org/2009/02/ws-evt/DeliveryFormats/Unwrap" </label>
+ <label> <kw>[Body]</kw>/wse:Subscribe/wse:Format@Name="http://www.w3.org/2009/02/ws-evt/DeliveryFormats/Unwrap" </label>
<def>
<p>
Indicate the unwrapped event delivery format.
@@ -943,7 +928,7 @@
</gitem>
<gitem>
- <label> /s:Envelope/s:Body/*/wse:Format@Name="http://www.w3.org/2009/02/ws-evt/DeliveryFormats/Wrap" </label>
+ <label> <kw>[Body]</kw>/wse:Subscribe/wse:Format@Name="http://www.w3.org/2009/02/ws-evt/DeliveryFormats/Wrap" </label>
<def>
<p>
Indicate the wrapped event delivery format.
@@ -952,7 +937,7 @@
</gitem>
<gitem>
- <label> /s:Envelope/s:Body/*/wse:Expires </label>
+ <label> <kw>[Body]</kw>/wse:Subscribe/wse:Expires </label>
<def>
<p>
Requested expiration time for the subscription. (No
@@ -996,7 +981,7 @@
</gitem>
<gitem>
- <label> /s:Envelope/s:Body/*/wse:Filter </label>
+ <label> <kw>[Body]</kw>/wse:Subscribe/wse:Filter </label>
<def>
<p>
A Boolean expression in some dialect, either as a string
@@ -1022,7 +1007,7 @@
</gitem>
<gitem>
- <label id="Dialect"> /s:Envelope/s:Body/*/wse:Filter/@Dialect </label>
+ <label id="Dialect"> <kw>[Body]</kw>/wse:Subscribe/wse:Filter/@Dialect </label>
<def>
<p>
Implied value is "http://www.w3.org/TR/1999/REC-xpath-19991116".
@@ -1043,14 +1028,14 @@
</gitem>
<gitem>
- <label> /s:Envelope/s:Body/*/wse:Filter/@Dialect="<loc
+ <label> <kw>[Body]</kw>/wse:Subscribe/wse:Filter/@Dialect="<loc
href="http://www.w3.org/TR/1999/REC-xpath-19991116">
http://www.w3.org/TR/1999/REC-xpath-19991116
</loc>"
</label>
<def>
<p>
- Value of /s:Envelope/s:Body/*/wse:Filter is an XPath
+ Value of <kw>[Body]</kw>/wse:Subscribe/wse:Filter is an XPath
<bibref ref="XPath1"/> predicate expression
(PredicateExpr); the context of the expression is:
</p>
@@ -1109,23 +1094,17 @@
</p>
<example>
- <eg><s:Envelope ...>
- <s:Header ...>
- <wsa:Action>
- http://www.w3.org/2009/02/ws-evt/SubscribeResponse
- </wsa:Action>
+ <eg><kw>[Action]</kw>
+ http://www.w3.org/2009/02/ws-evt/SubscribeResponse
+
+<kw>[Body]</kw>
+ <wse:SubscribeResponse ...>
+ <wse:SubscriptionManager>
+ <emph>wsa:EndpointReferenceType</emph>
+ </wse:SubscriptionManager>
+ <wse:Expires>(<emph>xs:dateTime</emph> | <emph>xs:duration</emph>)</wse:Expires>
...
- </s:Header>
- <s:Body ...>
- <wse:SubscribeResponse ...>
- <wse:SubscriptionManager>
- <emph>wsa:EndpointReferenceType</emph>
- </wse:SubscriptionManager>
- <wse:Expires>(<emph>xs:dateTime</emph> | <emph>xs:duration</emph>)</wse:Expires>
- ...
- </wse:SubscribeResponse>
- </s:Body>
-</s:Envelope></eg>
+ </wse:SubscribeResponse></eg>
</example>
<p>
@@ -1135,16 +1114,7 @@
<glist>
<gitem>
- <label> /s:Envelope/S:Header/wsa:RelatesTo </label>
- <def>
- <p>
- MUST be the value of the wsa:MessageID of the corresponding request.
- </p>
- </def>
- </gitem>
-
- <gitem>
- <label> /s:Envelope/s:Body/*/wse:SubscriptionManager </label>
+ <label> <kw>[Body]</kw>/wse:SubscribeResponse/wse:SubscriptionManager </label>
<def>
<p>
The EPR of the subscription manager for this subscription.
@@ -1163,7 +1133,7 @@
</gitem>
<gitem>
- <label> /s:Envelope/s:Body/*/wse:Expires </label>
+ <label> <kw>[Body]</kw>/wse:SubscribeResponse/wse:Expires </label>
<def>
<p>
The expiration time assigned by the event source. The
@@ -1350,20 +1320,14 @@
</p>
<example>
- <eg><s:Envelope ...>
- <s:Header ...>
- <wsa:Action>
- http://www.w3.org/2009/02/ws-evt/Renew
- </wsa:Action>
+ <eg><kw>[Action]</kw>
+ http://www.w3.org/2009/02/ws-evt/Renew
+
+<kw>[Body]</kw>
+ <wse:Renew ...>
+ <wse:Expires>(<emph>xs:dateTime</emph> | <emph>xs:duration</emph>)</wse:Expires> ?
...
- </s:Header>
- <s:Body ...>
- <wse:Renew ...>
- <wse:Expires>(<emph>xs:dateTime</emph> | <emph>xs:duration</emph>)</wse:Expires> ?
- ...
- </wse:Renew>
- </s:Body>
-</s:Envelope></eg>
+ </wse:Renew></eg>
</example>
<p>
@@ -1381,20 +1345,14 @@
</p>
<example>
- <eg><s:Envelope ...>
- <s:Header ...>
- <wsa:Action>
- http://www.w3.org/2009/02/ws-evt/RenewResponse
- </wsa:Action>
+ <eg><kw>[Action]</kw>
+ http://www.w3.org/2009/02/ws-evt/RenewResponse
+
+<kw>[Body]</kw>
+ <wse:RenewResponse ...>
+ <wse:Expires>(<emph>xs:dateTime</emph> | <emph>xs:duration</emph>)</wse:Expires> ?
...
- </s:Header>
- <s:Body ...>
- <wse:RenewResponse ...>
- <wse:Expires>(<emph>xs:dateTime</emph> | <emph>xs:duration</emph>)</wse:Expires> ?
- ...
- </wse:RenewResponse>
- </s:Body>
-</s:Envelope></eg>
+ </wse:RenewResponse></eg>
</example>
<p>
@@ -1405,7 +1363,7 @@
<glist>
<gitem>
- <label> /s:Envelope/s:Body/*/wse:Expires </label>
+ <label> <kw>[Body]</kw>/wse:RenewResponse/wse:Expires </label>
<def>
<p>
If the requested expiration is a duration, then the
@@ -1519,19 +1477,13 @@
</p>
<example>
- <eg><s:Envelope ...>
- <s:Header ...>
- <wsa:Action>
- http://www.w3.org/2009/02/ws-evt/GetStatus
- </wsa:Action>
+ <eg><kw>[Action]</kw>
+ http://www.w3.org/2009/02/ws-evt/GetStatus
+
+<kw>[Body]</kw>
+ <wse:GetStatus ...>
...
- </s:Header>
- <s:Body ...>
- <wse:GetStatus ...>
- ...
- </wse:GetStatus>
- </s:Body>
-</s:Envelope></eg>
+ </wse:GetStatus></eg>
</example>
<p>
@@ -1549,20 +1501,14 @@
</p>
<example>
- <eg><s:Envelope ...>
- <s:Header ...>
- <wsa:Action>
- http://www.w3.org/2009/02/ws-evt/GetStatusResponse
- </wsa:Action>
+ <eg><kw>[Action]</kw>
+ http://www.w3.org/2009/02/ws-evt/GetStatusResponse
+
+<kw>[Body]</kw>
+ <wse:GetStatusResponse ...>
+ <wse:Expires>(<emph>xs:dateTime</emph> | <emph>xs:duration</emph>)</wse:Expires> ?
...
- </s:Header>
- <s:Body ...>
- <wse:GetStatusResponse ...>
- <wse:Expires>(<emph>xs:dateTime</emph> | <emph>xs:duration</emph>)</wse:Expires> ?
- ...
- </wse:GetStatusResponse>
- </s:Body>
-</s:Envelope></eg>
+ </wse:GetStatusResponse></eg>
</example>
<p>
@@ -1666,19 +1612,13 @@
</p>
<example>
- <eg> <s:Envelope ...>
- <s:Header ...>
- <wsa:Action>
- http://www.w3.org/2009/02/ws-evt/Unsubscribe
- </wsa:Action>
+ <eg><kw>[Action]</kw>
+ http://www.w3.org/2009/02/ws-evt/Unsubscribe
+
+<kw>[Body]</kw>
+ <wse:Unsubscribe ...>
...
- </s:Header>
- <s:Body>
- <wse:Unsubscribe ...>
- ...
- </wse:Unsubscribe>
- </s:Body>
-</s:Envelope> </eg>
+ </wse:Unsubscribe></eg>
</example>
<p>
@@ -1696,16 +1636,10 @@
</p>
<example>
- <eg><s:Envelope ...>
- <s:Header ...>
- <wsa:Action>
- http://www.w3.org/2009/02/ws-evt/UnsubscribeResponse
- </wsa:Action>
- <wsa:RelatesTo><emph>xs:anyURI</emph></wsa:RelatesTo>
- ...
- </s:Header>
- <s:Body />
-</s:Envelope> </eg>
+ <eg><kw>[Action]</kw>
+ http://www.w3.org/2009/02/ws-evt/UnsubscribeResponse <!--
+
+<kw>[Body]</kw> --></eg>
</example>
<p>
@@ -1793,28 +1727,19 @@
</p>
<example>
- <eg><s:Envelope ...>
- <s:Header ...>
- <wsa:Action>
- http://www.w3.org/2009/02/ws-evt/SubscriptionEnd
- </wsa:Action> ?
- ...
- </s:Header>
- <s:Body ...>
- <wse:SubscriptionEnd ...>
- <wse:Status>
- (
- http://www.w3.org/2009/02/ws-evt/DeliveryFailure |
- http://www.w3.org/2009/02/ws-evt/SourceShuttingDown |
- http://www.w3.org/2009/02/ws-evt/SourceCancelling
- )
- </wse:Status>
- <wse:Reason xml:lang="<emph>language identifier</emph>" ><emph>xs:string</emph></wse:Reason> ?
- ...
- </wse:SubscriptionEnd>
+ <eg><kw>[Action]</kw>
+ http://www.w3.org/2009/02/ws-evt/SubscriptionEnd
+
+<kw>[Body]</kw>
+ <wse:SubscriptionEnd ...>
+ <wse:Status>
+ ( http://www.w3.org/2009/02/ws-evt/DeliveryFailure |
+ http://www.w3.org/2009/02/ws-evt/SourceShuttingDown |
+ http://www.w3.org/2009/02/ws-evt/SourceCancelling )
+ </wse:Status>
+ <wse:Reason xml:lang="<emph>language identifier</emph>" ><emph>xs:string</emph></wse:Reason> ?
...
- </s:Body>
-</s:Envelope></eg>
+ </wse:SubscriptionEnd></eg>
</example>
<p>
@@ -1825,7 +1750,7 @@
<glist>
<gitem>
<label>
- /s:Envelope/s:Body/wse:SubscriptionEnd/wse:Status =
+ <kw>[Body]</kw>/wse:SubscriptionEnd/wse:Status =
"http://www.w3.org/2009/02/ws-evt/DeliveryFailure"
</label>
<def>
@@ -1839,7 +1764,7 @@
<gitem>
<label>
- /s:Envelope/s:Body/wse:SubscriptionEnd/wse:Status =
+ <kw>[Body]</kw>/wse:SubscriptionEnd/wse:Status =
"http://www.w3.org/2009/02/ws-evt/SourceShuttingDown"
</label>
<def>
@@ -1855,7 +1780,7 @@
<gitem>
<label>
- /s:Envelope/s:Body/wse:SubscriptionEnd/wse:Status =
+ <kw>[Body]</kw>/wse:SubscriptionEnd/wse:Status =
"http://www.w3.org/2009/02/ws-evt/SourceCancelling"
</label>
<def>
@@ -1867,7 +1792,7 @@
</gitem>
<gitem>
- <label> /s:Envelope/s:Body/wse:SubscriptionEnd/wse:Reason </label>
+ <label> <kw>[Body]</kw>/wse:SubscriptionEnd/wse:Reason </label>
<def>
<p>
This optional element contains text, in the language
@@ -3217,12 +3142,10 @@
<wsdl:operation name="SubscribeOp" >
<wsdl:input
message="wse:SubscribeMsg"
- wsam:Action=
-"http://www.w3.org/2009/02/ws-evt/Subscribe"/>
+ wsam:Action="http://www.w3.org/2009/02/ws-evt/Subscribe"/>
<wsdl:output
message="wse:SubscribeResponseMsg"
- wsam:Action=
-"http://www.w3.org/2009/02/ws-evt/SubscribeResponse"/>
+ wsam:Action="http://www.w3.org/2009/02/ws-evt/SubscribeResponse"/>
</wsdl:operation>
</wsdl:portType>
@@ -3230,8 +3153,7 @@
<wsdl:operation name="SubscriptionEnd" >
<wsdl:input
message="wse:SubscriptionEnd"
- wsam:Action=
-"http://www.w3.org/2009/02/ws-evt/SubscriptionEnd"/>
+ wsam:Action="http://www.w3.org/2009/02/ws-evt/SubscriptionEnd"/>
</wsdl:operation>
</wsdl:portType>
@@ -3239,32 +3161,26 @@
<wsdl:operation name="RenewOp" >
<wsdl:input
message="wse:RenewMsg"
- wsam:Action=
-"http://www.w3.org/2009/02/ws-evt/Renew"/>
+ wsam:Action="http://www.w3.org/2009/02/ws-evt/Renew"/>
<wsdl:output
message="wse:RenewResponseMsg"
- wsam:Action=
-"http://www.w3.org/2009/02/ws-evt/RenewResponse"/>
+ wsam:Action="http://www.w3.org/2009/02/ws-evt/RenewResponse"/>
</wsdl:operation>
<wsdl:operation name="GetStatusOp" >
<wsdl:input
message="wse:GetStatusMsg"
- wsam:Action=
-"http://www.w3.org/2009/02/ws-evt/GetStatus"/>
+ wsam:Action="http://www.w3.org/2009/02/ws-evt/GetStatus"/>
<wsdl:output
message="wse:GetStatusResponseMsg"
- wsam:Action=
-"http://www.w3.org/2009/02/ws-evt/GetStatusResponse"/>
+ wsam:Action="http://www.w3.org/2009/02/ws-evt/GetStatusResponse"/>
</wsdl:operation>
<wsdl:operation name="UnsubscribeOp" >
<wsdl:input
message="wse:UnsubscribeMsg"
- wsam:Action=
-"http://www.w3.org/2009/02/ws-evt/Unsubscribe"/>
+ wsam:Action="http://www.w3.org/2009/02/ws-evt/Unsubscribe"/>
<wsdl:output
message="wse:UnsubscribeResponseMsg"
- wsam:Action=
-"http://www.w3.org/2009/02/ws-evt/UnsubscribeResponse"/>
+ wsam:Action="http://www.w3.org/2009/02/ws-evt/UnsubscribeResponse"/>
</wsdl:operation>
</wsdl:portType>
</wsdl:definitions></eg>
Index: wseventing.html
===================================================================
RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wseventing.html,v
retrieving revision 1.32
retrieving revision 1.33
diff -u -d -r1.32 -r1.33
--- wseventing.html 23 Mar 2009 19:38:29 -0000 1.32
+++ wseventing.html 24 Mar 2009 01:00:23 -0000 1.33
@@ -455,30 +455,21 @@
<h3><a name="Subscribe" id="Subscribe"/>4.1 Subscribe</h3><p>
To create a subscription, a subscriber sends a request message
of the following form to an event source:
- </p><div class="exampleOuter"><div class="exampleInner"><pre><s:Envelope ...>
- <s:Header ...>
- <wsa:Action>
- http://www.w3.org/2009/02/ws-evt/Subscribe
- </wsa:Action>
+ </p><div class="exampleOuter"><div class="exampleInner"><pre><b>[Action]</b>
+ http://www.w3.org/2009/02/ws-evt/Subscribe
+
+<b>[Body]</b>
+ <wse:Subscribe ...>
+ <wse:EndTo><em>endpoint-reference</em></wse:EndTo> ?
+ <wse:Delivery Mode="<em>xs:anyURI</em>"? ><em>xs:any</em></wse:Delivery>
+ <wse:Format Name="<em>xs:anyURI</em>"? ><em>xs:any*</em></wse:Format>
+ <wse:Expires>(<em>xs:dateTime</em> | <em>xs:duration</em>)</wse:Expires> ?
+ <wse:Filter Dialect="<em>xs:anyURI</em>"? > <em>xs:any</em> </wse:Filter> ?
...
- </s:Header>
- <s:Body ...>
- <wse:Subscribe ...>
- <wse:EndTo><em>endpoint-reference</em></wse:EndTo> ?
- <wse:Delivery Mode="<em>xs:anyURI</em>"? ><em>xs:any</em></wse:Delivery>
- <wse:Format Name="<em>xs:anyURI</em>"? ><em>xs:any*</em></wse:Format>
- <wse:Expires>(<em>xs:dateTime</em> | <em>xs:duration</em>)</wse:Expires> ?
- <wse:Filter Dialect="<em>xs:anyURI</em>"? > <em>xs:any</em> </wse:Filter> ?
- ...
- </wse:Subscribe>
- </s:Body>
-</s:Envelope></pre></div></div><p>
+ </wse:Subscribe></pre></div></div><p>
The following describes additional, normative constraints on
the outline listed above:
- </p><dl><dt class="label"> /s:Envelope/s:Header/wsa:Action </dt><dd><p>
- If a SOAP Action URI is used in the binding for SOAP, the
- value indicated herein MUST be used for that URI.
- </p></dd><dt class="label"> /s:Envelope/s:Body/*/wse:EndTo </dt><dd><p>
+ </p><dl><dt class="label"><b>[Body]</b>/wse:Subscribe/wse:EndTo </dt><dd><p>
Where to send a SubscriptionEnd message if the
subscription is terminated unexpectedly. (See
<a href="#SubscriptionEnd"><b>4.5 Subscription End</b></a>.) If
@@ -493,11 +484,11 @@
in this common situation, this specification defines a global
element, wse:Identifier of type xs:anyURI, that
MAY be used as a distinguishing reference parameter.
- </p></dd><dt class="label"> /s:Envelope/s:Body/*/wse:Delivery </dt><dd><p>
+ </p></dd><dt class="label"><b>[Body]</b>/wse:Subscribe/wse:Delivery </dt><dd><p>
A delivery destination for notification messages, using
some delivery mode. See <a href="#DeliveryModes"><b>2.2 Delivery Modes</b></a>
for details.
- </p></dd><dt class="label"> /s:Envelope/s:Body/*/wse:Delivery/@Mode </dt><dd><p>
+ </p></dd><dt class="label"><b>[Body]</b>/wse:Subscribe/wse:Delivery/@Mode </dt><dd><p>
The delivery mode to be used for notification messages
sent in relation to this subscription. Implied value is
"http://www.w3.org/2009/02/ws-evt/DeliveryModes/Push",
@@ -510,14 +501,14 @@
MAY generate a wse:DeliveryModeRequestedUnavailable fault
indicating that the requested delivery mode is not
supported.
- </p></dd><dt class="label">
- /s:Envelope/s:Body/*/wse:Delivery/@Mode="http://www.w3.org/2009/02/ws-evt/DeliveryModes/Push"
+ </p></dd><dt class="label"><b>[Body]</b>/wse:Subscribe/wse:Delivery/@Mode="http://www.w3.org/2009/02/ws-evt/DeliveryModes/Push"
</dt><dd><p>
- Value of /s:Envelope/s:Body/*/wse:Delivery MUST contain at least
+ Value of <b>[Body]</b>/wse:Subscribe/wse:Delivery MUST contain at
+ least
the single element, wse:NotifyTo, that contains the endpoint reference
to which notification messages should be sent. The value of this
element is not constrained for other delivery modes.
- </p></dd><dt class="label"> /s:Envelope/s:Body/*/wse:Format </dt><dd><p>
+ </p></dd><dt class="label"><b>[Body]</b>/wse:Subscribe/wse:Format </dt><dd><p>
The delivery format to be used for notification messages sent in
relation to this subscription. Implied value is
"http://www.w3.org/2009/02/ws-evt/DeliveryFormats/Unwrap", which
@@ -528,11 +519,11 @@
format, the request MUST
generate a wse:DeliveryFormatRequestedUnavailable fault indicating
that the requested delivery format is not supported.
- </p></dd><dt class="label"> /s:Envelope/s:Body/*/wse:Format@Name="http://www.w3.org/2009/02/ws-evt/DeliveryFormats/Unwrap" </dt><dd><p>
+ </p></dd><dt class="label"><b>[Body]</b>/wse:Subscribe/wse:Format@Name="http://www.w3.org/2009/02/ws-evt/DeliveryFormats/Unwrap" </dt><dd><p>
Indicate the unwrapped event delivery format.
- </p></dd><dt class="label"> /s:Envelope/s:Body/*/wse:Format@Name="http://www.w3.org/2009/02/ws-evt/DeliveryFormats/Wrap" </dt><dd><p>
+ </p></dd><dt class="label"><b>[Body]</b>/wse:Subscribe/wse:Format@Name="http://www.w3.org/2009/02/ws-evt/DeliveryFormats/Wrap" </dt><dd><p>
Indicate the wrapped event delivery format.
- </p></dd><dt class="label"> /s:Envelope/s:Body/*/wse:Expires </dt><dd><p>
+ </p></dd><dt class="label"><b>[Body]</b>/wse:Subscribe/wse:Expires </dt><dd><p>
Requested expiration time for the subscription. (No
implied value.) The event source defines the actual
expiration and is not constrained to use a time less or
@@ -563,10 +554,10 @@
fail; if so, the event source MAY generate a
wse:UnsupportedExpirationType fault indicating that an
unsupported expiration type was requested.
- </p></dd><dt class="label"> /s:Envelope/s:Body/*/wse:Filter </dt><dd><p>
+ </p></dd><dt class="label"><b>[Body]</b>/wse:Subscribe/wse:Filter </dt><dd><p>
A Boolean expression in some dialect, either as a string
or as an XML fragment (see
- <b>[<a href="#Dialect"> /s:Envelope/s:Body/*/wse:Filter/@Dialect </a>]</b>). If
+ <b>[<a href="#Dialect">[Body]/wse:Subscribe/wse:Filter/@Dialect </a>]</b>). If
the expression evaluates to false for a notification, the
notification MUST NOT be sent to the event sink. Implied
value is an expression that always returns true. If the event
@@ -580,7 +571,7 @@
source MAY generate a wse:FilteringRequestedUnavailable fault
indicating that the requested filter dialect is not
supported.
- </p></dd><dt class="label"><a name="Dialect" id="Dialect"/> /s:Envelope/s:Body/*/wse:Filter/@Dialect </dt><dd><p>
+ </p></dd><dt class="label"><a name="Dialect" id="Dialect"/><b>[Body]</b>/wse:Subscribe/wse:Filter/@Dialect </dt><dd><p>
Implied value is "http://www.w3.org/TR/1999/REC-xpath-19991116".
</p><p>
While an XPath predicate expression provides great
@@ -592,11 +583,11 @@
a filter dialect could allow the definition of a composite
filter that contained multiple filters from other
dialects.
- </p></dd><dt class="label"> /s:Envelope/s:Body/*/wse:Filter/@Dialect="<a href="http://www.w3.org/TR/1999/REC-xpath-19991116">
+ </p></dd><dt class="label"><b>[Body]</b>/wse:Subscribe/wse:Filter/@Dialect="<a href="http://www.w3.org/TR/1999/REC-xpath-19991116">
http://www.w3.org/TR/1999/REC-xpath-19991116
</a>"
</dt><dd><p>
- Value of /s:Envelope/s:Body/*/wse:Filter is an XPath
+ Value of <b>[Body]</b>/wse:Subscribe/wse:Filter is an XPath
<a href="#XPath1">[XPath 1.0]</a> predicate expression
(PredicateExpr); the context of the expression is:
</p><ul><li><p>Context Node: the SOAP Envelope containing the notification.</p></li><li><p>Context Position: 1.</p></li><li><p>Context Size: 1.</p></li><li><p>Variable Bindings: None.</p></li><li><p>
@@ -617,28 +608,20 @@
If the event source accepts a request to create a
subscription, it MUST reply with a response of the following
form:
- </p><div class="exampleOuter"><div class="exampleInner"><pre><s:Envelope ...>
- <s:Header ...>
- <wsa:Action>
- http://www.w3.org/2009/02/ws-evt/SubscribeResponse
- </wsa:Action>
+ </p><div class="exampleOuter"><div class="exampleInner"><pre><b>[Action]</b>
+ http://www.w3.org/2009/02/ws-evt/SubscribeResponse
+
+<b>[Body]</b>
+ <wse:SubscribeResponse ...>
+ <wse:SubscriptionManager>
+ <em>wsa:EndpointReferenceType</em>
+ </wse:SubscriptionManager>
+ <wse:Expires>(<em>xs:dateTime</em> | <em>xs:duration</em>)</wse:Expires>
...
- </s:Header>
- <s:Body ...>
- <wse:SubscribeResponse ...>
- <wse:SubscriptionManager>
- <em>wsa:EndpointReferenceType</em>
- </wse:SubscriptionManager>
- <wse:Expires>(<em>xs:dateTime</em> | <em>xs:duration</em>)</wse:Expires>
- ...
- </wse:SubscribeResponse>
- </s:Body>
-</s:Envelope></pre></div></div><p>
+ </wse:SubscribeResponse></pre></div></div><p>
The following describes additional, normative constraints on
the outline listed above:
- </p><dl><dt class="label"> /s:Envelope/S:Header/wsa:RelatesTo </dt><dd><p>
- MUST be the value of the wsa:MessageID of the corresponding request.
- </p></dd><dt class="label"> /s:Envelope/s:Body/*/wse:SubscriptionManager </dt><dd><p>
+ </p><dl><dt class="label"><b>[Body]</b>/wse:SubscribeResponse/wse:SubscriptionManager </dt><dd><p>
The EPR of the subscription manager for this subscription.
</p><p>
In some cases, it is convenient for all EPRs issued by a
@@ -648,7 +631,7 @@
specification defines a global element, wse:Identifier of
type xs:anyURI, that MAY be used as a distinguishing
reference parameter if desired by the event source.
- </p></dd><dt class="label"> /s:Envelope/s:Body/*/wse:Expires </dt><dd><p>
+ </p></dd><dt class="label"><b>[Body]</b>/wse:SubscribeResponse/wse:Expires </dt><dd><p>
The expiration time assigned by the event source. The
expiration time MAY be either an absolute time or a duration
but SHOULD be of the same type as the requested expiration
@@ -790,20 +773,14 @@
</p><p>
To renew a subscription, the subscriber sends a request of the
following form to the subscription manager:
- </p><div class="exampleOuter"><div class="exampleInner"><pre><s:Envelope ...>
- <s:Header ...>
- <wsa:Action>
- http://www.w3.org/2009/02/ws-evt/Renew
- </wsa:Action>
+ </p><div class="exampleOuter"><div class="exampleInner"><pre><b>[Action]</b>
+ http://www.w3.org/2009/02/ws-evt/Renew
+
+<b>[Body]</b>
+ <wse:Renew ...>
+ <wse:Expires>(<em>xs:dateTime</em> | <em>xs:duration</em>)</wse:Expires> ?
...
- </s:Header>
- <s:Body ...>
- <wse:Renew ...>
- <wse:Expires>(<em>xs:dateTime</em> | <em>xs:duration</em>)</wse:Expires> ?
- ...
- </wse:Renew>
- </s:Body>
-</s:Envelope></pre></div></div><p>
+ </wse:Renew></pre></div></div><p>
Components of the outline listed above are additionally
constrained as for a request to create a subscription (see
<a href="#Subscribe"><b>4.1 Subscribe</b></a>). Other components
@@ -813,24 +790,18 @@
If the subscription manager accepts a request to renew a
subscription, it MUST reply with a response of the following
form:
- </p><div class="exampleOuter"><div class="exampleInner"><pre><s:Envelope ...>
- <s:Header ...>
- <wsa:Action>
- http://www.w3.org/2009/02/ws-evt/RenewResponse
- </wsa:Action>
+ </p><div class="exampleOuter"><div class="exampleInner"><pre><b>[Action]</b>
+ http://www.w3.org/2009/02/ws-evt/RenewResponse
+
+<b>[Body]</b>
+ <wse:RenewResponse ...>
+ <wse:Expires>(<em>xs:dateTime</em> | <em>xs:duration</em>)</wse:Expires> ?
...
- </s:Header>
- <s:Body ...>
- <wse:RenewResponse ...>
- <wse:Expires>(<em>xs:dateTime</em> | <em>xs:duration</em>)</wse:Expires> ?
- ...
- </wse:RenewResponse>
- </s:Body>
-</s:Envelope></pre></div></div><p>
+ </wse:RenewResponse></pre></div></div><p>
Components of the outline listed above are constrained as for
a response to a subscribe request (see <a href="#Subscribe"><b>4.1 Subscribe</b></a>)
with the following addition(s):
- </p><dl><dt class="label"> /s:Envelope/s:Body/*/wse:Expires </dt><dd><p>
+ </p><dl><dt class="label"><b>[Body]</b>/wse:RenewResponse/wse:Expires </dt><dd><p>
If the requested expiration is a duration, then the
implied start of that duration is the time when the
subscription manager starts processing the Renew request.
@@ -909,19 +880,13 @@
<h3><a name="GetStatus" id="GetStatus"/>4.3 GetStatus</h3><p>
To get the status of a subscription, the subscriber sends a
request of the following form to the subscription manager:
- </p><div class="exampleOuter"><div class="exampleInner"><pre><s:Envelope ...>
- <s:Header ...>
- <wsa:Action>
- http://www.w3.org/2009/02/ws-evt/GetStatus
- </wsa:Action>
+ </p><div class="exampleOuter"><div class="exampleInner"><pre><b>[Action]</b>
+ http://www.w3.org/2009/02/ws-evt/GetStatus
+
+<b>[Body]</b>
+ <wse:GetStatus ...>
...
- </s:Header>
- <s:Body ...>
- <wse:GetStatus ...>
- ...
- </wse:GetStatus>
- </s:Body>
-</s:Envelope></pre></div></div><p>
+ </wse:GetStatus></pre></div></div><p>
Components of the outline listed above are additionally
constrained as for a request to renew a subscription (see
<a href="#Renew"><b>4.2 Renew</b></a>). Other components of the
@@ -931,20 +896,14 @@
If the subscription is valid and has not expired, the
subscription manager MUST reply with a response of the following
form:
- </p><div class="exampleOuter"><div class="exampleInner"><pre><s:Envelope ...>
- <s:Header ...>
- <wsa:Action>
- http://www.w3.org/2009/02/ws-evt/GetStatusResponse
- </wsa:Action>
+ </p><div class="exampleOuter"><div class="exampleInner"><pre><b>[Action]</b>
+ http://www.w3.org/2009/02/ws-evt/GetStatusResponse
+
+<b>[Body]</b>
+ <wse:GetStatusResponse ...>
+ <wse:Expires>(<em>xs:dateTime</em> | <em>xs:duration</em>)</wse:Expires> ?
...
- </s:Header>
- <s:Body ...>
- <wse:GetStatusResponse ...>
- <wse:Expires>(<em>xs:dateTime</em> | <em>xs:duration</em>)</wse:Expires> ?
- ...
- </wse:GetStatusResponse>
- </s:Body>
-</s:Envelope></pre></div></div><p>
+ </wse:GetStatusResponse></pre></div></div><p>
Components of the outline listed above are constrained as for
a response to a renew request (see <a href="#Renew"><b>4.2 Renew</b></a>).
Other components of the outline above are not further
@@ -1017,19 +976,13 @@
To explicitly delete a subscription, a subscribing event sink
sends a request of the following form to the subscription
manager:
- </p><div class="exampleOuter"><div class="exampleInner"><pre> <s:Envelope ...>
- <s:Header ...>
- <wsa:Action>
- http://www.w3.org/2009/02/ws-evt/Unsubscribe
- </wsa:Action>
+ </p><div class="exampleOuter"><div class="exampleInner"><pre><b>[Action]</b>
+ http://www.w3.org/2009/02/ws-evt/Unsubscribe
+
+<b>[Body]</b>
+ <wse:Unsubscribe ...>
...
- </s:Header>
- <s:Body>
- <wse:Unsubscribe ...>
- ...
- </wse:Unsubscribe>
- </s:Body>
-</s:Envelope> </pre></div></div><p>
+ </wse:Unsubscribe></pre></div></div><p>
Components of the outline above are additionally constrained
only as for a request to renew a subscription (see
<a href="#Renew"><b>4.2 Renew</b></a>). For example, the faults listed
@@ -1039,16 +992,8 @@
If the subscription manager accepts a request to delete a
subscription, it MUST reply with a response of the following
form:
- </p><div class="exampleOuter"><div class="exampleInner"><pre><s:Envelope ...>
- <s:Header ...>
- <wsa:Action>
- http://www.w3.org/2009/02/ws-evt/UnsubscribeResponse
- </wsa:Action>
- <wsa:RelatesTo><em>xs:anyURI</em></wsa:RelatesTo>
- ...
- </s:Header>
- <s:Body />
-</s:Envelope> </pre></div></div><p>
+ </p><div class="exampleOuter"><div class="exampleInner"><pre><b>[Action]</b>
+ http://www.w3.org/2009/02/ws-evt/UnsubscribeResponse </pre></div></div><p>
Components of the outline listed above are not further
constrained by this specification.
</p><p><a href="#Table10">Example 4-7</a> lists a hypothetical request to delete the
@@ -1109,39 +1054,28 @@
This endpoint reference MUST refer to an endpoint that supports the
SubscriptionEndPortType portType.
The message MUST be of the following form:
- </p><div class="exampleOuter"><div class="exampleInner"><pre><s:Envelope ...>
- <s:Header ...>
- <wsa:Action>
- http://www.w3.org/2009/02/ws-evt/SubscriptionEnd
- </wsa:Action> ?
- ...
- </s:Header>
- <s:Body ...>
- <wse:SubscriptionEnd ...>
- <wse:Status>
- (
- http://www.w3.org/2009/02/ws-evt/DeliveryFailure |
- http://www.w3.org/2009/02/ws-evt/SourceShuttingDown |
- http://www.w3.org/2009/02/ws-evt/SourceCancelling
- )
- </wse:Status>
- <wse:Reason xml:lang="<em>language identifier</em>" ><em>xs:string</em></wse:Reason> ?
- ...
- </wse:SubscriptionEnd>
+ </p><div class="exampleOuter"><div class="exampleInner"><pre><b>[Action]</b>
+ http://www.w3.org/2009/02/ws-evt/SubscriptionEnd
+
+<b>[Body]</b>
+ <wse:SubscriptionEnd ...>
+ <wse:Status>
+ ( http://www.w3.org/2009/02/ws-evt/DeliveryFailure |
+ http://www.w3.org/2009/02/ws-evt/SourceShuttingDown |
+ http://www.w3.org/2009/02/ws-evt/SourceCancelling )
+ </wse:Status>
+ <wse:Reason xml:lang="<em>language identifier</em>" ><em>xs:string</em></wse:Reason> ?
...
- </s:Body>
-</s:Envelope></pre></div></div><p>
+ </wse:SubscriptionEnd></pre></div></div><p>
The following describes additional, normative constraints on
the outline listed above:
- </p><dl><dt class="label">
- /s:Envelope/s:Body/wse:SubscriptionEnd/wse:Status =
+ </p><dl><dt class="label"><b>[Body]</b>/wse:SubscriptionEnd/wse:Status =
"http://www.w3.org/2009/02/ws-evt/DeliveryFailure"
</dt><dd><p>
This value MUST be used if the event source terminated the
subscription because of problems delivering
notifications.
- </p></dd><dt class="label">
- /s:Envelope/s:Body/wse:SubscriptionEnd/wse:Status =
+ </p></dd><dt class="label"><b>[Body]</b>/wse:SubscriptionEnd/wse:Status =
"http://www.w3.org/2009/02/ws-evt/SourceShuttingDown"
</dt><dd><p>
This value MUST be used if the event source terminated the
@@ -1149,13 +1083,12 @@
controlled manner; that is, if the event source is being shut
down but has the opportunity to send a SubscriptionEnd
message before it exits.
- </p></dd><dt class="label">
- /s:Envelope/s:Body/wse:SubscriptionEnd/wse:Status =
+ </p></dd><dt class="label"><b>[Body]</b>/wse:SubscriptionEnd/wse:Status =
"http://www.w3.org/2009/02/ws-evt/SourceCancelling"
</dt><dd><p>
This value MUST be used if the event source terminated the
subscription for some other reason before it expired.
- </p></dd><dt class="label"> /s:Envelope/s:Body/wse:SubscriptionEnd/wse:Reason </dt><dd><p>
+ </p></dd><dt class="label"><b>[Body]</b>/wse:SubscriptionEnd/wse:Reason </dt><dd><p>
This optional element contains text, in the language
specified by the @xml:lang attribute, describing the reason
for the unexpected subscription termination.
@@ -1938,12 +1871,10 @@
<wsdl:operation name="SubscribeOp" >
<wsdl:input
message="wse:SubscribeMsg"
- wsam:Action=
-"http://www.w3.org/2009/02/ws-evt/Subscribe"/>
+ wsam:Action="http://www.w3.org/2009/02/ws-evt/Subscribe"/>
<wsdl:output
message="wse:SubscribeResponseMsg"
- wsam:Action=
-"http://www.w3.org/2009/02/ws-evt/SubscribeResponse"/>
+ wsam:Action="http://www.w3.org/2009/02/ws-evt/SubscribeResponse"/>
</wsdl:operation>
</wsdl:portType>
@@ -1951,8 +1882,7 @@
<wsdl:operation name="SubscriptionEnd" >
<wsdl:input
message="wse:SubscriptionEnd"
- wsam:Action=
-"http://www.w3.org/2009/02/ws-evt/SubscriptionEnd"/>
+ wsam:Action="http://www.w3.org/2009/02/ws-evt/SubscriptionEnd"/>
</wsdl:operation>
</wsdl:portType>
@@ -1960,32 +1890,26 @@
<wsdl:operation name="RenewOp" >
<wsdl:input
message="wse:RenewMsg"
- wsam:Action=
-"http://www.w3.org/2009/02/ws-evt/Renew"/>
+ wsam:Action="http://www.w3.org/2009/02/ws-evt/Renew"/>
<wsdl:output
message="wse:RenewResponseMsg"
- wsam:Action=
-"http://www.w3.org/2009/02/ws-evt/RenewResponse"/>
+ wsam:Action="http://www.w3.org/2009/02/ws-evt/RenewResponse"/>
</wsdl:operation>
<wsdl:operation name="GetStatusOp" >
<wsdl:input
message="wse:GetStatusMsg"
- wsam:Action=
-"http://www.w3.org/2009/02/ws-evt/GetStatus"/>
+ wsam:Action="http://www.w3.org/2009/02/ws-evt/GetStatus"/>
<wsdl:output
message="wse:GetStatusResponseMsg"
- wsam:Action=
-"http://www.w3.org/2009/02/ws-evt/GetStatusResponse"/>
+ wsam:Action="http://www.w3.org/2009/02/ws-evt/GetStatusResponse"/>
</wsdl:operation>
<wsdl:operation name="UnsubscribeOp" >
<wsdl:input
message="wse:UnsubscribeMsg"
- wsam:Action=
-"http://www.w3.org/2009/02/ws-evt/Unsubscribe"/>
+ wsam:Action="http://www.w3.org/2009/02/ws-evt/Unsubscribe"/>
<wsdl:output
message="wse:UnsubscribeResponseMsg"
- wsam:Action=
-"http://www.w3.org/2009/02/ws-evt/UnsubscribeResponse"/>
+ wsam:Action="http://www.w3.org/2009/02/ws-evt/UnsubscribeResponse"/>
</wsdl:operation>
</wsdl:portType>
</wsdl:definitions></pre></div></div></div><div class="div1">
Received on Tuesday, 24 March 2009 01:00:37 UTC