org.optaplanner.core.impl.score.director
Class AbstractScoreDirector<F extends AbstractScoreDirectorFactory>
java.lang.Object
org.optaplanner.core.impl.score.director.AbstractScoreDirector<F>
- All Implemented Interfaces:
- ScoreDirector
- Direct Known Subclasses:
- DroolsScoreDirector, IncrementalScoreDirector, SimpleScoreDirector
public abstract class AbstractScoreDirector<F extends AbstractScoreDirectorFactory>
- extends Object
- implements ScoreDirector
Abstract superclass for ScoreDirector
.
Implementation note: Extending classes should follow these guidelines:
- before* method: last statement should be a call to the super method
- after* method: first statement should be a call to the super method
- See Also:
ScoreDirector
Method Summary |
void |
afterAllVariablesChanged(Object entity)
|
void |
afterEntityAdded(Object entity)
|
void |
afterEntityRemoved(Object entity)
|
void |
afterProblemFactAdded(Object problemFact)
|
void |
afterProblemFactChanged(Object problemFact)
|
void |
afterProblemFactRemoved(Object problemFact)
|
void |
afterVariableChanged(Object entity,
String variableName)
|
protected void |
appendLegacyConstraintOccurrences(StringBuilder analysis,
ScoreDirector corruptedScoreDirector,
ScoreDirector uncorruptedScoreDirector)
Deprecated. |
void |
assertExpectedWorkingScore(Score expectedWorkingScore,
Object completedAction)
Asserts that if the Score is calculated for the current workingSolution
in the current ScoreDirector (with possibly incremental calculation residue),
it is equal to the parameter expectedWorkingScore . |
void |
assertWorkingScoreFromScratch(Score workingScore,
Object completedAction)
Asserts that if the Score is calculated for the current workingSolution
in a fresh ScoreDirector (with no incremental calculation residue),
it is equal to the parameter workingScore . |
void |
beforeAllVariablesChanged(Object entity)
|
void |
beforeEntityAdded(Object entity)
|
void |
beforeEntityRemoved(Object entity)
|
void |
beforeProblemFactAdded(Object problemFact)
|
void |
beforeProblemFactChanged(Object problemFact)
|
void |
beforeProblemFactRemoved(Object problemFact)
|
void |
beforeVariableChanged(Object entity,
String variableName)
|
protected String |
buildScoreCorruptionAnalysis(ScoreDirector uncorruptedScoreDirector)
|
AbstractScoreDirector |
clone()
Clones this ScoreDirector and its workingSolution . |
Solution |
cloneWorkingSolution()
|
int |
countWorkingSolutionUninitializedVariables()
|
void |
dispose()
Needs to be called after use because some implementations needs to clean up their resources. |
long |
getCalculateCount()
|
Collection<ConstraintMatchTotal> |
getConstraintMatchTotals()
|
ScoreDefinition |
getScoreDefinition()
|
F |
getScoreDirectorFactory()
|
SolutionDescriptor |
getSolutionDescriptor()
|
Object |
getTrailingEntity(PlanningVariableDescriptor chainedVariableDescriptor,
Object planningValue)
|
int |
getWorkingEntityCount()
|
List<Object> |
getWorkingEntityList()
|
Solution |
getWorkingSolution()
The Solution that is used to calculate the Score . |
int |
getWorkingValueCount()
|
boolean |
isConstraintMatchEnabled()
|
boolean |
isWorkingSolutionInitialized()
|
protected void |
setCalculatedScore(Score score)
|
void |
setWorkingSolution(Solution workingSolution)
The workingSolution must never be the same instance as the bestSolution ,
it should be a (un)changed clone. |
String |
toString()
|
logger
protected final transient org.slf4j.Logger logger
scoreDirectorFactory
protected final F extends AbstractScoreDirectorFactory scoreDirectorFactory
constraintMatchEnabledPreference
protected boolean constraintMatchEnabledPreference
hasChainedVariables
protected boolean hasChainedVariables
chainedVariableToTrailingEntitiesMap
protected Map<PlanningVariableDescriptor,Map<Object,Set<Object>>> chainedVariableToTrailingEntitiesMap
workingSolution
protected Solution workingSolution
calculateCount
protected long calculateCount
AbstractScoreDirector
protected AbstractScoreDirector(F scoreDirectorFactory)
getScoreDirectorFactory
public F getScoreDirectorFactory()
- Specified by:
getScoreDirectorFactory
in interface ScoreDirector
- Returns:
- never null
getSolutionDescriptor
public SolutionDescriptor getSolutionDescriptor()
- Specified by:
getSolutionDescriptor
in interface ScoreDirector
- Returns:
- never null
getScoreDefinition
public ScoreDefinition getScoreDefinition()
- Specified by:
getScoreDefinition
in interface ScoreDirector
- Returns:
- never null
getWorkingSolution
public Solution getWorkingSolution()
- Description copied from interface:
ScoreDirector
- The
Solution
that is used to calculate the Score
.
Because a Score
is best calculated incrementally (by delta's),
the ScoreDirector
needs to be notified when it's workingSolution
changes.
If the Solution
has been changed since ScoreDirector.calculateScore()
has been called,
the Solution.getScore()
of this Solution
won't be correct.
- Specified by:
getWorkingSolution
in interface ScoreDirector
- Returns:
- never null
getCalculateCount
public long getCalculateCount()
- Specified by:
getCalculateCount
in interface ScoreDirector
- Returns:
- at least 0L
setWorkingSolution
public void setWorkingSolution(Solution workingSolution)
- Description copied from interface:
ScoreDirector
- The
workingSolution
must never be the same instance as the bestSolution
,
it should be a (un)changed clone.
- Specified by:
setWorkingSolution
in interface ScoreDirector
- Parameters:
workingSolution
- never null
cloneWorkingSolution
public Solution cloneWorkingSolution()
- Specified by:
cloneWorkingSolution
in interface ScoreDirector
beforeEntityAdded
public void beforeEntityAdded(Object entity)
- Specified by:
beforeEntityAdded
in interface ScoreDirector
afterEntityAdded
public void afterEntityAdded(Object entity)
- Specified by:
afterEntityAdded
in interface ScoreDirector
beforeAllVariablesChanged
public void beforeAllVariablesChanged(Object entity)
- Specified by:
beforeAllVariablesChanged
in interface ScoreDirector
afterAllVariablesChanged
public void afterAllVariablesChanged(Object entity)
- Specified by:
afterAllVariablesChanged
in interface ScoreDirector
beforeVariableChanged
public void beforeVariableChanged(Object entity,
String variableName)
- Specified by:
beforeVariableChanged
in interface ScoreDirector
afterVariableChanged
public void afterVariableChanged(Object entity,
String variableName)
- Specified by:
afterVariableChanged
in interface ScoreDirector
beforeEntityRemoved
public void beforeEntityRemoved(Object entity)
- Specified by:
beforeEntityRemoved
in interface ScoreDirector
afterEntityRemoved
public void afterEntityRemoved(Object entity)
- Specified by:
afterEntityRemoved
in interface ScoreDirector
beforeProblemFactAdded
public void beforeProblemFactAdded(Object problemFact)
- Specified by:
beforeProblemFactAdded
in interface ScoreDirector
afterProblemFactAdded
public void afterProblemFactAdded(Object problemFact)
- Specified by:
afterProblemFactAdded
in interface ScoreDirector
beforeProblemFactChanged
public void beforeProblemFactChanged(Object problemFact)
- Specified by:
beforeProblemFactChanged
in interface ScoreDirector
afterProblemFactChanged
public void afterProblemFactChanged(Object problemFact)
- Specified by:
afterProblemFactChanged
in interface ScoreDirector
beforeProblemFactRemoved
public void beforeProblemFactRemoved(Object problemFact)
- Specified by:
beforeProblemFactRemoved
in interface ScoreDirector
afterProblemFactRemoved
public void afterProblemFactRemoved(Object problemFact)
- Specified by:
afterProblemFactRemoved
in interface ScoreDirector
getWorkingEntityCount
public int getWorkingEntityCount()
- Specified by:
getWorkingEntityCount
in interface ScoreDirector
- Returns:
- >= 0
getWorkingEntityList
public List<Object> getWorkingEntityList()
- Specified by:
getWorkingEntityList
in interface ScoreDirector
- Returns:
- never null: an empty list if there are none
getWorkingValueCount
public int getWorkingValueCount()
- Specified by:
getWorkingValueCount
in interface ScoreDirector
- Returns:
- >= 0
countWorkingSolutionUninitializedVariables
public int countWorkingSolutionUninitializedVariables()
- Specified by:
countWorkingSolutionUninitializedVariables
in interface ScoreDirector
isWorkingSolutionInitialized
public boolean isWorkingSolutionInitialized()
- Specified by:
isWorkingSolutionInitialized
in interface ScoreDirector
- Returns:
- true if the
workingSolution
is initialized
setCalculatedScore
protected void setCalculatedScore(Score score)
isConstraintMatchEnabled
public boolean isConstraintMatchEnabled()
- Specified by:
isConstraintMatchEnabled
in interface ScoreDirector
- Returns:
- true if
ScoreDirector.getConstraintMatchTotals()
can be called
getConstraintMatchTotals
public Collection<ConstraintMatchTotal> getConstraintMatchTotals()
- Specified by:
getConstraintMatchTotals
in interface ScoreDirector
- Returns:
- never null
clone
public AbstractScoreDirector clone()
- Description copied from interface:
ScoreDirector
- Clones this
ScoreDirector
and its workingSolution
.
Use ScoreDirector.getWorkingSolution()
to retrieve the workingSolution
of that clone.
This is heavy method, because it usually breaks incremental score calculation. Use it sparingly.
Therefore it's best to clone lazily by delaying the clone call as long as possible.
- Specified by:
clone
in interface ScoreDirector
- Overrides:
clone
in class Object
- Returns:
- never null
getTrailingEntity
public Object getTrailingEntity(PlanningVariableDescriptor chainedVariableDescriptor,
Object planningValue)
- Specified by:
getTrailingEntity
in interface ScoreDirector
- Parameters:
chainedVariableDescriptor
- never null, must be PlanningVariableDescriptor.isChained()
true
and known to the SolutionDescriptor
planningValue
- sometimes null
- Returns:
- never null
assertExpectedWorkingScore
public void assertExpectedWorkingScore(Score expectedWorkingScore,
Object completedAction)
- Description copied from interface:
ScoreDirector
- Asserts that if the
Score
is calculated for the current workingSolution
in the current ScoreDirector
(with possibly incremental calculation residue),
it is equal to the parameter expectedWorkingScore
.
Used to assert that skipping ScoreDirector.calculateScore()
(when the score is otherwise determined) is correct,
- Specified by:
assertExpectedWorkingScore
in interface ScoreDirector
- Parameters:
expectedWorkingScore
- never nullcompletedAction
- sometimes null, when assertion fails then the completedAction's Object.toString()
is included in the exception message
assertWorkingScoreFromScratch
public void assertWorkingScoreFromScratch(Score workingScore,
Object completedAction)
- Description copied from interface:
ScoreDirector
- Asserts that if the
Score
is calculated for the current workingSolution
in a fresh ScoreDirector
(with no incremental calculation residue),
it is equal to the parameter workingScore
.
Furthermore, if the assert fails, a score corruption analysis might be included in the exception message.
- Specified by:
assertWorkingScoreFromScratch
in interface ScoreDirector
- Parameters:
workingScore
- never nullcompletedAction
- sometimes null, when assertion fails then the completedAction's Object.toString()
is included* in the exception message- See Also:
ScoreDirectorFactory.assertScoreFromScratch(Solution)
buildScoreCorruptionAnalysis
protected String buildScoreCorruptionAnalysis(ScoreDirector uncorruptedScoreDirector)
- Parameters:
uncorruptedScoreDirector
- never null
- Returns:
- never null
appendLegacyConstraintOccurrences
@Deprecated
protected void appendLegacyConstraintOccurrences(StringBuilder analysis,
ScoreDirector corruptedScoreDirector,
ScoreDirector uncorruptedScoreDirector)
- Deprecated.
dispose
public void dispose()
- Description copied from interface:
ScoreDirector
- Needs to be called after use because some implementations needs to clean up their resources.
- Specified by:
dispose
in interface ScoreDirector
toString
public String toString()
- Overrides:
toString
in class Object
Copyright © 2006-2013 JBoss by Red Hat. All Rights Reserved.