agentgui.simulationService.behaviour

Class SimulationServiceBehaviour

java.lang.Object

jade.core.behaviours.Behaviour

agentgui.simulationService.behaviour.SimulationServiceBehaviour

All Implemented Interfaces:

ServiceSensorInterface, java.io.Serializable

public abstract class SimulationServiceBehaviour
extends jade.core.behaviours.Behaviour
implements ServiceSensorInterface

The Class SimulationServiceBehaviour can be extended in order to use the functionality of the SimulationService in a behaviour instead of the usage through SimulationAgent.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class jade.core.behaviours.Behaviour

jade.core.behaviours.Behaviour.RunnableChangedEvent

Field Summary

Fields

Modifier and Type	Field and Description
protected EnvironmentModel	myEnvironmentModel The current EnvironmentModel.
protected ServiceSensor	mySensor The ServiceSensor of this agent.

Fields inherited from class jade.core.behaviours.Behaviour

myAgent, myEvent, NOTIFY_DOWN, NOTIFY_UP, parent, STATE_BLOCKED, STATE_READY, STATE_RUNNING

Constructor Summary

Constructors

Constructor and Description
SimulationServiceBehaviour(jade.core.Agent agent) Instantiates a new SimulationServiceBehaviour as an active agent, which means that the current agent is asked to react on notifications or environment changes.
SimulationServiceBehaviour(jade.core.Agent agent, boolean passive) Instantiates a new simulation agent as a passive agent.

Method Summary

Modifier and Type	Method and Description
void	action()
void	addSimulationServiceListener(ServiceSensorListener simulationServiceListener) Adds the simulation service listener.
protected void	checkAndActOnEnvironmentChanges() This Method checks if the environment changed in the meantime.
protected void	deregisterDFService() Unregisters a service for the agency to the DFService of JADE.
void	doDelete() Will delete/kill the current agent.
boolean	done()
protected jade.domain.FIPAAgentManagement.DFAgentDescription[]	findAgentsByServiceType(java.lang.String serviceType) Find and returns agents by a service type.
jade.core.Agent	getAgent() Gets the current agent.
jade.core.AID	getAID() Returns the AID of the current Agent.
int	onEnd()
protected EnvironmentNotification	onEnvironmentNotification(EnvironmentNotification notification) This method will be executed if a ManagerNotification arrives this agent.
abstract void	onEnvironmentStimulus() This method is called if a stimulus from the outside reached this agent.
void	onStart()
protected void	registerDFService(java.lang.String type, java.lang.String name, java.lang.String ownership) Registers a service for the agency to the DFService of JADE.
void	removeSimulationServiceListener(ServiceSensorListener simulationServiceListener) Removes the simulation service listener.
boolean	sendAgentNotification(jade.core.AID receiverAID, java.lang.Object notification) This method can be used to transfer any kind of information to one member of the current environment model.
void	sendDisplayAgentNotification(DisplayAgentNotification displayAgentNotification) Notify display agents about changes with a DisplayAgentNotification.
boolean	sendManagerNotification(java.lang.Object notification) This method can be used to transfer any kind of information to the Manager of the current environment model.
protected void	sensorPlugIn() This Method plugs IN the service sensor.
protected void	sensorPlugOut() This Method plugs OUT the service sensor.
void	setEnvironmentModel(EnvironmentModel envModel, boolean aSynchron) This method will be used by the ServiceActuator to inform this agent about changes in the environment.
abstract void	setMigration(jade.core.Location newLocation) This method will be used by the ServiceActuator (class) to inform this agent about its new migration location.
protected void	setMyStimulusAnswer(java.lang.Object myNextState) This method sets the answer respectively the change of a single simulation agent back to the central simulation manager.
void	setNotification(EnvironmentNotification notification) This method can be invoked from the simulation service, if a notification for the manager has to be delivered.

Methods inherited from class jade.core.behaviours.Behaviour

actionWrapper, block, block, getBehaviourName, getDataStore, getExecutionState, getParent, getRestartCounter, handle, handleBlockEvent, handleRestartEvent, isRunnable, reset, restart, root, setAgent, setBehaviourName, setDataStore, setExecutionState

Methods inherited from class java.lang.Object

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

Methods inherited from interface agentgui.simulationService.sensoring.ServiceSensorInterface

setPauseSimulation

Field Detail

mySensor

protected ServiceSensor mySensor

The ServiceSensor of this agent.

myEnvironmentModel

protected EnvironmentModel myEnvironmentModel

The current EnvironmentModel.

Constructor Detail

SimulationServiceBehaviour

public SimulationServiceBehaviour(jade.core.Agent agent)

Instantiates a new SimulationServiceBehaviour as an active agent, which means that the current agent is asked to react on notifications or environment changes.

Parameters:

agent - the agent

SimulationServiceBehaviour

public SimulationServiceBehaviour(jade.core.Agent agent,
                                  boolean passive)

