Package com.espertech.esper.common.internal.epl.expression.agg.base

Class ExprAggregateNodeBase

java.lang.Object

com.espertech.esper.common.internal.epl.expression.core.ExprNodeBase

com.espertech.esper.common.internal.epl.expression.agg.base.ExprAggregateNodeBase

All Implemented Interfaces:

ExprAggregateNode, ExprEvaluator, ExprForge, ExprForgeInstrumentable, ExprNode, ExprNodeRenderable, ExprValidator

Direct Known Subclasses:

ExprAggMultiFunctionCountMinSketchNode, ExprAggMultiFunctionLinearAccessNode, ExprAggMultiFunctionSortedMinMaxByNode, ExprAvedevNode, ExprAvgNode, ExprCountEverNode, ExprCountNode, ExprFirstLastEverNode, ExprLeavingAggNode, ExprMedianNode, ExprMinMaxAggrNode, ExprNthAggNode, ExprPlugInAggNode, ExprPlugInMultiFunctionAggNode, ExprRateAggNode, ExprStddevNode, ExprSumNode

public abstract class ExprAggregateNodeBase
extends ExprNodeBase
implements ExprEvaluator, ExprAggregateNode, ExprForgeInstrumentable

Base expression node that represents an aggregation function such as 'sum' or 'count'.

In terms of validation each concrete aggregation node must implement it's own validation.

In terms of evaluation this base class will ask the assigned AggregationResultFuture for the current state, using a column number assigned to the node.

Concrete subclasses must supply an aggregation state prototype node that reflects each group's (there may be group-by critera) current aggregation state.

Field Summary

Fields

Modifier and Type	Field	Description
protected CodegenFieldName	aggregationResultFutureMemberName
protected int	column
protected boolean	isDistinct	Indicator for whether the aggregation is distinct - i.e.
protected ExprAggregateLocalGroupByDesc	optionalAggregateLocalGroupByDesc
protected ExprNode	optionalFilter
protected ExprNode[]	positionalParams

Fields inherited from interface com.espertech.esper.common.internal.epl.expression.core.ExprEvaluator

EPTYPE, EPTYPEARRAY

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ExprAggregateNodeBase(boolean distinct)	Ctor.

Method Summary

Modifier and Type	Method	Description
final boolean	equalsNode(ExprNode node, boolean ignoreStreamPrefix)	Return true if a expression node semantically equals the current node, or false if not.
protected abstract boolean	equalsNodeAggregateMethodOnly(ExprAggregateNode node)	Return true if a expression aggregate node semantically equals the current node, or false if not.
final Object	evaluate(EventBean[] events, boolean isNewData, ExprEvaluatorContext exprEvaluatorContext)	Evaluate event tuple and return result.
CodegenExpression	evaluateCodegen(EPTypeClass requiredType, CodegenMethodScope parent, ExprForgeCodegenSymbol exprSymbol, CodegenClassScope codegenClassScope)
CodegenExpression	evaluateCodegenUninstrumented(EPTypeClass requiredType, CodegenMethodScope parent, ExprForgeCodegenSymbol exprSymbol, CodegenClassScope codegenClassScope)
CodegenExpression	getAggFuture(CodegenClassScope codegenClassScope)
abstract String	getAggregationFunctionName()	Returns the aggregation function name for representation in a generate expression string.
int	getColumn()
EPType	getEvaluationType()
ExprEvaluator	getExprEvaluator()
AggregationForgeFactory	getFactory()	Returns the aggregation state factory for use in grouping aggregation states per group-by keys.
ExprForge	getForge()
ExprForgeConstantType	getForgeConstantType()
ExprNode	getForgeRenderable()
ExprNode	getOptionalFilter()
ExprAggregateLocalGroupByDesc	getOptionalLocalGroupBy()
ExprNode[]	getPositionalParams()
ExprPrecedenceEnum	getPrecedence()	Returns precedence.
boolean	isConstantResult()
boolean	isDistinct()	Returns true if the aggregation node is only aggregatig distinct values, or false if aggregating all values.
protected boolean	isExprTextWildcardWhenNoParams()
protected abstract boolean	isFilterExpressionAsLastParameter()
protected ExprValidationException	makeExceptionExpectedParamNum(int lower, int upper)
void	setColumn(int column)
void	toPrecedenceFreeEPL(StringWriter writer, ExprNodeRenderableFlags flags)
ExprNode	validate(ExprValidationContext validationContext)
protected abstract AggregationForgeFactory	validateAggregationChild(ExprValidationContext validationContext)	Gives the aggregation node a chance to validate the sub-expression types.
void	validateFilter(ExprNode filterEvaluator)
protected final EPTypeClass	validateNumericChildAllowFilter(boolean hasFilter)
void	validatePositionals(ExprValidationContext validationContext)

