Package jade.core

Class BackEndContainer

java.lang.Object

jade.core.BackEndContainer

All Implemented Interfaces:

AgentContainer, BackEnd

public class BackEndContainer
extends Object
implements BackEnd

Author:

Giovanni Caire - TILAB, Jerome Picault - Motorola Labs

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	BackEndContainer.AgentImage	Inner class AgentImage

Field Summary

Fields

Modifier and Type	Field	Description
static String	ENABLE_MONITOR
protected jade.core.LADT	localAgents
static String	MONITOR_AGENT_CLASS
static String	MONITOR_AGENT_NAME
protected jade.core.CommandProcessor	myCommandProcessor
protected ContainerID	myID
protected IMTPManager	myIMTPManager
protected MainContainerImpl	myMainContainer
protected NodeDescriptor	myNodeDescriptor
protected Profile	myProfile
protected Credentials	ownerCredentials
protected JADEPrincipal	ownerPrincipal
static String	RESYNCH
static String	USE_BACKEND_MANAGER
static String	VERBOSE_SHUTDOWN	Profile option that specifies whether or not all log messages should be produced during the shutdown procedure

Fields inherited from interface jade.core.AgentContainer

AUX_CONTAINER_NAME, MAIN_CONTAINER_NAME

Constructor Summary

Constructors

Constructor	Description
BackEndContainer(Properties props, BEConnectionManager cm)

Method Summary

Modifier and Type	Method	Description
Agent	acquireLocalAgent(AID id)
void	addAddressToLocalAgents(String address)
BackEndContainer.AgentImage	addAgentImage(AID id, BackEndContainer.AgentImage img)
Agent	addLocalAgent(AID id, Agent a)
void	addPlatformListener(AgentManager.Listener l)
AID[]	agentNames()
void	becomeLeader(AMSEventQueueFeeder feeder)
String	bornAgent(String name)	A new agent has just started on the FrontEnd.
boolean	connect()
BackEndContainer.AgentImage	createAgentImage(AID id)
void	createAgentOnFE(String name, String className, String[] args)
void	deadAgent(String name)	An agent has just died on the FrontEnd.
void	disableDebugger(AID debuggerName, AID notToBeDebugged)	This method is re-defined to avoid NullPointerException.
void	enableDebugger(AID debuggerName, AID toBeDebugged)	This method is re-defined to avoid NullPointerException.
void	fillListFromBlockedBehaviours(List behaviours, Agent a)
void	fillListFromMessageQueue(List messages, Agent a)
void	fillListFromReadyBehaviours(List behaviours, Agent a)
BackEndContainer.AgentImage	getAgentImage(AID id)
AID[]	getAgentImages()
AID	getAMS()
Properties	getBootProperties()
AgentContainer	getContainerController(JADEPrincipal principal, Credentials credentials)
AID	getDefaultDF()
ServiceHelper	getHelper(Agent a, String serviceName)
ContainerID	getID()
MainContainer	getMain()
NodeDescriptor	getNodeDescriptor()
String	getPlatformID()
String	getProperty(String key, String aDefault)
ServiceFinder	getServiceFinder()
ServiceManager	getServiceManager()
void	handleBehaviourAdded(AID agentID, Behaviour b)
void	handleBehaviourRemoved(AID agentID, Behaviour b)
void	handleChangeBehaviourState(AID agentID, Behaviour b, String from, String to)
void	handleChangedAgentPrincipal(AID agentID, JADEPrincipal oldPrincipal, Credentials creds)
void	handleChangedAgentState(AID agentID, int oldState, int newState)
void	handleEnd(AID agentID)
void	handlePosted(AID agentID, ACLMessage msg)
void	handleReceived(AID agentID, ACLMessage msg)	Issue a NOTIFY_RECEIVED VerticalCommand
void	handleSend(ACLMessage msg, AID sender, boolean needClone)	Issue a SEND_MESSAGE VerticalCommand for each receiver
Location	here()
protected void	init()
void	initAgent(AID agentID, Agent instance, JADEPrincipal ownerPrincipal, Credentials initialCredentials)	Issue an INFORM_CREATED vertical command.
boolean	isJoined()
boolean	isLocalAgent(AID id)
void	killAgentOnFE(String name)
void	messageOut(ACLMessage msg, String sender)	An agent on the FrontEnd has sent a message.
boolean	postMessagesBlockToLocalAgent(ACLMessage[] mm, AID receiverID)
boolean	postMessageToLocalAgent(ACLMessage msg, AID receiverID)	Dispatch a message to an agent in the FrontEnd.
void	powerUpLocalAgent(AID agentID)
void	releaseLocalAgent(AID id)
void	removeAddressFromLocalAgents(String address)
BackEndContainer.AgentImage	removeAgentImage(AID id)
void	removeLocalAgent(AID id)
List	removePendingMessages(MessageTemplate template, boolean notifyFailure)
void	removePlatformListener(AgentManager.Listener l)
void	resumeAgentOnFE(String name)
void	resumedAgent(String name)	Notify the BackEnd container that an agent has resumed.
Object	serviceInvokation(String actor, String serviceName, String methodName, Object[] methodParams)	Pass a service helper method invocation request to the BackEnd
void	setPlatformAddresses(AID id)
void	shutDown()
protected void	startNode()	Add the node to the platform with the basic services
protected ServiceDescriptor	startService(String name, boolean activateIt)
protected void	stopService(String name)
void	suspendAgentOnFE(String name)
void	suspendedAgent(String name)	Notify the BackEnd container that an agent has suspended.

