Solution_
- the solution type, the class with the PlanningSolution
annotationpublic class CompositeMove<Solution_> extends Object implements Move<Solution_>
Warning: each of moves in the moveList must not rely on the effect of a previous move in the moveList to create its undoMove correctly.
Move
Constructor and Description |
---|
CompositeMove(Move<Solution_>... moves) |
Modifier and Type | Method and Description |
---|---|
static <Solution_,Move_ extends Move<Solution_>> |
buildMove(List<Move_> moveList) |
static <Solution_,Move_ extends Move<Solution_>> |
buildMove(Move_... moves) |
CompositeMove<Solution_> |
doMove(ScoreDirector<Solution_> scoreDirector)
Does the move (which indirectly affects the
ScoreDirector.getWorkingSolution() ). |
boolean |
equals(Object o) |
Move<Solution_>[] |
getMoves() |
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.
|
String |
getSimpleMoveTypeDescription()
Describes the move type for statistical purposes.
|
int |
hashCode() |
boolean |
isMoveDoable(ScoreDirector<Solution_> scoreDirector)
Called before a move is evaluated to decide whether the move can be done and evaluated.
|
String |
toString() |
@SafeVarargs public CompositeMove(Move<Solution_>... moves)
moves
- never null, never empty. Do not modify this argument afterwards or this CompositeMove corrupts.@SafeVarargs public static <Solution_,Move_ extends Move<Solution_>> Move<Solution_> buildMove(Move_... moves)
moves
- never null, sometimes empty. Do not modify this argument afterwards or the CompositeMove corrupts.public static <Solution_,Move_ extends Move<Solution_>> Move<Solution_> buildMove(List<Move_> moveList)
moveList
- never null, sometimes emptypublic boolean isMoveDoable(ScoreDirector<Solution_> scoreDirector)
Move
PlanningSolution
.It is recommended to keep this method implementation simple: do not use it in an attempt to satisfy normal hard and soft constraints.
Although you could also filter out non-doable moves in for example the MoveSelector
or MoveListFactory
, this is not needed as the Solver
will do it for you.
isMoveDoable
in interface Move<Solution_>
scoreDirector
- the ScoreDirector
not yet modified by the move.public CompositeMove<Solution_> doMove(ScoreDirector<Solution_> scoreDirector)
Move
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 Score
s 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.
doMove
in interface Move<Solution_>
scoreDirector
- never null, the ScoreDirector
that needs to get notified of the changespublic String getSimpleMoveTypeDescription()
Move
The format is not formalized. Never parse the String
returned by this method.
getSimpleMoveTypeDescription
in interface Move<Solution_>
public Collection<? extends Object> getPlanningEntities()
Move
AcceptorType.ENTITY_TABU
.
Duplicate 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
.
getPlanningEntities
in interface Move<Solution_>
public Collection<? extends Object> getPlanningValues()
Move
AcceptorType.VALUE_TABU
.
Duplicate 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
.
getPlanningValues
in interface Move<Solution_>
Copyright © 2006–2017 JBoss by Red Hat. All rights reserved.