Solution_
- the solution type, the class with the PlanningSolution
annotationpublic interface ScoreDirector<Solution_>
working solution
and calculates the Score
for it.Modifier and Type | Method and Description |
---|---|
void |
afterEntityAdded(Object entity) |
void |
afterEntityRemoved(Object entity) |
void |
afterProblemFactAdded(Object problemFact) |
void |
afterProblemFactRemoved(Object problemFact) |
void |
afterProblemPropertyChanged(Object problemFactOrEntity) |
void |
afterVariableChanged(Object entity,
String variableName) |
void |
afterVariableChanged(VariableDescriptor variableDescriptor,
Object entity) |
void |
beforeEntityAdded(Object entity) |
void |
beforeEntityRemoved(Object entity) |
void |
beforeProblemFactAdded(Object problemFact) |
void |
beforeProblemFactRemoved(Object problemFact) |
void |
beforeProblemPropertyChanged(Object problemFactOrEntity) |
void |
beforeVariableChanged(Object entity,
String variableName) |
void |
beforeVariableChanged(VariableDescriptor variableDescriptor,
Object entity) |
Score |
calculateScore()
Calculates the
Score and updates the working solution accordingly. |
void |
changeVariableFacade(VariableDescriptor variableDescriptor,
Object entity,
Object newValue) |
void |
dispose()
Needs to be called after use because some implementations needs to clean up their resources.
|
Map<Object,List<ConstraintMatch>> |
extractIndictmentMap()
Returns an aggregation of all the inverses of
ConstraintMatch.getJustificationList() . |
Collection<ConstraintMatchTotal> |
getConstraintMatchTotals()
Explains the
Score of calculateScore() . |
Solution_ |
getWorkingSolution()
The
PlanningSolution that is used to calculate the Score . |
boolean |
isConstraintMatchEnabled() |
<E> E |
locateWorkingObject(E externalObject)
Translates an entity or fact instance (often from another
Thread or JVM)
to this ScoreDirector 's internal working instance. |
void |
setWorkingSolution(Solution_ workingSolution)
The
working solution must never be the same instance as the
best solution , it should be a (un)changed clone. |
void |
triggerVariableListeners() |
Solution_ getWorkingSolution()
PlanningSolution
that is used to calculate the Score
.
Because a Score
is best calculated incrementally (by deltas),
the ScoreDirector
needs to be notified when its working solution
changes.
If the working solution
has been changed since calculateScore()
was called,
its Score
won't be correct.
void setWorkingSolution(Solution_ workingSolution)
working solution
must never be the same instance as the
best solution
, it should be a (un)changed clone.
Only call this method on a separate ScoreDirector
instance,
built by Solver.getScoreDirectorFactory()
,
not on the one used inside the Solver
itself.
workingSolution
- never nullScore calculateScore()
Score
and updates the working solution
accordingly.Score
of the working solution
boolean isConstraintMatchEnabled()
getConstraintMatchTotals()
can be calledCollection<ConstraintMatchTotal> getConstraintMatchTotals()
Score
of calculateScore()
.IllegalStateException
- if isConstraintMatchEnabled()
returns falseMap<Object,List<ConstraintMatch>> extractIndictmentMap()
ConstraintMatch.getJustificationList()
.
TODO Experimental method because it's calculated from scratch, without delta's. It will probably be renamed at some point.
ConstraintMatch.getJustificationList()
and the value is its ConstraintMatch
IllegalStateException
- if isConstraintMatchEnabled()
returns falsevoid beforeEntityAdded(Object entity)
void afterEntityAdded(Object entity)
void beforeVariableChanged(VariableDescriptor variableDescriptor, Object entity)
void afterVariableChanged(VariableDescriptor variableDescriptor, Object entity)
void changeVariableFacade(VariableDescriptor variableDescriptor, Object entity, Object newValue)
void triggerVariableListeners()
void beforeEntityRemoved(Object entity)
void afterEntityRemoved(Object entity)
void beforeProblemFactAdded(Object problemFact)
void afterProblemFactAdded(Object problemFact)
void beforeProblemPropertyChanged(Object problemFactOrEntity)
void afterProblemPropertyChanged(Object problemFactOrEntity)
void beforeProblemFactRemoved(Object problemFact)
void afterProblemFactRemoved(Object problemFact)
<E> E locateWorkingObject(E externalObject)
Thread
or JVM)
to this ScoreDirector
's internal working instance.
Useful during Move
relocation and in a ProblemFactChange
.
Matching is determined by the LocationStrategyType
on PlanningSolution
.
Matching uses a PlanningId
by default.
E
- the object typeexternalObject
- sometimes nullIllegalArgumentException
- if it cannot be located or if the externalObject's class is not supportedIllegalStateException
- if it cannot be locatedvoid dispose()
Copyright © 2006–2016 JBoss by Red Hat. All rights reserved.