Methods inherited from class java.lang.Object

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

Field Detail

USE_BACKEND_MANAGER

public static final String USE_BACKEND_MANAGER

See Also:

Constant Field Values

RESYNCH

public static final String RESYNCH

See Also:

Constant Field Values

VERBOSE_SHUTDOWN

public static final String VERBOSE_SHUTDOWN

Profile option that specifies whether or not all log messages should be produced during the shutdown procedure

See Also:

Constant Field Values

ENABLE_MONITOR

public static final String ENABLE_MONITOR

See Also:

Constant Field Values

MONITOR_AGENT_NAME

public static final String MONITOR_AGENT_NAME

See Also:

Constant Field Values

MONITOR_AGENT_CLASS

public static final String MONITOR_AGENT_CLASS

See Also:

Constant Field Values

localAgents

protected jade.core.LADT localAgents

myProfile

protected Profile myProfile

myCommandProcessor

protected jade.core.CommandProcessor myCommandProcessor

myMainContainer

protected MainContainerImpl myMainContainer

myIMTPManager

protected IMTPManager myIMTPManager

myID

protected ContainerID myID

myNodeDescriptor

protected NodeDescriptor myNodeDescriptor

ownerPrincipal

protected JADEPrincipal ownerPrincipal

ownerCredentials

protected Credentials ownerCredentials

Constructor Detail

BackEndContainer

public BackEndContainer(Properties props,
                        BEConnectionManager cm)
                 throws ProfileException

Throws:

ProfileException

Method Detail

connect

public boolean connect()

startNode

protected void startNode()
                  throws IMTPException,
                         ProfileException,
                         ServiceException,
                         JADESecurityException,
                         NotFoundException

Add the node to the platform with the basic services

Throws:

IMTPException

ProfileException

ServiceException

JADESecurityException

NotFoundException

bornAgent

public String bornAgent(String name)
                 throws JADESecurityException,
                        IMTPException

A new agent has just started on the FrontEnd. Adjust the agent name taking into account wild-cards. Issue an INFORM_CREATED vertical command.

Specified by:

bornAgent in interface BackEnd

Parameters:

name - The name of the new agent.

Returns:

the actual name of the agent

Throws:

JADESecurityException

IMTPException

deadAgent

public void deadAgent(String name)
               throws IMTPException

An agent has just died on the FrontEnd. Remove its image and notify the Main

Specified by:

deadAgent in interface BackEnd

Parameters:

name - The name of the dead agent.

Throws:

IMTPException

suspendedAgent

public void suspendedAgent(String name)
                    throws NotFoundException,
                           IMTPException

Description copied from interface: BackEnd

Notify the BackEnd container that an agent has suspended.

Specified by:

suspendedAgent in interface BackEnd

Parameters:

name - The name of the suspended agent.

Throws:

NotFoundException

IMTPException

resumedAgent

public void resumedAgent(String name)
                  throws NotFoundException,
                         IMTPException

Description copied from interface: BackEnd

Notify the BackEnd container that an agent has resumed.

Specified by:

resumedAgent in interface BackEnd

Parameters:

name - The name of the resumed agent.

Throws:

NotFoundException

IMTPException

messageOut

public void messageOut(ACLMessage msg,
                       String sender)
                throws NotFoundException,
                       IMTPException

An agent on the FrontEnd has sent a message. Note that the NotFoundException here is referred to the sender and indicates an inconsistency between the FrontEnd and the BackEnd

Specified by:

