Package org.drools.core.common

Class TupleStartEqualsConstraint

java.lang.Object

org.drools.core.common.TupleStartEqualsConstraint

All Implemented Interfaces:

Externalizable, Serializable, Cloneable, BetaNodeFieldConstraint, Constraint, RuleComponent

public class TupleStartEqualsConstraint
extends Object
implements BetaNodeFieldConstraint

Checks if one tuple is the start subtuple of other tuple. For instance, if we have two tuples: T1 = [ a, b, c ] T2 = [ a, b, c, d, e] This constraint will evaluate to true as T1 is the starting subtuple of T2. On the other hand, if we have: T1 = [ a, c, b ] T2 = [ a, b, c, d, e ] This constraint will evaluate to false, as T1 is not the starting subtuple of T2. Besides having the same elements, the order is different. This constraint is used when joining subnetworks back into the main network.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	TupleStartEqualsConstraint.TupleStartEqualsConstraintContextEntry

Nested classes/interfaces inherited from interface org.drools.core.spi.Constraint

Constraint.ConstraintType

Constructor Summary

Constructors

Constructor	Description
TupleStartEqualsConstraint()

Method Summary

Modifier and Type	Method	Description
TupleStartEqualsConstraint	clone()	Clones the constraint
BetaNodeFieldConstraint	cloneIfInUse()	Clone this constraints only if it is already used by a different node, otherwise returns this
ContextEntry	createContextEntry()
boolean	equals(Object object)
static TupleStartEqualsConstraint	getInstance()
Declaration[]	getRequiredDeclarations()	Returns all the declarations required by the given constraint implementation.
Constraint.ConstraintType	getType()	Returns the type of the constraint, either ALPHA, BETA or UNKNOWN
int	hashCode()
boolean	isAllowedCachedLeft(ContextEntry context, InternalFactHandle handle)
boolean	isAllowedCachedRight(Tuple tuple, ContextEntry context)
boolean	isTemporal()	Returns true in case this constraint is a temporal constraint
void	readExternal(ObjectInput in)
void	replaceDeclaration(Declaration oldDecl, Declaration newDecl)	When a rule contains multiple logical branches, i.e., makes use of 'OR' CE, it is required to clone patterns and declarations for each logical branch.
String	toString()
void	writeExternal(ObjectOutput out)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.drools.core.spi.Constraint

addPackageNames, equals, getListenedPropertyMask, getPackageNames, mergeEvaluationContext, registerEvaluationContext

Constructor Detail

TupleStartEqualsConstraint

public TupleStartEqualsConstraint()

Method Detail

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
                         ClassNotFoundException

Specified by:

readExternal in interface Externalizable

Throws:

IOException

ClassNotFoundException

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException

Specified by:

writeExternal in interface Externalizable

Throws:

IOException

getInstance

public static TupleStartEqualsConstraint getInstance()

getRequiredDeclarations

public Declaration[] getRequiredDeclarations()

Description copied from interface: Constraint

Returns all the declarations required by the given constraint implementation.

Specified by:

getRequiredDeclarations in interface Constraint

Returns:

replaceDeclaration

public void replaceDeclaration(Declaration oldDecl,
                               Declaration newDecl)

Description copied from interface: Constraint

When a rule contains multiple logical branches, i.e., makes use of 'OR' CE, it is required to clone patterns and declarations for each logical branch. Since this is done at ReteOO build type, when constraints were already created, eventually some constraints need to update their references to the declarations.

Specified by:

replaceDeclaration in interface Constraint

isTemporal

public boolean isTemporal()

Description copied from interface: Constraint

Returns true in case this constraint is a temporal constraint

Specified by:

isTemporal in interface Constraint

Returns:

createContextEntry

public ContextEntry createContextEntry()

Specified by:

createContextEntry in interface BetaNodeFieldConstraint

isAllowedCachedLeft

public boolean isAllowedCachedLeft(ContextEntry context,
                                   InternalFactHandle handle)

Specified by:

isAllowedCachedLeft in interface BetaNodeFieldConstraint

isAllowedCachedRight

public boolean isAllowedCachedRight(Tuple tuple,
                                    ContextEntry context)

Specified by:

isAllowedCachedRight in interface BetaNodeFieldConstraint

toString

public String toString()

Overrides:

toString in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object object)

Overrides:

equals in class Object

clone

public TupleStartEqualsConstraint clone()

Description copied from interface: Constraint

Clones the constraint

Specified by:

clone in interface Constraint

Overrides:

clone in class Object

Returns:

getType

public Constraint.ConstraintType getType()

Description copied from interface: Constraint

Returns the type of the constraint, either ALPHA, BETA or UNKNOWN

Specified by:

getType in interface Constraint

Returns:

cloneIfInUse

public BetaNodeFieldConstraint cloneIfInUse()

Description copied from interface: BetaNodeFieldConstraint

Clone this constraints only if it is already used by a different node, otherwise returns this

Specified by:

cloneIfInUse in interface BetaNodeFieldConstraint