Package org.optaplanner.core.impl.domain.variable.inverserelation

Class SingletonListInverseVariableListener<Solution_>

java.lang.Object

org.optaplanner.core.impl.domain.variable.inverserelation.SingletonListInverseVariableListener<Solution_>

All Implemented Interfaces:

Closeable, AutoCloseable, VariableListener<Solution_,Object>, SingletonInverseVariableSupply, Supply

public class SingletonListInverseVariableListener<Solution_>
extends Object
implements VariableListener<Solution_,Object>, SingletonInverseVariableSupply

Field Summary

Fields

Modifier and Type	Field	Description
protected InverseRelationShadowVariableDescriptor<Solution_>	shadowVariableDescriptor
protected ListVariableDescriptor<Solution_>	sourceVariableDescriptor

Constructor Summary

Constructors

Constructor	Description
SingletonListInverseVariableListener(InverseRelationShadowVariableDescriptor<Solution_> shadowVariableDescriptor, ListVariableDescriptor<Solution_> sourceVariableDescriptor)

Method Summary

Modifier and Type	Method	Description
void	afterEntityAdded(ScoreDirector<Solution_> scoreDirector, Object entity)
void	afterEntityRemoved(ScoreDirector<Solution_> scoreDirector, Object entity)
void	afterVariableChanged(ScoreDirector<Solution_> scoreDirector, Object entity)
void	beforeEntityAdded(ScoreDirector<Solution_> scoreDirector, Object entity)
void	beforeEntityRemoved(ScoreDirector<Solution_> scoreDirector, Object entity)
void	beforeVariableChanged(ScoreDirector<Solution_> scoreDirector, Object entity)
Object	getInverseSingleton(Object planningValue)	If entity1.varA = x then the inverse of x is entity1.
protected void	insert(InnerScoreDirector<Solution_,?> scoreDirector, Object entity)
boolean	requiresUniqueEntityEvents()	When set to true, this has a slight performance loss in Planner.
protected void	retract(InnerScoreDirector<Solution_,?> scoreDirector, Object entity)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.optaplanner.core.api.domain.variable.VariableListener

close, resetWorkingSolution

Field Detail

shadowVariableDescriptor

protected final InverseRelationShadowVariableDescriptor<Solution_> shadowVariableDescriptor

sourceVariableDescriptor

protected final ListVariableDescriptor<Solution_> sourceVariableDescriptor

Constructor Detail

SingletonListInverseVariableListener

public SingletonListInverseVariableListener(InverseRelationShadowVariableDescriptor<Solution_> shadowVariableDescriptor,
                                            ListVariableDescriptor<Solution_> sourceVariableDescriptor)

Method Detail

requiresUniqueEntityEvents

public boolean requiresUniqueEntityEvents()

Description copied from interface: VariableListener

When set to true, this has a slight performance loss in Planner. When set to false, it's often easier to make the listener implementation correct and fast.

Specified by:

requiresUniqueEntityEvents in interface VariableListener<Solution_,Object>

Returns:

true to guarantee that each of the before/after methods will only be called once per entity instance per operation type (add, change or remove).

beforeEntityAdded

public void beforeEntityAdded(ScoreDirector<Solution_> scoreDirector,
                              Object entity)

Specified by:

beforeEntityAdded in interface VariableListener<Solution_,Object>

Parameters:

scoreDirector - never null

entity - never null

afterEntityAdded

public void afterEntityAdded(ScoreDirector<Solution_> scoreDirector,
                             Object entity)

Specified by:

afterEntityAdded in interface VariableListener<Solution_,Object>

Parameters:

scoreDirector - never null

entity - never null

beforeVariableChanged

public void beforeVariableChanged(ScoreDirector<Solution_> scoreDirector,
                                  Object entity)

Specified by:

beforeVariableChanged in interface VariableListener<Solution_,Object>

Parameters:

scoreDirector - never null

entity - never null

afterVariableChanged

public void afterVariableChanged(ScoreDirector<Solution_> scoreDirector,
                                 Object entity)

Specified by:

afterVariableChanged in interface VariableListener<Solution_,Object>

Parameters:

scoreDirector - never null

entity - never null

beforeEntityRemoved

public void beforeEntityRemoved(ScoreDirector<Solution_> scoreDirector,
                                Object entity)

Specified by:

beforeEntityRemoved in interface VariableListener<Solution_,Object>

Parameters:

scoreDirector - never null

entity - never null

afterEntityRemoved

public void afterEntityRemoved(ScoreDirector<Solution_> scoreDirector,
                               Object entity)

Specified by:

afterEntityRemoved in interface VariableListener<Solution_,Object>

Parameters:

scoreDirector - never null

entity - never null

insert

protected void insert(InnerScoreDirector<Solution_,?> scoreDirector,
                      Object entity)

retract

protected void retract(InnerScoreDirector<Solution_,?> scoreDirector,
                       Object entity)

getInverseSingleton

public Object getInverseSingleton(Object planningValue)

Description copied from interface: SingletonInverseVariableSupply

If entity1.varA = x then the inverse of x is entity1.

Specified by:

getInverseSingleton in interface SingletonInverseVariableSupply

Parameters:

planningValue - never null

Returns:

sometimes null, an entity for which the planning variable is the planningValue.