messageOut in interface BackEnd

Parameters:

msg - The message to be dispatched.

sender - The name of the sender agent.

Throws:

NotFoundException

IMTPException

serviceInvokation

public Object serviceInvokation(String actor,
                                String serviceName,
                                String methodName,
                                Object[] methodParams)
                         throws NotFoundException,
                                ServiceException,
                                IMTPException

Description copied from interface: BackEnd

Pass a service helper method invocation request to the BackEnd

Specified by:

serviceInvokation in interface BackEnd

Parameters:

actor - The name of the agent that invoked the method

serviceName - The name of the service

methodName - The name of the invoked method

methodParams - The parameters of the invoked methods as an array of Objects

Returns:

the result of the invoked method or null if the method returns void

Throws:

NotFoundException

ServiceException

IMTPException

createAgentOnFE

public void createAgentOnFE(String name,
                            String className,
                            String[] args)
                     throws IMTPException

Throws:

IMTPException

killAgentOnFE

public void killAgentOnFE(String name)
                   throws IMTPException,
                          NotFoundException

Throws:

IMTPException

NotFoundException

suspendAgentOnFE

public void suspendAgentOnFE(String name)
                      throws IMTPException,
                             NotFoundException

Throws:

IMTPException

NotFoundException

resumeAgentOnFE

public void resumeAgentOnFE(String name)
                     throws IMTPException,
                            NotFoundException

Throws:

IMTPException

NotFoundException

postMessageToLocalAgent

public boolean postMessageToLocalAgent(ACLMessage msg,
                                       AID receiverID)

Dispatch a message to an agent in the FrontEnd. If this method is called by a thread that is serving a message sent by an agent in the FrontEnd too, nothing is done as the dispatch has already taken place in the FrontEnd (see messageOut()).

Specified by:

postMessageToLocalAgent in interface AgentContainer

postMessagesBlockToLocalAgent

public boolean postMessagesBlockToLocalAgent(ACLMessage[] mm,
                                             AID receiverID)

Specified by:

postMessagesBlockToLocalAgent in interface AgentContainer

acquireLocalAgent

public Agent acquireLocalAgent(AID id)

Specified by:

acquireLocalAgent in interface AgentContainer

releaseLocalAgent

public void releaseLocalAgent(AID id)

Specified by:

releaseLocalAgent in interface AgentContainer

agentNames

public AID[] agentNames()

Specified by:

agentNames in interface AgentContainer

enableDebugger

public void enableDebugger(AID debuggerName,
                           AID toBeDebugged)
                    throws IMTPException

This method is re-defined to avoid NullPointerException. In fact a search in the LADT would be done for the agent to be debugged, but the LADT is obviously empty.

Throws:

IMTPException

disableDebugger

public void disableDebugger(AID debuggerName,
                            AID notToBeDebugged)
                     throws IMTPException

This method is re-defined to avoid NullPointerException. In fact a search in the LADT would be done for the agent to be debugged, but the LADT is obviously empty.

Throws:

IMTPException

shutDown

public void shutDown()

Specified by:

shutDown in interface AgentContainer

createAgentImage

public BackEndContainer.AgentImage createAgentImage(AID id)

addAgentImage

public BackEndContainer.AgentImage addAgentImage(AID id,
                                                 BackEndContainer.AgentImage img)

removeAgentImage

public BackEndContainer.AgentImage removeAgentImage(AID id)

getAgentImage

public BackEndContainer.AgentImage getAgentImage(AID id)

getAgentImages

public AID[] getAgentImages()

removePendingMessages

public List removePendingMessages(MessageTemplate template,
                                  boolean notifyFailure)

getContainerController

public AgentContainer getContainerController(JADEPrincipal principal,
                                             Credentials credentials)

initAgent

public void initAgent(AID agentID,
                      Agent instance,
                      JADEPrincipal ownerPrincipal,
                      Credentials initialCredentials)
               throws NameClashException,
                      IMTPException,
                      NotFoundException,
                      JADESecurityException

Issue an INFORM_CREATED vertical command. Note that the Principal, if any, is that of the owner of the newly born agent, while the Credentials, if any, are a set additional initial credentials to be attached to the newly born agent. The SecurityService, if active, will create a new Principal for the newly born agent and will initialize its credentials as the union of the initial credential and the ownership certificate.

Specified by:

initAgent in interface AgentContainer

Throws:

NameClashException

IMTPException

NotFoundException

JADESecurityException

getNodeDescriptor

public NodeDescriptor getNodeDescriptor()

