com.apple.foundationdb.record.query.plan.temp.properties

Class CreatesDuplicatesProperty

java.lang.Object

com.apple.foundationdb.record.query.plan.temp.properties.CreatesDuplicatesProperty

All Implemented Interfaces:

PlannerProperty<Boolean>

@API(value=EXPERIMENTAL)
public class CreatesDuplicatesProperty
extends Object
implements PlannerProperty<Boolean>

A property that determines whether the expression may produce duplicate entries. If the given expression is a RelationalPlannerExpression, this will return whether the expression might produce multiple instances of the same record. If the given expression is a KeyExpression, then this will return whether the expression might return multiple results for the same record.

Method Summary

Modifier and Type	Method and Description
static boolean	evaluate(ExpressionRef<? extends PlannerExpression> ref, PlanContext context)
static Boolean	evaluate(PlannerExpression expression, PlanContext context)
static boolean	evaluate(RelationalPlannerExpression expression, PlanContext context)
Boolean	evaluateAtExpression(PlannerExpression expression, List<Boolean> childResults) Evaluate the property at the given expression, using the results of evaluating the property at its children.
Boolean	evaluateAtRef(ExpressionRef<? extends PlannerExpression> ref, List<Boolean> memberResults) Evaluate the property at the given reference, using the results of evaluating the property at its members.
boolean	shouldVisit(ExpressionRef<? extends PlannerExpression> ref) Return whether the property should visit the subtree rooted at the given expression.
boolean	shouldVisit(PlannerExpression expression) Return whether the property should visit the subtree rooted at the given expression.

Methods inherited from class java.lang.Object

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

Method Detail

shouldVisit

public boolean shouldVisit(@Nonnull
                           PlannerExpression expression)

Description copied from interface: PlannerProperty

Return whether the property should visit the subtree rooted at the given expression. Called on nodes in the expression tree in visit pre-order of the depth-first traversal of the tree. That is, as each node is visited for the first time, shouldVisit() is called on that node. If shouldVisit() returns false, then PlannerProperty.evaluateAtExpression(PlannerExpression, List) will not be called on the given expression.

Specified by:

shouldVisit in interface PlannerProperty<Boolean>

Parameters:

expression - the planner expression to visit

Returns:

true if the children of expression should be visited and false if they should not be visited

shouldVisit

public boolean shouldVisit(@Nonnull
                           ExpressionRef<? extends PlannerExpression> ref)

Description copied from interface: PlannerProperty

Return whether the property should visit the subtree rooted at the given expression. Called on nodes in the expression tree in visit pre-order of the depth-first traversal of the tree. That is, as each node is visited for the first time, shouldVisit() is called on that node. If shouldVisit() returns false, then PlannerProperty.evaluateAtRef(ExpressionRef, List) will not be called on the given expression.

Specified by:

shouldVisit in interface PlannerProperty<Boolean>

Parameters:

ref - the expression reference to visit

Returns:

true if the members of ref should be visited and false if they should not be visited

evaluateAtExpression

@Nonnull
public Boolean evaluateAtExpression(@Nonnull
                                             PlannerExpression expression,
                                             @Nonnull
                                             List<Boolean> childResults)

Description copied from interface: PlannerProperty

Evaluate the property at the given expression, using the results of evaluating the property at its children. Called on nodes in the expression tree in visit post-order of the depth-first traversal of the tree. That is, as each node is visited for the last time (after all of its children have been visited, if applicable), evaluateAtExpression() is called on that node.

Specified by:

evaluateAtExpression in interface PlannerProperty<Boolean>

Parameters:

expression - the cursor to visit

childResults - the results of the property evaluated at the children of expression

Returns:

the value of property at the given expression

evaluateAtRef

@Nonnull
public Boolean evaluateAtRef(@Nonnull
                                      ExpressionRef<? extends PlannerExpression> ref,
                                      @Nonnull
                                      List<Boolean> memberResults)

Description copied from interface: PlannerProperty

Evaluate the property at the given reference, using the results of evaluating the property at its members. Called on nodes in the expression tree in visit post-order of the depth-first traversal of the tree. That is, as each node is visited for the last time (after all of its children have been visited, if applicable), evaluateAtRef() is called on that node.

Specified by:

evaluateAtRef in interface PlannerProperty<Boolean>

Parameters:

ref - the expression reference to visit

memberResults - the results of the property evaluated at the members of ref

Returns:

the value of property at the given reference

evaluate

public static boolean evaluate(@Nonnull
                               ExpressionRef<? extends PlannerExpression> ref,
                               @Nonnull
                               PlanContext context)

evaluate

@Nullable
public static Boolean evaluate(@Nonnull
                                         PlannerExpression expression,
                                         @Nonnull
                                         PlanContext context)

evaluate

public static boolean evaluate(@Nonnull
                               RelationalPlannerExpression expression,
                               @Nonnull
                               PlanContext context)