/*****************************************************************
JADE - Java Agent DEvelopment Framework is a framework to develop
multi-agent systems in compliance with the FIPA specifications.
Copyright (C) 2000 CSELT S.p.A.
The updating of this file to JADE 2.0 has been partially supported by the IST-1999-10211 LEAP Project
GNU Lesser General Public License
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation,
version 2.1 of the License.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the
Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.
*****************************************************************/
package jade.domain;
//#APIDOC_EXCLUDE_FILE
//#MIDP_EXCLUDE_FILE
import java.io.FileWriter;
import jade.util.leap.Iterator;
import jade.util.leap.List;
import jade.util.leap.ArrayList;
import jade.util.leap.Map;
import jade.util.leap.HashMap;
import jade.util.InputQueue;
import jade.util.Logger;
import java.util.Hashtable;
import jade.core.*;
import jade.core.behaviours.*;
import jade.core.event.PlatformEvent;
import jade.core.event.MTPEvent;
import jade.domain.FIPAAgentManagement.InternalError;
import jade.domain.FIPAAgentManagement.*;
import jade.domain.JADEAgentManagement.*;
import jade.domain.introspection.*;
import jade.domain.mobility.*;
import jade.lang.acl.ACLMessage;
import jade.lang.acl.MessageTemplate;
import jade.content.*;
import jade.content.lang.*;
import jade.content.lang.sl.*;
import jade.content.onto.basic.Action;
import jade.mtp.MTPException;
import jade.mtp.MTPDescriptor;
import jade.security.JADESecurityException;
import jade.security.JADEPrincipal;
import jade.security.Credentials;
import java.util.Date;
/**
Standard <em>Agent Management System</em> agent. This class
implements <em><b>FIPA</b></em> <em>AMS</em> agent. <b>JADE</b>
applications cannot use this class directly, but interact with it
through <em>ACL</em> message passing.
@author Giovanni Rimassa - Universita' di Parma
@author Giovanni Caire - TILAB
@version $Date: 2009-12-22 15:36:11 +0100 (mar, 22 dic 2009) $ $Revision: 6242 $
*/
public class ams extends Agent /*implements AgentManager.Listener*/ {
public static final String PERIODIC_LOG_DELAY = "jade_domain_ams_periodiclogdelay";
public static final String MAX_RESULTS = "jade_domain_ams_maxresult";
// Limit of searchConstraints.maxresult
// FIPA Agent Management Specification doc num: SC00023J (6.1.4 Search Constraints)
// a negative value of maxresults indicates that the sender agent is willing to receive
// all available results
private static final int DEFAULT_MAX_RESULTS = 100;
private static final int DEFAULT_PERIODIC_LOG_DELAY = -1;
private int amsMaxResults = DEFAULT_MAX_RESULTS;
private Logger logger;
// The AgentPlatform where information about agents is stored
private AgentManager myPlatform;
// The codec for the SL language
private Codec codec = new SLCodec();
// ACL Message to use for tool notification
private ACLMessage toolNotification = new ACLMessage(ACLMessage.INFORM);
// Buffer for AgentPlatform notifications
private InputQueue eventQueue = new InputQueue();
private AMSEventQueueFeeder queueFeeder;
private Hashtable pendingNewAgents = new Hashtable();
private Hashtable pendingDeadAgents = new Hashtable();
private Hashtable pendingClonedAgents = new Hashtable();
private Hashtable pendingMovedAgents = new Hashtable();
private Hashtable pendingRemovedContainers = new Hashtable();
private APDescription theProfile = new APDescription();
/**
This constructor creates a new <em>AMS</em> agent. Since a direct
reference to an Agent Platform implementation must be passed to
it, this constructor cannot be called from application
code. Therefore, no other <em>AMS</em> agent can be created
beyond the default one.
*/
public ams(AgentManager ap) {
logger = Logger.getMyLogger(FIPANames.AMS);
myPlatform = ap;
// GC-MODIFY-18022007-START
//myPlatform.addListener(this);
// GC-MODIFY-18022007-END
}
/**
AMS initialization
*/
protected void setup() {
// Agent Platform Description.
theProfile.setName("\"" + getHap() + "\"");
writeAPDescription(theProfile);
String sLogDelay = getProperty(PERIODIC_LOG_DELAY, String.valueOf(DEFAULT_PERIODIC_LOG_DELAY));
try {
int logDelay = Integer.parseInt(sLogDelay);
if (logDelay > 0) {
// Activate periodic log
addBehaviour(new TickerBehaviour(this, (long) logDelay) {
public void onTick() {
logger.log(Logger.INFO, "JADE AMS active...");
}
});
}
}
catch (Exception e) {
logger.log(Logger.WARNING, "Wrong periodic log delay value "+sLogDelay+". It must be an integer value.");
}
String sMaxResults = getProperty(MAX_RESULTS, String.valueOf(DEFAULT_MAX_RESULTS));
try {
amsMaxResults = Integer.parseInt(sMaxResults);
}
catch (Exception e) {
logger.log(Logger.WARNING, "Wrong max result limit "+sMaxResults+". It must be an integer value.");
}
// Register the supported ontologies
getContentManager().registerOntology(FIPAManagementOntology.getInstance());
getContentManager().registerOntology(JADEManagementOntology.getInstance());
getContentManager().registerOntology(IntrospectionOntology.getInstance());
// Use fully qualified name to avoid conflict with old jade.domain.MobilityOntology
getContentManager().registerOntology(jade.domain.mobility.MobilityOntology.getInstance());
// register the supported languages: all profiles of SL are ok for ams
getContentManager().registerLanguage(codec, FIPANames.ContentLanguage.FIPA_SL0);
getContentManager().registerLanguage(codec, FIPANames.ContentLanguage.FIPA_SL1);
getContentManager().registerLanguage(codec, FIPANames.ContentLanguage.FIPA_SL2);
getContentManager().registerLanguage(codec, FIPANames.ContentLanguage.FIPA_SL);
// The behaviour managing FIPA requests
MessageTemplate mtF = MessageTemplate.and(MessageTemplate.MatchPerformative(ACLMessage.REQUEST), MessageTemplate.MatchOntology(FIPAManagementVocabulary.NAME));
Behaviour fipaResponderB = new AMSFipaAgentManagementBehaviour(this, mtF);
addBehaviour(fipaResponderB);
// The behaviour managing JADE requests
// MobilityOntology is matched for JADE 2.5 Backward compatibility
MessageTemplate mtJ = MessageTemplate.and(MessageTemplate.MatchPerformative(ACLMessage.REQUEST), MessageTemplate.or(MessageTemplate.MatchOntology(JADEManagementVocabulary.NAME), MessageTemplate.MatchOntology(jade.domain.mobility.MobilityOntology.NAME)));
Behaviour jadeResponderB = new AMSJadeAgentManagementBehaviour(this, mtJ);
addBehaviour(jadeResponderB);
// The behaviours dealing with platform tools
Behaviour registerTool = new RegisterToolBehaviour();
Behaviour deregisterTool = new DeregisterToolBehaviour();
Behaviour eventManager = new EventManager();
// Temporary patch:
SequentialBehaviour sb = new SequentialBehaviour();
sb.addSubBehaviour(new WakerBehaviour(this, 1000) {
public void onWake() {
// Just do nothing
}
});
sb.addSubBehaviour(registerTool);
addBehaviour(sb);
addBehaviour(deregisterTool);
addBehaviour(eventManager);
eventQueue.associate(eventManager);
// Initialize the message used for tools notification
toolNotification.setLanguage(FIPANames.ContentLanguage.FIPA_SL0);
toolNotification.setOntology(IntrospectionOntology.NAME);
toolNotification.setInReplyTo("tool-subscription");
}
//////////////////////////////////////////////////////////////////
// Methods implementing the actions of the JADEManagementOntology.
// All these methods
// - extract the necessary information from the requested Action
// object and format them properly (if necessary)
// - Call the corresponding method of the AgentManager using the
// permissions of the requester agent.
// - Convert eventual JADE-internal Exceptions into proper FIPAException.
// These methods are package-scoped as they are called by the
// AMSJadeAgentManagementBehaviour.
//////////////////////////////////////////////////////////////////
// CREATE AGENT
void createAgentAction(final CreateAgent ca, final AID requester, final JADEPrincipal requesterPrincipal, final Credentials requesterCredentials) throws FIPAException {
final String agentName = ca.getAgentName();
final AID agentID = new AID(agentName, AID.ISLOCALNAME);
final String className = ca.getClassName();
final ContainerID container = ca.getContainer();
if (logger.isLoggable(Logger.FINE))
logger.log(Logger.FINE, "Agent " + requester + " requesting Create-agent " + agentID + " on container " + container);
// Prepare arguments as a Object[]
Iterator it = ca.getAllArguments();
ArrayList listArg = new ArrayList();
while (it.hasNext()) {
listArg.add(it.next());
}
final Object[] args = listArg.toArray();
final JADEPrincipal owner = ca.getOwner();
final Credentials initialCredentials = ca.getInitialCredentials();
// Do the job in a separated thread to avoid deadlock
Thread auxThread = new Thread() {
public void run() {
try {
myPlatform.create(agentName, className, args, container, owner, initialCredentials, requesterPrincipal, requesterCredentials);
} catch (UnreachableException ue) {
// Send failure notification to the requester if any. Note that UnreachableException also wraps IMTPException that is not necessarily related to a real un-reachability problem
sendFailureNotification(ca, agentID, new InternalError(ue.getMessage()));
} catch (JADESecurityException ae) {
if (logger.isLoggable(Logger.SEVERE))
logger.log(Logger.SEVERE, "Agent " + requester.getName() + " does not have permission to perform action Create-agent: " + ae);
// Send failure notification to the requester if any
sendFailureNotification(ca, agentID, new Unauthorised());
} catch (NotFoundException nfe) {
// Send failure notification to the requester if any
sendFailureNotification(ca, agentID, new InternalError("Destination container not found. " + nfe.getMessage()));
} catch (NameClashException nce) {
// Send failure notification to the requester if any
sendFailureNotification(ca, agentID, new AlreadyRegistered());
} catch (Throwable t) {
// Send failure notification to the requester if any
sendFailureNotification(ca, agentID, new InternalError(t.getMessage()));
}
}
};
auxThread.start();
}
// KILL AGENT
void killAgentAction(KillAgent ka, AID requester, JADEPrincipal requesterPrincipal, Credentials requesterCredentials) throws FIPAException {
final AID agentID = ka.getAgent();
if (logger.isLoggable(Logger.FINE))
logger.log(Logger.FINE, "Agent " + requester + " requesting Kill-agent " + agentID);
try {
myPlatform.kill(agentID, requesterPrincipal, requesterCredentials);
} catch (JADESecurityException ae) {
if (logger.isLoggable(Logger.SEVERE))
logger.log(Logger.SEVERE, "Agent " + requester.getName() + " does not have permission to perform action KillAgent");
throw new Unauthorised();
} catch (UnreachableException ue) {
throw new InternalError("Container not reachable. " + ue.getMessage());
} catch (NotFoundException nfe) {
throw new InternalError("Agent not found. " + nfe.getMessage());
} catch (Exception e) {
e.printStackTrace();
throw new InternalError("Unexpected exception. " + e.getMessage());
}
}
// CLONE AGENT
void cloneAgentAction(CloneAction ca, AID requester) throws FIPAException {
MobileAgentDescription dsc = ca.getMobileAgentDescription();
final AID agentID = dsc.getName();
final ContainerID where = (ContainerID) dsc.getDestination();
final String newName = ca.getNewName();
if (logger.isLoggable(Logger.CONFIG))
logger.log(Logger.CONFIG, "Agent " + requester + " requesting Clone-agent " + agentID + " on container " + where);
try {
myPlatform.copy(agentID, where, newName);
} catch (JADESecurityException ae) {
if (logger.isLoggable(Logger.SEVERE))
logger.log(Logger.SEVERE, "Agent " + requester.getName() + " does not have permission to perform action CloneAgent");
throw new Unauthorised();
} catch (UnreachableException ue) {
throw new InternalError("Container not reachable. " + ue.getMessage());
} catch (NotFoundException nfe) {
throw new InternalError("NotFoundException. " + nfe.getMessage());
} catch (NameClashException nce) {
throw new AlreadyRegistered();
} catch (Exception e) {
e.printStackTrace();
throw new InternalError("Unexpected exception. " + e.getMessage());
}
}
// MOVE AGENT
void moveAgentAction(MoveAction ma, AID requester) throws FIPAException {
MobileAgentDescription dsc = ma.getMobileAgentDescription();
final AID agentID = dsc.getName();
final ContainerID where = (ContainerID) dsc.getDestination();
if (logger.isLoggable(Logger.FINE))
logger.log(Logger.FINE, "Agent " + requester + " requesting Move-agent " + agentID + " on container " + where);
try {
myPlatform.move(agentID, where);
} catch (JADESecurityException ae) {
if (logger.isLoggable(Logger.SEVERE))
logger.log(Logger.SEVERE, "Agent " + requester.getName() + " does not have permission to perform action MoveAgent");
throw new Unauthorised();
} catch (UnreachableException ue) {
throw new InternalError("Container not reachable. " + ue.getMessage());
} catch (NotFoundException nfe) {
throw new InternalError("NotFoundException. " + nfe.getMessage());
} catch (Exception e) {
e.printStackTrace();
throw new InternalError("Unexpected exception. " + e.getMessage());
}
}
// KILL CONTAINER
void killContainerAction(final KillContainer kc, final AID requester, final JADEPrincipal requesterPrincipal, final Credentials requesterCredentials) throws FIPAException {
final ContainerID cid = kc.getContainer();
if (logger.isLoggable(Logger.FINE)) {
logger.log(Logger.FINE, "Agent " + requester + " requesting Kill-container " + cid);
}
// Notify a KILL_CONTAINER_REQUESTED introspection event to all tools
KillContainerRequested kcr = new KillContainerRequested();
kcr.setContainer(cid);
EventRecord er = new EventRecord(kcr, here());
er.setWhen(new Date());
try {
notifyTools(er);
} catch (Exception e) {
// Should never happen
e.printStackTrace();
}
Thread auxThread = new Thread() {
public void run() {
try {
myPlatform.killContainer(cid, requesterPrincipal, requesterCredentials);
} catch (JADESecurityException ae) {
logger.log(Logger.SEVERE, "Agent " + requester.getName() + " does not have permission to perform action Kill-container: " + ae);
// Send failure notification to the requester if any
sendFailureNotification(kc, cid, new Unauthorised());
} catch (NotFoundException nfe) {
// Send failure notification to the requester if any
sendFailureNotification(kc, cid, new InternalError("Container not found. " + nfe.getMessage()));
} catch (UnreachableException ue) {
// Send failure notification to the requester if any
sendFailureNotification(kc, cid, new InternalError("Container unreachable. " + ue.getMessage()));
} catch (Throwable t) {
// Send failure notification to the requester if any
sendFailureNotification(kc, cid, new InternalError(t.getMessage()));
}
}
};
auxThread.start();
}
// SHUTDOWN PLATFORM
void shutdownPlatformAction(ShutdownPlatform sp, final AID requester, final JADEPrincipal requesterPrincipal, final Credentials requesterCredentials) throws FIPAException {
if (logger.isLoggable(Logger.FINE))
logger.log(Logger.FINE, "Agent " + requester + " requesting Shutdown-platform ");
// Notify a SHUTDOWN_PLATFORM_REQUESTED introspection event to all tools
ShutdownPlatformRequested spr = new ShutdownPlatformRequested();
EventRecord er = new EventRecord(spr, here());
er.setWhen(new Date());
try {
notifyTools(er);
} catch (Exception e) {
// Should never happen
e.printStackTrace();
}
Thread auxThread = new Thread() {
public void run() {
try {
myPlatform.shutdownPlatform(requesterPrincipal, requesterCredentials);
} catch (JADESecurityException ae) {
if (logger.isLoggable(Logger.SEVERE))
logger.log(Logger.SEVERE, "Agent " + requester.getName() + " does not have permission to perform action Shutdown-Platform: " + ae);
}
}
};
auxThread.start();
}
// INSTALL MTP
MTPDescriptor installMTPAction(InstallMTP im, AID requester) throws FIPAException {
if (logger.isLoggable(Logger.FINE))
logger.log(Logger.FINE, "Agent " + requester + " requesting Install-MTP");
// FIXME: Permissions for this action are not yet defined
try {
return myPlatform.installMTP(im.getAddress(), im.getContainer(), im.getClassName());
} catch (NotFoundException nfe) {
throw new InternalError("Container not found. " + nfe.getMessage());
} catch (UnreachableException ue) {
throw new InternalError("Container unreachable. " + ue.getMessage());
} catch (MTPException mtpe) {
throw new InternalError("Error in MTP installation. " + mtpe.getMessage());
}
}
// UNINSTALL MTP
void uninstallMTPAction(UninstallMTP um, AID requester) throws FIPAException {
if (logger.isLoggable(Logger.FINE))
logger.log(Logger.FINE, "Agent " + requester + " requesting Uninstall-MTP");
// FIXME: Permissions for this action are not yet defined
try {
myPlatform.uninstallMTP(um.getAddress(), um.getContainer());
} catch (NotFoundException nfe) {
throw new InternalError("Container not found. " + nfe.getMessage());
} catch (UnreachableException ue) {
throw new InternalError("Container unreachable. " + ue.getMessage());
} catch (MTPException mtpe) {
throw new InternalError("Error in MTP de-installation. " + mtpe.getMessage());
}
}
// SNIFF ON
void sniffOnAction(SniffOn so, AID requester) throws FIPAException {
if (logger.isLoggable(Logger.FINE))
logger.log(Logger.FINE, "Agent " + requester + " requesting Sniff-on");
// FIXME: Permissions for this action are not yet defined
try {
myPlatform.sniffOn(so.getSniffer(), so.getCloneOfSniffedAgents());
} catch (NotFoundException nfe) {
throw new InternalError("Agent not found. " + nfe.getMessage());
} catch (UnreachableException ue) {
throw new InternalError("Container unreachable. " + ue.getMessage());
}
}
// SNIFF OFF
void sniffOffAction(SniffOff so, AID requester) throws FIPAException {
if (logger.isLoggable(Logger.FINE))
logger.log(Logger.FINE, "Agent " + requester + " requesting Sniff-off");
// FIXME: Permissions for this action are not yet defined
try {
myPlatform.sniffOff(so.getSniffer(), so.getCloneOfSniffedAgents());
} catch (NotFoundException nfe) {
throw new InternalError("Agent not found. " + nfe.getMessage());
} catch (UnreachableException ue) {
throw new InternalError("Container unreachable. " + ue.getMessage());
}
}
// DEBUG ON
void debugOnAction(DebugOn don, AID requester) throws FIPAException {
if (logger.isLoggable(Logger.FINE))
logger.log(Logger.FINE, "Agent " + requester + " requesting Debug-on");
// FIXME: Permissions for this action are not yet defined
try {
myPlatform.debugOn(don.getDebugger(), don.getCloneOfDebuggedAgents());
} catch (NotFoundException nfe) {
throw new InternalError("Agent not found. " + nfe.getMessage());
} catch (UnreachableException ue) {
throw new InternalError("Container unreachable. " + ue.getMessage());
}
}
// DEBUG OFF
void debugOffAction(DebugOff doff, AID requester) throws FIPAException {
if (logger.isLoggable(Logger.FINE))
logger.log(Logger.FINE, "Agent " + requester + " requesting Debug-off");
// FIXME: Permissions for this action are not yet defined
try {
myPlatform.debugOff(doff.getDebugger(), doff.getCloneOfDebuggedAgents());
} catch (NotFoundException nfe) {
throw new InternalError("Agent not found. " + nfe.getMessage());
} catch (UnreachableException ue) {
throw new InternalError("Container unreachable. " + ue.getMessage());
}
}
// WHERE IS AGENT
Location whereIsAgentAction(WhereIsAgentAction wia, AID requester) throws FIPAException {
if (logger.isLoggable(Logger.FINE))
logger.log(Logger.FINE, "Agent " + requester + " requesting Where-is-agent");
// FIXME: Permissions for this action are not yet defined
try {
return myPlatform.getContainerID(wia.getAgentIdentifier());
} catch (NotFoundException nfe) {
throw new InternalError("Agent not found. " + nfe.getMessage());
}
}
// QUERY PLATFORM LOCATIONS
List queryPlatformLocationsAction(QueryPlatformLocationsAction qpl, AID requester) throws FIPAException {
if (logger.isLoggable(Logger.FINE))
logger.log(Logger.FINE, "Agent " + requester + " requesting Query-platform-locations");
// FIXME: Permissions for this action are not yet defined
ContainerID[] ids = myPlatform.containerIDs();
List l = new ArrayList();
for (int i = 0; i < ids.length; ++i) {
l.add(ids[i]);
}
return l;
}
// QUERY AGENTS ON LOCATION
List queryAgentsOnLocationAction(QueryAgentsOnLocation qaol, AID requester) throws FIPAException {
if (logger.isLoggable(Logger.FINE))
logger.log(Logger.FINE, "Agent " + requester + " requesting Query-agents-on-location");
// FIXME: Permissions for this action are not yet defined
try {
return myPlatform.containerAgents((ContainerID) qaol.getLocation());
} catch (NotFoundException nfe) {
throw new InternalError("Location not found. " + nfe.getMessage());
}
}
//////////////////////////////////////////////////////////////////
// Methods implementing the actions of the FIPAManagementOntology.
// All these methods
// - extract the necessary information from the requested Action
// object and check whether mandatory slots are present.
// - Call the corresponding method of the AgentManager using the
// permissions of the requester agent.
// - Convert eventual JADE-internal Exceptions into proper FIPAException.
// These methods are package-scoped as they are called by the
// AMSFipaAgentManagementBehaviour.
//////////////////////////////////////////////////////////////////
// REGISTER
void registerAction(Register r, AID requester) throws FIPAException {
final AMSAgentDescription amsd = (AMSAgentDescription) r.getDescription();
// Check mandatory slots
AID id = amsd.getName();
if (logger.isLoggable(Logger.FINE))
logger.log(Logger.FINE, "Agent " + requester + " requesting AMS-registration for " + id);
if (id == null || id.getName() == null || id.getName().length() == 0) {
throw new MissingParameter(FIPAManagementVocabulary.AMSAGENTDESCRIPTION, FIPAManagementVocabulary.DFAGENTDESCRIPTION_NAME);
}
try {
myPlatform.amsRegister(amsd);
} catch (AlreadyRegistered ar) {
throw ar;
} catch (JADESecurityException ae) {
if (logger.isLoggable(Logger.SEVERE))
logger.log(Logger.SEVERE, "Agent " + requester.getName() + " does not have permission to perform action Register");
throw new Unauthorised();
} catch (Exception e) {
e.printStackTrace();
throw new InternalError("Unexpected exception. " + e.getMessage());
}
}
// DEREGISTER
void deregisterAction(Deregister d, AID requester) throws FIPAException {
final AMSAgentDescription amsd = (AMSAgentDescription) d.getDescription();
// Check mandatory slots
AID id = amsd.getName();
if (logger.isLoggable(Logger.FINE))
logger.log(Logger.FINE, "Agent " + requester + " requesting AMS-deregistration for " + id);
if (id == null || id.getName() == null || id.getName().length() == 0) {
throw new MissingParameter(FIPAManagementVocabulary.AMSAGENTDESCRIPTION, FIPAManagementVocabulary.DFAGENTDESCRIPTION_NAME);
}
try {
myPlatform.amsDeregister(amsd);
} catch (NotRegistered nr) {
throw nr;
} catch (JADESecurityException ae) {
if (logger.isLoggable(Logger.SEVERE))
logger.log(Logger.SEVERE, "Agent " + requester.getName() + " does not have permission to perform action Deregister");
throw new Unauthorised();
} catch (Exception e) {
e.printStackTrace();
throw new InternalError("Unexpected exception. " + e.getMessage());
}
}
// MODIFY
void modifyAction(Modify m, AID requester) throws FIPAException {
final AMSAgentDescription amsd = (AMSAgentDescription) m.getDescription();
// Check mandatory slots
AID id = amsd.getName();
if (logger.isLoggable(Logger.FINE)) {
logger.log(Logger.FINE, "Agent " + requester + " requesting AMS-modification for " + id);
logger.log(Logger.FINE, "New state is " + amsd.getState() + ". New ownership is " + amsd.getOwnership());
}
if (id == null || id.getName() == null || id.getName().length() == 0) {
throw new MissingParameter(FIPAManagementVocabulary.AMSAGENTDESCRIPTION, FIPAManagementVocabulary.DFAGENTDESCRIPTION_NAME);
}
try {
myPlatform.amsModify(amsd);
} catch (NotRegistered nr) {
throw nr;
} catch (UnreachableException ue) {
throw new InternalError("Container not reachable. " + ue.getMessage());
} catch (NotFoundException nfe) {
throw new InternalError("Agent not found. " + nfe.getMessage());
} catch (JADESecurityException ae) {
if (logger.isLoggable(Logger.SEVERE))
logger.log(Logger.SEVERE, "Agent " + requester.getName() + " does not have permission to perform action Modify");
throw new Unauthorised();
} catch (Exception e) {
e.printStackTrace();
throw new InternalError("Unexpected exception. " + e.getMessage());
}
}
// SEARCH
List searchAction(Search s, AID requester) {
if (logger.isLoggable(Logger.FINE))
logger.log(Logger.FINE, "Agent " + requester + " requesting AMS-search");
return myPlatform.amsSearch((AMSAgentDescription) s.getDescription(), getActualMaxResults(s.getConstraints()));
}
/**
* @return
* <ul>
* <li> 1 if constraints.maxResults == null (according to FIPA specs)
* <li> The AMS internal max result limit if constraints.maxResults < 0 (the FIPA specs requires it to be
* infinite, but for practical reason we prefer to limit it)
* <li> constraints.maxResults otherwise
* </ul>
**/
private long getActualMaxResults(SearchConstraints constraints) {
long maxResult = (constraints.getMaxResults() == null ? 1 : constraints.getMaxResults().longValue());
maxResult = (maxResult < 0 ? amsMaxResults : maxResult); // limit the max num of results
return maxResult;
}
// GET_DESCRIPTION
APDescription getDescriptionAction(AID requester) {
if (requester != null) {
if (logger.isLoggable(Logger.FINE))
logger.log(Logger.FINE, "Agent " + requester + " requesting AMS-get-description");
}
theProfile.clearAllAPServices(); // clear all the services and recreate the new APDescription
MTPDescriptor dr;
for (Iterator mtps = platformMTPs().iterator(); mtps.hasNext();) {
dr = (MTPDescriptor) mtps.next();
// convert from an internal MTPDescriptor to a FIPA APService
theProfile.addAPServices(new APService(dr.getName(), dr.getAddresses()));
}
return theProfile;
}
//////////////////////////////////////////////////////////////////
// TOOLS REGISTRATION and NOTIFICATION
//////////////////////////////////////////////////////////////////
/**
Inner calss RegisterToolBehaviour.
This behaviour handles subscriptions of tools i.e. agents
to be notified about platform events.
*/
private class RegisterToolBehaviour extends CyclicBehaviour {
private MessageTemplate subscriptionTemplate;
RegisterToolBehaviour() {
MessageTemplate mt1 = MessageTemplate.MatchLanguage(FIPANames.ContentLanguage.FIPA_SL0);
MessageTemplate mt2 = MessageTemplate.MatchOntology(IntrospectionOntology.NAME);
MessageTemplate mt12 = MessageTemplate.and(mt1, mt2);
mt1 = MessageTemplate.MatchReplyWith("tool-subscription");
mt2 = MessageTemplate.MatchPerformative(ACLMessage.SUBSCRIBE);
subscriptionTemplate = MessageTemplate.and(mt1, mt2);
subscriptionTemplate = MessageTemplate.and(subscriptionTemplate, mt12);
}
public void action() {
// Receive 'subscribe' ACL messages.
ACLMessage current = receive(subscriptionTemplate);
if (current != null) {
// FIXME: Should parse 'iota ?x ...'
// Get new tool name from subscription message
AID newTool = current.getSender();
toolNotification.clearAllReceiver();
toolNotification.addReceiver(newTool);
try {
// Send a 'Reset' meta-event
ResetEvents re = new ResetEvents();
EventRecord er = new EventRecord(re, here());
Occurred o = new Occurred();
o.setWhat(er);
try {
getContentManager().fillContent(toolNotification, o);
send(toolNotification);
} catch (Exception e) {
e.printStackTrace();
}
// Send back the whole container list.
ContainerID[] ids = myPlatform.containerIDs();
for (int i = 0; i < ids.length; i++) {
ContainerID cid = ids[i];
AddedContainer ac = new AddedContainer();
ac.setContainer(cid);
ac.setOwnership(getContainerOwnership(cid));
er = new EventRecord(ac, here());
o = new Occurred();
o.setWhat(er);
try {
getContentManager().fillContent(toolNotification, o);
send(toolNotification);
} catch (Exception e) {
e.printStackTrace();
}
// Send the list of the MTPs installed on this container
Iterator mtps = myPlatform.containerMTPs(cid).iterator();
while (mtps.hasNext()) {
AddedMTP amtp = new AddedMTP();
amtp.setAddress(((MTPDescriptor) mtps.next()).getAddresses()[0]);
amtp.setWhere(cid);
er = new EventRecord(amtp, here());
o = new Occurred();
o.setWhat(er);
try {
getContentManager().fillContent(toolNotification, o);
send(toolNotification);
} catch (Exception e) {
e.printStackTrace();
}
}
}
// Send all agent names, along with their container name.
AID[] agents = myPlatform.agentNames();
for (int i = 0; i < agents.length; i++) {
AID agentName = agents[i];
ContainerID cid = myPlatform.getContainerID(agentName);
AMSAgentDescription amsd = myPlatform.getAMSDescription(agentName);
BornAgent ba = new BornAgent();
// Note that "agentName" may not include agent addresses
AID id = agentName;
if (amsd != null) {
if (amsd.getName() != null) {
id = amsd.getName();
}
ba.setState(amsd.getState());
ba.setOwnership(amsd.getOwnership());
ba.setClassName(id.getAllUserDefinedSlot().getProperty(AID.AGENT_CLASSNAME));
}
ba.setAgent(id);
ba.setWhere(cid);
er = new EventRecord(ba, here());
o = new Occurred();
o.setWhat(er);
try {
getContentManager().fillContent(toolNotification, o);
send(toolNotification);
} catch (Exception e) {
e.printStackTrace();
}
}
// Notification of the APDescription
PlatformDescription ap = new PlatformDescription();
ap.setPlatform(getDescriptionAction(null));
er = new EventRecord(ap, here());
o = new Occurred();
o.setWhat(er);
try {
getContentManager().fillContent(toolNotification, o);
send(toolNotification);
} catch (Exception e) {
e.printStackTrace();
}
myPlatform.addTool(newTool);
} catch (NotFoundException nfe) {
nfe.printStackTrace();
} catch (Exception e) {
e.printStackTrace();
}
} else
block();
}
} // End of RegisterToolBehaviour inner class
/**
Inner calss DeregisterToolBehaviour.
This behaviour handles tools un-subscriptions.
*/
private class DeregisterToolBehaviour extends CyclicBehaviour {
private MessageTemplate cancellationTemplate;
DeregisterToolBehaviour() {
MessageTemplate mt1 = MessageTemplate.MatchLanguage(FIPANames.ContentLanguage.FIPA_SL0);
MessageTemplate mt2 = MessageTemplate.MatchOntology(IntrospectionOntology.NAME);
MessageTemplate mt12 = MessageTemplate.and(mt1, mt2);
mt1 = MessageTemplate.MatchReplyWith("tool-cancellation");
mt2 = MessageTemplate.MatchPerformative(ACLMessage.CANCEL);
cancellationTemplate = MessageTemplate.and(mt1, mt2);
cancellationTemplate = MessageTemplate.and(cancellationTemplate, mt12);
}
public void action() {
// Receive 'cancel' ACL messages.
ACLMessage current = receive(cancellationTemplate);
if (current != null) {
// FIXME: Should parse the content
// Remove this tool from tools agent group.
myPlatform.removeTool(current.getSender());
} else
block();
}
} // End of DeregisterToolBehaviour inner class
/**
Inner interface Handler.
Perform additional operations related to a given platform event
*/
private interface Handler {
void handle(Event ev);
} // END of Handler inner interface
/**
Inner class EventManager.
This behaviour notifies
- all registered tools about all platform events
- the agent that had requested the AMS to perform an action
about the platform event forced by that action. Note that
this is done only for actions that produce an "asynchronous
event".
*/
private class EventManager extends CyclicBehaviour {
private Map handlers = new HashMap();
public EventManager() {
handlers.put(RemovedContainer.NAME, new Handler() {
public void handle(Event ev) {
// If this event was forced by an action requested by
// an agent --> notify him.
RemovedContainer rc = (RemovedContainer) ev;
ContainerID cid = rc.getContainer();
ACLMessage notification = (ACLMessage) pendingRemovedContainers.remove(cid);
if (notification != null) {
send(notification);
}
}
});
handlers.put(DeadAgent.NAME, new Handler() {
public void handle(Event ev) {
// If this event was forced by an action requested by
// an agent --> notify him.
DeadAgent da = (DeadAgent) ev;
AID agentID = da.getAgent();
ACLMessage notification = (ACLMessage) pendingDeadAgents.remove(agentID);
if (notification != null) {
send(notification);
}
}
});
handlers.put(MovedAgent.NAME, new Handler() {
public void handle(Event ev) {
// If this event was forced by an action requested by
// an agent --> notify him.
MovedAgent ma = (MovedAgent) ev;
AID agentID = ma.getAgent();
ACLMessage notification = (ACLMessage) pendingMovedAgents.remove(agentID);
if (notification != null) {
send(notification);
}
}
});
handlers.put(BornAgent.NAME, new Handler() {
public void handle(Event ev) {
// If this event was forced by an action requested by
// an agent --> notify him.
BornAgent ba = (BornAgent) ev;
AID agentID = ba.getAgent();
// The requested action could be a CreateAgent or a CloneAgent
ACLMessage notification = (ACLMessage) pendingNewAgents.remove(agentID);
if (notification == null) {
notification = (ACLMessage) pendingClonedAgents.remove(agentID);
}
if (notification != null) {
send(notification);
}
}
});
handlers.put(PlatformDescription.NAME, new Handler() {
public void handle(Event ev) {
// Update the PlatformDescription txt file.
writeAPDescription(((PlatformDescription) ev).getPlatform());
}
});
}
public void action() {
try {
EventRecord er = (EventRecord) eventQueue.get();
if (er != null) {
// Perform event-specific actions (if any)
Event ev = er.getWhat();
if (logger.isLoggable(Logger.FINE))
logger.log(Logger.FINE, "EventManager serving event " + ev.getName());
Handler handler = (Handler) handlers.get(ev.getName());
if (handler != null) {
handler.handle(ev);
}
// Notify all tools about the event
notifyTools(er);
} else {
block();
}
} catch (Throwable t) {
// Should never happen
t.printStackTrace();
}
}
} // END of EventManager inner class
private void notifyTools(EventRecord er) throws Exception {
toolNotification.clearAllReceiver();
AID[] allTools = myPlatform.agentTools();
for (int i = 0; i < allTools.length; i++) {
AID tool = allTools[i];
toolNotification.addReceiver(tool);
}
Occurred o = new Occurred();
o.setWhat(er);
getContentManager().fillContent(toolNotification, o);
send(toolNotification);
}
//////////////////////////////////////////////////////////////////
// Platform events input methods.
// The following methods are called when a platform event is notified
// to the Main and are executed outside the AMS thread.
// They result in preparing a proper IntrospectionOntology event (i.e. a
// description of the event that has just happened) and inserting it in
// AMS event queue. The EventManager behaviour will handle them within
// the AMS thread.
//////////////////////////////////////////////////////////////////
public void resetEvents(boolean sendSnapshot) {
// FIXME: in this method here() does not work since the agent toolkit is
// not yet initialized.
// GC-ADD-18022007-START
queueFeeder = new AMSEventQueueFeeder(eventQueue, here());
myPlatform.addListener(queueFeeder);
// GC-ADD-18022007-END
// Put the initial event in the event queue
eventQueue.clear();
ResetEvents re = new ResetEvents();
EventRecord er = new EventRecord(re, here());
eventQueue.put(er);
if (sendSnapshot) {
try {
// Send back the whole container list.
ContainerID[] ids = myPlatform.containerIDs();
for (int i = 0; i < ids.length; i++) {
ContainerID cid = ids[i];
AddedContainer ac = new AddedContainer();
ac.setContainer(cid);
ac.setOwnership(getContainerOwnership(cid));
er = new EventRecord(ac, here());
eventQueue.put(er);
// Send the list of the MTPs installed on this container
Iterator mtps = myPlatform.containerMTPs(cid).iterator();
while (mtps.hasNext()) {
AddedMTP amtp = new AddedMTP();
amtp.setAddress(((MTPDescriptor) mtps.next()).getAddresses()[0]);
amtp.setWhere(cid);
er = new EventRecord(amtp, here());
eventQueue.put(er);
}
}
// The PlatformDescription has changed --> Generate a suitable event
PlatformDescription ap = new PlatformDescription();
ap.setPlatform(getDescriptionAction(null));
er = new EventRecord(ap, here());
eventQueue.put(er);
// Send all agent names, along with their container name.
AID[] agents = myPlatform.agentNames();
for (int j = 0; j < agents.length; j++) {
AID agentName = agents[j];
// FIXME: Check if we have to lock the AgentDescriptor
AMSAgentDescription amsd = myPlatform.getAMSDescription(agentName);
if (! amsd.getState().equals(AMSAgentDescription.LATENT)) {
ContainerID c = myPlatform.getContainerID(agentName);
BornAgent ba = new BornAgent();
// Note that "agentName" may not include agent addresses
AID id = agentName;
if (amsd != null) {
if (amsd.getName() != null) {
id = amsd.getName();
}
ba.setState(amsd.getState());
ba.setOwnership(amsd.getOwnership());
}
ba.setAgent(id);
ba.setWhere(c);
er = new EventRecord(ba, here());
eventQueue.put(er);
}
}
} catch (NotFoundException nfe) {
// It should never happen
nfe.printStackTrace();
}
}
}
// GC-ADD-18022007-START
public void setQueueFeeder(AMSEventQueueFeeder feeder) {
queueFeeder = feeder;
queueFeeder.setAms(this);
eventQueue = queueFeeder.getQueue();
}
public AMSEventQueueFeeder getQueueFeeder() {
return queueFeeder;
}
// GC-ADD-18022007-START
/**
Put a BornAgent event in the AMS event queue
*
public void bornAgent(PlatformEvent ev) {
if (logger.isLoggable(Logger.CONFIG))
logger.log(Logger.CONFIG, ev.toString());
ContainerID cid = ev.getContainer();
AID agentID = ev.getAgent();
String ownership = ev.getNewOwnership();
BornAgent ba = new BornAgent();
ba.setAgent(agentID);
ba.setWhere(cid);
ba.setState(AMSAgentDescription.ACTIVE);
ba.setOwnership(ownership);
ba.setClassName((String) agentID.getAllUserDefinedSlot().get(AID.AGENT_CLASSNAME));
EventRecord er = new EventRecord(ba, here());
er.setWhen(ev.getTime());
eventQueue.put(er);
}*/
/**
Put a DeadAgent event in the AMS event queue
*
public void deadAgent(PlatformEvent ev) {
if (logger.isLoggable(Logger.CONFIG))
logger.log(Logger.CONFIG, ev.toString());
ContainerID cid = ev.getContainer();
AID agentID = ev.getAgent();
DeadAgent da = new DeadAgent();
da.setAgent(agentID);
da.setWhere(cid);
if (ev.getContainerRemoved()) {
da.setContainerRemoved(new Boolean(true));
}
EventRecord er = new EventRecord(da, here());
er.setWhen(ev.getTime());
eventQueue.put(er);
}*/
/**
Put a SuspendedAgent event in the AMS event queue
*
public void suspendedAgent(PlatformEvent ev) {
if (logger.isLoggable(Logger.CONFIG))
logger.log(Logger.CONFIG, ev.toString());
ContainerID cid = ev.getContainer();
AID name = ev.getAgent();
SuspendedAgent sa = new SuspendedAgent();
sa.setAgent(name);
sa.setWhere(cid);
EventRecord er = new EventRecord(sa, here());
er.setWhen(ev.getTime());
eventQueue.put(er);
}*/
/**
Put a ResumedAgent event in the AMS event queue
*
public void resumedAgent(PlatformEvent ev) {
if (logger.isLoggable(Logger.CONFIG))
logger.log(Logger.CONFIG, ev.toString());
ContainerID cid = ev.getContainer();
AID name = ev.getAgent();
ResumedAgent ra = new ResumedAgent();
ra.setAgent(name);
ra.setWhere(cid);
EventRecord er = new EventRecord(ra, here());
er.setWhen(ev.getTime());
eventQueue.put(er);
}*/
/**
Put a FrozenAgent event in the AMS event queue
*
public void frozenAgent(PlatformEvent ev) {
if (logger.isLoggable(Logger.CONFIG))
logger.log(Logger.CONFIG, ev.toString());
ContainerID cid = ev.getContainer();
AID name = ev.getAgent();
ContainerID bufferContainer = ev.getNewContainer();
FrozenAgent fa = new FrozenAgent();
fa.setAgent(name);
fa.setWhere(cid);
fa.setBufferContainer(bufferContainer);
EventRecord er = new EventRecord(fa, here());
er.setWhen(ev.getTime());
eventQueue.put(er);
}*/
/**
Put a ThawedAgent event in the AMS event queue
*
public void thawedAgent(PlatformEvent ev) {
if (logger.isLoggable(Logger.CONFIG))
logger.log(Logger.CONFIG, ev.toString());
ContainerID cid = ev.getContainer();
AID name = ev.getAgent();
ContainerID bufferContainer = ev.getNewContainer();
ThawedAgent ta = new ThawedAgent();
ta.setAgent(name);
ta.setWhere(cid);
ta.setBufferContainer(bufferContainer);
EventRecord er = new EventRecord(ta, here());
er.setWhen(ev.getTime());
eventQueue.put(er);
}*/
/**
Put a MovedAgent event in the AMS event queue
*
public void movedAgent(PlatformEvent ev) {
if (logger.isLoggable(Logger.CONFIG))
logger.log(Logger.CONFIG, ev.toString());
ContainerID from = ev.getContainer();
ContainerID to = ev.getNewContainer();
AID agentID = ev.getAgent();
MovedAgent ma = new MovedAgent();
ma.setAgent(agentID);
ma.setFrom(from);
ma.setTo(to);
EventRecord er = new EventRecord(ma, here());
er.setWhen(ev.getTime());
eventQueue.put(er);
}*/
/**
Put a ChangedAgentOwnership event in the AMS event queue
*
public void changedAgentPrincipal(PlatformEvent ev) {
if (logger.isLoggable(Logger.CONFIG))
logger.log(Logger.CONFIG, ev.toString());
ContainerID cid = ev.getContainer();
AID name = ev.getAgent();
ChangedAgentOwnership cao = new ChangedAgentOwnership();
cao.setAgent(name);
cao.setWhere(cid);
cao.setFrom(ev.getOldOwnership());
cao.setTo(ev.getNewOwnership());
EventRecord er = new EventRecord(cao, here());
er.setWhen(ev.getTime());
eventQueue.put(er);
}*/
/**
Put an AddedContainer event in the AMS event queue
*
public void addedContainer(PlatformEvent ev) {
if (logger.isLoggable(Logger.CONFIG))
logger.log(Logger.CONFIG, ev.toString());
ContainerID cid = ev.getContainer();
String name = cid.getName();
AddedContainer ac = new AddedContainer();
ac.setContainer(cid);
EventRecord er = new EventRecord(ac, here());
er.setWhen(ev.getTime());
eventQueue.put(er);
}*/
/**
Put a RemovedContainer event in the AMS event queue
*
public void removedContainer(PlatformEvent ev) {
if (logger.isLoggable(Logger.CONFIG))
logger.log(Logger.CONFIG, ev.toString());
ContainerID cid = ev.getContainer();
String name = cid.getName();
RemovedContainer rc = new RemovedContainer();
rc.setContainer(cid);
EventRecord er = new EventRecord(rc, here());
er.setWhen(ev.getTime());
eventQueue.put(er);
}*/
/**
Put a XXX event in the AMS event queue
*
public synchronized void changedContainerPrincipal(PlatformEvent ev) {
if (logger.isLoggable(Logger.CONFIG))
logger.log(Logger.CONFIG, ev.toString());
// FIXME: There is no element in the IntrospectionOntology
// corresponding to this event
}*/
/**
Put a AddedMTP event in the AMS event queue
*
public synchronized void addedMTP(MTPEvent ev) {
if (logger.isLoggable(Logger.CONFIG))
logger.log(Logger.CONFIG, "MTPEvent [added MTP]");
Channel ch = ev.getChannel();
ContainerID cid = ev.getPlace();
String proto = ch.getProtocol();
String address = ch.getAddress();
// Generate a suitable AMS event
AddedMTP amtp = new AddedMTP();
amtp.setAddress(address);
amtp.setProto(proto);
amtp.setWhere(cid);
EventRecord er = new EventRecord(amtp, here());
er.setWhen(ev.getTime());
eventQueue.put(er);
// The PlatformDescription has changed --> Generate a suitable event
PlatformDescription ap = new PlatformDescription();
ap.setPlatform(getDescriptionAction(null));
er = new EventRecord(ap, here());
er.setWhen(ev.getTime());
eventQueue.put(er);
}*/
/**
Put a RemovedMTP event in the AMS event queue
*
public synchronized void removedMTP(MTPEvent ev) {
if (logger.isLoggable(Logger.CONFIG))
logger.log(Logger.CONFIG, "MTPEvent [removed MTP]");
Channel ch = ev.getChannel();
ContainerID cid = ev.getPlace();
String proto = ch.getProtocol();
String address = ch.getAddress();
RemovedMTP rmtp = new RemovedMTP();
rmtp.setAddress(address);
rmtp.setProto(proto);
rmtp.setWhere(cid);
EventRecord er = new EventRecord(rmtp, here());
er.setWhen(ev.getTime());
eventQueue.put(er);
// The PlatformDescription has changed --> Generate a suitable event
PlatformDescription ap = new PlatformDescription();
ap.setPlatform(getDescriptionAction(null));
er = new EventRecord(ap, here());
er.setWhen(ev.getTime());
eventQueue.put(er);
}*/
/*
public void messageIn(MTPEvent ev) {
if (logger.isLoggable(Logger.CONFIG))
logger.log(Logger.CONFIG, "MTPEvent [message in]");
}
public void messageOut(MTPEvent ev) {
if (logger.isLoggable(Logger.CONFIG))
logger.log(Logger.CONFIG, "MTPEvent [message out]");
}*/
//////////////////////////////////////////////////
// Utility methods
//////////////////////////////////////////////////
/**
Return the ownership of a container
*/
private String getContainerOwnership(ContainerID container) {
// FIXME: should use AgentManager to do that
return JADEPrincipal.NONE;
}
/**
Return the ownership of an agent
*/
private String getAgentOwnership(AID agent) {
String ownership = null;
try {
AMSAgentDescription amsd = myPlatform.getAMSDescription(agent);
ownership = amsd.getOwnership();
} catch (Exception e) {
// Do nothing
}
return (ownership != null ? ownership : JADEPrincipal.NONE);
}
/**
Write the AP description in a text file
*/
private void writeAPDescription(APDescription description) {
//Write the APDescription file.
try {
FileWriter f = new FileWriter(getProperty(Profile.FILE_DIR, "") + "APDescription.txt");
f.write(description.toString());
f.write('\n');
f.flush();
f.close();
} catch (java.io.IOException ioe) {
ioe.printStackTrace();
}
}
/**
Return a list of all MTPs in the platform
*/
private List platformMTPs() {
List mtps = new ArrayList();
ContainerID[] cc = myPlatform.containerIDs();
for (int i = 0; i < cc.length; ++i) {
try {
List l = myPlatform.containerMTPs(cc[i]);
Iterator it = l.iterator();
while (it.hasNext()) {
mtps.add(it.next());
}
} catch (NotFoundException nfe) {
// The container has died while we were looping --> ignore it
}
}
return mtps;
}
/**
Store a notification message to be sent at a later time.
Package-scoped as it is called by the AMSJadeAgentManagementBehaviour
*/
void storeNotification(Concept action, Object key, ACLMessage notification) {
if (action instanceof CreateAgent) {
pendingNewAgents.put(key, notification);
}
if (action instanceof KillAgent) {
pendingDeadAgents.put(key, notification);
} else if (action instanceof CloneAction) {
pendingClonedAgents.put(key, notification);
} else if (action instanceof MoveAction) {
pendingMovedAgents.put(key, notification);
} else if (action instanceof KillContainer) {
pendingRemovedContainers.put(key, notification);
}
}
/**
This method is executed by an auxiliary thread started by the AMS
to perform certain actions (createAgent, killContainer) asynchronously
*/
private void sendFailureNotification(final Concept action, final Object key, final FIPAException fe) {
addBehaviour(new OneShotBehaviour(this) {
public void action() {
ACLMessage notification = null;
if (action instanceof CreateAgent) {
notification = (ACLMessage) pendingNewAgents.remove(key);
} else if (action instanceof KillContainer) {
notification = (ACLMessage) pendingRemovedContainers.remove(key);
}
if (notification != null) {
notification.setPerformative(ACLMessage.FAILURE);
// Compose the content
Action slAction = new Action(getAID(), action);
ContentElementList cel = new ContentElementList();
cel.add(slAction);
cel.add(fe);
try {
getContentManager().fillContent(notification, cel);
} catch (Exception e) {
// Should never happen
e.printStackTrace();
notification.setContent("(" + fe.getMessage() + ")");
}
send(notification);
}
}
});
}
}