Specified by:

getNodeDescriptor in interface AgentContainer

init

protected void init()
             throws IMTPException,
                    ProfileException

Throws:

IMTPException

ProfileException

here

public Location here()

Specified by:

here in interface AgentContainer

handleSend

public void handleSend(ACLMessage msg,
                       AID sender,
                       boolean needClone)

Issue a SEND_MESSAGE VerticalCommand for each receiver

handlePosted

public void handlePosted(AID agentID,
                         ACLMessage msg)

handleReceived

public void handleReceived(AID agentID,
                           ACLMessage msg)

Issue a NOTIFY_RECEIVED VerticalCommand

handleBehaviourAdded

public void handleBehaviourAdded(AID agentID,
                                 Behaviour b)

handleBehaviourRemoved

public void handleBehaviourRemoved(AID agentID,
                                   Behaviour b)

handleChangeBehaviourState

public void handleChangeBehaviourState(AID agentID,
                                       Behaviour b,
                                       String from,
                                       String to)

handleChangedAgentPrincipal

public void handleChangedAgentPrincipal(AID agentID,
                                        JADEPrincipal oldPrincipal,
                                        Credentials creds)

handleChangedAgentState

public void handleChangedAgentState(AID agentID,
                                    int oldState,
                                    int newState)

handleEnd

public void handleEnd(AID agentID)

setPlatformAddresses

public void setPlatformAddresses(AID id)

getAMS

public AID getAMS()

Specified by:

getAMS in interface AgentContainer

getDefaultDF

public AID getDefaultDF()

Specified by:

getDefaultDF in interface AgentContainer

getProperty

public String getProperty(String key,
                          String aDefault)

getBootProperties

public Properties getBootProperties()

getHelper

public ServiceHelper getHelper(Agent a,
                               String serviceName)
                        throws ServiceException

Throws:

ServiceException

getPlatformID

public String getPlatformID()

Specified by:

getPlatformID in interface AgentContainer

addLocalAgent

public Agent addLocalAgent(AID id,
                           Agent a)

Specified by:

addLocalAgent in interface AgentContainer

powerUpLocalAgent

public void powerUpLocalAgent(AID agentID)
                       throws NotFoundException

Specified by:

powerUpLocalAgent in interface AgentContainer

Throws:

NotFoundException

removeLocalAgent

public void removeLocalAgent(AID id)

Specified by:

removeLocalAgent in interface AgentContainer

isLocalAgent

public boolean isLocalAgent(AID id)

Specified by:

isLocalAgent in interface AgentContainer

fillListFromMessageQueue

public void fillListFromMessageQueue(List messages,
                                     Agent a)

Specified by:

fillListFromMessageQueue in interface AgentContainer

fillListFromReadyBehaviours

public void fillListFromReadyBehaviours(List behaviours,
                                        Agent a)

Specified by:

fillListFromReadyBehaviours in interface AgentContainer

fillListFromBlockedBehaviours

public void fillListFromBlockedBehaviours(List behaviours,
                                          Agent a)

Specified by:

fillListFromBlockedBehaviours in interface AgentContainer

addAddressToLocalAgents

public void addAddressToLocalAgents(String address)

Specified by:

addAddressToLocalAgents in interface AgentContainer

removeAddressFromLocalAgents

public void removeAddressFromLocalAgents(String address)

Specified by:

removeAddressFromLocalAgents in interface AgentContainer

getID

public ContainerID getID()

Specified by:

getID in interface AgentContainer

getMain

public MainContainer getMain()

Specified by:

getMain in interface AgentContainer

getServiceManager

public ServiceManager getServiceManager()

Specified by:

getServiceManager in interface AgentContainer

getServiceFinder

public ServiceFinder getServiceFinder()

Specified by:

getServiceFinder in interface AgentContainer

startService

protected ServiceDescriptor startService(String name,
                                         boolean activateIt)
                                  throws ServiceException

Throws:

ServiceException

stopService

protected void stopService(String name)
                    throws ServiceException

Throws:

ServiceException

becomeLeader

public void becomeLeader(AMSEventQueueFeeder feeder)

Specified by:

becomeLeader in interface AgentContainer

addPlatformListener

public void addPlatformListener(AgentManager.Listener l)
                         throws ClassCastException

Throws:

ClassCastException

removePlatformListener

public void removePlatformListener(AgentManager.Listener l)
                            throws ClassCastException

Throws:

ClassCastException

isJoined

public boolean isJoined()

Specified by:

isJoined in interface AgentContainer