org.apache.jackrabbit.oak.query.ast

Class JoinImpl

java.lang.Object

org.apache.jackrabbit.oak.query.ast.SourceImpl

org.apache.jackrabbit.oak.query.ast.JoinImpl

public class JoinImpl
extends SourceImpl

A join. This object contains the left hand side source, the right hand side source, the join type, and the join condition.

Field Summary

Fields

Modifier and Type	Field and Description
protected QueryImpl	query

Constructor Summary

Constructors

Constructor and Description
JoinImpl(SourceImpl left, SourceImpl right, JoinType joinType, JoinConditionImpl joinCondition)

Method Summary

Modifier and Type	Method and Description
void	addJoinCondition(JoinConditionImpl joinCondition, boolean forThisSelector) Add the join condition (the ON ...
protected PropertyValue	convertValueToType(PropertyValue v, PropertyValue targetType)
org.apache.jackrabbit.oak.query.ast.AstElement	copyOf()
Filter	createFilter(boolean preparing) !Test purpose only! this creates a filter for the given query
void	execute(NodeState rootState) Execute the query.
java.lang.String	getIndexCostInfo(NodeState rootState) Get the index cost as a JSON string.
java.util.List<JoinConditionImpl>	getInnerJoinConditions() Get the list of inner join conditions.
java.util.ArrayList<SourceImpl>	getInnerJoinSelectors() Get all sources that are joined via inner join.
JoinConditionImpl	getJoinCondition()
SourceImpl	getLeft()
protected java.lang.String	getLocalPath(java.lang.String path) Calculate the session local path (the path excluding the workspace name) if possible.
java.lang.String	getPlan(NodeState rootState) Get the query plan.
SourceImpl	getRight()
SelectorImpl	getSelector(java.lang.String selectorName) Get the selector with the given name, or null if not found.
long	getSize(NodeState rootState, Result.SizePrecision precision, long max) Get the size if known.
boolean	isOuterJoinRightHandSide() Whether any selector is the outer-join right hand side.
boolean	next() Go to the next node for the given source.
protected java.lang.String	normalizePath(java.lang.String path) Validate and normalize the path.
protected java.lang.String	normalizePropertyName(java.lang.String propertyName) Normalize the property name (including namespace remapping).
ExecutionPlan	prepare() Prepare executing the query (recursively).
void	prepare(ExecutionPlan p) Re-apply a previously prepared plan.
protected java.lang.String	protect(java.lang.Object expression)
protected java.lang.String	quote(java.lang.String pathOrName)
protected java.lang.String	quoteJson(java.lang.String string)
void	setOuterJoin(boolean outerJoinLeftHandSide, boolean outerJoinRightHandSide) Set whether this source is the left hand side or right hand side of a left outer join.
void	setQuery(QueryImpl query)
void	setQueryConstraint(ConstraintImpl queryConstraint) Set the complete constraint of the query (the WHERE ...
java.lang.String	toString()
void	unprepare() Undo a prepare.

Methods inherited from class org.apache.jackrabbit.oak.query.ast.SourceImpl

getExistingSelector

Methods inherited from class java.lang.Object

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

Field Detail

query

protected QueryImpl query

Constructor Detail

JoinImpl

public JoinImpl(SourceImpl left,
                SourceImpl right,
                JoinType joinType,
                JoinConditionImpl joinCondition)

Method Detail

getInnerJoinSelectors

public java.util.ArrayList<SourceImpl> getInnerJoinSelectors()

Description copied from class: SourceImpl

Get all sources that are joined via inner join. (These can be swapped.)

Specified by:

getInnerJoinSelectors in class SourceImpl

Returns:

the list of selectors (sorted from left to right)

getInnerJoinConditions

public java.util.List<JoinConditionImpl> getInnerJoinConditions()

Description copied from class: SourceImpl

Get the list of inner join conditions. (These match the inner join selectors.)

Overrides:

getInnerJoinConditions in class SourceImpl

Returns:

the list of join conditions

getJoinCondition

public JoinConditionImpl getJoinCondition()

getLeft

public SourceImpl getLeft()

getRight

public SourceImpl getRight()

getPlan

public java.lang.String getPlan(NodeState rootState)

Description copied from class: SourceImpl

Get the query plan.

Specified by:

getPlan in class SourceImpl

Parameters:

rootState - the root

Returns:

the query plan

getIndexCostInfo

public java.lang.String getIndexCostInfo(NodeState rootState)

Description copied from class: SourceImpl

Get the index cost as a JSON string.

Specified by:

getIndexCostInfo in class SourceImpl

Parameters:

rootState - the root

Returns:

the cost

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

unprepare

public void unprepare()

Description copied from class: SourceImpl

Undo a prepare.

Specified by:

unprepare in class SourceImpl

prepare

public void prepare(ExecutionPlan p)

Description copied from class: SourceImpl

Re-apply a previously prepared plan. This will also 're-wire' the selectors with the join constraints

Specified by:

prepare in class SourceImpl

Parameters:

p - the plan to use

prepare

public ExecutionPlan prepare()

Description copied from class: SourceImpl

Prepare executing the query (recursively). This will 'wire' the selectors with the join constraints, and decide which index to use.

Specified by:

prepare in class SourceImpl

Returns:

the execution plan

getSelector

public SelectorImpl getSelector(java.lang.String selectorName)

Description copied from class: SourceImpl

Get the selector with the given name, or null if not found.

Specified by:

getSelector in class SourceImpl

Parameters:

selectorName - the selector name

Returns:

the selector, or null

execute

public void execute(NodeState rootState)

Description copied from class: SourceImpl

Execute the query. The current node is set to before the first row.

Specified by:

execute in class SourceImpl

Parameters:

rootState - root state of the given revision

createFilter

public Filter createFilter(boolean preparing)

Description copied from class: SourceImpl

!Test purpose only! this creates a filter for the given query

Specified by:

createFilter in class SourceImpl

Parameters:

preparing - whether this this the prepare phase

Returns:

a new filter

setQueryConstraint

public void setQueryConstraint(ConstraintImpl queryConstraint)

Description copied from class: SourceImpl

Set the complete constraint of the query (the WHERE ... condition).

Specified by:

setQueryConstraint in class SourceImpl

Parameters:

queryConstraint - the constraint

setOuterJoin

public void setOuterJoin(boolean outerJoinLeftHandSide,
                         boolean outerJoinRightHandSide)

Description copied from class: SourceImpl

Set whether this source is the left hand side or right hand side of a left outer join.

Specified by:

setOuterJoin in class SourceImpl

Parameters:

outerJoinLeftHandSide - true if yes

outerJoinRightHandSide - true if yes

addJoinCondition

public void addJoinCondition(JoinConditionImpl joinCondition,
                             boolean forThisSelector)

Description copied from class: SourceImpl

Add the join condition (the ON ... condition).

Specified by:

addJoinCondition in class SourceImpl

Parameters:

joinCondition - the join condition

forThisSelector - if set, the join condition can only be evaluated when all previous selectors are executed.

next

public boolean next()

Description copied from class: SourceImpl

Go to the next node for the given source. This will also filter the result for the right node type if required.

Specified by:

next in class SourceImpl

Returns:

true if there is a next row

isOuterJoinRightHandSide

public boolean isOuterJoinRightHandSide()

Description copied from class: SourceImpl

Whether any selector is the outer-join right hand side.

Specified by:

isOuterJoinRightHandSide in class SourceImpl

Returns:

true if there is any

getSize

public long getSize(NodeState rootState,
                    Result.SizePrecision precision,
                    long max)

Description copied from class: SourceImpl

Get the size if known.

Specified by:

getSize in class SourceImpl

Parameters:

rootState - the root node state (to initialize the cursor, if needed)

precision - the required precision

max - the maximum nodes read (for an exact size)

Returns:

the size, or -1 if unknown

copyOf

public org.apache.jackrabbit.oak.query.ast.AstElement copyOf()

Returns:

a clone of self. Default implementation in AstElement returns same reference to this.

protect

protected java.lang.String protect(java.lang.Object expression)

quote

protected java.lang.String quote(java.lang.String pathOrName)

quoteJson

protected java.lang.String quoteJson(java.lang.String string)

setQuery

public void setQuery(QueryImpl query)

normalizePropertyName

protected java.lang.String normalizePropertyName(java.lang.String propertyName)

Normalize the property name (including namespace remapping). Asterisks are kept.

Parameters:

propertyName - the property name to normalize

Returns:

the normalized (oak-) property name

normalizePath

protected java.lang.String normalizePath(java.lang.String path)

Validate and normalize the path.

Parameters:

path - the path to validate

Returns:

the validated and normalized path

convertValueToType

protected PropertyValue convertValueToType(PropertyValue v,
                                           PropertyValue targetType)

getLocalPath

protected java.lang.String getLocalPath(java.lang.String path)

Calculate the session local path (the path excluding the workspace name) if possible.

Parameters:

path - the absolute path

Returns:

the session local path, or null if not within this workspace