Methods inherited from class com.espertech.esper.common.internal.epl.expression.core.ExprNodeBase

accept, accept, acceptChildnodes, addChildNode, addChildNodes, addChildNodeToFront, checkValidated, checkValidatedException, getChildNodes, replaceUnlistedChildNode, setChildNode, setChildNodes, toEPL

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.espertech.esper.common.internal.epl.expression.core.ExprNode

accept, accept, acceptChildnodes, addChildNode, addChildNodes, getChildNodes, replaceUnlistedChildNode, setChildNode, setChildNodes

Methods inherited from interface com.espertech.esper.common.internal.epl.expression.core.ExprNodeRenderable

toEPL

Field Details

column

protected int column

optionalAggregateLocalGroupByDesc

protected ExprAggregateLocalGroupByDesc optionalAggregateLocalGroupByDesc

optionalFilter

protected ExprNode optionalFilter

positionalParams

protected ExprNode[] positionalParams

aggregationResultFutureMemberName

protected CodegenFieldName aggregationResultFutureMemberName

isDistinct

protected boolean isDistinct

Indicator for whether the aggregation is distinct - i.e. only unique values are considered.

Constructor Details

ExprAggregateNodeBase

protected ExprAggregateNodeBase(boolean distinct)

Ctor.

Parameters:

distinct - - sets the flag indicatating whether only unique values should be aggregated

Method Details

getAggregationFunctionName

public abstract String getAggregationFunctionName()

Returns the aggregation function name for representation in a generate expression string.

Returns:

aggregation function name

isFilterExpressionAsLastParameter

protected abstract boolean isFilterExpressionAsLastParameter()

equalsNodeAggregateMethodOnly

protected abstract boolean equalsNodeAggregateMethodOnly(ExprAggregateNode node)

Return true if a expression aggregate node semantically equals the current node, or false if not.

For use by the equalsNode implementation which compares the distinct flag.

Parameters:

node - to compare to

Returns:

true if semantically equal, or false if not equals

validateAggregationChild

protected abstract AggregationForgeFactory validateAggregationChild(ExprValidationContext validationContext)
                                                             throws ExprValidationException

Gives the aggregation node a chance to validate the sub-expression types.

Parameters:

validationContext - validation information

Returns:

aggregation function factory to use

Throws:

ExprValidationException - when expression validation failed

getForgeConstantType

public ExprForgeConstantType getForgeConstantType()

Specified by:

getForgeConstantType in interface ExprForge

getPositionalParams

public ExprNode[] getPositionalParams()

Specified by:

getPositionalParams in interface ExprAggregateNode

getExprEvaluator

public ExprEvaluator getExprEvaluator()

Specified by:

getExprEvaluator in interface ExprForge

isConstantResult

public boolean isConstantResult()

getForgeRenderable

public ExprNode getForgeRenderable()

Specified by:

getForgeRenderable in interface ExprForge

validate

public ExprNode validate(ExprValidationContext validationContext)
                  throws ExprValidationException

Specified by:

validate in interface ExprValidator

Throws:

ExprValidationException

validatePositionals

public void validatePositionals(ExprValidationContext validationContext)
                         throws ExprValidationException

Specified by:

validatePositionals in interface ExprAggregateNode

