All Packages  Class Hierarchy  This Package  Previous  Next  Index

Interface ajanta.server.AServer

public interface AServer
extends Remote
The remotely callable interface supported by all agent servers. Unauthenticated versions of recall, retract and terminate are currently included in the interface for testing/convenience only. They will be removed from here, and changed to private functions within the AgentServer class.

Method Index

o authenticate(URN, int)
It is used to obtain ticket from this server from a remote site.
o recall(URN, URN, Ticket)
It is used to recall an agent ...which basically allow an agent to complete its task at the current server and upon completion migate it to the reportTo server ( but it aborts its prespecifed itinerary).
o recall(URN, URN, URN)
It is used to recall an agent ...which basically allow an agent to complete its task at the current server ( but it aborts its prespecifed itinerary) and upon completion migate it to the reportTo server.
o retract(URN, URN, Ticket)
It is used to retract an agent ...it preempts the agent from its current task and its prespecifed itinerary.
o retract(URN, URN, URN)
It is used to retract an agent ...it preempts the agent from its current task and its prespecified itinerary.
o terminate(URN)
It is used to abort an agent ...it immediately kill the agent.
o terminate(URN, Ticket)
It is used to abort an agent ...it immediately kills the agent.
o whoAreYou()
A simple method in the AServer interface, for obtaining an agent server's URN

Methods

o whoAreYou 
 public abstract URN whoAreYou() throws RemoteException
A simple method in the AServer interface, for obtaining an agent server's URN

o authenticate 
 public abstract Ticket authenticate(URN caller,
                                     int nonce) throws RemoteException
It is used to obtain ticket from this server from a remote site.

Parameters:
caller - caller identity( URN )
nonce - random number used as challenge
o recall 
 public abstract void recall(URN target,
                             URN caller,
                             URN reportTo) throws RemoteException
It is used to recall an agent ...which basically allow an agent to complete its task at the current server ( but it aborts its prespecifed itinerary) and upon completion migate it to the reportTo server. This do not involve authentication and will be deprecated in future release.

Parameters:
target - URN of the agent to be relocated
recaller - URN of the recaller
reportTo - URN of the entity to whom agent has to report
o recall 
 public abstract void recall(URN target,
                             URN reportTo,
                             Ticket t) throws RemoteException, InvalidKeyException, SignatureException
It is used to recall an agent ...which basically allow an agent to complete its task at the current server and upon completion migate it to the reportTo server ( but it aborts its prespecifed itinerary). Recaller must authenticate himself with the remote server inorder to recall the agent.Only owner, creator or gurdian are allowed to recall an agent. 
     AServer targetServer = getAgentCurrentServer( agentURN );
     Ticket ticket = remoteServerTicket ( targetServer, myURN , 3000, dsa_priv );
     recall (agentURN , myURN , ticket )

Parameters:
target - URN of the agent to be relocated
reportTo - URN of the entity to whom agent has to report
t - ticket obtained from the remote server
o retract 
 public abstract void retract(URN target,
                              URN caller,
                              URN reportTo) throws RemoteException
It is used to retract an agent ...it preempts the agent from its current task and its prespecified itinerary. Then immediately migate it to the reportTo server. This do not involve authentication and will be deprecated in future release.

Parameters:
target - URN of the agent to be relocated
recaller - URN of the retractor
reportTo - URN of the entity to whom agent has to report
o retract 
 public abstract void retract(URN target,
                              URN reportTo,
                              Ticket t) throws RemoteException, InvalidKeyException, SignatureException
It is used to retract an agent ...it preempts the agent from its current task and its prespecifed itinerary. Then migate the agent to the reportTo server. Retractor must authenticate himself with the remote server inorder to retract the agent.Only owner, creator or gurdian are allowed to retract an agent. 
     AServer targetServer = getAgentCurrentServer( agentURN );
     Ticket ticket = remoteServerTicket ( targetServer, myURN , 3000, dsa_priv );
     retract (agentURN , myURN , ticket )

Parameters:
target - URN of the agent to be retracted
reportTo - URN of the entity to whom agent has to report
t - ticket obtained from the remote server
o terminate 
 public abstract void terminate(URN target) throws RemoteException
It is used to abort an agent ...it immediately kill the agent. This do not involve authentication and will be deprecated in future release.

Parameters:
target - URN of the agent to be terminated
o terminate 
 public abstract void terminate(URN target,
                                Ticket t) throws RemoteException, InvalidKeyException, SignatureException
It is used to abort an agent ...it immediately kills the agent. Caller must authenticate himself with the remote server inorder to terminate the agent.Only owner, creator or gurdian are allowed to terminate an agent. 
     AServer targetServer = getAgentCurrentServer( agentURN );
     Ticket ticket = remoteServerTicket ( targetServer, myURN , 3000, dsa_priv );
     terminate (agentURN  , ticket )

Parameters:
target - URN of the agent to be terminated 
All Packages  Class Hierarchy  This Package  Previous  Next  Index