Package ai.timefold.solver.core.config.heuristic.selector.value

Class ValueSelectorConfig

java.lang.Object

ai.timefold.solver.core.config.AbstractConfig<Config_>

ai.timefold.solver.core.config.heuristic.selector.SelectorConfig<ValueSelectorConfig>

ai.timefold.solver.core.config.heuristic.selector.value.ValueSelectorConfig

@NullMarked
public class ValueSelectorConfig
extends SelectorConfig<ValueSelectorConfig>

Field Summary

Fields

Modifier and Type	Field	Description
protected @Nullable SelectionCacheType	cacheType
protected @Nullable Class<? extends Comparator>	comparatorClass
protected @Nullable Class<? extends ComparatorFactory>	comparatorFactoryClass
protected @Nullable Class<?>	downcastEntityClass
protected @Nullable Class<? extends SelectionFilter>	filterClass
protected @Nullable String	id
protected @Nullable String	mimicSelectorRef
protected @Nullable NearbySelectionConfig	nearbySelectionConfig
protected @Nullable Class<? extends SelectionProbabilityWeightFactory>	probabilityWeightFactoryClass
protected @Nullable Long	selectedCountLimit
protected @Nullable SelectionOrder	selectionOrder
protected @Nullable Class<? extends SelectionSorter>	sorterClass
protected @Nullable Class<? extends Comparator>	sorterComparatorClass	Deprecated, for removal: This API element is subject to removal in a future version. Deprecated in favor of comparatorClass.
protected @Nullable ValueSorterManner	sorterManner
protected @Nullable SelectionSorterOrder	sorterOrder
protected @Nullable Class<? extends SelectionSorterWeightFactory>	sorterWeightFactoryClass	Deprecated, for removal: This API element is subject to removal in a future version. Deprecated in favor of comparatorFactoryClass.
protected @Nullable String	variableName

Constructor Summary

Constructors

Constructor	Description
ValueSelectorConfig()
ValueSelectorConfig(@Nullable ValueSelectorConfig inheritedConfig)
ValueSelectorConfig(String variableName)

Method Summary