Throws:

ExprValidationException

getFactory

public AggregationForgeFactory getFactory()

Returns the aggregation state factory for use in grouping aggregation states per group-by keys.

Specified by:

getFactory in interface ExprAggregateNode

Returns:

prototype aggregation state as a factory for aggregation states per group-by key value

setColumn

public void setColumn(int column)

Specified by:

setColumn in interface ExprAggregateNode

evaluate

public final Object evaluate(EventBean[] events,
 boolean isNewData,
 ExprEvaluatorContext exprEvaluatorContext)

Description copied from interface: ExprEvaluator

Evaluate event tuple and return result.

Specified by:

evaluate in interface ExprEvaluator

Parameters:

events - - event tuple

isNewData - - indicates whether we are dealing with new data (istream) or old data (rstream)

exprEvaluatorContext - context for expression evaluation

Returns:

evaluation result, a boolean value for OR/AND-type evalution nodes.

evaluateCodegenUninstrumented

public CodegenExpression evaluateCodegenUninstrumented(EPTypeClass requiredType,
 CodegenMethodScope parent,
 ExprForgeCodegenSymbol exprSymbol,
 CodegenClassScope codegenClassScope)

Specified by:

evaluateCodegenUninstrumented in interface ExprForgeInstrumentable

evaluateCodegen

public CodegenExpression evaluateCodegen(EPTypeClass requiredType,
 CodegenMethodScope parent,
 ExprForgeCodegenSymbol exprSymbol,
 CodegenClassScope codegenClassScope)

Specified by:

evaluateCodegen in interface ExprForge

getEvaluationType

public EPType getEvaluationType()

Specified by:

getEvaluationType in interface ExprForge

getForge

public ExprForge getForge()

Specified by:

getForge in interface ExprNode

isDistinct

public boolean isDistinct()

Returns true if the aggregation node is only aggregatig distinct values, or false if aggregating all values.

Specified by:

isDistinct in interface ExprAggregateNode

Returns:

true if 'distinct' keyword was given, false if not

equalsNode

public final boolean equalsNode(ExprNode node,
 boolean ignoreStreamPrefix)

Description copied from interface: ExprNode

Return true if a expression node semantically equals the current node, or false if not.

Concrete implementations should compare the type and any additional information that impact the evaluation of a node.

Specified by:

equalsNode in interface ExprNode

Parameters:

node - to compare to

ignoreStreamPrefix - when the equals-comparison can ignore prefix of event properties

Returns:

true if semantically equal, or false if not equals

getColumn

public int getColumn()

Specified by:

getColumn in interface ExprAggregateNode

validateNumericChildAllowFilter

protected final EPTypeClass validateNumericChildAllowFilter(boolean hasFilter)
                                                     throws ExprValidationException

Throws:

ExprValidationException

makeExceptionExpectedParamNum

protected ExprValidationException makeExceptionExpectedParamNum(int lower,
 int upper)

toPrecedenceFreeEPL

public void toPrecedenceFreeEPL(StringWriter writer,
 ExprNodeRenderableFlags flags)

Specified by:

toPrecedenceFreeEPL in class ExprNodeBase

getPrecedence

public ExprPrecedenceEnum getPrecedence()

Description copied from interface: ExprNode

Returns precedence.

Specified by:

getPrecedence in interface ExprNode

Returns:

precedence

validateFilter

public void validateFilter(ExprNode filterEvaluator)
                    throws ExprValidationException

Throws:

ExprValidationException

getOptionalLocalGroupBy

public ExprAggregateLocalGroupByDesc getOptionalLocalGroupBy()

Specified by:

getOptionalLocalGroupBy in interface ExprAggregateNode

getOptionalFilter

public ExprNode getOptionalFilter()

Specified by:

getOptionalFilter in interface ExprAggregateNode

isExprTextWildcardWhenNoParams

protected boolean isExprTextWildcardWhenNoParams()

getAggFuture

public CodegenExpression getAggFuture(CodegenClassScope codegenClassScope)