ensemble

Class EnvironmentAgent

java.lang.Object

jade.core.Agent

ensemble.EnsembleAgent

ensemble.EnvironmentAgent

All Implemented Interfaces:

LifeCycle, RouterClient, jade.core.TimerListener, java.io.Serializable, java.lang.Runnable

Direct Known Subclasses:

LM_Environment

public class EnvironmentAgent
extends EnsembleAgent

An agent that represents the environment.

Author:

Leandro Ferrari Thomaz

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private class	EnvironmentAgent.CheckAgentDeregister Checks if all Musical Agents were destroyed.
private class	EnvironmentAgent.CheckEndTurn Classe internar responsável por verificar se todos os agentes já agiram no turno atual.
private class	EnvironmentAgent.CheckRegister Classe interna responsável por verificar se uma simulação pode ser iniciada, ou seja, se todos os agentes estão prontos.
private class	EnvironmentAgent.KillAgent Kills this agent.

Nested classes/interfaces inherited from class jade.core.Agent

jade.core.Agent.Interrupted

Field Summary

Fields

Modifier and Type	Field and Description
private int	agentEventsProcessed Número de eventos processados pelos EventServers no turno atual.
private int	agentEventsSent Número de eventos enviados pelos Agentes Musicais no turno atual.
java.util.concurrent.ConcurrentHashMap<java.lang.String,java.lang.String>	agentsPublicFacts Tabela de fatos públicos dos agentes (Fenótipo).
private java.util.concurrent.locks.Lock	batchLock The batch lock.
protected jade.domain.FIPAAgentManagement.DFAgentDescription	dfd The dfd.
protected java.util.concurrent.ConcurrentHashMap<java.lang.String,EventServer>	eventServers Event Servers registrados (por tipo de evento).
private int	evtSrvEventsProcessed Número de eventos processados pelos Agentes Musicais no turno atual.
private int	evtSrvEventsSent Número de eventos enviados pelos EventServers para os Agentes no turno atual.
private long	initialAgents Número inicial de Agentes Musicais.
private long	lastUpdateTime The last update time.
private java.util.concurrent.locks.Lock	lock Lock.
private int	numberCreatedAgents Contador para manter nome dos agentes único.
private int	registeredAgents Número de agentes registrados no Ambiente.
private int	registeredAgentsNextTurn Número de agentes registrados no Ambiente para o próximo turno.
private int	registeredAgentsReady Número de agentes registrados que finalizaram suas ações no turno atual.
private Constants.EA_STATE	state Estado do Agente Ambiente.
(package private) jade.core.behaviours.ThreadedBehaviourFactory	tbf The tbf.
private boolean	waitAllAgents Controla se deve esperar todos os agentes serem criados para iniciar a simulação.
private long	waitTimeTurn Tempo mínimo de espera entre cada turno.
protected World	world Descrição do Mundo Virtual.

Fields inherited from class ensemble.EnsembleAgent

isBatch, parameters

Fields inherited from class jade.core.Agent

AP_ACTIVE, AP_DELETED, AP_IDLE, AP_INITIATED, AP_MAX, AP_MIN, AP_SUSPENDED, AP_WAITING, D_ACTIVE, D_MAX, D_MIN, D_RETIRED, D_SUSPENDED, D_UNKNOWN, MSG_QUEUE_CLASS

Constructor Summary

Constructors

Constructor and Description
EnvironmentAgent()

Method Summary

Methods

