Package ai.timefold.solver.core.impl.domain.valuerange.descriptor

Class FromSolutionPropertyValueRangeDescriptor<Solution_>

java.lang.Object

ai.timefold.solver.core.impl.domain.valuerange.descriptor.AbstractValueRangeDescriptor<Solution_>

ai.timefold.solver.core.impl.domain.valuerange.descriptor.AbstractFromPropertyValueRangeDescriptor<Solution_>

ai.timefold.solver.core.impl.domain.valuerange.descriptor.FromSolutionPropertyValueRangeDescriptor<Solution_>

Type Parameters:

Solution_ - the solution type, the class with the PlanningSolution annotation

All Implemented Interfaces:

ValueRangeDescriptor<Solution_>

@NullMarked
public final class FromSolutionPropertyValueRangeDescriptor<Solution_>
extends AbstractFromPropertyValueRangeDescriptor<Solution_>

Field Summary

Fields inherited from class ai.timefold.solver.core.impl.domain.valuerange.descriptor.AbstractFromPropertyValueRangeDescriptor

arrayWrapping, collectionWrapping, countable, memberAccessor

Fields inherited from class ai.timefold.solver.core.impl.domain.valuerange.descriptor.AbstractValueRangeDescriptor

variableDescriptor

Constructor Summary

Constructors

Constructor	Description
FromSolutionPropertyValueRangeDescriptor(int ordinal, GenuineVariableDescriptor<Solution_> variableDescriptor, MemberAccessor memberAccessor)

Method Summary

Modifier and Type	Method	Description
boolean	canExtractValueRangeFromSolution()	Returns true if the value range is defined at the solution level and can be directly extracted from the solution; otherwise, it returns false, as the value range can only be extracted or computed from the entities.
<T> ValueRange<T>	extractAllValues(Solution_ solution)	Extracts the ValueRange from the solution or, if the value range is defined at the entity level, extracts a composite ValueRange from all entities in the solution.
<T> ValueRange<T>	extractValuesFromEntity(Solution_ solution, Object entity)	Extracts the ValueRange from the planning entity.

Methods inherited from class ai.timefold.solver.core.impl.domain.valuerange.descriptor.AbstractFromPropertyValueRangeDescriptor

isCountable, isGenericTypeImmutable, processValueRange, readValueRange, readValueRangeForSolution, transformArrayToList

Methods inherited from class ai.timefold.solver.core.impl.domain.valuerange.descriptor.AbstractValueRangeDescriptor

getOrdinal, getVariableDescriptor, mightContainEntity, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface ai.timefold.solver.core.impl.domain.valuerange.descriptor.ValueRangeDescriptor

acceptsNullInValueRange

Constructor Details

FromSolutionPropertyValueRangeDescriptor

public FromSolutionPropertyValueRangeDescriptor(int ordinal,
 GenuineVariableDescriptor<Solution_> variableDescriptor,
 MemberAccessor memberAccessor)

Method Details

extractAllValues

public <T> ValueRange<T> extractAllValues(Solution_ solution)

Description copied from interface: ValueRangeDescriptor

Extracts the ValueRange from the solution or, if the value range is defined at the entity level, extracts a composite ValueRange from all entities in the solution.

The method should not be invoked directly by selectors or other components of the solver. The ValueRangeManager.getFromSolution(ValueRangeDescriptor, Object) and ValueRangeManager.getFromEntity(ValueRangeDescriptor, Object) serve as the single source of truth for managing value ranges and should be used by outer components.

Calling this method outside ValueRangeManager may lead to unnecessary recomputation of ranges.

extractValuesFromEntity

public <T> ValueRange<T> extractValuesFromEntity(Solution_ solution,
 Object entity)

Description copied from interface: ValueRangeDescriptor

Extracts the ValueRange from the planning entity. If the value range is defined at the solution level instead, this method reads the value range from there.

The method should not be invoked directly by selectors or other components of the solver. The ValueRangeManager.getFromSolution(ValueRangeDescriptor, Object) and ValueRangeManager.getFromEntity(ValueRangeDescriptor, Object) serve as the single source of truth for managing value ranges and should be used by outer components.

Calling this method outside ValueRangeManager may lead to unnecessary recomputation of ranges.

canExtractValueRangeFromSolution

public boolean canExtractValueRangeFromSolution()

Description copied from interface: ValueRangeDescriptor

Returns true if the value range is defined at the solution level and can be directly extracted from the solution; otherwise, it returns false, as the value range can only be extracted or computed from the entities.