org.optaplanner.core.api.solver.event

Class BestSolutionChangedEvent<Solution_ extends Solution>

java.lang.Object

java.util.EventObject

org.optaplanner.core.api.solver.event.BestSolutionChangedEvent<Solution_>

All Implemented Interfaces:

Serializable

public class BestSolutionChangedEvent<Solution_ extends Solution>
extends EventObject

Delivered when the best Solution changes during solving. Delivered in the solver thread (which is the thread that calls Solver.solve(Solution).

See Also:

Serialized Form

Field Summary

Fields inherited from class java.util.EventObject

source

Constructor Summary

Constructors

Constructor and Description
BestSolutionChangedEvent(Solver<Solution_> solver, long timeMillisSpent, Solution_ newBestSolution, int newUninitializedVariableCount)

Method Summary

Methods

Modifier and Type	Method and Description
Solution_	getNewBestSolution() Note that: In real-time planning, not all ProblemFactChanges might be processed: check isEveryProblemFactChangeProcessed().
long	getTimeMillisSpent()
boolean	isEveryProblemFactChangeProcessed()
boolean	isNewBestSolutionInitialized()

Methods inherited from class java.util.EventObject

getSource, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

BestSolutionChangedEvent

public BestSolutionChangedEvent(Solver<Solution_> solver,
                        long timeMillisSpent,
                        Solution_ newBestSolution,
                        int newUninitializedVariableCount)

Parameters:

solver - never null

timeMillisSpent - >= 0L

newBestSolution - never null

newUninitializedVariableCount - >= 0

Method Detail

getTimeMillisSpent

public long getTimeMillisSpent()

Returns:

>= 0, the amount of millis spent since the Solver started until getNewBestSolution() was found

getNewBestSolution

public Solution_ getNewBestSolution()

Note that:

• In real-time planning, not all ProblemFactChanges might be processed: check isEveryProblemFactChangeProcessed().
• this Solution might be uninitialized: check isNewBestSolutionInitialized().
• this Solution might be infeasible: check FeasibilityScore.isFeasible().

Returns:

never null

isEveryProblemFactChangeProcessed

public boolean isEveryProblemFactChangeProcessed()

Returns:

As defined by Solver.isEveryProblemFactChangeProcessed()

See Also:

Solver.isEveryProblemFactChangeProcessed()

isNewBestSolutionInitialized

public boolean isNewBestSolutionInitialized()

Returns:

true if all the planning entities have planning variables that are initialized.