QueryImpl ("The Adobe AEM Quickstart and Web Application.")

java.lang.Object
- org.apache.jackrabbit.oak.query.QueryImpl

All Implemented Interfaces:: Query

public class QueryImpl
extends java.lang.Object
implements Query

Represents a parsed query.

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`JCR_PATH` The "jcr:path" pseudo-property.
`static java.lang.String`	`JCR_SCORE` The "jcr:score" pseudo-property.
`static java.lang.String`	`OAK_SCORE_EXPLANATION` The "oak:explainScore" pseudo-property.
`static java.lang.String`	`REP_EXCERPT` The "rep:excerpt" pseudo-property.
`static java.lang.String`	`REP_FACET` The "rep:facet" pseudo-property.
`static java.lang.String`	`REP_SPELLCHECK` The "rep:spellcheck" pseudo-property.
`static java.lang.String`	`REP_SUGGEST` The "rep:suggest" pseudo-property.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`bindValue(java.lang.String varName, PropertyValue value)`
`Query`	`buildAlternativeQuery()` Try to convert the query to an alternative form, specially a "union".
`boolean`	`containsUnfilteredFullTextCondition()` Whether the condition contains a fulltext condition that can not be applied to the filter, for example because it is part of an "or" condition of the form "where a=1 or contains(., 'x')".
`Query`	`copyOf()` returns a clone of the current object.
`ResultImpl`	`executeQuery()`
`SelectorExecutionPlan`	`getBestSelectorExecutionPlan(FilterImpl filter)`
`java.util.List<java.lang.String>`	`getBindVariableNames()`
`PropertyValue`	`getBindVariableValue(java.lang.String bindVariableName)`
`int`	`getColumnIndex(java.lang.String columnName)`
`ColumnImpl[]`	`getColumns()`
`ConstraintImpl`	`getConstraint()`
`double`	`getEstimatedCost()` Get the estimated cost.
`ExecutionContext`	`getExecutionContext()`
`java.lang.String`	`getIndexCostInfo()` Get the index cost as a JSON string.
`NamePathMapper`	`getNamePathMapper()`
`java.lang.String`	`getOakPath(java.lang.String path)` Validate the path is syntactically correct, and convert it to an Oak internal path (including namespace remapping if needed).
`OrderingImpl[]`	`getOrderings()`
`java.lang.String`	`getPlan()` Get the query plan.
`java.util.Iterator<ResultRowImpl>`	`getRows()`
`int`	`getSelectorIndex(java.lang.String selectorName)`
`java.lang.String[]`	`getSelectorNames()`
`QueryEngineSettings`	`getSettings()`
`long`	`getSize()` Get the size if known.
`long`	`getSize(Result.SizePrecision precision, long max)` Get the size if known.
`SourceImpl`	`getSource()`
`java.lang.String`	`getStatement()`
`Tree`	`getTree(java.lang.String path)`
`void`	`init()` Initialize the query.
`boolean`	`isInit()`
`boolean`	`isInternal()`
`boolean`	`isMeasureOrExplainEnabled()`
`boolean`	`isSortedByIndex()` Returns whether the results will be sorted by index.
`void`	`prepare()` Prepare the query.
`static long`	`saturatedAdd(long x, long y)` Add two values, but don't let it overflow or underflow.
`void`	`setDistinct(boolean distinct)`
`void`	`setExecutionContext(ExecutionContext context)`
`void`	`setExplain(boolean explain)`
`void`	`setInternal(boolean isInternal)`
`void`	`setLimit(long limit)`
`void`	`setMeasure(boolean measure)`
`void`	`setOffset(long offset)`
`void`	`setOrderings(OrderingImpl[] orderings)`
`void`	`setTraversalEnabled(boolean traversalEnabled)`
`java.lang.String`	`toString()`

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - JCR_PATH
```
public static final java.lang.String JCR_PATH
```
    The "jcr:path" pseudo-property.
    
    See Also:
    
    Constant Field Values
  - JCR_SCORE
```
public static final java.lang.String JCR_SCORE
```
    The "jcr:score" pseudo-property.
    
    See Also:
    
    Constant Field Values
  - REP_EXCERPT
```
public static final java.lang.String REP_EXCERPT
```
    The "rep:excerpt" pseudo-property.
    
    See Also:
    
    Constant Field Values
  - REP_FACET
```
public static final java.lang.String REP_FACET
```
    The "rep:facet" pseudo-property.
    
    See Also:
    
    Constant Field Values
  - OAK_SCORE_EXPLANATION
