public interface Move
Solution
.
Usually the move holds a direct reference to each planning entity of the Solution
that it will change when doMove(ScoreDirector)
is called.
On that change it should also notify the ScoreDirector
accordingly.
A Move should implement Object.equals(Object)
and Object.hashCode()
.Modifier and Type | Method and Description |
---|---|
Move |
createUndoMove(ScoreDirector scoreDirector)
Called before the move is done, so the move can be evaluated and then be undone
without resulting into a permanent change in the solution.
|
void |
doMove(ScoreDirector scoreDirector)
Does the Move and updates the
Solution and its ScoreDirector accordingly. |
Collection<? extends Object> |
getPlanningEntities()
Returns all planning entities that are being changed by this move.
|
Collection<? extends Object> |
getPlanningValues()
Returns all planning values that entities are being assigned to by this move.
|
boolean |
isMoveDoable(ScoreDirector scoreDirector)
Called before a move is evaluated to decide whether the move can be done and evaluated.
|
boolean isMoveDoable(ScoreDirector scoreDirector)
Solution
.MoveSelector
or MoveListFactory
, this is not needed as the Solver
will do it for you.scoreDirector
- the ScoreDirector
not yet modified by the move.Move createUndoMove(ScoreDirector scoreDirector)
scoreDirector
- the ScoreDirector
not yet modified by the move.void doMove(ScoreDirector scoreDirector)
Solution
and its ScoreDirector
accordingly.
When the Solution
is modified, the ScoreDirector
should be correctly notified,
otherwise later calculated Score
s can be corrupted.scoreDirector
- never null, the ScoreDirector
that needs to get notified of the changes.Collection<? extends Object> getPlanningEntities()
AcceptorConfig.AcceptorType#PLANNING_ENTITY_TABU
.
Duplicates entries in the returned Collection
are best avoided.
The returned Collection
is recommended to be in a stable order.
For example: use List
or LinkedHashSet
, but not HashSet
.Collection<? extends Object> getPlanningValues()
AcceptorConfig.AcceptorType#PLANNING_VALUE_TABU
.
Duplicates entries in the returned Collection
are best avoided.
The returned Collection
is recommended to be in a stable order.
For example: use List
or LinkedHashSet
, but not HashSet
.Copyright © 2006-2014 JBoss by Red Hat. All Rights Reserved.