Modifier and Type	Method and Description
void	addEventServer(java.lang.String className, Parameters esParam) Cria uma instância de um EventServer esporádico ou frequente.
void	addWorld(java.lang.String className, Parameters parameters) Adds the world.
private void	agentProcessed(int events) Registra a mensagem de um agente indicando que terminou o turno.
java.lang.String	createMusicalAgent(java.lang.String agentName, java.lang.String agentClass, Parameters parameters) Cria um novo Agente no Ambiente.
protected void	deregisterAgent(java.lang.String agentName) Retira um agente musical do registro de agentes ativos no ambiente.
void	destroyAgent(java.lang.String agentName) Kills a musical agent.
private void	eventAgentProcessed() Registra que um Agente terminou de processar.
void	eventProcessed() Registra a informação do EventServer que um evento foi processado.
void	eventSent() Registra que um evento foi enviado pelo EventServer.
Constants.EA_STATE	getEAState() Gets the eA state.
EventServer	getEventServer(java.lang.String eventType) Gets the event server.
World	getWorld() Gets the world.
protected void	prepareAgent(java.lang.String agentName) Prepare agent.
protected void	preUpdateClock() Método executado pelo Ambiente, quando em modo BATCH, imediatamente antes de alterar o turno.
protected void	processControlCommand(Command cmd) Process control command.
void	receiveCommand(Command cmd) A framework-implemented method that receives a command sent by the RouterAgent and calls processCommand.
protected void	registerAgent(java.lang.String agentName, Parameters parameters) Registra um agente musical no Ambiente.
protected void	registerService(java.lang.String name, java.lang.String type) Registra um tipo de evento tratado por este Agente Ambiente no diretório do JADE.
void	removeEventServer(java.lang.String eventType) Removes an EventServer from the EnvironmentAgent.
boolean	start() Framework-implemented initialization method.
boolean	stop() Framework-implemented finalization method.

Methods inherited from class ensemble.EnsembleAgent

configure, finit, getAddress, getAgent, getAgentName, getClock, getParameter, getParameter, getParameters, init, parameterUpdate, processCommand, sendCommand, setParameters, setup, takeDown

Methods inherited from class jade.core.Agent

addBehaviour, afterClone, afterMove, beforeClone, beforeMove, blockingReceive, blockingReceive, blockingReceive, blockingReceive, changeStateTo, clean, createMessageQueue, doActivate, doClone, doDelete, doMove, doSuspend, doTimeOut, doWait, doWait, doWake, getAgentState, getAID, getAMS, getArguments, getBootProperties, getContainerController, getContentManager, getCurQueueSize, getDefaultDF, getHap, getHelper, getLocalName, getName, getO2AObject, getProperty, getQueueSize, getState, here, isRestarting, join, notifyChangeBehaviourState, notifyRestarted, postMessage, putBack, putO2AObject, receive, receive, removeBehaviour, removeTimer, restartLater, restore, restoreBufferedState, run, send, setArguments, setEnabledO2ACommunication, setGenerateBehaviourEvents, setO2AManager, setQueueSize, waitUntilStarted, write

Methods inherited from class java.lang.Object

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

Field Detail

state

private Constants.EA_STATE state

Estado do Agente Ambiente.

dfd

protected jade.domain.FIPAAgentManagement.DFAgentDescription dfd

The dfd.

tbf

jade.core.behaviours.ThreadedBehaviourFactory tbf

The tbf.

lock

private java.util.concurrent.locks.Lock lock

Lock.

batchLock

private java.util.concurrent.locks.Lock batchLock

The batch lock.

world

protected World world

Descrição do Mundo Virtual.

eventServers

protected java.util.concurrent.ConcurrentHashMap<java.lang.String,EventServer> eventServers

Event Servers registrados (por tipo de evento).

agentsPublicFacts

public java.util.concurrent.ConcurrentHashMap<java.lang.String,java.lang.String> agentsPublicFacts

Tabela de fatos públicos dos agentes (Fenótipo).

numberCreatedAgents

private int numberCreatedAgents

Contador para manter nome dos agentes único.

lastUpdateTime

private long lastUpdateTime

The last update time.

waitTimeTurn

private long waitTimeTurn

Tempo mínimo de espera entre cada turno.

waitAllAgents

private boolean waitAllAgents

Controla se deve esperar todos os agentes serem criados para iniciar a simulação.

initialAgents

private long initialAgents

Número inicial de Agentes Musicais.

registeredAgents

private int registeredAgents

Número de agentes registrados no Ambiente.

registeredAgentsNextTurn

private int registeredAgentsNextTurn

Número de agentes registrados no Ambiente para o próximo turno.

