fr.lifl.jedi.gui.control.automaticControl
Class AutomaticSimulationController

java.lang.Object
  java.util.Observable
      fr.lifl.jedi.controllersCore.AbstractGUIController<GUIView>
          fr.lifl.jedi.controllersCore.AbstractControlGUIController<ISimulationGUI>
              fr.lifl.jedi.gui.control.automaticControl.AutomaticSimulationController

All Implemented Interfaces:

java.util.Observer

public class AutomaticSimulationController
extends AbstractControlGUIController<ISimulationGUI>

A controller that sends events to the simulation core to perform an automatic initialization, then runs simulation, and finally quits the simulation when the simulation ending criterion is met.

Version:

JEDI V 2.2

Created the 7th may 2009

Author:

Yoann Kubera

SMAC Team (Systèmes Multi-Agents et Comportement)

LIFL (Laboratoire d'Informatique Fondamentale de Lille)

University of Lille, France

Field Summary

Fields inherited from class fr.lifl.jedi.controllersCore.AbstractGUIController

core, view

Constructor Summary

AutomaticSimulationController()
Constructor of the controller that automatically launches a simulation once, and then quits.

Method Summary

protected void	handleViewMessage(ISimulationEvent event) Defines how the controller reacts when it receives an event coming from the view.
protected void	reactToCloseRequest() This method is called when the program is about to exit.
void	start() Launches a simulation, i.e.
protected void	updateViewAfterInitialization() This method is called whenever the simulation core finished the environment's initialization.
protected void	updateViewAfterTimeStep() This method is called whenever a simulation step ends.
protected void	updateViewAtSimulationsAbortion() This method is called when the simulation ended because of an abortion (because of a ToSimulationCoreControlEvents.TO_CORE_ABORT_SIMULATION event sent by the controller of a simulation control GUI).
protected void	updateViewAtSimulationsEnd() This method is called when the simulation ended normaly -- i.e.
protected void	updateViewDuringTimeStep() This method is called whenever a simulation step starts.
protected void	updateViewWhenPaused() This method is called whenever the simulation is paused.
protected void	updateViewWhileInitializing() This method is called when the simulation core begins to (and has not finished to) initialize the simulation.

Methods inherited from class fr.lifl.jedi.controllersCore.AbstractControlGUIController

sendEventToSimulationCore

Methods inherited from class fr.lifl.jedi.controllersCore.AbstractGUIController

getView, setSimulationCore, update

Methods inherited from class java.util.Observable

addObserver, clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, notifyObservers, setChanged

Methods inherited from class java.lang.Object

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

Constructor Detail

AutomaticSimulationController

public AutomaticSimulationController()

Constructor of the controller that automatically launches a simulation once, and then quits.

Method Detail

handleViewMessage

protected void handleViewMessage(ISimulationEvent event)

Description copied from class: AbstractGUIController

Defines how the controller reacts when it receives an event coming from the view.

Specified by:

handleViewMessage in class AbstractGUIController<ISimulationGUI>

Parameters:

event - The event that came from the view.

See Also:

AbstractGUIController.handleViewMessage(fr.lifl.jedi.gui.ISimulationEvent)

start

public void start()

Launches a simulation, i.e. performs the initiatlization, then runs the simulation until its ending conditions are met. Once these conditions are met, the simulation will end, and simulation will be exited.

reactToCloseRequest

protected void reactToCloseRequest()

Description copied from class: AbstractGUIController

This method is called when the program is about to exit. The program exits only when all controllers registered to the simulation core finished their call to the AbstractGUIController.reactToCloseRequest() method.

Specified by:

reactToCloseRequest in class AbstractGUIController<ISimulationGUI>

See Also:

AbstractGUIController.reactToCloseRequest()

updateViewAfterInitialization

protected void updateViewAfterInitialization()

Description copied from class: AbstractGUIController

This method is called whenever the simulation core finished the environment's initialization. The simulation can be started (i.e. the first simulation step can be performed) only when all controllers registered to the simulation core finished their call to the AbstractGUIController.updateViewAfterInitialization() method.

Specified by:

updateViewAfterInitialization in class AbstractGUIController<ISimulationGUI>

See Also:

AbstractGUIController.reactToCloseRequest()

updateViewAfterTimeStep

protected void updateViewAfterTimeStep()

Description copied from class: AbstractGUIController

This method is called whenever a simulation step ends. The simulation will resume (i.e. the next simulation step will be performed) only when all controllers registered to the simulation core finished their call to the AbstractGUIController.updateViewAfterTimeStep() method.

Specified by:

updateViewAfterTimeStep in class AbstractGUIController<ISimulationGUI>

See Also:

AbstractGUIController.reactToCloseRequest()

updateViewAtSimulationsAbortion

protected void updateViewAtSimulationsAbortion()

Description copied from class: AbstractGUIController

This method is called when the simulation ended because of an abortion (because of a ToSimulationCoreControlEvents.TO_CORE_ABORT_SIMULATION event sent by the controller of a simulation control GUI). The simulation can be initialized again only when all controllers registered to the simulation core finished their call to the AbstractGUIController.updateViewAtSimulationsAbortion() method.

Specified by:

updateViewAtSimulationsAbortion in class AbstractGUIController<ISimulationGUI>

See Also:

AbstractGUIController.reactToCloseRequest()

updateViewAtSimulationsEnd

protected void updateViewAtSimulationsEnd()

Description copied from class: AbstractGUIController

This method is called when the simulation ended normaly -- i.e. if the simulation met its ending criterion (see SimulationCore.hasToStop()). The simulation can be initialized again only when all controllers registered to the simulation core finished their call to the AbstractGUIController.updateViewAtSimulationsEnd() method.

Specified by:

updateViewAtSimulationsEnd in class AbstractGUIController<ISimulationGUI>

See Also:

AbstractGUIController.reactToCloseRequest()

updateViewDuringTimeStep

protected void updateViewDuringTimeStep()

Description copied from class: AbstractGUIController

This method is called whenever a simulation step starts. Please do not access to the environment in this method. Otherwise, a concurrent access exception might be thrown.

Specified by:

updateViewDuringTimeStep in class AbstractGUIController<ISimulationGUI>

See Also:

AbstractGUIController.updateViewDuringTimeStep()

updateViewWhenPaused

protected void updateViewWhenPaused()

Description copied from class: AbstractGUIController

This method is called whenever the simulation is paused. The simulation can resume only when all controllers registered to the simulation core finished their call to the AbstractGUIController.updateViewWhenPaused() method.

Specified by:

updateViewWhenPaused in class AbstractGUIController<ISimulationGUI>

See Also:

AbstractGUIController.reactToCloseRequest()

updateViewWhileInitializing

protected void updateViewWhileInitializing()

Description copied from class: AbstractGUIController

This method is called when the simulation core begins to (and has not finished to) initialize the simulation. Please do not access to the environment in this method. Otherwise, a concurrent access exception might be thrown.

Specified by:

updateViewWhileInitializing in class AbstractGUIController<ISimulationGUI>

See Also:

AbstractGUIController.reactToCloseRequest()