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:
- Cloneable, ScoreDirector
- Direct Known Subclasses:
- DroolsScoreDirector, IncrementalScoreDirector, SimpleScoreDirector
public abstract class AbstractScoreDirector<F extends AbstractScoreDirectorFactory>
- extends Object
- implements ScoreDirector, Cloneable
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 |
afterEntityAdded(Object entity)
|
void |
afterEntityAdded(PlanningEntityDescriptor entityDescriptor,
Object entity)
|
void |
afterEntityRemoved(Object entity)
|
void |
afterEntityRemoved(PlanningEntityDescriptor entityDescriptor,
Object entity)
|
void |
afterProblemFactAdded(Object problemFact)
|
void |
afterProblemFactChanged(Object problemFact)
|
void |
afterProblemFactRemoved(Object problemFact)
|
void |
afterShadowVariableChanged(Object entity,
String variableName)
|
void |
afterVariableChanged(Object entity,
String variableName)
|
void |
afterVariableChanged(PlanningVariableDescriptor variableDescriptor,
Object entity)
|
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 |
beforeEntityAdded(Object entity)
|
void |
beforeEntityAdded(PlanningEntityDescriptor entityDescriptor,
Object entity)
|
void |
beforeEntityRemoved(Object entity)
|
void |
beforeEntityRemoved(PlanningEntityDescriptor entityDescriptor,
Object entity)
|
void |
beforeProblemFactAdded(Object problemFact)
|
void |
beforeProblemFactChanged(Object problemFact)
|
void |
beforeProblemFactRemoved(Object problemFact)
|
void |
beforeShadowVariableChanged(Object entity,
String variableName)
|
void |
beforeVariableChanged(Object entity,
String variableName)
|
void |
beforeVariableChanged(PlanningVariableDescriptor variableDescriptor,
Object entity)
|
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
trailingEntityMapSupport
protected TrailingEntityMapSupport trailingEntityMapSupport
variableListenerSupport
protected PlanningVariableListenerSupport variableListenerSupport
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
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
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
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
beforeEntityAdded
public final void beforeEntityAdded(Object entity)
- Specified by:
beforeEntityAdded
in interface ScoreDirector
afterEntityAdded
public final void afterEntityAdded(Object entity)
- Specified by:
afterEntityAdded
in interface ScoreDirector
beforeVariableChanged
public final void beforeVariableChanged(Object entity,
String variableName)
- Specified by:
beforeVariableChanged
in interface ScoreDirector
afterVariableChanged
public final void afterVariableChanged(Object entity,
String variableName)
- Specified by:
afterVariableChanged
in interface ScoreDirector
beforeEntityRemoved
public final void beforeEntityRemoved(Object entity)
- Specified by:
beforeEntityRemoved
in interface ScoreDirector
afterEntityRemoved
public final void afterEntityRemoved(Object entity)
- Specified by:
afterEntityRemoved
in interface ScoreDirector
beforeEntityAdded
public void beforeEntityAdded(PlanningEntityDescriptor entityDescriptor,
Object entity)
afterEntityAdded
public void afterEntityAdded(PlanningEntityDescriptor entityDescriptor,
Object entity)
beforeVariableChanged
public void beforeVariableChanged(PlanningVariableDescriptor variableDescriptor,
Object entity)
afterVariableChanged
public void afterVariableChanged(PlanningVariableDescriptor variableDescriptor,
Object entity)
beforeShadowVariableChanged
public void beforeShadowVariableChanged(Object entity,
String variableName)
afterShadowVariableChanged
public void afterShadowVariableChanged(Object entity,
String variableName)
beforeEntityRemoved
public void beforeEntityRemoved(PlanningEntityDescriptor entityDescriptor,
Object entity)
afterEntityRemoved
public void afterEntityRemoved(PlanningEntityDescriptor entityDescriptor,
Object entity)
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
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.
toString
public String toString()
- Overrides:
toString
in class Object
Copyright © 2006-2013 JBoss by Red Hat. All Rights Reserved.