agentgui.simulationService.balancing

Class BaseLoadBalancing

java.lang.Object

jade.core.behaviours.Behaviour

jade.core.behaviours.SimpleBehaviour

jade.core.behaviours.OneShotBehaviour

agentgui.simulationService.balancing.BaseLoadBalancing

All Implemented Interfaces:

BaseLoadBalancingInterface, java.io.Serializable

Direct Known Subclasses:

DynamicLoadBalancingBase, StaticLoadBalancingBase

public abstract class BaseLoadBalancing
extends jade.core.behaviours.OneShotBehaviour
implements BaseLoadBalancingInterface

This class is the abstract super class for the dynamic and static load balancing. It provide functionalities, which should be available in both kind of balancing approaches.

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 java.util.Hashtable<java.lang.String,java.lang.Float>	currContainerBenchmarkResults The BenchmarkResults of all involved container.
protected java.util.Hashtable<java.lang.String,jade.core.Location>	currContainerLoactions The locations in the distributed system.
protected DistributionSetup	currDisSetup The current distribution setup.
protected Project	currProject The current project instance.
protected SimulationSetup	currSimSetup The current simulation setup.
protected java.lang.Integer	currThresholdExceededOverAll The indicator that says if the thresholds were exceeded over all.
protected LoadThresholdLevels	currThresholdLevels The current threshold levels.
protected LoadServiceHelper	loadHelper The load helper for the connection to the LoadService.
protected SimulationServiceHelper	simHelper The simulation helper for the connection to the SimulationsService.

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
BaseLoadBalancing(jade.core.Agent agent) Instantiates a new base load balancing.

Method Summary

Modifier and Type	Method and Description
void	action()
protected java.lang.Object[]	getStartArguments(AgentClassElement4SimStart ace4SimStart) This method will return the Object Array for the start argument of an agent.
protected void	openMonitorAgents() This method will start the Load-Monitor-Agent and Thread-Monitor-Agent.
protected void	setAgentMigration(java.util.Vector<LoadAgentMap.AID_Container> transferAgents) This Method transfers the new LoadAgentMap-Instance to the SimulationService and informs the agent about the location they have to migrate.
protected boolean	startAgent(java.lang.String nickName, java.lang.Class<? extends jade.core.Agent> agentClass, java.lang.Object[] args) Method to start a new agent.
protected boolean	startAgent(java.lang.String nickName, java.lang.Class<? extends jade.core.Agent> agentClass, java.lang.Object[] args, jade.core.Location toLocation) Main-Method to start a new agent.
protected boolean	startAgent(java.lang.String nickName, java.lang.String agentClassName, java.lang.Object[] args) Method to start a new agent.
protected boolean	startAgent(java.lang.String nickName, java.lang.String agentClassName, java.lang.Object[] args, jade.core.Location toLocation) Method to start a new agent.
protected boolean	startAgentsOnContainers(java.util.Hashtable<jade.core.Location,java.util.ArrayList<AgentClassElement4SimStart>> agentContainerList, boolean verbose) start agents on their assigned locations.
protected java.util.Hashtable<java.lang.String,jade.core.Location>	startNumberOfRemoteContainer(int numberOfContainer, boolean filterMainContainer, RemoteContainerConfig remoteContainerConfig) This method will start a number of remote container.
protected java.lang.String	startRemoteContainer() This Method can be invoked, if a new remote container is required.
protected java.lang.String	startRemoteContainer(RemoteContainerConfig remoteContainerConfig) This Method can be invoked, if a new remote container is required.

Methods inherited from class jade.core.behaviours.OneShotBehaviour

done

Methods inherited from class jade.core.behaviours.SimpleBehaviour

reset

Methods inherited from class jade.core.behaviours.Behaviour

actionWrapper, block, block, getAgent, getBehaviourName, getDataStore, getExecutionState, getParent, getRestartCounter, handle, handleBlockEvent, handleRestartEvent, isRunnable, onEnd, onStart, 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.balancing.BaseLoadBalancingInterface

doBalancing

Field Detail

simHelper

protected SimulationServiceHelper simHelper

The simulation helper for the connection to the SimulationsService.

loadHelper

protected LoadServiceHelper loadHelper

The load helper for the connection to the LoadService.

currProject

protected Project currProject

The current project instance.

currSimSetup

protected SimulationSetup currSimSetup

The current simulation setup.

currDisSetup

protected DistributionSetup currDisSetup

The current distribution setup.

currThresholdLevels

