Package org.simplesim.simulator

Class DynamicDecorator

java.lang.Object

org.simplesim.simulator.DynamicDecorator

All Implemented Interfaces:

Simulator

public final class DynamicDecorator
extends Object
implements Simulator

Decorator class to enable dynamic changes of the model during simulation run.

This class wraps any other simulator implementation and registers itself as EventsProcessedListener to be called after each simulation cycle. Communication of the agents' change requests is done by a static and thread-safe queue within the AbstractAgent class. Changes are done by concrete implementations of the ChangeRequest interface. So, agents prepare and organize the change process whereas the the various change request implementations are responsible for the conduct of the specified model change. This class ensures the processing of the change requests.

To use model change functionality, agents have to issue change request via AbstractAgent#addModelChangeRequest(ChangeRequest) class.

See Also:

• ChangeRequest
• BasicAgent

Nested Class Summary

Nested classes/interfaces inherited from interface org.simplesim.simulator.Simulator

Simulator.InvalidSimulatorStateException

Constructor Summary

Constructors

Constructor	Description
DynamicDecorator(Simulator value)

Method Summary

Modifier and Type	Method	Description
List<Agent>	getCurrentEventList()
Domain	getRootDomain()
Time	getSimulationTime()
void	registerEventsProcessedListener(Listener<Simulator> listener)	Registers an EventsProcessedListener to be called after each simulation cycle.
void	runSimulation(Time stop)	Starts a simulation run
void	unregisterEventsProcessedListener(Listener<Simulator> listener)	Unregisters an EventsProcessedListener.

Methods inherited from class java.lang.Object

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

Constructor Details

DynamicDecorator

public DynamicDecorator(Simulator value)

Method Details

runSimulation

public void runSimulation(Time stop)

Description copied from interface: Simulator

Starts a simulation run

Specified by:

runSimulation in interface Simulator

Parameters:

stop - simulation time when the simulation should stop

getRootDomain

public Domain getRootDomain()

Specified by:

getRootDomain in interface Simulator

getSimulationTime

public Time getSimulationTime()

Specified by:

getSimulationTime in interface Simulator

getCurrentEventList

public List<Agent> getCurrentEventList()

Specified by:

getCurrentEventList in interface Simulator

registerEventsProcessedListener

public void registerEventsProcessedListener(Listener<Simulator> listener)

Description copied from interface: Simulator

Registers an EventsProcessedListener to be called after each simulation cycle.

Specified by:

registerEventsProcessedListener in interface Simulator

Parameters:

listener - the Listener implementation to be added

unregisterEventsProcessedListener

public void unregisterEventsProcessedListener(Listener<Simulator> listener)

Description copied from interface: Simulator

Unregisters an EventsProcessedListener.

Specified by:

unregisterEventsProcessedListener in interface Simulator

Parameters:

listener - the Listener implementation to be removed