- From: Doug Davis via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 23 Mar 2011 00:26:35 +0000
- To: public-ws-resource-access-notifications@w3.org
Update of /w3ccvs/WWW/2002/ws/ra/edcopies In directory hutz:/tmp/cvs-serv27541 Modified Files: wsenum.html wsenum.xml Log Message: 11776 Index: wsenum.html =================================================================== RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wsenum.html,v retrieving revision 1.166 retrieving revision 1.167 diff -u -d -r1.166 -r1.167 --- wsenum.html 22 Mar 2011 23:54:11 -0000 1.166 +++ wsenum.html 23 Mar 2011 00:26:33 -0000 1.167 @@ -65,7 +65,7 @@ 5.7 <a href="#UnusableEPR">UnusableEPR</a><br/> 5.8 <a href="#EndToNotSupported">EndToNotSupported</a><br/> 5.9 <a href="#EmptyFilter">EmptyFilter</a><br/> - 5.10 <a href="#MaxElementsMustBeZero">MaxElementsMustBeZero</a><br/> + 5.10 <a href="#MaxItemsMustBeZero">MaxItemsMustBeZero</a><br/> 6 <a href="#Security">Security Considerations</a><br/> 6.1 <a href="#iddiv2x1x1874">Creating Enumeration Contexts</a><br/> 6.2 <a href="#iddiv2x1x1879">Protecting Enumeration Contexts</a><br/> @@ -365,7 +365,7 @@ context to become invalid and allows the data source to free up any resources it might have allocated to the enumeration. Issuing a Release operation prior to reaching the end of the sequence of - elements is explicitly allowed; however, no further operations + items is explicitly allowed; however, no further operations MUST be issued after a Release. </p><p> An enumeration context can become invalid for any reason including: @@ -415,7 +415,7 @@ </wsen:NewContext> | <wsen:EnumerationContext ...>...</wsen:EnumerationContext> ) <wsen:MaxTime><em>xs:duration</em></wsen:MaxTime> ? - <wsen:MaxElements><em>xs:long</em></wsen:MaxElements> ? + <wsen:MaxItems><em>xs:long</em></wsen:MaxItems> ? <wsen:MaxCharacters><em>xs:long</em></wsen:MaxCharacters> ? <em>xs:any</em>* </wsen:Enumerate></pre></div></div><p> @@ -491,9 +491,9 @@ </p></dd><dt class="label"><b>[Body]</b>/wsen:Enumerate/wsen:NewContext/wsen:Filter </dt><dd><p> This OPTIONAL element contains a Boolean predicate in some dialect (see <b>[<a href="#Dialect">[Body]/wsen:Enumerate/wsen:NewContext/wsen:Filter/@Dialect </a>]</b>) - that all elements of + that all items of interest MUST satisfy. The resultant enumeration context MUST NOT - return elements for which this predicate expression evaluates to + return items for which this predicate expression evaluates to the value false. If this element is absent, then the implied value is the expression true(), indicating that no filtering is desired. @@ -591,20 +591,20 @@ element is absent, the data source is NOT REQUIRED to limit the amount of time it takes to assemble the Enumerate response. The data source MUST recognize the wsen:MaxTime - element. If no elements + element. If no items are available prior to the request message's deadline, the data source MUST return an EnumerationResponse message that contains a wsen:Items element with no child elements present. </p><p> This is useful with data sources that - accumulate elements over time and package them into a single Enumerate + accumulate items over time and package them into a single Enumerate response. - </p></dd><dt class="label"><b>[Body]</b>/wsen:Enumerate/wsen:MaxElements </dt><dd><p> + </p></dd><dt class="label"><b>[Body]</b>/wsen:Enumerate/wsen:MaxItems </dt><dd><p> This OPTIONAL element (of type xs:long) indicates the number of items (child elements of wsen:Items in the Enumerate response) the consumer is willing to accept. When this element is absent, its implied value is 1. Implementations MUST NOT return - more than this number of elements in the Enumerate response message. + more than this number of items in the Enumerate response message. Implementations MAY return fewer than this number based on either the wsen:MaxTime timeout, the wsen:MaxCharacters size limit, or implementation-specific constraints. @@ -615,12 +615,12 @@ </p><p> If the data source does not support returning items in response to a Enumerate request that also created a new enumeration, and the - Enumerate request did not include a wsen:MaxElemenets with a + Enumerate request did not include a wsen:MaxItems with a value of zero, then the data source MUST generate a - wsen:MaxElementsMustBeZero fault. + wsen:MaxItemsMustBeZero fault. </p></dd><dt class="label"><b>[Body]</b>/wsen:Enumerate/wsen:MaxCharacters </dt><dd><p> This OPTIONAL element (of type xs:long) - indicates the maximum size of the returned elements, in Unicode + indicates the maximum size of the returned items, in Unicode characters, that the consumer is willing to accept. When this element is absent, the data source is NOT REQUIRED to limit the number of characters in the Enumerate response. @@ -628,7 +628,7 @@ return a Enumerate response message whose wsen:Items element, and all of its children, is larger than MaxCharacters. Implementations MAY return a smaller message - based on the wsen:MaxTime timeout, the wsen:MaxElements limit, or + based on the wsen:MaxTime timeout, the wsen:MaxItems limit, or implementation-specific constraints. </p><p> Even if a Enumerate request contains a @@ -704,7 +704,7 @@ representation, if any, with the contents of this element. </p></dd><dt class="label"><b>[Body]</b>/wsen:EnumerateResponse/wsen:Items/<em>xs:any</em></dt><dd><p> The OPTIONAL Items element contains zero or - more enumeration-specific elements, one for each element being + more enumeration-specific elements, one for each item being returned. </p></dd><dt class="label"><b>[Body]</b>/wsen:EnumerateResponse/wsen:Items/@Reason </dt><dd><p> @@ -716,11 +716,11 @@ if the wsen:Items element has one or more child elements. </p></dd><dt class="label"><b>[Body]</b>/wsen:EnumerateResponse/wsen:Items/@Reason="http://www.w3.org/2002/ws/ra/edcopies/ws-enu/TimedOut" </dt><dd><p> - This value MUST be used if no elements are available prior to the + This value MUST be used if no items are available prior to the Enumeration request message's deadline. </p></dd><dt class="label"><b>[Body]</b>/wsen:EnumerateResponse/wsen:EndOfSequence </dt><dd><p> This OPTIONAL element indicates that no more - elements are available from this enumeration and the enumeration + items are available from this enumeration and the enumeration context sent by the consumer in the request becomes invalid. </p></dd></dl><p> Note that at least one of wsen:Items or @@ -754,7 +754,7 @@ (20) <wsen:NewContext> (21) <wsen:Expires> PT10M </wsen:Expires> (22) </wsen:NewContext> -(23) <wsen:MaxElements> 0 </wsen:MaxElements> +(23) <wsen:MaxItems> 0 </wsen:MaxItems> (24) </wsen:Enumerate> (25) </s:Body> (26) </s:Envelope></pre></div></div><p> @@ -765,7 +765,7 @@ enumeration context that will be good for 10 minutes. No wsen:Filter element is present, so the resultant enumeration context is expected to return all available - elements. Line (23) indicates that the Enumerate response + items. Line (23) indicates that the Enumerate response is not to include any items from the enumeration - this operation is just estalishing the enumeration context. </p><p><a href="#enumRes">Example 4-2</a> lists a response to the request in @@ -824,7 +824,7 @@ (19) <wsen:Enumerate> (20) <wsen:EnumerationContext>123</wsen:EnumerationContext> (21) <wsen:MaxTime>P30S</wsen:MaxTime> -(22) <wsen:MaxElements>10</wsen:MaxElements> +(22) <wsen:MaxItems>10</wsen:MaxItems> (23) </wsen:Enumerate> (24) </s:Body> (25) </s:Envelope></pre></div></div><p> @@ -833,7 +833,7 @@ with a Enumerate response message. Line (21) indicates that the response message SHOULD be generated no more than 30 seconds after receipt of the Enumerate request message. Line (22) indicates that no more than - 10 elements can be returned in the body of the Enumerate response + 10 items can be returned in the body of the Enumerate response message. </p><p><a href="#EnumerateRes">Example 4-4</a> lists a response to the request in <a href="#EnumerateReq">Example 4-3</a>. @@ -866,9 +866,9 @@ (26) </s:Body> (27) </s:Envelope></pre></div></div><p> Lines (05-07) in <a href="#EnumerateRes">Example 4-4</a> indicate this message - is a Enumerate response message. Lines (18-22) are the five elements + is a Enumerate response message. Lines (18-22) are the five items returned by this Enumerate request. The presence of a wsen:EndOfSequence - element (line (24)) indicates that no more elements are available + element (line (24)) indicates that no more items are available and that the enumeration context is now invalid. </p></div><div class="div2"> <h3><a name="Renew" id="Renew"/>4.2 Renew</h3><p> @@ -1206,11 +1206,11 @@ Enumerate request containing a filter that, for whatever reason, will never evaluate to true. </p><table border="1"><tbody><tr><td><b>[Code]</b></td><td>s12:Sender</td></tr><tr><td><b>[Subcode]</b></td><td>wsen:EmptyFilter</td></tr><tr><td><b>[Reason]</b></td><td>The wsen:Filter would result in zero data items.</td></tr><tr><td><b>[Detail]</b></td><td><em> The wsen:Filter value. </em></td></tr></tbody></table></div><div class="div2"> -<h3><a name="MaxElementsMustBeZero" id="MaxElementsMustBeZero"/>5.10 MaxElementsMustBeZero</h3><p> +<h3><a name="MaxItemsMustBeZero" id="MaxItemsMustBeZero"/>5.10 MaxItemsMustBeZero</h3><p> This fault MUST be generated by a data source that does not support returning items in a Enumerate response and the Enumerate request - did not include a wsen:MaxElements with a value of zero. - </p><table border="1"><tbody><tr><td><b>[Code]</b></td><td>s12:Sender</td></tr><tr><td><b>[Subcode]</b></td><td>wsen:MaxElementsMustBeZero</td></tr><tr><td><b>[Reason]</b></td><td>wsen:MaxElements must be zero when creating a new enumeration.</td></tr><tr><td><b>[Detail]</b></td><td><em>none</em></td></tr></tbody></table></div></div><div class="div1"> + did not include a wsen:MaxItems with a value of zero. + </p><table border="1"><tbody><tr><td><b>[Code]</b></td><td>s12:Sender</td></tr><tr><td><b>[Subcode]</b></td><td>wsen:MaxItemsMustBeZero</td></tr><tr><td><b>[Reason]</b></td><td>wsen:MaxItems must be zero when creating a new enumeration.</td></tr><tr><td><b>[Detail]</b></td><td><em>none</em></td></tr></tbody></table></div></div><div class="div1"> <h2><a name="Security" id="Security"/>6 Security Considerations</h2><p> This specification considers two sets of security requirements, those of the applications that use the WS-Enumeration protocol and those of @@ -1320,7 +1320,7 @@ <wsen:DateTimeSupported .../> ? <wsen:Expires min="<em>xs:duration</em>"? max="<em>xs:duration</em>"? .../> ? <wsen:MaxTime ...> <em>xs:duration</em> </wsen:MaxTime> ? - <wsen:MaxElements ...> <em>xs:long</em> </wsen:MaxElements> ? + <wsen:MaxItems ...> <em>xs:long</em> </wsen:MaxItems> ? <wsen:MaxCharacters ...> <em>xs:long</em> </wsen:MaxCharacters> ? <wsen:EndToSupported .../> ? <wsen:ItemsOnNewContextSupported .../> ? @@ -1358,9 +1358,9 @@ The implied default is infinite. Note: a value of "PT0S" indicates that this endpoint supports any duration value. - </p></dd><dt class="label"> /wsen:DataSource/wsen:MaxElements </dt><dd><p> + </p></dd><dt class="label"> /wsen:DataSource/wsen:MaxItems </dt><dd><p> When present, this OPTIONAL parameter indicates the maximum - MaxElements value supported by this endpoint. The value specified + MaxItems value supported by this endpoint. The value specified MUST be greater than zero. </p></dd><dt class="label"> /wsen:DataSource/wsen:MaxCharacters </dt><dd><p> When present, this OPTIONAL parameter indicates the maximum @@ -1377,7 +1377,7 @@ Enumerate operation creating a new enumeration context and returning an initial set of items in the Enumerate response message. When a data source does not support this feature, - all consumers MUST include a wsen:MaxElements with + all consumers MUST include a wsen:MaxItems with a value of zero in Enumerate requests that create new enumeration contexts. </p></dd><dt class="label"> /wsen:DataSource/xs:any </dt><dd><p> @@ -1630,7 +1630,7 @@ </xs:choice> <xs:element name='MaxTime' type='tns:PositiveDurationType' minOccurs='0' /> - <xs:element name='MaxElements' type='xs:positiveInteger' + <xs:element name='MaxItems' type='xs:positiveInteger' minOccurs='0' /> <xs:element name='MaxCharacters' type='xs:positiveInteger' minOccurs='0' /> @@ -1813,7 +1813,7 @@ </xs:complexType> </xs:element name='Expires'> <xs:element name='MaxTime' type='tns:Duration' minOccurs='0'/> - <xs:element name='MaxElements' type='tns:Long' minOccurs='0'/> + <xs:element name='MaxItems' type='tns:Long' minOccurs='0'/> <xs:element name='MaxCharacters' type='tns:Long' minOccurs='0'/> <xs:any namespace='##other' processContents='lax' minOccurs='0' maxOccurs='unbounded'/> @@ -2103,4 +2103,5 @@ <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=12063">12063</a></td></tr><tr><td> 2011/02/15 </td><td> DD </td><td> Added resolution of issue <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=11990">11990</a></td></tr><tr><td> 2011/02/15 </td><td> DD </td><td> Added resolution of issue <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=11949">11949</a></td></tr><tr><td> 2011/03/22 </td><td> DD </td><td> Added resolution of issue - <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=12112">12112</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=12112">12112</a></td></tr><tr><td> 2011/03/22 </td><td> DD </td><td> Added resolution of issue + <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=11776">11776</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.157 retrieving revision 1.158 diff -u -d -r1.157 -r1.158 --- wsenum.xml 22 Mar 2011 23:54:11 -0000 1.157 +++ wsenum.xml 23 Mar 2011 00:26:33 -0000 1.158 @@ -617,7 +617,7 @@ context to become invalid and allows the data source to free up any resources it might have allocated to the enumeration. Issuing a Release operation prior to reaching the end of the sequence of - elements is explicitly allowed; however, no further operations + items is explicitly allowed; however, no further operations MUST be issued after a Release. </p> @@ -702,7 +702,7 @@ </wsen:NewContext> | <wsen:EnumerationContext ...>...</wsen:EnumerationContext> ) <wsen:MaxTime><emph>xs:duration</emph></wsen:MaxTime> ? - <wsen:MaxElements><emph>xs:long</emph></wsen:MaxElements> ? + <wsen:MaxItems><emph>xs:long</emph></wsen:MaxItems> ? <wsen:MaxCharacters><emph>xs:long</emph></wsen:MaxCharacters> ? <emph>xs:any</emph>* </wsen:Enumerate></eg> @@ -828,9 +828,9 @@ <p> This OPTIONAL element contains a Boolean predicate in some dialect (see <specref ref="Dialect"/>) - that all elements of + that all items of interest MUST satisfy. The resultant enumeration context MUST NOT - return elements for which this predicate expression evaluates to + return items for which this predicate expression evaluates to the value false. If this element is absent, then the implied value is the expression true(), indicating that no filtering is desired. @@ -1007,28 +1007,28 @@ element is absent, the data source is NOT REQUIRED to limit the amount of time it takes to assemble the Enumerate response. The data source MUST recognize the wsen:MaxTime - element. If no elements + element. If no items are available prior to the request message's deadline, the data source MUST return an EnumerationResponse message that contains a wsen:Items element with no child elements present. </p> <p> This is useful with data sources that - accumulate elements over time and package them into a single Enumerate + accumulate items over time and package them into a single Enumerate response. </p> </def> </gitem> <gitem> - <label> <kw>[Body]</kw>/wsen:Enumerate/wsen:MaxElements </label> + <label> <kw>[Body]</kw>/wsen:Enumerate/wsen:MaxItems </label> <def> <p> This OPTIONAL element (of type xs:long) indicates the number of items (child elements of wsen:Items in the Enumerate response) the consumer is willing to accept. When this element is absent, its implied value is 1. Implementations MUST NOT return - more than this number of elements in the Enumerate response message. + more than this number of items in the Enumerate response message. Implementations MAY return fewer than this number based on either the wsen:MaxTime timeout, the wsen:MaxCharacters size limit, or implementation-specific constraints. @@ -1043,9 +1043,9 @@ <p> If the data source does not support returning items in response to a Enumerate request that also created a new enumeration, and the - Enumerate request did not include a wsen:MaxElemenets with a + Enumerate request did not include a wsen:MaxItems with a value of zero, then the data source MUST generate a - wsen:MaxElementsMustBeZero fault. + wsen:MaxItemsMustBeZero fault. </p> </def> @@ -1056,7 +1056,7 @@ <def> <p> This OPTIONAL element (of type xs:long) - indicates the maximum size of the returned elements, in Unicode + indicates the maximum size of the returned items, in Unicode characters, that the consumer is willing to accept. When this element is absent, the data source is NOT REQUIRED to limit the number of characters in the Enumerate response. @@ -1064,7 +1064,7 @@ return a Enumerate response message whose wsen:Items element, and all of its children, is larger than MaxCharacters. Implementations MAY return a smaller message - based on the wsen:MaxTime timeout, the wsen:MaxElements limit, or + based on the wsen:MaxTime timeout, the wsen:MaxItems limit, or implementation-specific constraints. </p> @@ -1187,7 +1187,7 @@ <def> <p> The OPTIONAL Items element contains zero or - more enumeration-specific elements, one for each element being + more enumeration-specific elements, one for each item being returned. </p> </def> @@ -1217,7 +1217,7 @@ </label> <def> <p> - This value MUST be used if no elements are available prior to the + This value MUST be used if no items are available prior to the Enumeration request message's deadline. </p> </def> @@ -1228,7 +1228,7 @@ <def> <p> This OPTIONAL element indicates that no more - elements are available from this enumeration and the enumeration + items are available from this enumeration and the enumeration context sent by the consumer in the request becomes invalid. </p> </def> @@ -1274,7 +1274,7 @@ (20) <wsen:NewContext> (21) <wsen:Expires> PT10M </wsen:Expires> (22) </wsen:NewContext> -(23) <wsen:MaxElements> 0 </wsen:MaxElements> +(23) <wsen:MaxItems> 0 </wsen:MaxItems> (24) </wsen:Enumerate> (25) </s:Body> (26) </s:Envelope></eg> @@ -1288,7 +1288,7 @@ enumeration context that will be good for 10 minutes. No wsen:Filter element is present, so the resultant enumeration context is expected to return all available - elements. Line (23) indicates that the Enumerate response + items. Line (23) indicates that the Enumerate response is not to include any items from the enumeration - this operation is just estalishing the enumeration context. </p> @@ -1362,7 +1362,7 @@ (19) <wsen:Enumerate> (20) <wsen:EnumerationContext>123</wsen:EnumerationContext> (21) <wsen:MaxTime>P30S</wsen:MaxTime> -(22) <wsen:MaxElements>10</wsen:MaxElements> +(22) <wsen:MaxItems>10</wsen:MaxItems> (23) </wsen:Enumerate> (24) </s:Body> (25) </s:Envelope></eg> @@ -1374,7 +1374,7 @@ with a Enumerate response message. Line (21) indicates that the response message SHOULD be generated no more than 30 seconds after receipt of the Enumerate request message. Line (22) indicates that no more than - 10 elements can be returned in the body of the Enumerate response + 10 items can be returned in the body of the Enumerate response message. </p> @@ -1416,9 +1416,9 @@ <p> Lines (05-07) in <specref ref="EnumerateRes"/> indicate this message - is a Enumerate response message. Lines (18-22) are the five elements + is a Enumerate response message. Lines (18-22) are the five items returned by this Enumerate request. The presence of a wsen:EndOfSequence - element (line (24)) indicates that no more elements are available + element (line (24)) indicates that no more items are available and that the enumeration context is now invalid. </p> @@ -2206,13 +2206,13 @@ </table> </div2> - <div2 id="MaxElementsMustBeZero"> - <head>MaxElementsMustBeZero</head> + <div2 id="MaxItemsMustBeZero"> + <head>MaxItemsMustBeZero</head> <p> This fault MUST be generated by a data source that does not support returning items in a Enumerate response and the Enumerate request - did not include a wsen:MaxElements with a value of zero. + did not include a wsen:MaxItems with a value of zero. </p> <table border="1"> @@ -2224,12 +2224,12 @@ <tr> <td><kw>[Subcode]</kw></td> - <td>wsen:MaxElementsMustBeZero</td> + <td>wsen:MaxItemsMustBeZero</td> </tr> <tr> <td><kw>[Reason]</kw></td> - <td>wsen:MaxElements must be zero when creating a new enumeration.</td> + <td>wsen:MaxItems must be zero when creating a new enumeration.</td> </tr> <tr> @@ -2397,7 +2397,7 @@ <wsen:DateTimeSupported .../> ? <wsen:Expires min="<emph>xs:duration</emph>"? max="<emph>xs:duration</emph>"? .../> ? <wsen:MaxTime ...> <emph>xs:duration</emph> </wsen:MaxTime> ? - <wsen:MaxElements ...> <emph>xs:long</emph> </wsen:MaxElements> ? + <wsen:MaxItems ...> <emph>xs:long</emph> </wsen:MaxItems> ? <wsen:MaxCharacters ...> <emph>xs:long</emph> </wsen:MaxCharacters> ? <wsen:EndToSupported .../> ? <wsen:ItemsOnNewContextSupported .../> ? @@ -2485,11 +2485,11 @@ </gitem> <gitem> - <label> /wsen:DataSource/wsen:MaxElements </label> + <label> /wsen:DataSource/wsen:MaxItems </label> <def> <p> When present, this OPTIONAL parameter indicates the maximum - MaxElements value supported by this endpoint. The value specified + MaxItems value supported by this endpoint. The value specified MUST be greater than zero. </p> </def> @@ -2527,7 +2527,7 @@ Enumerate operation creating a new enumeration context and returning an initial set of items in the Enumerate response message. When a data source does not support this feature, - all consumers MUST include a wsen:MaxElements with + all consumers MUST include a wsen:MaxItems with a value of zero in Enumerate requests that create new enumeration contexts. </p> @@ -2898,7 +2898,7 @@ </xs:choice> <xs:element name='MaxTime' type='tns:PositiveDurationType' minOccurs='0' /> - <xs:element name='MaxElements' type='xs:positiveInteger' + <xs:element name='MaxItems' type='xs:positiveInteger' minOccurs='0' /> <xs:element name='MaxCharacters' type='xs:positiveInteger' minOccurs='0' /> @@ -3081,7 +3081,7 @@ </xs:complexType> </xs:element name='Expires'> <xs:element name='MaxTime' type='tns:Duration' minOccurs='0'/> - <xs:element name='MaxElements' type='tns:Long' minOccurs='0'/> + <xs:element name='MaxItems' type='tns:Long' minOccurs='0'/> <xs:element name='MaxCharacters' type='tns:Long' minOccurs='0'/> <xs:any namespace='##other' processContents='lax' minOccurs='0' maxOccurs='unbounded'/> @@ -4048,6 +4048,13 @@ <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=12112">12112</loc> </td> </tr> + <tr> + <td> 2011/03/22 </td> + <td> DD </td> + <td> Added resolution of issue + <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=11776">11776</loc> + </td> + </tr> </tbody> </table> </div1>
Received on Wednesday, 23 March 2011 00:26:39 UTC