scroll

Returns a SearchResult object containing the next page of the scroll session, and the scrollId to be used in the next scroll action. A scroll session is always initiated by a search action and including the scroll argument; more information below.

There is a small delay between the time a document is created and its availability in our search layer (usually a couple of seconds). That means that a document that was just created might not be returned immediately by this function.

To get more information about scroll sessions, please refer to the API reference documentation.


scroll(scrollId, [options], callback)

Arguments Type Description
scrollId string The "scrollId" provided with the last scroll response or from the initial search request if it is the first scroll call
options JSON object Optional parameters
callback function Callback handling the response

Options

Option Type Description Default
queuable boolean Make this request queuable or not true
scroll string Re-initializes the scroll session timeout to its value. If not defined, the scroll timeout is defaulted to a Kuzzle configuration undefined

Callback Response

Returns an instantiated SearchResult object.


Usage

Copied to clipboard!

Options opts = new Options();
opts.setScroll("1m");

kuzzle
  .collection("collection", "index")
  .scroll(scrollId, opts, new ResponseListener<SearchResult>() {
    @Override
    public void onSuccess(SearchResult searchResult) {
      for (Document doc : searchResult.getDocuments()) {
        // Get documents
      }

  searchResult.getTotal(); // return total of documents returned

  searchResult.getAggregations(): // return a JSONObject representing the aggregations response
    }

  @Override
  public void onError(JSONObject error) {
    // Handle error
    }
  });