Package fr.dyade.aaa.jndi2.server

Class Container

java.lang.Object

fr.dyade.aaa.agent.Agent

fr.dyade.aaa.jndi2.server.Container

All Implemented Interfaces:

AgentMBean, Encodable, Serializable

public class Container
extends Agent

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private Vector	entryPoints
private LifeCycleListener	lifeCycleListener
private static long	serialVersionUID	define serialVersionUID for interoperability

Fields inherited from class fr.dyade.aaa.agent.Agent

agentProfiling, DEBUG, emptyString, fixed, logmon

Fields inherited from interface fr.dyade.aaa.common.encoding.Encodable

BOOLEAN_ENCODED_SIZE, BYTE_ENCODED_SIZE, DOUBLE_ENCODED_SIZE, FLOAT_ENCODED_SIZE, INT_ENCODED_SIZE, LONG_ENCODED_SIZE, SHORT_ENCODED_SIZE

Constructor Summary

Constructors

Constructor	Description
Container()	This agent cannot be swapped and has a reserved identifier on each agent server.

Method Summary

Modifier and Type	Method	Description
void	addEntryPoint(EntryPoint entryPoint)
void	agentFinalize(boolean lastTime)	Called to inform this agent that it is garbaged and that it should free any active resources that it has allocated.
void	agentInitialize(boolean firstTime)	Gives this agent an opportunity to initialize after having been deployed, and each time it is loaded into memory.
void	react(AgentId from, Notification not)	Defines the reaction of the agent when receiving a notification.
(package private) void	sendNotification(AgentId to, Notification not)
void	setLifeCycleListener(LifeCycleListener lifeCycleListener)

Methods inherited from class fr.dyade.aaa.agent.Agent

agentSave, decode, delete, delete, delete, deploy, deploy, doAdminSyncNotification, encode, getAgentId, getCommitTime, getEncodableClassId, getEncodedSize, getId, getLogTopic, getName, getReactNb, getReactTime, hasName, incWorkInProgress, isAgentProfiling, isDeployed, isFixed, isUpdated, load, needToBeCommited, resetCommitTime, resetReactTime, resetTimer, save, sendTo, sendTo, sendTo, setAgentProfiling, setName, setNoSave, setSave, toString

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

define serialVersionUID for interoperability

See Also:

Constant Field Values

entryPoints

private Vector entryPoints

lifeCycleListener

private LifeCycleListener lifeCycleListener

Constructor Detail

Container

public Container()

This agent cannot be swapped and has a reserved identifier on each agent server.

Method Detail

addEntryPoint

public void addEntryPoint(EntryPoint entryPoint)

setLifeCycleListener

public void setLifeCycleListener(LifeCycleListener lifeCycleListener)

react

public void react(AgentId from,
                  Notification not)
           throws Exception

Description copied from class: Agent

Defines the reaction of the agent when receiving a notification. This member function implements the common reactive behavior of an agent, it is called by the execution engine (see Engine class).

If there is no corresponding reaction, the agent send an UnknownNotification notification to the sender.

Overrides:

react in class Agent

Parameters:

from - agent sending notification

not - notification to react to

Throws:

Exception - unspecialized exception

agentInitialize

public void agentInitialize(boolean firstTime)
                     throws Exception

Description copied from class: Agent

Gives this agent an opportunity to initialize after having been deployed, and each time it is loaded into memory.

This function is first called by the factory agent, just after it deploys the agent.

This function is used by agents with a fixed field set to true to initialize their transient variables, as it is called each time the agent server is restarted.

This function is not declared final so that derived classes may change their reload policy. The implementation of this method provided by the Agent class just registers the JMS MBean.

Overrides:

agentInitialize in class Agent

Parameters:

firstTime - true when first called by the factory

Throws:

Exception - unspecialized exception

agentFinalize

public void agentFinalize(boolean lastTime)

Description copied from class: Agent

Called to inform this agent that it is garbaged and that it should free any active resources that it has allocated. A subclass of Agent should override this method if it has any operation that it wants to perform before it is garbaged. For example, an agent with threads (a ProxyAgent for example) would use the initialize method to create the threads and the agentFinalize method to stop them.

Be careful, the notification sending is not allowed in this method.

The implementation of this method provided by the Agent class just unregister the JMX MBean if needed.

Overrides:

agentFinalize in class Agent

Parameters:

lastTime - true when last called by the factory on agent deletion.

sendNotification

void sendNotification(AgentId to,
                      Notification not)