protected LoadThresholdLevels currThresholdLevels

The current threshold levels.

currThresholdExceededOverAll

protected java.lang.Integer currThresholdExceededOverAll

The indicator that says if the thresholds were exceeded over all.

currContainerBenchmarkResults

protected java.util.Hashtable<java.lang.String,java.lang.Float> currContainerBenchmarkResults

The BenchmarkResults of all involved container.

currContainerLoactions

protected java.util.Hashtable<java.lang.String,jade.core.Location> currContainerLoactions

The locations in the distributed system.

Constructor Detail

BaseLoadBalancing

public BaseLoadBalancing(jade.core.Agent agent)

Instantiates a new base load balancing.

Method Detail

action

public void action()

Specified by:

action in class jade.core.behaviours.Behaviour

getStartArguments

protected java.lang.Object[] getStartArguments(AgentClassElement4SimStart ace4SimStart)

This method will return the Object Array for the start argument of an agent.

Parameters:

ace4SimStart - the AgentClassElement4SimStart

Returns:

the start arguments as object array

startAgent

protected boolean startAgent(java.lang.String nickName,
                             java.lang.String agentClassName,
                             java.lang.Object[] args)

Method to start a new agent.

Parameters:

nickName - the nick name

agentClassName - the agent class name

args - the start arguments as Object array

Returns:

true, if successful

startAgent

protected boolean startAgent(java.lang.String nickName,
                             java.lang.Class<? extends jade.core.Agent> agentClass,
                             java.lang.Object[] args)

Method to start a new agent.

Parameters:

nickName - the nick name

agentClass - the agent class

args - the start arguments as Object array

Returns:

true, if successful

startAgent

protected boolean startAgent(java.lang.String nickName,
                             java.lang.String agentClassName,
                             java.lang.Object[] args,
                             jade.core.Location toLocation)

Method to start a new agent.

Parameters:

nickName - the nick name

agentClassName - the agent class name

args - the start arguments as Object array

toLocation - the location, where the agent should start

Returns:

true, if successful

startAgent

protected boolean startAgent(java.lang.String nickName,
                             java.lang.Class<? extends jade.core.Agent> agentClass,
                             java.lang.Object[] args,
                             jade.core.Location toLocation)

Main-Method to start a new agent. All other methods will use this one at least.

Parameters:

nickName - the nick name

agentClass - the agent class

args - the start arguments as Object array

toLocation - the location, where the agent should start

Returns:

true, if successful

startAgentsOnContainers

protected boolean startAgentsOnContainers(java.util.Hashtable<jade.core.Location,java.util.ArrayList<AgentClassElement4SimStart>> agentContainerList,
                                          boolean verbose)

start agents on their assigned locations.

Parameters:

agentContainerList - the agent container list

verbose - the verbose

Returns:

true, if successful

openMonitorAgents

protected void openMonitorAgents()

This method will start the Load-Monitor-Agent and Thread-Monitor-Agent.

startRemoteContainer

protected java.lang.String startRemoteContainer()

This Method can be invoked, if a new remote container is required. If the container was started the method returns the new containers name and will update the local information of currContainerLoactions and currContainerBenchmarkResults.

Returns:

the name of the new container

See Also:

currContainerLoactions, currContainerBenchmarkResults

startRemoteContainer

protected java.lang.String startRemoteContainer(RemoteContainerConfig remoteContainerConfig)

This Method can be invoked, if a new remote container is required. If the container was started the method returns the new containers name and will update the local information of currContainerLoactions and currContainerBenchmarkResults.

Parameters:

remoteContainerConfig - the remote container configuration out of the Project

Returns:

the name of the new container

See Also:

currContainerLoactions, currContainerBenchmarkResults

startNumberOfRemoteContainer

protected java.util.Hashtable<java.lang.String,jade.core.Location> startNumberOfRemoteContainer(int numberOfContainer,
                                                                                                boolean filterMainContainer,
                                                                                                RemoteContainerConfig remoteContainerConfig)

This method will start a number of remote container.

Parameters:

numberOfContainer - the number of container

remoteContainerConfig - the remote container configuration

filterMainContainer - true, if the Main-Container should be filter out of the result

Returns:

the newly started locations

setAgentMigration

protected void setAgentMigration(java.util.Vector<LoadAgentMap.AID_Container> transferAgents)

This Method transfers the new LoadAgentMap-Instance to the SimulationService and informs the agent about the location they have to migrate.

Parameters:

transferAgents - the new agent migration