Package jade.imtp.leap

Class BackEndStub

java.lang.Object

jade.imtp.leap.MicroStub

jade.imtp.leap.BackEndStub

All Implemented Interfaces:

BackEnd

public class BackEndStub
extends MicroStub
implements BackEnd

Class declaration

Author:

Giovanni Caire - TILAB

Nested Class Summary

Nested classes/interfaces inherited from class jade.imtp.leap.MicroStub

MicroStub.PostponedCommand

Field Summary

Fields inherited from class jade.imtp.leap.MicroStub

logger, MINIMUM_TIMEOUT, myDispatcher, pendingCommands

Constructor Summary

Constructors

Constructor	Description
BackEndStub(Dispatcher d, Properties props)

Method Summary

Modifier and Type	Method	Description
static void	appendProp(StringBuffer sb, String key, String val)
String	bornAgent(String name)	Notify the BackEnd container that a new agent is born.
void	deadAgent(String name)	Notify the BackEnd container that an agent has died.
static StringBuffer	encodeCreateMediatorRequest(Properties pp)	The method encodes the create mediator request, setting all the common properties retrived in the passed property parameter.
protected void	handlePostponedCommandExpired(Command c, ICPException exception)
void	messageOut(ACLMessage msg, String sender)	Pass an ACLMessage to the BackEnd for dispatching.
static void	parseCreateMediatorResponse(String responseMessage, Properties pp)
void	resumedAgent(String name)	Notify the BackEnd container that an agent has resumed.
Object	serviceInvokation(String actor, String serviceName, String methodName, Object[] methodParams)	Pass a service helper method invocation request to the BackEnd
void	suspendedAgent(String name)	Notify the BackEnd container that an agent has suspended.

Methods inherited from class jade.imtp.leap.MicroStub

checkFlush, endFlush, executeRemotely, flush, isEmpty

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BackEndStub

public BackEndStub(Dispatcher d,
                   Properties props)

Method Detail

bornAgent

public String bornAgent(String name)
                 throws JADESecurityException,
                        IMTPException

Description copied from interface: BackEnd

Notify the BackEnd container that a new agent is born.

Specified by:

bornAgent in interface BackEnd

Parameters:

name - The name of the new agent.

Returns:

The name actually assigned to the newly born agent.

Throws:

JADESecurityException

IMTPException

deadAgent

public void deadAgent(String name)
               throws IMTPException

Description copied from interface: BackEnd

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.

Specified by:

deadAgent in interface BackEnd

Parameters:

name - The name of the dead agent.

Throws:

IMTPException

suspendedAgent

public void suspendedAgent(String name)
                    throws NotFoundException,
                           IMTPException

Description copied from interface: BackEnd

Notify the BackEnd container that an agent has suspended.

Specified by:

suspendedAgent in interface BackEnd

Parameters:

name - The name of the suspended agent.

Throws:

NotFoundException

IMTPException

resumedAgent

public void resumedAgent(String name)
                  throws NotFoundException,
                         IMTPException

Description copied from interface: BackEnd

Notify the BackEnd container that an agent has resumed.

Specified by:

resumedAgent in interface BackEnd

Parameters:

name - The name of the resumed agent.

Throws:

NotFoundException

IMTPException

messageOut

public void messageOut(ACLMessage msg,
                       String sender)
                throws NotFoundException,
                       IMTPException

Description copied from interface: BackEnd

Pass an ACLMessage to the BackEnd for dispatching.

Specified by:

messageOut in interface BackEnd

Parameters:

msg - The message to be dispatched.

sender - The name of the sender agent.

Throws:

NotFoundException

IMTPException

serviceInvokation

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

Description copied from interface: BackEnd

Pass a service helper method invocation request to the BackEnd

Specified by:

serviceInvokation in interface 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

handlePostponedCommandExpired

protected void handlePostponedCommandExpired(Command c,
                                             ICPException exception)

Overrides:

handlePostponedCommandExpired in class MicroStub

parseCreateMediatorResponse

public static final void parseCreateMediatorResponse(String responseMessage,
                                                     Properties pp)

encodeCreateMediatorRequest

public static final StringBuffer encodeCreateMediatorRequest(Properties pp)

The method encodes the create mediator request, setting all the common properties retrived in the passed property parameter.

Parameters:

pp -

Returns:

a StringBuffer to allow the dispatcher to add dispatcher specific properties.

appendProp

public static void appendProp(StringBuffer sb,
                              String key,
                              String val)