registeredAgentsReady

private int registeredAgentsReady

Número de agentes registrados que finalizaram suas ações no turno atual.

agentEventsSent

private int agentEventsSent

Número de eventos enviados pelos Agentes Musicais no turno atual.

agentEventsProcessed

private int agentEventsProcessed

Número de eventos processados pelos EventServers no turno atual.

evtSrvEventsSent

private int evtSrvEventsSent

Número de eventos enviados pelos EventServers para os Agentes no turno atual.

evtSrvEventsProcessed

private int evtSrvEventsProcessed

Número de eventos processados pelos Agentes Musicais no turno atual.

Constructor Detail

EnvironmentAgent

public EnvironmentAgent()

Method Detail

getEAState

public final Constants.EA_STATE getEAState()

Gets the eA state.

Returns:

the eA state

getWorld

public final World getWorld()

Gets the world.

Returns:

the world

getEventServer

public final EventServer getEventServer(java.lang.String eventType)

Gets the event server.

Parameters:

eventType - the event type

Returns:

the event server

start

public boolean start()

Description copied from interface: LifeCycle

Framework-implemented initialization method.

Returns:

true, if successful

stop

public boolean stop()

Description copied from interface: LifeCycle

Framework-implemented finalization method.

Returns:

true, if successful

addWorld

public void addWorld(java.lang.String className,
            Parameters parameters)

Adds the world.

Parameters:

className - the class name

parameters - the parameters

registerService

protected final void registerService(java.lang.String name,
                   java.lang.String type)

Registra um tipo de evento tratado por este Agente Ambiente no diretório do JADE.

Parameters:

name - nome do EventServer que trata o evento

type - tipo do evento

addEventServer

public final void addEventServer(java.lang.String className,
                  Parameters esParam)

Cria uma instância de um EventServer esporádico ou frequente.

Parameters:

className - classe Java do EventServer

esParam - the es param

removeEventServer

public final void removeEventServer(java.lang.String eventType)

Removes an EventServer from the EnvironmentAgent.

Parameters:

eventType - the event type

processControlCommand

protected final void processControlCommand(Command cmd)

Process control command.

Parameters:

cmd - the cmd

receiveCommand

public final void receiveCommand(Command cmd)

Description copied from interface: RouterClient

A framework-implemented method that receives a command sent by the RouterAgent and calls processCommand.

Parameters:

cmd - the cmd

createMusicalAgent

public final java.lang.String createMusicalAgent(java.lang.String agentName,
                                  java.lang.String agentClass,
                                  Parameters parameters)

Cria um novo Agente no Ambiente. Se o nome do agente é null ou vazio, cria um nome sequencial, baseado na classe.

Parameters:

agentName - the agent name

agentClass - the agent class

parameters - the parameters

Returns:

the string

destroyAgent

public final void destroyAgent(java.lang.String agentName)

Kills a musical agent.

Parameters:

agentName - Musical Agent's name

registerAgent

protected final void registerAgent(java.lang.String agentName,
                 Parameters parameters)

Registra um agente musical no Ambiente.

Parameters:

agentName - the agent name

parameters - the parameters

prepareAgent

protected final void prepareAgent(java.lang.String agentName)

Prepare agent.

Parameters:

agentName - the agent name

deregisterAgent

protected final void deregisterAgent(java.lang.String agentName)

Retira um agente musical do registro de agentes ativos no ambiente.

Parameters:

agentName - the agent name

agentProcessed

private final void agentProcessed(int events)

Registra a mensagem de um agente indicando que terminou o turno.

Parameters:

events - the events

eventProcessed

public final void eventProcessed()

Registra a informação do EventServer que um evento foi processado.

eventSent

public final void eventSent()

Registra que um evento foi enviado pelo EventServer.

eventAgentProcessed

private final void eventAgentProcessed()

Registra que um Agente terminou de processar.

preUpdateClock

protected void preUpdateClock()

Método executado pelo Ambiente, quando em modo BATCH, imediatamente antes de alterar o turno.