org.objectweb.joram.mom.dest
Class Destination

java.lang.Object
  fr.dyade.aaa.agent.Agent
      org.objectweb.joram.mom.dest.Destination

All Implemented Interfaces:

AdminDestinationItf, AgentMBean, java.io.Serializable

Direct Known Subclasses:

Queue, Topic

public abstract class Destination

extends Agent

implements AdminDestinationItf

A Destination agent is an agent hosting a MOM destination, for example a Queue or a Topic. Its behaviour is provided by a DestinationImpl instance.

See Also:

DestinationImpl, Serialized Form

Field Summary

protected DestinationImpl

destImpl The reference of the DestinationImpl instance providing this this agent with its Destination behaviour.

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

fixed, logmon, name

Constructor Summary

	Destination() Empty constructor for newInstance().
	Destination(AgentId adminId) Constructs a Destination agent.
protected	Destination(boolean fixed) Constructor with parameters for fixing the destination.
protected	Destination(java.lang.String name, boolean fixed, int stamp) Constructor with parameters for fixing the destination and specifying its identifier.

Method Summary

protected void	agentInitialize(boolean firstTime) Gives this agent an opportunity to initialize after having been deployed, and each time it is loaded into memory.
abstract DestinationImpl	createsImpl(AgentId adminId) Creates the specific implementation.
void	init(AgentId adminId) Initializes the destination by creating the DestinationImpl object.
void	react(AgentId from, Notification not) Reactions to notifications are implemented by the DestinationImpl class.
void	setProperties(java.util.Properties prop) Sets properties for the destination.

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

agentFinalize, delete, delete, deploy, deploy, getId, getLogTopic, getName, isDeployed, isFixed, needToBeCommited, save, sendTo, sendTo, sendTo, setNoSave, toString

Methods inherited from class java.lang.Object

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

Field Detail

destImpl

protected DestinationImpl destImpl

The reference of the DestinationImpl instance providing this this agent with its Destination behaviour.

Constructor Detail

Destination

public Destination()

Empty constructor for newInstance().

Destination

public Destination(AgentId adminId)

Constructs a Destination agent.

Parameters:

adminId - Identifier of the agent which will be the administrator of the topic.

Destination

protected Destination(boolean fixed)

Constructor with parameters for fixing the destination.

Destination

protected Destination(java.lang.String name,
                      boolean fixed,
                      int stamp)

Constructor with parameters for fixing the destination and specifying its identifier.

Method Detail

init

public final void init(AgentId adminId)

Initializes the destination by creating the DestinationImpl object.

Specified by:

init in interface AdminDestinationItf

Parameters:

adminId - Identifier of the destination administrator.

createsImpl

public abstract DestinationImpl createsImpl(AgentId adminId)

Creates the specific implementation.

Parameters:

adminId - Identifier of the topic administrator.

setProperties

public void setProperties(java.util.Properties prop)

Sets properties for the destination.

Empty method as no properties may be set for the generic destination.

Specified by:

setProperties in interface AdminDestinationItf

agentInitialize

protected void agentInitialize(boolean firstTime)
                        throws java.lang.Exception

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

Overrides:

agentInitialize in class Agent

Parameters:

firstTime - true when first called by the factory

Throws:

java.lang.Exception - unspecialized exception

react

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

Reactions to notifications are implemented by the DestinationImpl class.

Overrides:

react in class Agent

Parameters:

from - agent sending notification

not - notification to react to

Throws:

java.lang.Exception - unspecialized exception