Modifier and Type	Method	Description
ValueSelectorConfig	copyConfig()	Typically implemented by constructing a new instance and calling AbstractConfig.inherit(AbstractConfig) on it.
static <Solution_> SelectionSorter<Solution_,Object>	determineSorter(ValueSorterManner valueSorterManner, GenuineVariableDescriptor<Solution_> variableDescriptor)
@Nullable SelectionCacheType	getCacheType()
@Nullable Class<? extends Comparator>	getComparatorClass()
@Nullable Class<? extends ComparatorFactory>	getComparatorFactoryClass()
@Nullable Class<?>	getDowncastEntityClass()
@Nullable Class<? extends SelectionFilter>	getFilterClass()
@Nullable String	getId()
@Nullable String	getMimicSelectorRef()
@Nullable NearbySelectionConfig	getNearbySelectionConfig()
@Nullable Class<? extends SelectionProbabilityWeightFactory>	getProbabilityWeightFactoryClass()
@Nullable Long	getSelectedCountLimit()
@Nullable SelectionOrder	getSelectionOrder()
@Nullable Class<? extends SelectionSorter>	getSorterClass()
@Nullable Class<? extends Comparator>	getSorterComparatorClass()	Deprecated, for removal: This API element is subject to removal in a future version. Deprecated in favor of getComparatorClass()
@Nullable ValueSorterManner	getSorterManner()
@Nullable SelectionSorterOrder	getSorterOrder()
@Nullable Class<? extends SelectionSorterWeightFactory>	getSorterWeightFactoryClass()	Deprecated, for removal: This API element is subject to removal in a future version. Deprecated in favor of getComparatorFactoryClass()
@Nullable String	getVariableName()
boolean	hasNearbySelectionConfig()	Verifies if the current configuration has any Nearby Selection settings.
static <Solution_> boolean	hasSorter(ValueSorterManner valueSorterManner, GenuineVariableDescriptor<Solution_> variableDescriptor)
ValueSelectorConfig	inherit(ValueSelectorConfig inheritedConfig)	Inherits each property of the inheritedConfig unless that property (or a semantic alternative) is defined by this instance (which overwrites the inherited behaviour).
void	setCacheType(@Nullable SelectionCacheType cacheType)
void	setComparatorClass(@Nullable Class<? extends Comparator> comparatorClass)
void	setComparatorFactoryClass(@Nullable Class<? extends ComparatorFactory> comparatorFactoryClass)
void	setDowncastEntityClass(@Nullable Class<?> downcastEntityClass)
void	setFilterClass(@Nullable Class<? extends SelectionFilter> filterClass)
void	setId(@Nullable String id)
void	setMimicSelectorRef(@Nullable String mimicSelectorRef)
void	setNearbySelectionConfig(@Nullable NearbySelectionConfig nearbySelectionConfig)
void	setProbabilityWeightFactoryClass(@Nullable Class<? extends SelectionProbabilityWeightFactory> probabilityWeightFactoryClass)
void	setSelectedCountLimit(@Nullable Long selectedCountLimit)
void	setSelectionOrder(@Nullable SelectionOrder selectionOrder)
void	setSorterClass(@Nullable Class<? extends SelectionSorter> sorterClass)
void	setSorterComparatorClass(@Nullable Class<? extends Comparator> sorterComparatorClass)	Deprecated, for removal: This API element is subject to removal in a future version. Deprecated in favor of setComparatorClass(Class)
void	setSorterManner(@Nullable ValueSorterManner sorterManner)
void	setSorterOrder(@Nullable SelectionSorterOrder sorterOrder)
void	setSorterWeightFactoryClass(@Nullable Class<? extends SelectionSorterWeightFactory> sorterWeightFactoryClass)	Deprecated, for removal: This API element is subject to removal in a future version. Deprecated in favor of setComparatorFactoryClass(Class)
void	setVariableName(@Nullable String variableName)
String	toString()
void	visitReferencedClasses(Consumer<Class<?>> classVisitor)	Call the class visitor on each (possibly null) Class instance provided to this config by the user (including those provided in child configs).
ValueSelectorConfig	withCacheType(SelectionCacheType cacheType)
ValueSelectorConfig	withComparatorClass(Class<? extends Comparator> comparatorClass)
ValueSelectorConfig	withComparatorFactoryClass(Class<? extends ComparatorFactory> comparatorFactoryClass)
ValueSelectorConfig	withDowncastEntityClass(Class<?> entityClass)
ValueSelectorConfig	withFilterClass(Class<? extends SelectionFilter> filterClass)
ValueSelectorConfig	withId(String id)
ValueSelectorConfig	withMimicSelectorRef(String mimicSelectorRef)
ValueSelectorConfig	withNearbySelectionConfig(NearbySelectionConfig nearbySelectionConfig)
ValueSelectorConfig	withProbabilityWeightFactoryClass(Class<? extends SelectionProbabilityWeightFactory> factoryClass)
ValueSelectorConfig	withSelectedCountLimit(long selectedCountLimit)
ValueSelectorConfig	withSelectionOrder(SelectionOrder selectionOrder)
ValueSelectorConfig	withSorterClass(Class<? extends SelectionSorter> sorterClass)
ValueSelectorConfig	withSorterComparatorClass(Class<? extends Comparator> comparatorClass)	Deprecated, for removal: This API element is subject to removal in a future version. Deprecated in favor of withComparatorClass(Class)
ValueSelectorConfig	withSorterManner(ValueSorterManner sorterManner)
ValueSelectorConfig	withSorterOrder(SelectionSorterOrder sorterOrder)
ValueSelectorConfig	withSorterWeightFactoryClass(Class<? extends SelectionSorterWeightFactory> weightFactoryClass)	Deprecated, for removal: This API element is subject to removal in a future version. Deprecated in favor of withComparatorFactoryClass(Class)
ValueSelectorConfig	withVariableName(String variableName)

Methods inherited from class java.lang.Object

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

Field Details

id

protected @Nullable String id

mimicSelectorRef

protected @Nullable String mimicSelectorRef

downcastEntityClass

protected @Nullable Class<?> downcastEntityClass

variableName

protected @Nullable String variableName

cacheType

protected @Nullable SelectionCacheType cacheType

selectionOrder

protected @Nullable SelectionOrder selectionOrder

nearbySelectionConfig

protected @Nullable NearbySelectionConfig nearbySelectionConfig

filterClass

protected @Nullable Class<? extends SelectionFilter> filterClass

sorterManner

protected @Nullable ValueSorterManner sorterManner

sorterComparatorClass

@Deprecated(forRemoval=true,
            since="1.28.0")
protected @Nullable Class<? extends Comparator> sorterComparatorClass

Deprecated, for removal: This API element is subject to removal in a future version.

Deprecated in favor of comparatorClass.

comparatorClass

protected @Nullable Class<? extends Comparator> comparatorClass

sorterWeightFactoryClass

@Deprecated(forRemoval=true,
            since="1.28.0")
protected @Nullable Class<? extends SelectionSorterWeightFactory> sorterWeightFactoryClass

Deprecated, for removal: This API element is subject to removal in a future version.

Deprecated in favor of comparatorFactoryClass.

