Package ai.timefold.solver.core.impl.heuristic.move

Class AbstractSimplifiedMove<Solution_>

java.lang.Object

ai.timefold.solver.core.impl.heuristic.move.AbstractSimplifiedMove<Solution_>

Type Parameters:

Solution_ -

All Implemented Interfaces:

Move<Solution_>

Direct Known Subclasses:

ListAssignMove, ListUnassignMove, NoChangeMove, SubListUnassignMove

public abstract class AbstractSimplifiedMove<Solution_>
extends Object
implements Move<Solution_>

This is an alternative to AbstractMove, allowing to trade some performance for less boilerplate. This move will record all events that change variables, and replay them in the undo move, therefore removing the need to implement the undo move.

Constructor Summary

Constructors

Constructor	Description
AbstractSimplifiedMove()

Method Summary

Modifier and Type	Method	Description
final Move<Solution_>	doMove(ScoreDirector<Solution_> scoreDirector)	Does the move (which indirectly affects the ScoreDirector.getWorkingSolution()).
protected abstract void	doMoveOnGenuineVariables(ScoreDirector<Solution_> scoreDirector)
final void	doMoveOnly(ScoreDirector<Solution_> scoreDirector)	As defined by Move.doMove(ScoreDirector), but does not return an undo move.
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface ai.timefold.solver.core.impl.heuristic.move.Move

getPlanningEntities, getPlanningValues, getSimpleMoveTypeDescription, isMoveDoable, rebase

Constructor Details

AbstractSimplifiedMove

public AbstractSimplifiedMove()

Method Details

doMove

public final Move<Solution_> doMove(ScoreDirector<Solution_> scoreDirector)

Description copied from interface: Move

Does the move (which indirectly affects the ScoreDirector.getWorkingSolution()). When the working solution is modified, the ScoreDirector must be correctly notified (through ScoreDirector.beforeVariableChanged(Object, String) and ScoreDirector.afterVariableChanged(Object, String)), otherwise later calculated Scores will be corrupted.

This method must end with calling ScoreDirector.triggerVariableListeners() to ensure all shadow variables are updated.

This method must return an undo move, so the move can be evaluated and then be undone without resulting into a permanent change in the solution.

Specified by:

doMove in interface Move<Solution_>

Parameters:

scoreDirector - never null, the ScoreDirector that needs to get notified of the changes

Returns:

an undoMove which does the exact opposite of this move

doMoveOnly

public final void doMoveOnly(ScoreDirector<Solution_> scoreDirector)

Description copied from interface: Move

As defined by Move.doMove(ScoreDirector), but does not return an undo move.

Specified by:

doMoveOnly in interface Move<Solution_>

Parameters:

scoreDirector - never null, the ScoreDirector that needs to get notified of the changes

doMoveOnGenuineVariables

protected abstract void doMoveOnGenuineVariables(ScoreDirector<Solution_> scoreDirector)

toString

public String toString()

Overrides:

toString in class Object