de.uka.ipd.sdq.simucomframework
Interface ISimuComControl

All Known Implementing Classes:

AbstractMain

public interface ISimuComControl

Control interface for the SimuCom Framework. It defines methods, which are responsible for starting and stopping the simulation. The code generated for each SimuCom instance contains the class main.SimuComControl that extends AbstractMain and provides the missing information.

Author:

Roman Andrej Steffen Becker

Method Summary

Throwable	getErrorThrowable() Returns an exception which caused the simulation to terminate in case of simulation errors as indicated by the SimuComResult returned by the startSimulation method
SimuComStatus	getStatus() Retrieve an object containing the status of this simulation.
SimuComResult	startSimulation(SimuComConfig config, IStatusObserver statusObserver, boolean useOwnSensorstorage) Start a simulation run
void	stopSimulation() Cancels a running simulation by disallowing the generation of new simulation events

Method Detail

startSimulation

SimuComResult startSimulation(SimuComConfig config,
                              IStatusObserver statusObserver,
                              boolean useOwnSensorstorage)

Start a simulation run

Parameters:

config - The configuration object which sets many simulation parameters like stop conditions, storage location, etc.

statusObserver - An observer which gets notifications on the simulation progress

useOwnSensorstorage - If true, the simulation uses an own, temporary result store instead of the sensorfactory storage passed in the simulation parameter object. Use this for remote simulation docks which do not have access to the local sensor factory storages

Returns:

The result of the simulation run

stopSimulation

void stopSimulation()

Cancels a running simulation by disallowing the generation of new simulation events

getErrorThrowable

Throwable getErrorThrowable()

Returns an exception which caused the simulation to terminate in case of simulation errors as indicated by the SimuComResult returned by the startSimulation method

Returns:

The exception which caused the simulation to terminate

getStatus

SimuComStatus getStatus()

Retrieve an object containing the status of this simulation.

Returns:

A SimuComStatus object containing the simulation status