jade.core
Interface AgentManager

All Known Implementing Classes:

MainContainerImpl

public interface AgentManager

This interface provides Agent Life Cycle management services to the platform AMS.

Nested Class Summary

static interface

AgentManager.Listener This callback interface is implemented by the AMS in order to be notified of significant platform-level events (e.g. container added or removed, agents birth or death, mtp configuration changes, etc.).

Method Summary

void	activate(AID agentID)
void	addListener(AgentManager.Listener l)
void	addTool(AID tool)
AID[]	agentNames()
AID[]	agentTools()
void	amsDeregister(AMSAgentDescription dsc)
void	amsModify(AMSAgentDescription dsc)
void	amsRegister(AMSAgentDescription dsc)
List	amsSearch(AMSAgentDescription template, long maxResults)
List	containerAgents(ContainerID cid)
ContainerID[]	containerIDs()
List	containerMTPs(ContainerID cid)
void	copy(AID agentID, Location where, java.lang.String newAgentName)
void	create(java.lang.String agentName, java.lang.String className, java.lang.Object[] arguments, ContainerID cid, jade.security.JADEPrincipal owner, jade.security.Credentials initialCredentials, jade.security.JADEPrincipal requesterPrincipal, jade.security.Credentials requesterCredentials) Create an agent on the given container.
void	debugOff(AID debuggerName, List toBeDebugged)
void	debugOn(AID debuggerName, List toBeDebugged)
AMSAgentDescription	getAMSDescription(AID agentID)
ContainerID	getContainerID(AID agentID)
MTPDescriptor	installMTP(java.lang.String address, ContainerID cid, java.lang.String className)
void	kill(AID agentID, jade.security.JADEPrincipal requesterPrincipal, jade.security.Credentials requesterCredentials)
void	killContainer(ContainerID cid, jade.security.JADEPrincipal requesterPrincipal, jade.security.Credentials requesterCredentials)
void	move(AID agentID, Location where)
void	removeListener(AgentManager.Listener l)
void	removeTool(AID tool)
void	shutdownPlatform(jade.security.JADEPrincipal requesterPrincipal, jade.security.Credentials requesterCredentials)
void	sniffOff(AID snifferName, List toBeSniffed)
void	sniffOn(AID snifferName, List toBeSniffed)
void	suspend(AID agentID)
void	take(AID agentID, java.lang.String username, byte[] password)
void	uninstallMTP(java.lang.String address, ContainerID cid)
void	wait(AID agentID, java.lang.String password)
void	wake(AID agentID, java.lang.String password)

Method Detail

addListener

void addListener(AgentManager.Listener l)

removeListener

void removeListener(AgentManager.Listener l)

containerIDs

ContainerID[] containerIDs()

agentNames

AID[] agentNames()

containerMTPs

List containerMTPs(ContainerID cid)
                   throws NotFoundException

Throws:

NotFoundException

containerAgents

List containerAgents(ContainerID cid)
                     throws NotFoundException

Throws:

NotFoundException

addTool

void addTool(AID tool)

removeTool

void removeTool(AID tool)

agentTools

AID[] agentTools()

getContainerID

ContainerID getContainerID(AID agentID)
                           throws NotFoundException

Throws:

NotFoundException

getAMSDescription

AMSAgentDescription getAMSDescription(AID agentID)
                                      throws NotFoundException

Throws:

NotFoundException

create

void create(java.lang.String agentName,
            java.lang.String className,
            java.lang.Object[] arguments,
            ContainerID cid,
            jade.security.JADEPrincipal owner,
            jade.security.Credentials initialCredentials,
            jade.security.JADEPrincipal requesterPrincipal,
            jade.security.Credentials requesterCredentials)
            throws UnreachableException,
                   jade.security.JADESecurityException,
                   NotFoundException,
                   NameClashException

Create an agent on the given container. If the container-name is null then the agent is created on the main-container.

Throws:

NotFoundException - if the passed container does not exist

UnreachableException - if the container is unreachable

jade.security.JADESecurityException - if this action is not authorized

NameClashException

kill

void kill(AID agentID,
          jade.security.JADEPrincipal requesterPrincipal,
          jade.security.Credentials requesterCredentials)
          throws NotFoundException,
                 UnreachableException,
                 jade.security.JADESecurityException

