cgl.narada.transport.threadpool
Class PoolTCPLinkFactory

java.lang.Object
  java.lang.Thread
      cgl.narada.transport.threadpool.PoolTCPLinkFactory

All Implemented Interfaces:

LinkFactory, TransportDebugFlags, Runnable

public class PoolTCPLinkFactory
extends Thread
implements LinkFactory, TransportDebugFlags

This is a TCP thread pool based implementation of the LinkFactory Interface. Lets assume that the connection is being initiated by a node A to another node B. There are two independent factors that need to be borne in mind while using LinkFactory. The first is of course setting the link factory properties. The second is specifying the properties to create a link to some other node B.

To initialize the PoolTCPLinkFactory one needs to specify the PoolTCPServerPort . When the value of this variable is set to 0 it implies that the node A initiating a connection to node B will not accept link creation requests from any other node.

To create a link to node B the following properties needs to be specified.

hostname: This is the hostname on which the node B's process is running.

portnum: This is the port number on which node B accepts link creation requests from other nodes. In other words, the PoolTCPServerPort specified to the PoolTCPChannelFactory at node B is equal to portnum.

Nested Class Summary

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

Thread.State, Thread.UncaughtExceptionHandler

Field Summary

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Fields inherited from interface cgl.narada.transport.TransportDebugFlags

IPSecLink_Debug, IPSecLinkFactory_Debug, IPSecReceiverThread_Debug, IPSecSenderThread_Debug, IPSecServerThread_Debug, MulticastLink_Debug, MulticastLinkFactory_Debug, MulticastReceiverThread_Debug, MulticastSenderThread_Debug, NIOTCPLink_Debug, NIOTCPLinkFactory_Debug, NIOTCPReceiverThread_Debug, NIOTCPSenderThread_Debug, NIOTCPServerThread_Debug, PoolTCPLink_Debug, PoolTCPLinkFactory_Debug, PoolTCPLinkReceiver_Debug, PoolTCPLinkSender_Debug, PoolTCPServerThread_Debug, PTCPLink_Debug, PTCPLinkFactory_Debug, PTCPReceiverThread_Debug, PTCPSenderThread_Debug, PTCPServerThread_Debug, ReceiveTask_Debug, RTPLink_Debug, RTPLinkFactory_Debug, RTPReceiverThread_Debug, RTPSenderThread_Debug, SendTask_Debug, TCPLink_Debug, TCPLinkFactory_Debug, TCPReceiverThread_Debug, TCPSenderThread_Debug, TCPServerThread_Debug, TransmissionManager_Debug, TransportHandlerImpl_Debug, UDPLink_Debug, UDPLinkFactory_Debug, UDPReceiverThread_Debug, UDPSenderThread_Debug

Constructor Summary

PoolTCPLinkFactory()

Method Summary

boolean	canManageLinkMigrationOfType(String linkType) Indicates if this factory can manage migration of links of a certain type
void	completedTask(String taskIdentifier)
Link	createLink(Properties linkProperties) Create a communication link based on the properties that have been specified.
void	dispose() This method is used to garbage collect any resources associated with the link factory
String	getManagedLinksType() Return the type of all the links created/managed by this factory
TransportHandler	getTransportHandler()
void	handleInboundPoolTCPLinkRequest(SocketChannel sc)
boolean	loadLinkFactoryServices() Start communication services.
void	manageExecution(NetworkTask networkTask) Schedule the execution of the network task in question.
void	manageLinkMigration(Link link) Used to migrate communications of a link to the one supported by links managed by this factory
void	reportLinkLoss(Link linkLost)
void	run()
void	setLinkFactoryProperties(Properties factoryProperties)
void	setLinkStatusInterval(long interval) Set the interval for checking status of all links managed by this factory to the one specified in the argument
void	setTransportHandler(TransportHandler transportHandler) Sets the reference to the transport handler.

Methods inherited from class java.lang.Thread

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

Methods inherited from class java.lang.Object

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

Constructor Detail

PoolTCPLinkFactory

public PoolTCPLinkFactory()

Method Detail

setLinkFactoryProperties

public void setLinkFactoryProperties(Properties factoryProperties)

Specified by:

setLinkFactoryProperties in interface LinkFactory

getManagedLinksType

public String getManagedLinksType()

Return the type of all the links created/managed by this factory

Specified by:

getManagedLinksType in interface LinkFactory

createLink

public Link createLink(Properties linkProperties)
                throws TransportException

Create a communication link based on the properties that have been specified.

Specified by:

createLink in interface LinkFactory

Throws:

TransportException

setLinkStatusInterval

public void setLinkStatusInterval(long interval)

Set the interval for checking status of all links managed by this factory to the one specified in the argument

Specified by:

setLinkStatusInterval in interface LinkFactory

loadLinkFactoryServices

public boolean loadLinkFactoryServices()
                                throws TransportException

Start communication services. In the case of PoolTCP for example, the thread which incorporates the serverSocket.accept() is started

Specified by:

loadLinkFactoryServices in interface LinkFactory

Throws:

TransportException

canManageLinkMigrationOfType

public boolean canManageLinkMigrationOfType(String linkType)

Indicates if this factory can manage migration of links of a certain type

Specified by:

canManageLinkMigrationOfType in interface LinkFactory

manageLinkMigration

public void manageLinkMigration(Link link)
                         throws TransportException

Used to migrate communications of a link to the one supported by links managed by this factory

Specified by:

manageLinkMigration in interface LinkFactory

Throws:

TransportException

setTransportHandler

public void setTransportHandler(TransportHandler transportHandler)

Sets the reference to the transport handler. This is done during the loadLinkFactory() operation within the transport handler implementations.

Specified by:

setTransportHandler in interface LinkFactory

dispose

public void dispose()

This method is used to garbage collect any resources associated with the link factory

Specified by:

dispose in interface LinkFactory

handleInboundPoolTCPLinkRequest

public void handleInboundPoolTCPLinkRequest(SocketChannel sc)

reportLinkLoss

public void reportLinkLoss(Link linkLost)

getTransportHandler

public TransportHandler getTransportHandler()

run

public void run()

Specified by:

run in interface Runnable

Overrides:

run in class Thread

manageExecution

public void manageExecution(NetworkTask networkTask)

Schedule the execution of the network task in question.

Parameters:

task -

completedTask

public void completedTask(String taskIdentifier)