jade.core
Interface BackEnd

All Known Implementing Classes:

BackEndContainer

public interface BackEnd

Author:

Giovanni Caire - TILAB

Method Summary

java.lang.String	bornAgent(java.lang.String name) Notify the BackEnd container that a new agent is born.
void	deadAgent(java.lang.String name) Notify the BackEnd container that an agent has died.
void	messageOut(ACLMessage msg, java.lang.String sender) Pass an ACLMessage to the BackEnd for dispatching.
void	resumedAgent(java.lang.String name) Notify the BackEnd container that an agent has resumed.
java.lang.Object	serviceInvokation(java.lang.String actor, java.lang.String serviceName, java.lang.String methodName, java.lang.Object[] methodParams) Pass a service helper method invokation request to the BackEnd
void	suspendedAgent(java.lang.String name) Notify the BackEnd container that an agent has suspended.

Method Detail

bornAgent

java.lang.String bornAgent(java.lang.String name)
                           throws IMTPException,
                                  jade.security.JADESecurityException

Notify the BackEnd container that a new agent is born.

Parameters:

name - The name of the new agent.

Returns:

The name actually assigned to the newly born agent.

Throws:

IMTPException

jade.security.JADESecurityException

deadAgent

void deadAgent(java.lang.String name)
               throws IMTPException

Notify the BackEnd container that an agent has died. Note that this does not throw NotFoundException as, if the BackEnd does not contain an AgentImage for the deadAgent it just ignores the call.

Parameters:

name - The name of the dead agent.

Throws:

IMTPException

suspendedAgent

void suspendedAgent(java.lang.String name)
                    throws NotFoundException,
                           IMTPException

Notify the BackEnd container that an agent has suspended.

Parameters:

name - The name of the suspended agent.

Throws:

NotFoundException

IMTPException

resumedAgent

void resumedAgent(java.lang.String name)
                  throws NotFoundException,
                         IMTPException

Notify the BackEnd container that an agent has resumed.

Parameters:

name - The name of the resumed agent.

Throws:

NotFoundException

IMTPException

messageOut

void messageOut(ACLMessage msg,
                java.lang.String sender)
                throws NotFoundException,
                       IMTPException

Pass an ACLMessage to the BackEnd for dispatching.

Parameters:

msg - The message to be dispatched.

sender - The name of the sender agent.

Throws:

NotFoundException

IMTPException

serviceInvokation

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

Pass a service helper method invokation request to the 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