io.sarl.sre.services.lifecycle

Interface LifecycleServiceListener

All Superinterfaces:

EventListener

All Known Implementing Classes:

AgentEventEmitter, LifecycleServiceListener.LifecycleServiceAdapter

public interface LifecycleServiceListener
extends EventListener

Listener on events related to the life-cycle of an agent.

Version:

io.janusproject.plugin 0.12.0 20210527-171007

Author:

Sebastian Rodriguez, Stéphane Galland

Maven Group Id:

io.janusproject.sre

Maven Artifact Id:

io.janusproject.plugin

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	LifecycleServiceListener.LifecycleServiceAdapter Event adapter on events related to the life-cycle of an agent.

Method Summary

Modifier and Type	Method and Description
void	agentDestroyed(agent : Agent, outerContexts : ConcurrentCollection<ContextReference>, terminationCause : Object) Invoked when the agent is destroyed.
void	agentKillFailure(killingAgent : UUID, innerContext : ContextReference, cause : Object) Invoked when the agent killing has failed.
void	agentSpawned(spawningAgent : UUID, parent : Context, agentType : Class<? extends Agent>, spawnedAgent : Agent, initializationParameters : Object[]) Invoked when the agent is spawned.
void	agentSpawnFailure(spawningAgent : UUID, parent : Context, agentType : Class<? extends Agent>, cause : Object) Invoked when the agent spawning has failed.

Method Detail

agentSpawned

def agentSpawned(spawningAgent : UUID,
                 parent : Context,
                 agentType : Class<? extends Agent>,
                 spawnedAgent : Agent,
                 initializationParameters : Object[]) : void 

Description copied from interface: LifecycleServiceListener

Invoked when the agent is spawned.

Parameters:

spawningAgent - the identifier of the agent which spawns the given agent, if null, the root agent (Janus kernel) is assumed.

parent - the context in which the agent was created.

agentType - the type of the spawned agents.

spawnedAgent - the spawned agent.

initializationParameters - list of parameters that were passed to the agent.

agentDestroyed

def agentDestroyed(agent : Agent,
                   outerContexts : ConcurrentCollection<ContextReference>,
                   terminationCause : Object) : void 

Description copied from interface: LifecycleServiceListener

Invoked when the agent is destroyed.

Parameters:

agent - the destroyed agent.

outerContexts - the contexts from which the given agent were removed after its destruction.

terminationCause - the cause of the termination of the agent. If it is null, the agent was destroyed without providing a reason.

agentSpawnFailure

def agentSpawnFailure(spawningAgent : UUID,
                      parent : Context,
                      agentType : Class<? extends Agent>,
                      cause : Object) : void 

Description copied from interface: LifecycleServiceListener

Invoked when the agent spawning has failed.

Parameters:

spawningAgent - the identifier of the agent which spawns the given agent.

parent - the context in which the agent was created.

agentType - the type of the spawned agents.

cause - the cause of the failure.

agentKillFailure

def agentKillFailure(killingAgent : UUID,
                     innerContext : ContextReference,
                     cause : Object) : void 

Description copied from interface: LifecycleServiceListener

Invoked when the agent killing has failed.

Parameters:

killingAgent - the identifier of the agent tried to be killed.

innerContext - the inner context of the agent.

cause - the cause of the failure