Package org.optaplanner.core.api.score
Interface ScoreManager<Solution_,Score_ extends Score<Score_>>
-
- Type Parameters:
Solution_
- the solution type, the class with thePlanningSolution
annotationScore_
- the actual score type
- All Known Implementing Classes:
DefaultScoreManager
public interface ScoreManager<Solution_,Score_ extends Score<Score_>>
A stateless service to help calculateScore
,ConstraintMatchTotal
,Indictment
, etc.To create a ScoreManager, use
create(SolverFactory)
.These methods are thread-safe unless explicitly stated otherwise.
-
-
Method Summary
All Methods Static Methods Instance Methods Abstract Methods Modifier and Type Method Description static <Solution_,Score_ extends Score<Score_>>
ScoreManager<Solution_,Score_>create(SolverFactory<Solution_> solverFactory)
Uses aSolverFactory
to build aScoreManager
.static <Solution_,Score_ extends Score<Score_>,ProblemId_>
ScoreManager<Solution_,Score_>create(SolverManager<Solution_,ProblemId_> solverManager)
Uses aSolverManager
to build aScoreManager
.ScoreExplanation<Solution_,Score_>
explainScore(Solution_ solution)
Calculates and retrievesConstraintMatchTotal
s andIndictment
s necessary for describing the quality of a particular solution.String
getSummary(Solution_ solution)
Returns a diagnostic text that explains the solution through theConstraintMatch
API to identify which constraints or planning entities cause that score quality.Score_
updateScore(Solution_ solution)
-
-
-
Method Detail
-
create
static <Solution_,Score_ extends Score<Score_>> ScoreManager<Solution_,Score_> create(SolverFactory<Solution_> solverFactory)
Uses aSolverFactory
to build aScoreManager
.- Type Parameters:
Solution_
- the solution type, the class with thePlanningSolution
annotationScore_
- the actual score type- Parameters:
solverFactory
- never null- Returns:
- never null
-
create
static <Solution_,Score_ extends Score<Score_>,ProblemId_> ScoreManager<Solution_,Score_> create(SolverManager<Solution_,ProblemId_> solverManager)
Uses aSolverManager
to build aScoreManager
.- Type Parameters:
Solution_
- the solution type, the class with thePlanningSolution
annotationScore_
- the actual score typeProblemId_
- the ID type of a submitted problem, such asLong
orUUID
- Parameters:
solverManager
- never null- Returns:
- never null
-
getSummary
String getSummary(Solution_ solution)
Returns a diagnostic text that explains the solution through theConstraintMatch
API to identify which constraints or planning entities cause that score quality. In case of aninfeasible
solution, this can help diagnose the cause of that.Do not parse this string. Instead, to provide this information in a UI or a service, use
explainScore(Object)
to retrieveScoreExplanation.getConstraintMatchTotalMap()
andScoreExplanation.getIndictmentMap()
and convert those into a domain specific API.- Parameters:
solution
- never null- Returns:
- null if
updateScore(Object)
returns null with the same solution - Throws:
IllegalStateException
- when constraint matching is disabled or not supported by the underlying score calculator, such asEasyScoreCalculator
.
-
explainScore
ScoreExplanation<Solution_,Score_> explainScore(Solution_ solution)
Calculates and retrievesConstraintMatchTotal
s andIndictment
s necessary for describing the quality of a particular solution.- Parameters:
solution
- never null- Returns:
- never null
- Throws:
IllegalStateException
- when constraint matching is disabled or not supported by the underlying score calculator, such asEasyScoreCalculator
.
-
-