org.eclipse.equinox.internal.p2.metadata.expression

Class QueryResult<T>

java.lang.Object

org.eclipse.equinox.internal.p2.metadata.expression.QueryResult<T>

All Implemented Interfaces:

java.lang.Iterable<T>, IQueryable<T>, IQueryResult<T>

public class QueryResult<T>
extends java.lang.Object
implements IQueryResult<T>

A result optimized for dealing with iterators returned from expression evaluation.

Constructor Summary

Constructors

Constructor and Description
QueryResult(java.util.Collection<T> collection)
QueryResult(java.util.Iterator<T> iterator) Create an QueryResult based on the given iterator.

Method Summary

Modifier and Type	Method and Description
boolean	isEmpty() Returns whether this QueryResult is empty.
java.util.Iterator<T>	iterator() Returns an iterator on the collected objects.
IQueryResult<T>	query(IQuery<T> query, IProgressMonitor monitor) Performs a query, passing any objects that satisfy the query to the provided collector.
T[]	toArray(java.lang.Class<T> clazz) Returns the collected objects as an array
java.util.Set<T>	toSet() Creates a new Set copy with the contents of this query result.
java.util.Set<T>	toUnmodifiableSet() Returns a Set backed by this query result.

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

Constructor Detail

QueryResult

public QueryResult(java.util.Iterator<T> iterator)

Create an QueryResult based on the given iterator. The oneShot parameter can be set to true if the returned instance is expected to be perused only once. This will allow some optimizations since the result of the iteration doesn't need to be copied in preparation for a second iteration.

Parameters:

iterator - The iterator to use as the result iterator.

QueryResult

public QueryResult(java.util.Collection<T> collection)

Method Detail

isEmpty

public boolean isEmpty()

Description copied from interface: IQueryResult

Returns whether this QueryResult is empty.

Specified by:

isEmpty in interface IQueryResult<T>

Returns:

true if this QueryResult has accepted any results, and false otherwise.

iterator

public java.util.Iterator<T> iterator()

Description copied from interface: IQueryResult

Returns an iterator on the collected objects.

Specified by:

iterator in interface java.lang.Iterable<T>

Specified by:

iterator in interface IQueryResult<T>

Returns:

an iterator of the collected objects.

toArray

public T[] toArray(java.lang.Class<T> clazz)

Description copied from interface: IQueryResult

Returns the collected objects as an array

Specified by:

toArray in interface IQueryResult<T>

Parameters:

clazz - The type of array to return

Returns:

The array of results

toSet

public java.util.Set<T> toSet()

Description copied from interface: IQueryResult

Creates a new Set copy with the contents of this query result. The copy can be altered without any side effects on its origin.

Specified by:

toSet in interface IQueryResult<T>

Returns:

A detached copy of the result.

query

public IQueryResult<T> query(IQuery<T> query,
                             IProgressMonitor monitor)

Description copied from interface: IQueryable

Performs a query, passing any objects that satisfy the query to the provided collector.

This method is long-running; progress and cancellation are provided by the given progress monitor.

Specified by:

query in interface IQueryable<T>

Parameters:

query - The query to perform

monitor - a progress monitor, or null if progress reporting is not desired

Returns:

The collector argument

toUnmodifiableSet

public java.util.Set<T> toUnmodifiableSet()

Description copied from interface: IQueryResult

Returns a Set backed by this query result. The set is immutable.

Specified by:

toUnmodifiableSet in interface IQueryResult<T>

Returns:

A Set backed by this query result.