com.amazon.carbonado.qe

Class UnionQueryAnalyzer<S extends Storable>

java.lang.Object

com.amazon.carbonado.qe.UnionQueryAnalyzer<S>

All Implemented Interfaces:

QueryExecutorFactory<S>

public class UnionQueryAnalyzer<S extends Storable>
extends java.lang.Object
implements QueryExecutorFactory<S>

Analyzes a query specification and determines how it can be executed as a union of smaller queries. If necessary, the UnionQueryAnalyzer will alter the query slightly, imposing a total ordering. Internally, an IndexedQueryAnalyzer is used for selecting the best indexes.

UnionQueryAnalyzer is sharable and thread-safe. An instance for a particular Storable type can be cached, avoiding repeated construction cost. In addition, the analyzer caches learned foreign indexes.

Author:

Brian S O'Neill

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	UnionQueryAnalyzer.Result

Constructor Summary

Constructors

Constructor and Description
UnionQueryAnalyzer(java.lang.Class<S> type, RepositoryAccess access)

Method Summary

Methods

Modifier and Type	Method and Description
UnionQueryAnalyzer.Result	analyze(Filter<S> filter, OrderingList<S> ordering, QueryHints hints)
QueryExecutor<S>	executor(Filter<S> filter, OrderingList<S> ordering, QueryHints hints) Returns an executor that handles the given query specification.
java.lang.Class<S>	getStorableType()

Methods inherited from class java.lang.Object

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

Constructor Detail

UnionQueryAnalyzer

public UnionQueryAnalyzer(java.lang.Class<S> type,
                  RepositoryAccess access)

Parameters:

type - type of storable being queried

access - repository access for examing available indexes

Throws:

java.lang.IllegalArgumentException - if type or indexProvider is null

Method Detail

getStorableType

public java.lang.Class<S> getStorableType()

Specified by:

getStorableType in interface QueryExecutorFactory<S extends Storable>

analyze

public UnionQueryAnalyzer.Result analyze(Filter<S> filter,
                                OrderingList<S> ordering,
                                QueryHints hints)
                                  throws SupportException,
                                         RepositoryException

Parameters:

filter - optional filter which must be bound

ordering - optional properties which define desired ordering

hints - optional query hints

Throws:

SupportException

RepositoryException

executor

public QueryExecutor<S> executor(Filter<S> filter,
                        OrderingList<S> ordering,
                        QueryHints hints)
                                           throws RepositoryException

Returns an executor that handles the given query specification.

Specified by:

executor in interface QueryExecutorFactory<S extends Storable>

Parameters:

filter - optional filter which must be bound

ordering - optional properties which define desired ordering

hints - optional query hints

Throws:

RepositoryException