public class FinishedByEvaluatorDefinition extends Object implements EvaluatorDefinition
The implementation of the finishedby
evaluator definition.
The finishedby
evaluator correlates two events and matches when the current event
start timestamp happens before the correlated event start timestamp, but both end timestamps occur at
the same time. This is the symmetrical opposite of finishes
evaluator.
Lets look at an example:
$eventA : EventA( this finishedby $eventB )
The previous pattern will match if and only if the $eventA starts before $eventB starts and finishes at the same time $eventB finishes. In other words:
$eventA.startTimestamp < $eventB.startTimestamp && $eventA.endTimestamp == $eventB.endTimestamp
The finishedby
evaluator accepts one optional parameter. If it is defined, it determines
the maximum distance between the end timestamp of both events in order for the operator to match. Example:
$eventA : EventA( this finishedby[ 5s ] $eventB )Will match if and only if:
$eventA.startTimestamp < $eventB.startTimestamp && abs( $eventA.endTimestamp - $eventB.endTimestamp ) <= 5s
NOTE: it makes no sense to use a negative interval value for the parameter and the engine will raise an exception if that happens.
Modifier and Type | Class and Description |
---|---|
static class |
FinishedByEvaluatorDefinition.FinishedByEvaluator
Implements the 'finishedby' evaluator itself
|
EvaluatorDefinition.Target
Modifier and Type | Field and Description |
---|---|
static Operator |
FINISHED_BY |
protected static String |
finishedByOp |
static Operator |
NOT_FINISHED_BY |
Constructor and Description |
---|
FinishedByEvaluatorDefinition() |
Modifier and Type | Method and Description |
---|---|
Evaluator |
getEvaluator(ValueType type,
Operator operator)
Returns the evaluator instance for the given type and the
defined parameterText
|
Evaluator |
getEvaluator(ValueType type,
Operator operator,
String parameterText)
Returns the evaluator instance for the given type and the
defined parameterText
|
Evaluator |
getEvaluator(ValueType type,
String operatorId,
boolean isNegated,
String parameterText)
Returns the evaluator instance for the given type and the
defined parameterText
|
Evaluator |
getEvaluator(ValueType type,
String operatorId,
boolean isNegated,
String parameterText,
EvaluatorDefinition.Target left,
EvaluatorDefinition.Target right)
Returns the evaluator instance for the given type and the
defined parameterText
|
String[] |
getEvaluatorIds()
Returns the list of identifies this
evaluator implementation supports
|
EvaluatorDefinition.Target |
getTarget()
There are evaluators that operate on *fact* attributes,
evaluators that operate on *fact handle* attributes, and
evaluators that operate on both.
|
boolean |
isNegatable()
My apologies to English speakers if the word "negatable" does not
exist. :)
This method returns true if this evaluator supports negation.
|
void |
readExternal(ObjectInput in) |
boolean |
supportsType(ValueType type)
Returns true in case this evaluator supports operations over values
of that specific type.
|
void |
writeExternal(ObjectOutput out) |
protected static final String finishedByOp
public static Operator FINISHED_BY
public static Operator NOT_FINISHED_BY
public void readExternal(ObjectInput in) throws IOException, ClassNotFoundException
readExternal
in interface Externalizable
IOException
ClassNotFoundException
public void writeExternal(ObjectOutput out) throws IOException
writeExternal
in interface Externalizable
IOException
public Evaluator getEvaluator(ValueType type, Operator operator)
EvaluatorDefinition
type
- the type of the attributes this evaluator will
operate on. This is important because the evaluator
may do optimisations and type coercion based on the
types it is evaluating. It is also possible that
this evaluator does not support a given type.operator
- the operator implemented by the evaluatorpublic Evaluator getEvaluator(ValueType type, Operator operator, String parameterText)
EvaluatorDefinition
type
- the type of the attributes this evaluator will
operate on. This is important because the evaluator
may do optimisations and type coercion based on the
types it is evaluating. It is also possible that
this evaluator does not support a given type.operator
- the operator implemented by the evaluatorparameterText
- some evaluators support parameters and these
parameters are defined as a String that is
parsed by the evaluator itself.public Evaluator getEvaluator(ValueType type, String operatorId, boolean isNegated, String parameterText)
EvaluatorDefinition
type
- the type of the attributes this evaluator will
operate on. This is important because the evaluator
may do optimisations and type coercion based on the
types it is evaluating. It is also possible that
this evaluator does not support a given type.operatorId
- the string identifier of the evaluatorisNegated
- true if the evaluator instance to be returned is
the negated version of the evaluator.parameterText
- some evaluators support parameters and these
parameters are defined as a String that is
parsed by the evaluator itself.public Evaluator getEvaluator(ValueType type, String operatorId, boolean isNegated, String parameterText, EvaluatorDefinition.Target left, EvaluatorDefinition.Target right)
EvaluatorDefinition
type
- the type of the attributes this evaluator will
operate on. This is important because the evaluator
may do optimisations and type coercion based on the
types it is evaluating. It is also possible that
this evaluator does not support a given type.operatorId
- the string identifier of the evaluatorisNegated
- true if the evaluator instance to be returned is
the negated version of the evaluator.parameterText
- some evaluators support parameters and these
parameters are defined as a String that is
parsed by the evaluator itself.left
- the target of the evaluator on the Left side,
i.e., on Rete terms, the previous binding or
the actual value on the right side of the operator.right
- the target of the evaluator on the Right side,
i.e., on Rete terms, the current pattern field.public String[] getEvaluatorIds()
EvaluatorDefinition
public boolean isNegatable()
EvaluatorDefinition
public EvaluatorDefinition.Target getTarget()
EvaluatorDefinition
public boolean supportsType(ValueType type)
EvaluatorDefinition
Copyright © 2001–2016 JBoss by Red Hat. All rights reserved.