org.alfresco.query
Interface PagingResults

All Known Subinterfaces:
CannedQueryResults
All Known Implementing Classes:
EmptyCannedQueryResults, EmptyPagingResults

public interface PagingResults

Marker interface for single page of results

Since:
4.0

Method Summary
 java.util.List getPage()
          Get the page of results.
 java.lang.String getQueryExecutionId()
          Get a unique ID associated with these query results.
 Pair getTotalResultCount()
          Get the total result count assuming no paging applied.
 boolean hasMoreItems()
          True if more items on next page.
 

Method Detail

getPage

java.util.List getPage()
Get the page of results.

Returns:
the results - possibly empty but never null

hasMoreItems

boolean hasMoreItems()
True if more items on next page.

Note: could also return true if page was cutoff/trimmed for some reason (eg. due to permission checks of large page of requested max items)

Returns:
true if more items (eg. on next page)
- true => at least one more page (or incomplete page - if cutoff)
- false => last page (or incomplete page - if cutoff)

getTotalResultCount

Pair getTotalResultCount()
Get the total result count assuming no paging applied. This value will only be available if the query supports it and the client requested it. By default, it is not requested.

Returns result as an approx "range" pair

Returns:
Returns the total results as a range (all results, including the paged results returned)

getQueryExecutionId

java.lang.String getQueryExecutionId()
Get a unique ID associated with these query results. This must be available before and after execution i.e. it must depend on the type of query and the query parameters rather than the execution results. Client has the option to pass this back as a hint when paging.

Returns:
a unique ID associated with the query execution results


Copyright © 2005 - 2010 Alfresco Software, Inc. All Rights Reserved.