com.massa.mrules.condition

Class MConditionSet

java.lang.Object

com.massa.mrules.base.AbstractMRulesObject

com.massa.mrules.addon.AbstractAddon

com.massa.mrules.condition.AbstractCondition

com.massa.mrules.condition.MConditionSet

All Implemented Interfaces:

IAddon, IMRulesObject, ICondition, Outable, Serializable, Cloneable, Iterable<ICondition>

@PersistantProperty(property="operator") @PersistantProperty(property="conditions",alias="condition")
public class MConditionSet
extends AbstractCondition
implements Iterable<ICondition>

ICondition implementation allowing to combine sub-IConditions evaluation results and do more complex testings.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static String	CONDSET_ID

Constructor Summary

Constructors

Constructor and Description
MConditionSet()
MConditionSet(boolean not, ILogicalOperator operator, List<ICondition> conditions)
MConditionSet(ILogicalOperator operator, List<ICondition> conditions) not defaults to false.

Method Summary

Modifier and Type	Method and Description
MConditionSet	clone() Clones the Addon.
ICondition	combine(ILogicalOperator otherOperator, ICondition otherCondition) Combines the current condition set with the other condition using the other operator.
void	compile(ICompilationContext ctxt) Checks presence of operator and conditions.
List<ICondition>	getConditions()
CostInfo	getEstimatedCost(ICompilationContext ctxt) Estimates the condition complexity, to allow callers to optimize calls.
String	getImplementationId() Unique addon implementation ID.
ILogicalOperator	getOperator()
protected ConditionEquivalence	internalIsEquivalent(ICondition o) Called by AbstractCondition.internalIsEquivalent(ICondition) if the other condition is not an instance of MConditionNot.
boolean	isCacheUsed() Returns false by default.
boolean	isConstantValue() Tells if this condition returns a constant result for all executions.
Iterator<ICondition>	iterator()
void	optimize(ICompilationContext ctxt) Optimizes conditions order inside this set, depending on their estimated cost, except if operator prevents it.
protected boolean	pEquals(AbstractCondition o) Tests equality on other parameters than "not".
protected boolean	pEvaluate(IExecutionContext ctxt)
protected int	pHashCode() Computes hashCode on other parameters than "not".
protected void	pToString(OuterWithLevel outer) Finishes toString output.
void	setConditions(List<ICondition> conditions)
void	setOperator(ILogicalOperator operator)

Methods inherited from class com.massa.mrules.condition.AbstractCondition

combineToNewSet, equals, evaluate, hashCode, isEquivalent, isNot, isShouldBeWrappedToConstantValue, setNot, toString

Methods inherited from class com.massa.mrules.addon.AbstractAddon

getInternalCacheIdentifier, isInternalCacheIdentifierNeeded, resetCachedData, setInternalCacheIdentifier, toString, wasRegistered

Methods inherited from class com.massa.mrules.base.AbstractMRulesObject

getDebugInfo, getDescription, getName, setDebugInfo, setDescription, setName

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from interface com.massa.mrules.addon.IAddon

getInternalCacheIdentifier, isInternalCacheIdentifierNeeded, resetCachedData, setInternalCacheIdentifier, wasRegistered

Methods inherited from interface com.massa.mrules.base.IMRulesObject

getDebugInfo, getDescription, getName, setDebugInfo, setDescription, setName

Field Detail

CONDSET_ID

public static final String CONDSET_ID

See Also:

Constant Field Values

Constructor Detail

MConditionSet

public MConditionSet()

MConditionSet

public MConditionSet(ILogicalOperator operator,
                     List<ICondition> conditions)

not defaults to false.

MConditionSet

public MConditionSet(boolean not,
                     ILogicalOperator operator,
                     List<ICondition> conditions)

Method Detail

compile

public void compile(ICompilationContext ctxt)
             throws MRuleValidationException

Checks presence of operator and conditions. Calls validate on operator and conditions.

