Package ddf.catalog.util.impl

Class ResultIterable

java.lang.Object

ddf.catalog.util.impl.ResultIterable

All Implemented Interfaces:

Iterable<ddf.catalog.data.Result>

public class ResultIterable
extends Object
implements Iterable<ddf.catalog.data.Result>

Class used to iterate over the Result objects contained in a QueryResponse returned when executing a QueryRequest. The class will fetch new results as needed until all results that match the query provided have been exhausted.

Since the class may use the page size provided in the Query to fetch the results, its value should be carefully set to avoid any memory or performance issues.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	DEFAULT_PAGE_SIZE

Method Summary

Modifier and Type	Method	Description
Iterator<ddf.catalog.data.Result>	iterator()
static ResultIterable	resultIterable(ddf.catalog.CatalogFramework catalogFramework, ddf.catalog.operation.QueryRequest queryRequest)	Creates an iterable that will call the CatalogFramework to retrieve the results that match the QueryRequest provided.
static ResultIterable	resultIterable(ddf.catalog.CatalogFramework catalogFramework, ddf.catalog.operation.QueryRequest queryRequest, int maxResultCount)	Creates an iterable that will call the CatalogFramework to retrieve the results that match the QueryRequest provided.
static ResultIterable	resultIterable(QueryFunction queryFunction, ddf.catalog.operation.QueryRequest queryRequest)	Creates an iterable that will call a QueryFunction to retrieve the results that match the QueryRequest provided.
static ResultIterable	resultIterable(QueryFunction queryFunction, ddf.catalog.operation.QueryRequest queryRequest, int maxResultCount)	Creates an iterable that will call a QueryFunction to retrieve the results that match the QueryRequest provided.
Stream<ddf.catalog.data.Result>	stream()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Details

DEFAULT_PAGE_SIZE

public static final int DEFAULT_PAGE_SIZE

See Also:

• Constant Field Values

Method Details

resultIterable

public static ResultIterable resultIterable(ddf.catalog.CatalogFramework catalogFramework,
 ddf.catalog.operation.QueryRequest queryRequest)

Creates an iterable that will call the CatalogFramework to retrieve the results that match the QueryRequest provided. There will be no limit to the number of results returned.

Parameters:

catalogFramework - reference to the CatalogFramework to call to retrieve the results.

queryRequest - request used to retrieve the results.

resultIterable

public static ResultIterable resultIterable(QueryFunction queryFunction,
 ddf.catalog.operation.QueryRequest queryRequest)

Creates an iterable that will call a QueryFunction to retrieve the results that match the QueryRequest provided. There will be no limit to the number of results returned.

Parameters:

queryFunction - reference to the QueryFunction to call to retrieve the results.

queryRequest - request used to retrieve the results.

resultIterable

public static ResultIterable resultIterable(ddf.catalog.CatalogFramework catalogFramework,
 ddf.catalog.operation.QueryRequest queryRequest,
 int maxResultCount)

Creates an iterable that will call the CatalogFramework to retrieve the results that match the QueryRequest provided.

Parameters:

catalogFramework - reference to the CatalogFramework to call to retrieve the results.

queryRequest - request used to retrieve the results.

maxResultCount - a positive integer indicating the maximum number of results in total to query for

resultIterable

public static ResultIterable resultIterable(QueryFunction queryFunction,
 ddf.catalog.operation.QueryRequest queryRequest,
 int maxResultCount)

Creates an iterable that will call a QueryFunction to retrieve the results that match the QueryRequest provided. If the query request does not include a sort-by, then the code will default to sorting by the metacard ID in descending order.

Parameters:

queryFunction - reference to the QueryFunction to call to retrieve the results.

queryRequest - request used to retrieve the results.

maxResultCount - a positive integer indicating the maximum number of results in total to query for

iterator

public Iterator<ddf.catalog.data.Result> iterator()

Specified by:

iterator in interface Iterable<ddf.catalog.data.Result>

stream

public Stream<ddf.catalog.data.Result> stream()