comparatorFactoryClass

protected @Nullable Class<? extends ComparatorFactory> comparatorFactoryClass

sorterOrder

protected @Nullable SelectionSorterOrder sorterOrder

sorterClass

protected @Nullable Class<? extends SelectionSorter> sorterClass

probabilityWeightFactoryClass

protected @Nullable Class<? extends SelectionProbabilityWeightFactory> probabilityWeightFactoryClass

selectedCountLimit

protected @Nullable Long selectedCountLimit

Constructor Details

ValueSelectorConfig

public ValueSelectorConfig()

ValueSelectorConfig

public ValueSelectorConfig(String variableName)

ValueSelectorConfig

public ValueSelectorConfig(@Nullable ValueSelectorConfig inheritedConfig)

Method Details

getId

public @Nullable String getId()

setId

public void setId(@Nullable String id)

getMimicSelectorRef

public @Nullable String getMimicSelectorRef()

setMimicSelectorRef

public void setMimicSelectorRef(@Nullable String mimicSelectorRef)

getDowncastEntityClass

public @Nullable Class<?> getDowncastEntityClass()

setDowncastEntityClass

public void setDowncastEntityClass(@Nullable Class<?> downcastEntityClass)

getVariableName

public @Nullable String getVariableName()

setVariableName

public void setVariableName(@Nullable String variableName)

getCacheType

public @Nullable SelectionCacheType getCacheType()

setCacheType

public void setCacheType(@Nullable SelectionCacheType cacheType)

getSelectionOrder

public @Nullable SelectionOrder getSelectionOrder()

setSelectionOrder

public void setSelectionOrder(@Nullable SelectionOrder selectionOrder)

getNearbySelectionConfig

public @Nullable NearbySelectionConfig getNearbySelectionConfig()

setNearbySelectionConfig

public void setNearbySelectionConfig(@Nullable NearbySelectionConfig nearbySelectionConfig)

getFilterClass

public @Nullable Class<? extends SelectionFilter> getFilterClass()

setFilterClass

public void setFilterClass(@Nullable Class<? extends SelectionFilter> filterClass)

getSorterManner

public @Nullable ValueSorterManner getSorterManner()

setSorterManner

public void setSorterManner(@Nullable ValueSorterManner sorterManner)

getSorterComparatorClass

@Deprecated(forRemoval=true,
            since="1.28.0")
public @Nullable Class<? extends Comparator> getSorterComparatorClass()

Deprecated, for removal: This API element is subject to removal in a future version.

Deprecated in favor of getComparatorClass()

setSorterComparatorClass

@Deprecated(forRemoval=true,
            since="1.28.0")
public void setSorterComparatorClass(@Nullable Class<? extends Comparator> sorterComparatorClass)

Deprecated, for removal: This API element is subject to removal in a future version.

Deprecated in favor of setComparatorClass(Class)

getComparatorClass

public @Nullable Class<? extends Comparator> getComparatorClass()

setComparatorClass

public void setComparatorClass(@Nullable Class<? extends Comparator> comparatorClass)

getSorterWeightFactoryClass

@Deprecated(forRemoval=true,
            since="1.28.0")
public @Nullable Class<? extends SelectionSorterWeightFactory> getSorterWeightFactoryClass()

Deprecated, for removal: This API element is subject to removal in a future version.

Deprecated in favor of getComparatorFactoryClass()

setSorterWeightFactoryClass

@Deprecated(forRemoval=true,
            since="1.28.0")
public void setSorterWeightFactoryClass(@Nullable Class<? extends SelectionSorterWeightFactory> sorterWeightFactoryClass)

Deprecated, for removal: This API element is subject to removal in a future version.

Deprecated in favor of setComparatorFactoryClass(Class)

Parameters:

sorterWeightFactoryClass - the class

getComparatorFactoryClass

public @Nullable Class<? extends ComparatorFactory> getComparatorFactoryClass()

setComparatorFactoryClass

public void setComparatorFactoryClass(@Nullable Class<? extends ComparatorFactory> comparatorFactoryClass)

getSorterOrder

public @Nullable SelectionSorterOrder getSorterOrder()

setSorterOrder

public void setSorterOrder(@Nullable SelectionSorterOrder sorterOrder)

getSorterClass

public @Nullable Class<? extends SelectionSorter> getSorterClass()

setSorterClass

public void setSorterClass(@Nullable Class<? extends SelectionSorter> sorterClass)

getProbabilityWeightFactoryClass

public @Nullable Class<? extends SelectionProbabilityWeightFactory> getProbabilityWeightFactoryClass()

setProbabilityWeightFactoryClass