```
public static final java.lang.String OAK_SCORE_EXPLANATION
```
    The "oak:explainScore" pseudo-property.
    
    See Also:
    
    Constant Field Values
  - REP_SPELLCHECK
```
public static final java.lang.String REP_SPELLCHECK
```
    The "rep:spellcheck" pseudo-property.
    
    See Also:
    
    Constant Field Values
  - REP_SUGGEST
```
public static final java.lang.String REP_SUGGEST
```
    The "rep:suggest" pseudo-property.
    
    See Also:
    
    Constant Field Values
- Method Detail
  - init
```
public void init()
```
    Description copied from interface: Query
    
    Initialize the query. This will 'wire' selectors into constraints, and collect bind variable names. It will also simplify expressions if possible, but will not prepare the query.
    
    Specified by:
    
    init in interface Query
  - getColumns
```
public ColumnImpl[] getColumns()
```
    Specified by:
    
    getColumns in interface Query
  - getConstraint
```
public ConstraintImpl getConstraint()
```
  - getOrderings
```
public OrderingImpl[] getOrderings()
```
  - getSource
```
public SourceImpl getSource()
```
  - bindValue
```
public void bindValue(java.lang.String varName,
                      PropertyValue value)
```
    Specified by:
    
    bindValue in interface Query
  - setLimit
```
public void setLimit(long limit)
```
    Specified by:
    
    setLimit in interface Query
  - setOffset
```
public void setOffset(long offset)
```
    Specified by:
    
    setOffset in interface Query
  - setExplain
```
public void setExplain(boolean explain)
```
    Specified by:
    
    setExplain in interface Query
  - setMeasure
```
public void setMeasure(boolean measure)
```
    Specified by:
    
    setMeasure in interface Query
  - setDistinct
```
public void setDistinct(boolean distinct)
```
  - executeQuery
```
public ResultImpl executeQuery()
```
    Specified by:
    
    executeQuery in interface Query
  - getRows
```
public java.util.Iterator<ResultRowImpl> getRows()
```
    Specified by:
    
    getRows in interface Query
  - isSortedByIndex
```
public boolean isSortedByIndex()
```
    Description copied from interface: Query
    
    Returns whether the results will be sorted by index. The query must already be prepared.
    
    Specified by:
    
    isSortedByIndex in interface Query
    
    Returns:
    
    if sorted by index
  - getPlan
```
public java.lang.String getPlan()
```
    Description copied from interface: Query
    
    Get the query plan. The query must already be prepared.
    
    Specified by:
    
    getPlan in interface Query
    
    Returns:
    
    the query plan
  - getIndexCostInfo
```
public java.lang.String getIndexCostInfo()
```
    Description copied from interface: Query
    
    Get the index cost as a JSON string. The query must already be prepared.
    
    Specified by:
    
    getIndexCostInfo in interface Query
    
    Returns:
    
    the index cost
  - getEstimatedCost
```
public double getEstimatedCost()
```
    Description copied from interface: Query
    
    Get the estimated cost.
    
    Specified by:
    
    getEstimatedCost in interface Query
    
    Returns:
    
    the estimated cost
  - prepare
```
public void prepare()
```
    Description copied from interface: Query
    
    Prepare the query. The cost is estimated and the execution plan is decided here.
    
    Specified by:
    
    prepare in interface Query
  - getSelectorIndex
```
public int getSelectorIndex(java.lang.String selectorName)
```
    Specified by:
    
    getSelectorIndex in interface Query
  - getColumnIndex
```
public int getColumnIndex(java.lang.String columnName)
```
    Specified by:
    
    getColumnIndex in interface Query
  - getBindVariableValue
```
public PropertyValue getBindVariableValue(java.lang.String bindVariableName)
```
  - getSelectorNames
```
public java.lang.String[] getSelectorNames()
```
    Specified by:
    
    getSelectorNames in interface Query
  - getBindVariableNames
```
public java.util.List<java.lang.String> getBindVariableNames()
```
    Specified by:
    
    getBindVariableNames in interface Query
  - setTraversalEnabled
```
public void setTraversalEnabled(boolean traversalEnabled)
```
    Specified by:
    
    setTraversalEnabled in interface Query
  - getBestSelectorExecutionPlan
```
public SelectorExecutionPlan getBestSelectorExecutionPlan(FilterImpl filter)
```
  - setExecutionContext
```
public void setExecutionContext(ExecutionContext context)
```
    Specified by:
    
    setExecutionContext in interface Query
  - setOrderings
```
public void setOrderings(OrderingImpl[] orderings)
```
    Specified by:
    
    setOrderings in interface Query
  - getNamePathMapper
