Package jade.imtp.leap.JICP

Class BIBEDispatcher

java.lang.Object

java.lang.Thread

jade.imtp.leap.JICP.BIBEDispatcher

All Implemented Interfaces:

BEConnectionManager, Dispatcher, JICPMediator, Runnable

public class BIBEDispatcher
extends Thread
implements BEConnectionManager, Dispatcher, JICPMediator

Class declaration

Author:

Giovanni Caire - TILAB

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected class	BIBEDispatcher.InpConnectionHolder	Inner class InpConnectionHolder.
protected class	BIBEDispatcher.OutConnectionHolder	Inner class OutConnectionHolder Wrapper for the connection used to receive commands from the FrontEnd

Nested classes/interfaces inherited from class java.lang.Thread

Thread.State, Thread.UncaughtExceptionHandler

Field Summary

Fields

Modifier and Type	Field	Description
protected BIBEDispatcher.InpConnectionHolder	inpHolder
protected BIBEDispatcher.OutConnectionHolder	outHolder

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor	Description
BIBEDispatcher()	Constructor declaration

Method Summary

Modifier and Type	Method	Description
byte[]	dispatch(byte[] payload, boolean flush, int oldSessionId)
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
boolean	handleIncomingConnection(Connection c, JICPPacket pkt, InetAddress addr, int port)	This is called by the JICPServer when a JICP CREATE_MEDIATOR or CONNECT_MEDIATOR is received.
JICPPacket	handleJICPPacket(JICPPacket p, InetAddress addr, int port)	This is called by the JICPServer when a JICP packet addressing this mediator as recipient-ID is received.
protected JICPPacket	handlePacket(JICPPacket pkt)
void	init(JICPMediatorManager mgr, String id, Properties props)	Initialize parameters and start the embedded thread
void	kill()	Shutdown self initiated or forced by the JICPServer this BackEndContainer is attached to.
void	run()
void	shutdown()	Make this BackEndDispatcher terminate.
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.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, onSpinWait, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Field Detail

inpHolder

protected BIBEDispatcher.InpConnectionHolder inpHolder

outHolder

protected BIBEDispatcher.OutConnectionHolder outHolder

Constructor Detail

BIBEDispatcher

public BIBEDispatcher()

Constructor declaration

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 start the embedded thread

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 JICPServer this BackEndContainer is attached to.

Specified by:

kill in interface JICPMediator

handleJICPPacket

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

This is called by the JICPServer when a JICP packet addressing this mediator as recipient-ID is received. In the case of the BIBEDispatcher this should never happen.

Specified by:

handleJICPPacket in interface JICPMediator

Parameters:

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

This is called by the JICPServer when a JICP CREATE_MEDIATOR or CONNECT_MEDIATOR is received.

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

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

Make this BackEndDispatcher terminate.

Specified by:

shutdown in interface BEConnectionManager

dispatch

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

Specified by:

dispatch in interface Dispatcher

Throws:

ICPException

run

public void run()

Specified by:

run in interface Runnable

Overrides:

run in class Thread

handlePacket

protected JICPPacket handlePacket(JICPPacket pkt)