UnionQueryAnalyzer (Carbonado 1.2.3 API)

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
+

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)
+

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
    +
  +
+

Class UnionQueryAnalyzer<S extends Storable>

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

UnionQueryAnalyzer

Method Detail

getStorableType

analyze

executor