Specified by:

compile in interface ICondition

Throws:

MRuleValidationException - if validation problem detected.

See Also:

ICondition.compile(ICompilationContext)

optimize

public void optimize(ICompilationContext ctxt)
              throws MRuleValidationException

Optimizes conditions order inside this set, depending on their estimated cost, except if operator prevents it.

Specified by:

optimize in interface IAddon

Overrides:

optimize in class AbstractAddon

Throws:

MRuleValidationException

getEstimatedCost

public CostInfo getEstimatedCost(ICompilationContext ctxt)
                          throws MRuleValidationException

Description copied from interface: ICondition

Estimates the condition complexity, to allow callers to optimize calls. Calls to this method should be done on a compiled condition, so that all information is available to compute complexity.
Calls to non-compiled instance may return non-accurate results.

Specified by:

getEstimatedCost in interface ICondition

Throws:

MRuleValidationException - if validation problem detected.

isConstantValue

public boolean isConstantValue()

Description copied from interface: ICondition

Tells if this condition returns a constant result for all executions.

Specified by:

isConstantValue in interface ICondition

pEvaluate

protected boolean pEvaluate(IExecutionContext ctxt)
                     throws MConditionEvaluationException

Specified by:

pEvaluate in class AbstractCondition

Throws:

MConditionEvaluationException

See Also:

ICondition.evaluate(IExecutionContext)

getImplementationId

public String getImplementationId()

Description copied from interface: IAddon

Unique addon implementation ID. In case of conflict, an Class Initialization error will be raised.

Specified by:

getImplementationId in interface IAddon

isCacheUsed

public boolean isCacheUsed()

Description copied from class: AbstractAddon

Returns false by default.

Specified by:

isCacheUsed in interface IAddon

Overrides:

isCacheUsed in class AbstractAddon

internalIsEquivalent

protected ConditionEquivalence internalIsEquivalent(ICondition o)

Description copied from class: AbstractCondition

Called by AbstractCondition.internalIsEquivalent(ICondition) if the other condition is not an instance of MConditionNot.

Specified by:

internalIsEquivalent in class AbstractCondition

combine

public ICondition combine(ILogicalOperator otherOperator,
                          ICondition otherCondition)

Combines the current condition set with the other condition using the other operator.
If possible, the current set will be enriched with the condition. If not, a new set will be returned.
if the provided condition is a set, it could be merged into the current one if possible.

Specified by:

combine in interface ICondition

Overrides:

combine in class AbstractCondition

Parameters:

otherCondition - condition to combine with

otherOperator - operator to be used

Returns:

result of combination. can be the current instance or a new one depending of the parameters.

pToString

protected void pToString(OuterWithLevel outer)
                  throws IOException

Description copied from class: AbstractCondition

Finishes toString output.

Specified by:

pToString in class AbstractCondition

Throws:

IOException

clone

public MConditionSet clone()

Description copied from interface: IAddon

Clones the Addon.
The general contract is that the clone of a compiled Addon is still compiled.

Specified by:

clone in interface IAddon

Specified by:

clone in interface IMRulesObject

Specified by:

clone in interface ICondition

Overrides:

clone in class AbstractCondition

pEquals

protected boolean pEquals(AbstractCondition o)

Description copied from class: AbstractCondition

Tests equality on other parameters than "not".

Specified by:

pEquals in class AbstractCondition

pHashCode

protected int pHashCode()

Description copied from class: AbstractCondition

Computes hashCode on other parameters than "not".

Specified by:

pHashCode in class AbstractCondition

iterator

public Iterator<ICondition> iterator()

Specified by:

iterator in interface Iterable<ICondition>

getOperator

public ILogicalOperator getOperator()

setOperator

public void setOperator(ILogicalOperator operator)

getConditions

public List<ICondition> getConditions()

setConditions

public void setConditions(List<ICondition> conditions)