Package org.optaplanner.core.api.domain.entity

Annotation Type PlanningEntity

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

Specifies that the class is a planning entity. Each planning entity must have at least 1 PlanningVariable property.

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

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
Class<? extends Comparator>	difficultyComparatorClass	Allows a collection of planning entities to be sorted by difficulty.
Class<? extends SelectionSorterWeightFactory>	difficultyWeightFactoryClass	The SelectionSorterWeightFactory alternative for difficultyComparatorClass().
Class<? extends SelectionFilter>	movableEntitySelectionFilter	Deprecated. in favor of pinningFilter().
Class<? extends PinningFilter>	pinningFilter	A pinned planning entity is never changed during planning, this is useful in repeated planning use cases (such as continuous planning and real-time planning).

Element Detail

movableEntitySelectionFilter

@Deprecated
Class<? extends SelectionFilter> movableEntitySelectionFilter

Deprecated.

in favor of pinningFilter().

A pinned planning entity is never changed during planning, this is useful in repeated planning use cases (such as continuous planning and real-time planning).

This applies to all the planning variables of this planning entity. To pin individual variables, see https://issues.redhat.com/browse/PLANNER-124

The method SelectionFilter.accept(ScoreDirector, Object) returns false if the selection entity is pinned and it returns true if the selection entity is movable

Returns:

PlanningEntity.NullMovableEntitySelectionFilter when it is null (workaround for annotation limitation)

Default:

org.optaplanner.core.api.domain.entity.PlanningEntity.NullMovableEntitySelectionFilter.class

pinningFilter

Class<? extends PinningFilter> pinningFilter

A pinned planning entity is never changed during planning, this is useful in repeated planning use cases (such as continuous planning and real-time planning).

This applies to all the planning variables of this planning entity. To pin individual variables, see https://issues.redhat.com/browse/PLANNER-124

The method PinningFilter.accept(Object, Object) returns false if the selection entity is pinned and it returns true if the selection entity is movable

Returns:

PlanningEntity.NullPinningFilter when it is null (workaround for annotation limitation)

Default:

org.optaplanner.core.api.domain.entity.PlanningEntity.NullPinningFilter.class

difficultyComparatorClass

Class<? extends Comparator> difficultyComparatorClass

Allows a collection of planning entities to be sorted by difficulty. A difficultyWeight estimates how hard is to plan a certain PlanningEntity. Some algorithms benefit from planning on more difficult planning entities first/last or from focusing on them.

The Comparator should sort in ascending difficulty (even though many optimization algorithms will reverse it). For example: sorting 3 processes on difficultly based on their RAM usage requirement: Process B (1GB RAM), Process A (2GB RAM), Process C (7GB RAM),

Do not use together with difficultyWeightFactoryClass().

Returns:

PlanningEntity.NullDifficultyComparator when it is null (workaround for annotation limitation)

See Also:

difficultyWeightFactoryClass()

Default:

org.optaplanner.core.api.domain.entity.PlanningEntity.NullDifficultyComparator.class

difficultyWeightFactoryClass

Class<? extends SelectionSorterWeightFactory> difficultyWeightFactoryClass

The SelectionSorterWeightFactory alternative for difficultyComparatorClass().

Do not use together with difficultyComparatorClass().

Returns:

PlanningEntity.NullDifficultyWeightFactory when it is null (workaround for annotation limitation)

See Also:

difficultyComparatorClass()

Default:

org.optaplanner.core.api.domain.entity.PlanningEntity.NullDifficultyWeightFactory.class