Package fr.dyade.aaa.agent

Class AgentFactory

java.lang.Object

fr.dyade.aaa.agent.Agent

fr.dyade.aaa.agent.AgentFactory

All Implemented Interfaces:

AgentMBean, Encodable, Serializable

final class AgentFactory
extends Agent

Agent used to allow remote agent creation. Every agent server hosts a factory agent, they all use a predefined stamp identifier AgentId.factoryId. The factory must be able to create all types of objects, actually it is supposed that the corresponding classes can be reached.

The agent creation process involves the following steps

• locally creating the Agent object in memory ;
• serializing the agent state, building an AgentCreateRequest notification with the resulting string, sending it to the target Factory agent ;
• the factory agent building the object in memory from the serialized image, and saving it into operational storage ;
• the factory agent calling the initialize method.

The AgentDeleteRequest class of notification follows a similar process to remotely delete agents.

Field Summary

Fields

Modifier and Type	Field	Description
private static long	serialVersionUID	define serialVersionUID for interoperability

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

agentProfiling, commitTime, DEBUG, deployed, emptyString, fixed, id, last, logmon, name, reactNb, reactTime

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
AgentFactory(AgentId factoryId)	Allocates a new AgentFactory agent.

Method Summary

Modifier and Type	Method	Description
protected void	agentInitialize(boolean firstTime)	Gives this agent an opportunity to initialize after having been deployed, and each time it is loaded into memory.
protected String	getLogTopic()	Returns log topic for factory agent.
void	react(AgentId from, Notification not)	Reacts to notifications ... .

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

agentFinalize, agentSave, decode, delete, delete, delete, deploy, deploy, doAdminSyncNotification, encode, getAgentId, getCommitTime, getEncodableClassId, getEncodedSize, getId, getName, getReactNb, getReactTime, hasName, incWorkInProgress, isAgentProfiling, isDeployed, isFixed, isUpdated, load, 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

Constructor Detail

AgentFactory

AgentFactory(AgentId factoryId)

Allocates a new AgentFactory agent. An AgentFactory agent must be created on every agent server the first time it runs.

Parameters:

factoryId - unique identifier for factory agent.

Method Detail

getLogTopic

protected String getLogTopic()

Returns log topic for factory agent.

Overrides:

getLogTopic in class Agent

Returns:

the default log topic for agents.

agentInitialize

protected void agentInitialize(boolean firstTime)
                        throws Exception

Gives this agent an opportunity to initialize after having been deployed, and each time it is loaded into memory. Loads the list of agents with a fixed field set to true.

Overrides:

agentInitialize in class Agent

Parameters:

firstTime - true when first called by the factory

Throws:

Exception - unspecialized exception

react

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

Reacts to notifications ... .

Overrides:

react in class Agent

Parameters:

from - agent sending notification

not - notification to react to

Throws:

Exception - unspecialized exception