- 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