- From: Doug Davis <dug@us.ibm.com>
- Date: Wed, 7 Jan 2009 11:43:12 -0500
- To: public-ws-resource-access@w3.org
- Message-ID: <OF22A72181.D68056FA-ON85257537.005A2E93-85257537.005BEABF@us.ibm.com>
When creating new enumerations it can be useful to the client to know
(prior to receiving the data) how much data will be coming so it can
allocate the proper space. To that end, it would be nice if client could
ask for the EnumerateResponse message to include this information.
Proposal:
Extend the Enumerate request with the stuff in bold:
<wsen:Enumerate ?>
<wsen:EndTo>endpoint-reference</wsen:EndTo> ?
<wsen:Expires>[xs:dateTime | xs:duration]</wsen:Expires> ?
<wsen:Filter Dialect="xs:anyURI"?> xs:any </wsen:Filter> ?
<wsen:RequestCount Exact="xs:boolean"?> ?
?
</wsen:Enumerate>
/RequestCount
when present this element indicates that the client is asking for the
data source to return the number of data items in the EnumerateResponse
message.
When not present the default value is value. If the service doesn't
support
this option then a fault must be generate.
/RequestCount@Exact
when present, and set to 'true', this attribute indicates that the data
source MUST return
the exact number of items in the filtered enumeration in the
EnumerateRespones. If an exact count
can not be determined then a fault must be generated. The default value
is 'false' - which means the service can choose to estimate the total
count
if that is all it can do.
and the EnumerateResponse with:
<wsen:EnumerateResponse ?>
<wsen:Expires>[xs:dateTime | xs:duration]</wsen:Expires> ?
<wsen:EnumerationContext>?</wsen:EnumerationContext>
<wsen:TotalCount Exact="xs:boolean"?> xs:long </wsen:TotalCount> ?
?
</wsen:EnumerateResponse>
/TotalCount
when present this element indicates the total size of the filtered
enumeration. This element MUST be present if the RequestCount
element was on the Enumerate request.
/TotalCount@Exact
when present and set to 'true' this element indicates that the total
count value is
the exact number of items in the filtered enumeration and not an
estimate. The default value is 'false'.
thanks
-Doug
______________________________________________________
STSM | Web Services Architect | IBM Software Group
(919) 254-6905 | IBM T/L 444-6905 | dug@us.ibm.com
Received on Wednesday, 7 January 2009 16:44:17 UTC