Package jade.imtp.leap.nio

Class NIOHTTPBEDispatcher

java.lang.Object

jade.imtp.leap.nio.NIOHTTPBEDispatcher

All Implemented Interfaces:

BEConnectionManager, Dispatcher, JICPMediator, NIOMediator

public class NIOHTTPBEDispatcher
extends Object
implements NIOMediator, Dispatcher, BEConnectionManager

Author:

Eduard Drenth: Logica, 11-jul-2009

Constructor Summary

Constructors

Constructor	Description
NIOHTTPBEDispatcher()

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
Properties	getProperties()	Retrieve the startup Properties for this NIOMediator.
void	handleConnectionError(Connection c, Exception e)	Notify this NIOMediator that an error occurred on one of the Connections it was using.
boolean	handleIncomingConnection(Connection c, JICPPacket pkt, InetAddress addr, int port)	Handle an incoming connection.
JICPPacket	handleJICPPacket(Connection c, JICPPacket pkt, InetAddress addr, int port)	Handle an incoming JICP packet received by the MediatorManager
JICPPacket	handleJICPPacket(JICPPacket pkt, InetAddress addr, int port)	Passes to this JICPMediator a JICP packet.
void	init(JICPMediatorManager mgr, String id, Properties props)	Initialize parameters and activate the BackEndContainer
void	kill()	Termination self initiated or forced by the MediatorManager we are attached to.
void	shutdown()	Termination initiated by the BackEndContainer (i.e.
void	tick(long time)	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

NIOHTTPBEDispatcher

public NIOHTTPBEDispatcher()

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

kill

public void kill()

Termination self initiated or forced by the MediatorManager we are attached to.

Specified by:

kill in interface JICPMediator

tick

public void tick(long time)

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

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. In both cases the Front-end is connecting --> Set the front-end status to CONNECTING, but don't use this connection: to allow us sending commands to the front-end an initial dummy response will be received soon.

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.

handleJICPPacket

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

Handle an incoming JICP packet received by the MediatorManager

Specified by:

handleJICPPacket in interface NIOMediator

Throws:

ICPException

handleJICPPacket

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

Description copied from interface: JICPMediator

Passes to this JICPMediator a JICP packet. This is called by the JICPServer this Mediator is attached to when a JICPPacket is received having the recipient-ID field set to the ID of this JICPMediator.

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

handleConnectionError

public void handleConnectionError(Connection c,
                                  Exception e)

Description copied from interface: NIOMediator

Notify this NIOMediator that an error occurred on one of the Connections it was using. This information is important since, unlike normal mediators, a NIOMediator may not read packets from connections on its own (the JICPMediatorManager does that in general).

Specified by:

handleConnectionError in interface NIOMediator

getProperties

public Properties getProperties()

Description copied from interface: NIOMediator

Retrieve the startup Properties for this NIOMediator.

Specified by:

getProperties in interface NIOMediator

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()

Termination initiated by the BackEndContainer (i.e. by the platform). When the BackEndContainer exits

Specified by:

shutdown in interface BEConnectionManager

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