public void setProbabilityWeightFactoryClass(@Nullable Class<? extends SelectionProbabilityWeightFactory> probabilityWeightFactoryClass)

getSelectedCountLimit

public @Nullable Long getSelectedCountLimit()

setSelectedCountLimit

public void setSelectedCountLimit(@Nullable Long selectedCountLimit)

withId

public ValueSelectorConfig withId(String id)

withMimicSelectorRef

public ValueSelectorConfig withMimicSelectorRef(String mimicSelectorRef)

withDowncastEntityClass

public ValueSelectorConfig withDowncastEntityClass(Class<?> entityClass)

withVariableName

public ValueSelectorConfig withVariableName(String variableName)

withCacheType

public ValueSelectorConfig withCacheType(SelectionCacheType cacheType)

withSelectionOrder

public ValueSelectorConfig withSelectionOrder(SelectionOrder selectionOrder)

withNearbySelectionConfig

public ValueSelectorConfig withNearbySelectionConfig(NearbySelectionConfig nearbySelectionConfig)

withFilterClass

public ValueSelectorConfig withFilterClass(Class<? extends SelectionFilter> filterClass)

withSorterManner

public ValueSelectorConfig withSorterManner(ValueSorterManner sorterManner)

withSorterComparatorClass

@Deprecated(forRemoval=true,
            since="1.28.0")
public ValueSelectorConfig withSorterComparatorClass(Class<? extends Comparator> comparatorClass)

Deprecated, for removal: This API element is subject to removal in a future version.

Deprecated in favor of withComparatorClass(Class)

withComparatorClass

public ValueSelectorConfig withComparatorClass(Class<? extends Comparator> comparatorClass)

withSorterWeightFactoryClass

@Deprecated(forRemoval=true,
            since="1.28.0")
public ValueSelectorConfig withSorterWeightFactoryClass(Class<? extends SelectionSorterWeightFactory> weightFactoryClass)

Deprecated, for removal: This API element is subject to removal in a future version.

Deprecated in favor of withComparatorFactoryClass(Class)

Parameters:

weightFactoryClass - the factory class

withComparatorFactoryClass

public ValueSelectorConfig withComparatorFactoryClass(Class<? extends ComparatorFactory> comparatorFactoryClass)

withSorterOrder

public ValueSelectorConfig withSorterOrder(SelectionSorterOrder sorterOrder)

withSorterClass

public ValueSelectorConfig withSorterClass(Class<? extends SelectionSorter> sorterClass)

withProbabilityWeightFactoryClass

public ValueSelectorConfig withProbabilityWeightFactoryClass(Class<? extends SelectionProbabilityWeightFactory> factoryClass)

withSelectedCountLimit

public ValueSelectorConfig withSelectedCountLimit(long selectedCountLimit)

inherit

public ValueSelectorConfig inherit(ValueSelectorConfig inheritedConfig)

Description copied from class: AbstractConfig

Inherits each property of the inheritedConfig unless that property (or a semantic alternative) is defined by this instance (which overwrites the inherited behaviour).

After the inheritance, if a property on this AbstractConfig composition is replaced, it should not affect the inherited composition instance.

Specified by:

inherit in class AbstractConfig<ValueSelectorConfig>

Returns:

this

copyConfig

public ValueSelectorConfig copyConfig()

Description copied from class: AbstractConfig

Typically implemented by constructing a new instance and calling AbstractConfig.inherit(AbstractConfig) on it.

Specified by:

copyConfig in class AbstractConfig<ValueSelectorConfig>

Returns:

new instance

visitReferencedClasses

public void visitReferencedClasses(Consumer<Class<?>> classVisitor)

Description copied from class: AbstractConfig

Call the class visitor on each (possibly null) Class instance provided to this config by the user (including those provided in child configs). Required to create the bean factory in Quarkus.

Specified by:

visitReferencedClasses in class AbstractConfig<ValueSelectorConfig>

Parameters:

classVisitor - The visitor of classes. Can accept null instances of Class.

toString

public String toString()

Overrides:

toString in class AbstractConfig<ValueSelectorConfig>

hasSorter

public static <Solution_> boolean hasSorter(ValueSorterManner valueSorterManner,
 GenuineVariableDescriptor<Solution_> variableDescriptor)

determineSorter

public static <Solution_>
SelectionSorter<Solution_,Object> determineSorter(ValueSorterManner valueSorterManner,
 GenuineVariableDescriptor<Solution_> variableDescriptor)

hasNearbySelectionConfig

public boolean hasNearbySelectionConfig()

Description copied from class: SelectorConfig

Verifies if the current configuration has any Nearby Selection settings.

Specified by:

hasNearbySelectionConfig in class SelectorConfig<ValueSelectorConfig>