jade.core
Interface AgentManager


public interface AgentManager

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


Inner 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.).
 
Field Summary
static java.lang.String AUX_CONTAINER_NAME
           
static java.lang.String MAIN_CONTAINER_NAME
           
 
Method Summary
 void activate(AID agentID)
           
 void addListener(AgentManager.Listener l)
           
 AID[] agentNames()
           
 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.String[] arguments, ContainerID cid, java.lang.String ownership, jade.security.CertificateFolder certs)
           
 void debugOff(AID debuggerName, List toBeDebugged)
           
 void debugOn(AID debuggerName, List toBeDebugged)
           
 jade.security.CertificateFolder getAMSDelegation(AID agentID)
           
 AMSAgentDescription getAMSDescription(AID agentID)
           
 jade.security.Authority getAuthority()
           
 ContainerID getContainerID(AID agentID)
           
 jade.mtp.MTPDescriptor installMTP(java.lang.String address, ContainerID cid, java.lang.String className)
           
 void kill(AID agentID)
           
 void killContainer(ContainerID cid)
           
 void move(AID agentID, Location where)
           
 void removeListener(AgentManager.Listener l)
           
 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)
           
 

Field Detail

MAIN_CONTAINER_NAME

public static final java.lang.String MAIN_CONTAINER_NAME

AUX_CONTAINER_NAME

public static final java.lang.String AUX_CONTAINER_NAME
Method Detail

addListener

public void addListener(AgentManager.Listener l)

removeListener

public void removeListener(AgentManager.Listener l)

containerIDs

public ContainerID[] containerIDs()

agentNames

public AID[] agentNames()

containerMTPs

public List containerMTPs(ContainerID cid)
                   throws NotFoundException

containerAgents

public List containerAgents(ContainerID cid)
                     throws NotFoundException

getContainerID

public ContainerID getContainerID(AID agentID)
                           throws NotFoundException

getAMSDescription

public AMSAgentDescription getAMSDescription(AID agentID)
                                      throws NotFoundException

getAMSDelegation

public jade.security.CertificateFolder getAMSDelegation(AID agentID)

getAuthority

public jade.security.Authority getAuthority()

create

public void create(java.lang.String agentName,
                   java.lang.String className,
                   java.lang.String[] arguments,
                   ContainerID cid,
                   java.lang.String ownership,
                   jade.security.CertificateFolder certs)
            throws UnreachableException,
                   jade.security.AuthException

kill

public void kill(AID agentID)
          throws NotFoundException,
                 UnreachableException,
                 jade.security.AuthException

suspend

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

activate

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

wait

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

wake

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

move

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

copy

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

killContainer

public void killContainer(ContainerID cid)
                   throws NotFoundException,
                          jade.security.AuthException

installMTP

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

uninstallMTP

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

take

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

sniffOn

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

sniffOff

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

debugOn

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

debugOff

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

amsRegister

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

amsDeregister

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

amsModify

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

amsSearch

public List amsSearch(AMSAgentDescription template,
                      long maxResults)