```
public NamePathMapper getNamePathMapper()
```
  - getTree
```
public Tree getTree(java.lang.String path)
```
    Specified by:
    
    getTree in interface Query
  - isMeasureOrExplainEnabled
```
public boolean isMeasureOrExplainEnabled()
```
    Specified by:
    
    isMeasureOrExplainEnabled in interface Query
  - getOakPath
```
public java.lang.String getOakPath(java.lang.String path)
```
    Validate the path is syntactically correct, and convert it to an Oak internal path (including namespace remapping if needed).
    
    Parameters:
    
    path - the path
    
    Returns:
    
    the the converted path
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - getSize
```
public long getSize()
```
    Description copied from interface: Query
    
    Get the size if known.
    
    Specified by:
    
    getSize in interface Query
    
    Returns:
    
    the size, or -1 if unknown
  - getSize
```
public long getSize(Result.SizePrecision precision,
                    long max)
```
    Description copied from interface: Query
    
    Get the size if known.
    
    Specified by:
    
    getSize in interface Query
    
    Parameters:
    
    precision - the required precision
    
    max - the maximum nodes read (for an exact size)
    
    Returns:
    
    the size, or -1 if unknown
  - getStatement
```
public java.lang.String getStatement()
```
    Specified by:
    
    getStatement in interface Query
    
    Returns:
    
    the original statement as it was used to construct the object. If not provided the toString() will be used instead.
  - getSettings
```
public QueryEngineSettings getSettings()
```
  - setInternal
```
public void setInternal(boolean isInternal)
```
    Specified by:
    
    setInternal in interface Query
  - getExecutionContext
```
public ExecutionContext getExecutionContext()
```
  - saturatedAdd
```
public static long saturatedAdd(long x,
                                long y)
```
    Add two values, but don't let it overflow or underflow.
    
    Parameters:
    
    x - the first value
    
    y - the second value
    
    Returns:
    
    the sum, or Long.MIN_VALUE for underflow, or Long.MAX_VALUE for overflow
  - buildAlternativeQuery
```
public Query buildAlternativeQuery()
```
    Description copied from interface: Query
    
    Try to convert the query to an alternative form, specially a "union". To avoid any potential error due to state variables perform the conversion before the Query.init().
    
    Specified by:
    
    buildAlternativeQuery in interface Query
    
    Returns:
    
    this if no conversions are possible or a new instance of a Query. Cannot return null.
  - copyOf
```
public Query copyOf()
```
    Description copied from interface: Query
    
    returns a clone of the current object. Will throw an exception in case it's invoked in a non appropriate moment. For example the default QueryImpl cannot be cloned once the Query.init() has been executed.
    
    May return null if not implemented.
    
    Specified by:
    
    copyOf in interface Query
    
    Returns:
    
    a clone of self
  - isInit
```
public boolean isInit()
```
    Specified by:
    
    isInit in interface Query
    
    Returns:
    
    true if the query has been already initialised. false otherwise.
  - isInternal
```
public boolean isInternal()
```
    Specified by:
    
    isInternal in interface Query
    
    Returns:
    
    true if the current query is internal. false otherwise.
  - containsUnfilteredFullTextCondition
```
public boolean containsUnfilteredFullTextCondition()
```
    Description copied from interface: Query
    
    Whether the condition contains a fulltext condition that can not be applied to the filter, for example because it is part of an "or" condition of the form "where a=1 or contains(., 'x')".
    
    Specified by:
    
    containsUnfilteredFullTextCondition in interface Query
    
    Returns:
    
    true if yes

Class QueryImpl

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

JCR_PATH

JCR_SCORE

REP_EXCERPT

REP_FACET

OAK_SCORE_EXPLANATION

REP_SPELLCHECK

REP_SUGGEST

Method Detail

init

getColumns

getConstraint

getOrderings

getSource

bindValue

setLimit

setOffset

setExplain

setMeasure

setDistinct

executeQuery

getRows

isSortedByIndex

getPlan

getIndexCostInfo

getEstimatedCost

prepare

getSelectorIndex

getColumnIndex

getBindVariableValue

getSelectorNames

getBindVariableNames

setTraversalEnabled

getBestSelectorExecutionPlan

setExecutionContext

setOrderings

getNamePathMapper

getTree

isMeasureOrExplainEnabled

getOakPath

toString

getSize

getSize

getStatement

getSettings

setInternal

getExecutionContext

saturatedAdd

buildAlternativeQuery

copyOf

isInit

isInternal

containsUnfilteredFullTextCondition