Package org.optaplanner.core.api.domain.solution

Annotation Interface PlanningSolution

@Target(TYPE)
@Retention(RUNTIME)
public @interface PlanningSolution

Specifies that the class is a planning solution. A solution represents a problem and a possible solution of that problem. A possible solution does not need to be optimal or even feasible. A solution's planning variables might not be initialized (especially when delivered as a problem).

A solution is mutable. For scalability reasons (to facilitate incremental score calculation), the same solution instance (called the working solution per move thread) is continuously modified. It's cloned to recall the best solution.

Each planning solution must have exactly 1 PlanningScore property.

Each planning solution must have at least 1 PlanningEntityCollectionProperty or PlanningEntityProperty property.

Each planning solution is recommended to have 1 ConstraintConfigurationProvider property too.

Each planning solution used with Drools score calculation must have at least 1 ProblemFactCollectionProperty or ProblemFactProperty property.

The class should have a public no-arg constructor, so it can be cloned (unless the solutionCloner() is specified).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	PlanningSolution.NullSolutionCloner	Workaround for annotation limitation in solutionCloner().

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
AutoDiscoverMemberType	autoDiscoverMemberType	Enable reflection through the members of the class to automatically assume PlanningScore, PlanningEntityCollectionProperty, PlanningEntityProperty, ProblemFactCollectionProperty, ProblemFactProperty and ConstraintConfigurationProvider annotations based on the member type.
LookUpStrategyType	lookUpStrategyType
Class<? extends SolutionCloner>	solutionCloner	Overrides the default SolutionCloner to implement a custom PlanningSolution cloning implementation.

Element Details

autoDiscoverMemberType

AutoDiscoverMemberType autoDiscoverMemberType

Enable reflection through the members of the class to automatically assume PlanningScore, PlanningEntityCollectionProperty, PlanningEntityProperty, ProblemFactCollectionProperty, ProblemFactProperty and ConstraintConfigurationProvider annotations based on the member type.

Returns:

never null

Default:

NONE

solutionCloner

Class<? extends SolutionCloner> solutionCloner

Overrides the default SolutionCloner to implement a custom PlanningSolution cloning implementation.

If this is not specified, then the default reflection-based SolutionCloner is used, so you don't have to worry about it.

Returns:

PlanningSolution.NullSolutionCloner when it is null (workaround for annotation limitation)

Default:

org.optaplanner.core.api.domain.solution.PlanningSolution.NullSolutionCloner.class

lookUpStrategyType

LookUpStrategyType lookUpStrategyType

Returns:

never null

Default:

PLANNING_ID_OR_NONE