Throws:

NotFoundException

UnreachableException

jade.security.JADESecurityException

suspend

void suspend(AID agentID)
             throws NotFoundException,
                    UnreachableException,
                    jade.security.JADESecurityException

Throws:

NotFoundException

UnreachableException

jade.security.JADESecurityException

activate

void activate(AID agentID)
              throws NotFoundException,
                     UnreachableException,
                     jade.security.JADESecurityException

Throws:

NotFoundException

UnreachableException

jade.security.JADESecurityException

wait

void wait(AID agentID,
          java.lang.String password)
          throws NotFoundException,
                 UnreachableException

Throws:

NotFoundException

UnreachableException

wake

void wake(AID agentID,
          java.lang.String password)
          throws NotFoundException,
                 UnreachableException

Throws:

NotFoundException

UnreachableException

move

void move(AID agentID,
          Location where)
          throws NotFoundException,
                 UnreachableException,
                 jade.security.JADESecurityException

Throws:

NotFoundException

UnreachableException

jade.security.JADESecurityException

copy

void copy(AID agentID,
          Location where,
          java.lang.String newAgentName)
          throws NotFoundException,
                 NameClashException,
                 UnreachableException,
                 jade.security.JADESecurityException

Throws:

NotFoundException

NameClashException

UnreachableException

jade.security.JADESecurityException

shutdownPlatform

void shutdownPlatform(jade.security.JADEPrincipal requesterPrincipal,
                      jade.security.Credentials requesterCredentials)
                      throws jade.security.JADESecurityException

Throws:

jade.security.JADESecurityException

killContainer

void killContainer(ContainerID cid,
                   jade.security.JADEPrincipal requesterPrincipal,
                   jade.security.Credentials requesterCredentials)
                   throws NotFoundException,
                          UnreachableException,
                          jade.security.JADESecurityException

Throws:

NotFoundException

UnreachableException

jade.security.JADESecurityException

installMTP

MTPDescriptor installMTP(java.lang.String address,
                         ContainerID cid,
                         java.lang.String className)
                         throws NotFoundException,
                                UnreachableException,
                                MTPException

Throws:

NotFoundException

UnreachableException

MTPException

uninstallMTP

void uninstallMTP(java.lang.String address,
                  ContainerID cid)
                  throws NotFoundException,
                         UnreachableException,
                         MTPException

Throws:

NotFoundException

UnreachableException

MTPException

take

void take(AID agentID,
          java.lang.String username,
          byte[] password)
          throws NotFoundException,
                 UnreachableException,
                 jade.security.JADESecurityException

Throws:

NotFoundException

UnreachableException

jade.security.JADESecurityException

sniffOn

void sniffOn(AID snifferName,
             List toBeSniffed)
             throws NotFoundException,
                    UnreachableException

Throws:

NotFoundException

UnreachableException

sniffOff

void sniffOff(AID snifferName,
              List toBeSniffed)
              throws NotFoundException,
                     UnreachableException

Throws:

NotFoundException

UnreachableException

debugOn

void debugOn(AID debuggerName,
             List toBeDebugged)
             throws NotFoundException,
                    UnreachableException

Throws:

NotFoundException

UnreachableException

debugOff

void debugOff(AID debuggerName,
              List toBeDebugged)
              throws NotFoundException,
                     UnreachableException

Throws:

NotFoundException

UnreachableException

amsRegister

void amsRegister(AMSAgentDescription dsc)
                 throws AlreadyRegistered,
                        jade.security.JADESecurityException

Throws:

AlreadyRegistered

jade.security.JADESecurityException

amsDeregister

void amsDeregister(AMSAgentDescription dsc)
                   throws NotRegistered,
                          jade.security.JADESecurityException

Throws:

NotRegistered

jade.security.JADESecurityException

amsModify

void amsModify(AMSAgentDescription dsc)
               throws NotRegistered,
                      NotFoundException,
                      UnreachableException,
                      jade.security.JADESecurityException

Throws:

NotRegistered

NotFoundException

UnreachableException

jade.security.JADESecurityException

amsSearch

List amsSearch(AMSAgentDescription template,
               long maxResults)