SearchResult #

When performing a search, Kuzzle returns an SearchResult object, which holds the items matching the given query and allows to drill through next result pages if applicable.

Properties #

String

String

int

int

String

Methods #

The SearchResult object has an unique next method, which returns a new SearchResult object.

(SearchResult* sr) Next();

Behaviour of the next method #

In order to be able to compute the next search page, some initial conditions must be met.

Depending on the arguments given to the initial search, thhe next method will pick one of the following policies, by decreasing order of priority (i.e. a search including a scroll, sort and size will use the scroll policy).

If no policy is applicable, the next method will throw an exception.

1. scroll #

This is the preferred way to get some paginated results.

If the original search is given a scroll parameter, the next method will use a cursor to paginate results.

The results that are returned from a scroll request reflect the state of the index at the time the initial search request was performed, like a snapshot in time.

As such, even if some documents are added or deleted from the database between two calls to next, the result is garanteed to include all items matching the query at the time the initial search was sent and to not get any duplicate between two search pages.

2. sort / size #

If the initial search is given some sort and size parameters, the next method will retrieve the next items matching the sort.

To avoid too many duplicates, it is advised to provide a sort combination that will always identify one item only. The recommended way is to use the field _uid which is certain to contain one unique value for each document.

Because this method does not freeze the research between two calls, if some updates are applied to the database between two calls, it is still possible to miss some documents and/or to get some duplicates between search pages.

3. from / size #

If the initial search is given some from and size parameters, the next method will increment the from parameter to retrieved the next results.

Because this method does not freeze the research between two calls, if some updates are applied to the database between two calls, it is possible to miss some documents and/or to get some duplicates between search pages.

Usage #

try {
  int i;
  for (i = 0; i < 5; i++) {
    kuzzle.getDocument().create("nyc-open-data", "yellow-taxi", "", "{\"category\": \"suv\"}");
  }
  for (i = 5; i < 15; i++) {
    kuzzle.getDocument().create("nyc-open-data", "yellow-taxi", "", "{\"category\": \"limousine\"}");
  }
  kuzzle.getIndex().refresh("nyc-open-data");
  QueryOptions options = new QueryOptions();
  options.setScroll("1m");
  options.setSize(2);
  SearchResult response = kuzzle.getDocument().search("nyc-open-data", "yellow-taxi", "{\"query\":{\"match\": {\"category\": \"suv\"}}}", options);
  SearchResult nextPage = response.next();
  System.out.println(String.format("Successfully retrieved %d documents", nextPage.getFetched()));
} catch (KuzzleException e) {
  System.err.println(e.getMessage());
}