Package ai.timefold.solver.core.impl.neighborhood.stream

Class DefaultMoveStreamFactory<Solution_>

java.lang.Object

ai.timefold.solver.core.impl.neighborhood.stream.DefaultMoveStreamFactory<Solution_>

All Implemented Interfaces:

MoveStreamFactory<Solution_>

@NullMarked
public final class DefaultMoveStreamFactory<Solution_>
extends Object
implements MoveStreamFactory<Solution_>

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	DefaultMoveStreamFactory.ListVariableNodeSharingSupportFunctions<Solution_,Entity_,Value_>
static final record	DefaultMoveStreamFactory.NodeSharingSupportFunctions<Solution_,Entity_,Value_>

Constructor Summary

Constructors

Constructor	Description
DefaultMoveStreamFactory(SolutionDescriptor<Solution_> solutionDescriptor, EnvironmentMode environmentMode)

Method Summary

Modifier and Type	Method	Description
DefaultNeighborhoodSession<Solution_>	createSession(SessionContext<Solution_> context)
<A> UniEnumeratingStream<Solution_,A>	forEach(Class<A> sourceClass, boolean includeNull)	Start a EnumeratingStream of all instances of the sourceClass that are known as problem facts or planning entities.
<Entity_, Value_> UniEnumeratingStream<Solution_,ElementPosition>	forEachAssignablePosition(PlanningListVariableMetaModel<Solution_,Entity_,Value_> variableMetaModel)	Enumerate all possible positions of a list variable to which a value can be assigned.
<Entity_, Value_> UniEnumeratingStream<Solution_,Value_>	forEachAssignedValue(PlanningListVariableMetaModel<Solution_,Entity_,Value_> variableMetaModel)	Enumerate all values assigned to any entity's PlanningListVariable.
<Entity_, Value_> UniEnumeratingStream<Solution_,Value_>	forEachAssignedValueUnfiltered(PlanningListVariableMetaModel<Solution_,Entity_,Value_> variableMetaModel)	Enumerate all values assigned to any entity's PlanningListVariable.
<Entity_, Value_> UniEnumeratingStream<Solution_,PositionInList>	forEachDestination(PlanningListVariableMetaModel<Solution_,Entity_,Value_> variableMetaModel)	Enumerate all possible positions of a list variable to which a value can be assigned.
<Entity_, Value_> UniEnumeratingStream<Solution_,ElementPosition>	forEachDestinationIncludingUnassigned(PlanningListVariableMetaModel<Solution_,Entity_,Value_> variableMetaModel)	As defined by MoveStreamFactory.forEachDestination(PlanningListVariableMetaModel), but also includes a single UnassignedElement position if the list variable allows unassigned values.
<A> UniEnumeratingStream<Solution_,A>	forEachUnfiltered(Class<A> sourceClass, boolean includeNull)	Start a EnumeratingStream of all instances of the sourceClass that are known as problem facts or planning entities.
<Entity_, Value_> DefaultMoveStreamFactory.ListVariableNodeSharingSupportFunctions<Solution_,Entity_,Value_>	getNodeSharingSupportFunctions(PlanningListVariableMetaModel<Solution_,Entity_,Value_> variableMetaModel)
<Entity_, Value_> DefaultMoveStreamFactory.NodeSharingSupportFunctions<Solution_,Entity_,Value_>	getNodeSharingSupportFunctions(PlanningVariableMetaModel<Solution_,Entity_,Value_> variableMetaModel)
SolutionDescriptor<Solution_>	getSolutionDescriptor()
<A> UniSamplingStream<Solution_,A>	pick(UniEnumeratingStream<Solution_,A> enumeratingStream)

Methods inherited from class java.lang.Object

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

Constructor Details

DefaultMoveStreamFactory

public DefaultMoveStreamFactory(SolutionDescriptor<Solution_> solutionDescriptor,
 EnvironmentMode environmentMode)

Method Details

createSession

public DefaultNeighborhoodSession<Solution_> createSession(SessionContext<Solution_> context)

forEach

public <A> UniEnumeratingStream<Solution_,A> forEach(Class<A> sourceClass,
 boolean includeNull)

Description copied from interface: MoveStreamFactory

Start a EnumeratingStream of all instances of the sourceClass that are known as problem facts or planning entities.

If the sourceClass is a PlanningEntity, then it is automatically filtered to only contain entities which are not pinned.

If the sourceClass is a shadow entity (an entity without any genuine planning variables), and if there exists a genuine PlanningEntity with a PlanningListVariable which accepts instances of this shadow entity as values in that list, then this stream will filter out all sourceClass instances which are pinned in that list.

This stream returns genuine entities regardless of whether they have any null genuine planning variables. This stream returns shadow entities regardless of whether they are assigned to any genuine entity. They can easily be filtered out.

Specified by:

forEach in interface MoveStreamFactory<Solution_>

Parameters:

sourceClass - the class of the instances to enumerate

includeNull - if true, the stream will include a single null element

Returns:

A stream containing a tuple for each of the entities as described above.

See Also:

• An annotation to mark the entire entity as pinned.
• An annotation to specify only a portion of PlanningListVariable is pinned.
• Specialized method exists to automatically include pinned entities as well.

forEachUnfiltered

public <A> UniEnumeratingStream<Solution_,A> forEachUnfiltered(Class<A> sourceClass,
 boolean includeNull)

Description copied from interface: MoveStreamFactory

