Package jade.imtp.leap.http

Class HTTPBEDispatcher

java.lang.Object

jade.imtp.leap.http.HTTPBEDispatcher

All Implemented Interfaces:

BEConnectionManager, Dispatcher, JICPMediator

public class HTTPBEDispatcher
extends Object
implements BEConnectionManager, Dispatcher, JICPMediator

Class declaration

Author:

Giovanni Caire - TILAB

Constructor Summary

Constructors

Constructor	Description
HTTPBEDispatcher()

Method Summary

Modifier and Type	Method	Description
byte[]	dispatch(byte[] payload, boolean flush, int oldSessionId)	This is called by the Stub using this Dispatcher to dispatch a serialized command to the FrontEnd.
FrontEnd	getFrontEnd(BackEnd be, Properties props)	Return a stub of the remote FrontEnd that is connected to the local BackEnd.
String	getID()	Retrieve the ID of this mediator
protected void	handleConnectionError()
boolean	handleIncomingConnection(Connection c, JICPPacket pkt, InetAddress addr, int port)	Handle an incoming connection.
JICPPacket	handleJICPPacket(JICPPacket pkt, InetAddress addr, int port)	Handle an incoming JICP packet received by the MediatorManager.
protected void	handlePeerExited()
void	init(JICPMediatorManager mgr, String id, Properties props)	Initialize parameters and activate the BackEndContainer
void	kill()	Shutdown self initiated or forced by the MediatorManager this BackEndContainer is attached to.
void	shutdown()	Clean up this HTTPBEDispatcher.
protected BackEndSkel	startBackEndContainer(Properties props)
void	tick(long currentTime)	This is periodically called by the JICPMediatorManager and should be used by a JICPMediator to evaluate the elapsed time without the need of a dedicated thread or timer.

Methods inherited from class java.lang.Object

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

Constructor Detail

HTTPBEDispatcher

public HTTPBEDispatcher()

Method Detail

getID

public String getID()

Description copied from interface: JICPMediator

Retrieve the ID of this mediator

Specified by:

getID in interface JICPMediator

init

public void init(JICPMediatorManager mgr,
                 String id,
                 Properties props)
          throws ICPException

Initialize parameters and activate the BackEndContainer

Specified by:

init in interface JICPMediator

Throws:

ICPException

startBackEndContainer

protected final BackEndSkel startBackEndContainer(Properties props)
                                           throws ICPException

Throws:

ICPException

kill

public void kill()

Shutdown self initiated or forced by the MediatorManager this BackEndContainer is attached to.

Specified by:

kill in interface JICPMediator

handleJICPPacket

public JICPPacket handleJICPPacket(JICPPacket pkt,
                                   InetAddress addr,
                                   int port)
                            throws ICPException

Handle an incoming JICP packet received by the MediatorManager.

Specified by:

handleJICPPacket in interface JICPMediator

Parameters:

pkt - the JICPPacket

addr - the address of the mediated entity

port - the local port used by the mediated entity

Throws:

ICPException

handleIncomingConnection

public boolean handleIncomingConnection(Connection c,
                                        JICPPacket pkt,
                                        InetAddress addr,
                                        int port)

Handle an incoming connection. This is called by the MediatorManager when a CREATE or CONNECT_MEDIATOR request is received. The HTTPBEDispatcher reacts to this call by resetting the current situation

Specified by:

handleIncomingConnection in interface JICPMediator

Parameters:

c - the connection to the mediated entity

pkt - the packet that was sent by the mediated entity when opening this connection

addr - the address of the mediated entity

port - the local port used by the mediated entity

Returns:

an indication to the JICPMediatorManager to keep the connection open.

tick

public void tick(long currentTime)

Description copied from interface: JICPMediator

This is periodically called by the JICPMediatorManager and should be used by a JICPMediator to evaluate the elapsed time without the need of a dedicated thread or timer.

Specified by:

tick in interface JICPMediator

dispatch

public byte[] dispatch(byte[] payload,
                       boolean flush,
                       int oldSessionId)
                throws ICPException

This is called by the Stub using this Dispatcher to dispatch a serialized command to the FrontEnd. Mutual exclusion with itself to ensure one command at a time is dispatched.

Specified by:

dispatch in interface Dispatcher

Throws:

ICPException

getFrontEnd

public FrontEnd getFrontEnd(BackEnd be,
                            Properties props)
                     throws IMTPException

Return a stub of the remote FrontEnd that is connected to the local BackEnd.

Specified by:

getFrontEnd in interface BEConnectionManager

Parameters:

be - The local BackEnd

props - Additional (implementation dependent) connection configuration properties.

Returns:

A stub of the remote FrontEnd.

Throws:

IMTPException

shutdown

public void shutdown()

Clean up this HTTPBEDispatcher. The shutdown process can be activated in the following cases: 1) The local container is requested to exit --> The exit commad is forwarded to the FrontEnd 1.a) Forwarding OK. The FrontEnd sends back a response with the TERMINATED_INFO set. When this response is received the shutdown() method is called (see handleJICPPacket()). 1.b) Forwarding failed. The BackEndContainer ignores the exception and directly calls the shutdown() method. Note that in the case the FrontEnd spontaneously exits and in the case the max disconnection time expires the kill() method is called --> see case 1.

Specified by:

shutdown in interface BEConnectionManager

handlePeerExited

protected void handlePeerExited()

handleConnectionError

protected void handleConnectionError()