Instantiates a new simulation agent as a passive agent. The agent will just listening to changes in the environment model but it is not expected, that it will react on it. This is used for example for agents, which are displaying the current environment.

Parameters:

agent - the agent

passive - the passive

Method Detail

getAgent

public jade.core.Agent getAgent()

Gets the current agent.

Overrides:

getAgent in class jade.core.behaviours.Behaviour

Returns:

the agent

action

public void action()

Specified by:

action in class jade.core.behaviours.Behaviour

getAID

public jade.core.AID getAID()

Description copied from interface: ServiceSensorInterface

Returns the AID of the current Agent.

Specified by:

getAID in interface ServiceSensorInterface

Returns:

the AID

doDelete

public void doDelete()

Description copied from interface: ServiceSensorInterface

Will delete/kill the current agent.

Specified by:

doDelete in interface ServiceSensorInterface

done

public boolean done()

Specified by:

done in class jade.core.behaviours.Behaviour

onStart

public void onStart()

Overrides:

onStart in class jade.core.behaviours.Behaviour

onEnd

public int onEnd()

Overrides:

onEnd in class jade.core.behaviours.Behaviour

sensorPlugIn

protected void sensorPlugIn()

This Method plugs IN the service sensor.

sensorPlugOut

protected void sensorPlugOut()

This Method plugs OUT the service sensor.

checkAndActOnEnvironmentChanges

protected void checkAndActOnEnvironmentChanges()

This Method checks if the environment changed in the meantime. If so, the method 'onEnvironmentStimulus' will be fired

setMigration

public abstract void setMigration(jade.core.Location newLocation)

This method will be used by the ServiceActuator (class) to inform this agent about its new migration location.

Specified by:

setMigration in interface ServiceSensorInterface

Parameters:

newLocation - the new Location for the migration

setEnvironmentModel

public void setEnvironmentModel(EnvironmentModel envModel,
                                boolean aSynchron)

This method will be used by the ServiceActuator to inform this agent about changes in the environment. It can be either used to do this asynchronously or synchronously. It is highly recommended to do this asynchronously, so that the agency can act parallel and not sequentially.

Specified by:

setEnvironmentModel in interface ServiceSensorInterface

Parameters:

envModel - the current or new EnvironmentModel

aSynchron - true, if this should be done asynchronously

onEnvironmentStimulus

public abstract void onEnvironmentStimulus()

This method is called if a stimulus from the outside reached this agent. It can be overwritten in the child class to act on environment changes.

setMyStimulusAnswer

protected void setMyStimulusAnswer(java.lang.Object myNextState)

This method sets the answer respectively the change of a single simulation agent back to the central simulation manager.

Parameters:

myNextState - the next state of this agent in the next instance of the environment model

sendManagerNotification

public boolean sendManagerNotification(java.lang.Object notification)

This method can be used to transfer any kind of information to the Manager of the current environment model.

Parameters:

notification - the notification

Returns:

true, if successful

sendAgentNotification

public boolean sendAgentNotification(jade.core.AID receiverAID,
                                     java.lang.Object notification)

This method can be used to transfer any kind of information to one member of the current environment model.

Parameters:

receiverAID - the AID of receiver agent

notification - the notification

Returns:

true, if successful

sendDisplayAgentNotification

public void sendDisplayAgentNotification(DisplayAgentNotification displayAgentNotification)

Notify display agents about changes with a DisplayAgentNotification.

Parameters:

displayAgentNotification - the display agent message

setNotification

public void setNotification(EnvironmentNotification notification)

This method can be invoked from the simulation service, if a notification for the manager has to be delivered.

Specified by:

setNotification in interface ServiceSensorInterface

Parameters:

notification - the new notification

onEnvironmentNotification

protected EnvironmentNotification onEnvironmentNotification(EnvironmentNotification notification)

This method will be executed if a ManagerNotification arrives this agent.

Parameters:

notification - the notification

addSimulationServiceListener

public void addSimulationServiceListener(ServiceSensorListener simulationServiceListener)

Adds the simulation service listener.

Parameters:

simulationServiceListener - the simulation service listener

removeSimulationServiceListener

public void removeSimulationServiceListener(ServiceSensorListener simulationServiceListener)

Removes the simulation service listener.

Parameters:

simulationServiceListener - the simulation service listener

registerDFService

protected void registerDFService(java.lang.String type,
                                 java.lang.String name,
                                 java.lang.String ownership)

Registers a service for the agency to the DFService of JADE.

Parameters:

type - the type

name - the name

deregisterDFService

protected void deregisterDFService()

Unregisters a service for the agency to the DFService of JADE.

findAgentsByServiceType

protected jade.domain.FIPAAgentManagement.DFAgentDescription[] findAgentsByServiceType(java.lang.String serviceType)

Find and returns agents by a service type.

Parameters:

serviceType - the service type

Returns:

the dF agent description[]