Start a EnumeratingStream of all instances of the sourceClass that are known as problem facts or planning entities. If the sourceClass is a genuine or shadow entity, it returns instances regardless of their pinning status. Otherwise as defined by MoveStreamFactory.forEach(Class, boolean).

Specified by:

forEachUnfiltered in interface MoveStreamFactory<Solution_>

getNodeSharingSupportFunctions

public <Entity_,
Value_>
DefaultMoveStreamFactory.NodeSharingSupportFunctions<Solution_,Entity_,Value_> getNodeSharingSupportFunctions(PlanningVariableMetaModel<Solution_,Entity_,Value_> variableMetaModel)

forEachAssignedValueUnfiltered

public <Entity_,
Value_>
UniEnumeratingStream<Solution_,Value_> forEachAssignedValueUnfiltered(PlanningListVariableMetaModel<Solution_,Entity_,Value_> variableMetaModel)

Description copied from interface: MoveStreamFactory

Enumerate all values assigned to any entity's PlanningListVariable. Unlike MoveStreamFactory.forEachAssignedValue(PlanningListVariableMetaModel), this will include pinned values. You can use SolutionView.getPositionOf(PlanningListVariableMetaModel, Object) later downstream to get the position of the value in an entity's list variable, if needed.

Specified by:

forEachAssignedValueUnfiltered in interface MoveStreamFactory<Solution_>

Parameters:

variableMetaModel - the meta model of the list variable to enumerate

Returns:

enumerating stream with all values as defined above

See Also:

• An annotation to mark the entire entity as pinned.
• An annotation to specify only a portion of PlanningListVariable is pinned.

forEachAssignedValue

public <Entity_,
Value_>
UniEnumeratingStream<Solution_,Value_> forEachAssignedValue(PlanningListVariableMetaModel<Solution_,Entity_,Value_> variableMetaModel)

Description copied from interface: MoveStreamFactory

Enumerate all values assigned to any entity's PlanningListVariable. This will not include any pinned positions or fully pinned entities. You can use SolutionView.getPositionOf(PlanningListVariableMetaModel, Object) later downstream to get the position of the value in an entity's list variable, if needed.

Specified by:

forEachAssignedValue in interface MoveStreamFactory<Solution_>

Parameters:

variableMetaModel - the meta model of the list variable to enumerate

Returns:

enumerating stream with all values as defined above

See Also:

• An annotation to mark the entire entity as pinned.
• An annotation to specify only a portion of PlanningListVariable is pinned.

forEachDestination

public <Entity_,
Value_>
UniEnumeratingStream<Solution_,PositionInList> forEachDestination(PlanningListVariableMetaModel<Solution_,Entity_,Value_> variableMetaModel)

Description copied from interface: MoveStreamFactory

Enumerate all possible positions of a list variable to which a value can be assigned. This will include one position past the current end of the list, allowing for assigning at the end of a list. It will not include any pinned positions or fully pinned entities, as well as UnassignedElement. To include UnassignedElement, use MoveStreamFactory.forEachDestinationIncludingUnassigned(PlanningListVariableMetaModel) instead.

Specified by:

forEachDestination in interface MoveStreamFactory<Solution_>

Parameters:

variableMetaModel - the meta model of the list variable to enumerate

Returns:

enumerating stream with positions as defined above

See Also:

• Read more about element positions.
• An annotation to mark the entire entity as pinned.
• An annotation to specify only a portion of PlanningListVariable is pinned.

forEachDestinationIncludingUnassigned

public <Entity_,
Value_>
UniEnumeratingStream<Solution_,ElementPosition> forEachDestinationIncludingUnassigned(PlanningListVariableMetaModel<Solution_,Entity_,Value_> variableMetaModel)

Description copied from interface: MoveStreamFactory

As defined by MoveStreamFactory.forEachDestination(PlanningListVariableMetaModel), but also includes a single UnassignedElement position if the list variable allows unassigned values. If the list variable does not allow unassigned values, then this method behaves exactly the same as MoveStreamFactory.forEachDestination(PlanningListVariableMetaModel).

Specified by:

forEachDestinationIncludingUnassigned in interface MoveStreamFactory<Solution_>

getNodeSharingSupportFunctions

public <Entity_,
Value_>
DefaultMoveStreamFactory.ListVariableNodeSharingSupportFunctions<Solution_,Entity_,Value_> getNodeSharingSupportFunctions(PlanningListVariableMetaModel<Solution_,Entity_,Value_> variableMetaModel)

pick

public <A> UniSamplingStream<Solution_,A> pick(UniEnumeratingStream<Solution_,A> enumeratingStream)

Specified by:

pick in interface MoveStreamFactory<Solution_>

getSolutionDescriptor

public SolutionDescriptor<Solution_> getSolutionDescriptor()

forEachAssignablePosition

public <Entity_,
Value_>
UniEnumeratingStream<Solution_,ElementPosition> forEachAssignablePosition(PlanningListVariableMetaModel<Solution_,Entity_,Value_> variableMetaModel)

Description copied from interface: MoveStreamFactory

Enumerate all possible positions of a list variable to which a value can be assigned. This will eliminate all positions on pinned entities, as well as all pinned indexes. If the list variable allows unassigned values, the resulting stream will include a single instance of UnassignedElement instance.

Will be removed right before this API is moved out of preview.

Specified by:

forEachAssignablePosition in interface MoveStreamFactory<Solution_>

Parameters:

variableMetaModel - the meta model of the list variable to enumerate

Returns:

enumerating stream with all assignable positions of a given list variable

See Also:

• Read more about element positions.