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 #
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
}
});