info.pppc.base.plugin.common

Class ProactiveRouting

java.lang.Object

info.pppc.base.plugin.common.ProactiveRouting

All Implemented Interfaces:

IListener, IExtension, IOperation, IDispatcher, IPlugin, IRouting, IStreamer

Direct Known Subclasses:

MxIPProactiveRouting

public class ProactiveRouting
extends java.lang.Object
implements IRouting, IListener, IOperation

The proactive implements simple multi-hop routing with proactive route distribution.

Author:

Marcus Handte

Field Summary

Fields

Modifier and Type	Field and Description
static byte	MAXIMUM_HOPS The maximum hop count for route announcements.
static short	PLUGIN_ABILITY The ability of the plug-in [6][0].
static java.lang.String	PROPERTY_GATEWAY The property in the plug-in description that determines whether the plug-in has gateway capabilities.
static java.lang.String	PROPERTY_NEIGHBORS The property in the plug-in description that contains a neighbor list.
static java.lang.String	PROPERTY_SYSTEM The property in the plug-in description that contains a system id.

Fields inherited from interface info.pppc.base.system.IExtension

EXTENSION_COMPRESSION, EXTENSION_DISCOVERY, EXTENSION_ENCRYPTION, EXTENSION_ROUTING, EXTENSION_SEMANTIC, EXTENSION_SERIALIZATION, EXTENSION_TRANSCEIVER

Constructor Summary

Constructors

Constructor and Description
ProactiveRouting() Creates a new proactive routing plug-in that does not retransmit route announcements via the same technology.
ProactiveRouting(boolean retransmit) Creates a new proactive routing plug-in.

Method Summary

Methods

Modifier and Type	Method and Description
void	deliverIncoming(IStreamConnector connector, ISession session) Called whenever a connection request is incoming.
PluginDescription	getPluginDescription() Returns the plug-in description.
void	handleEvent(Event event) Handles incoming route announcements.
IStreamConnector	openSession(ISession session) Called to open a session with some remote system.
void	perform(IMonitor monitor) Perform continuous route announcements until this thing is deactivated.
boolean	prepareSession(PluginDescription d, NFCollection c, ISession s) Called to prepare a session to the specified remote device
void	setFilter(IRoutingFilter filter) Sets the gateway filter to the specified filter.
void	setRoutingManager(IRoutingManager manager) Sets the routing manager upon startup.
void	start() Called to start the plug-in.
void	stop() Called to stop the plug-in.

Methods inherited from class java.lang.Object

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

Field Detail

MAXIMUM_HOPS

public static final byte MAXIMUM_HOPS

The maximum hop count for route announcements.

See Also:

Constant Field Values

PLUGIN_ABILITY

public static short PLUGIN_ABILITY

The ability of the plug-in [6][0].

PROPERTY_NEIGHBORS

public static java.lang.String PROPERTY_NEIGHBORS

The property in the plug-in description that contains a neighbor list.

PROPERTY_SYSTEM

public static java.lang.String PROPERTY_SYSTEM

The property in the plug-in description that contains a system id.

PROPERTY_GATEWAY

public static java.lang.String PROPERTY_GATEWAY

The property in the plug-in description that determines whether the plug-in has gateway capabilities.

Constructor Detail

ProactiveRouting

public ProactiveRouting()

Creates a new proactive routing plug-in that does not retransmit route announcements via the same technology.

ProactiveRouting

public ProactiveRouting(boolean retransmit)

Creates a new proactive routing plug-in. Depending on the retransmission flag, this plug-in will either re- announce incoming packets via the same technology or not.

Parameters:

retransmit - A flag that indicates whether route announcements will be retransmitted via the same technology. Normally, this is only needed for the network emulator.

Method Detail

setRoutingManager

public void setRoutingManager(IRoutingManager manager)

Sets the routing manager upon startup.

Specified by:

setRoutingManager in interface IRouting

Parameters:

manager - The routing manager upon startup.

getPluginDescription

public PluginDescription getPluginDescription()

Returns the plug-in description. The plug-in description

Specified by:

getPluginDescription in interface IPlugin

Returns:

The plug-in description.

start

public void start()

Called to start the plug-in. After startup, the plug-in will start with the route announcement.

Specified by:

start in interface IPlugin

stop

public void stop()

Called to stop the plug-in. This will also stop the route announcement.

Specified by:

stop in interface IPlugin

deliverIncoming

public void deliverIncoming(IStreamConnector connector,
                   ISession session)

Called whenever a connection request is incoming.

Specified by:

deliverIncoming in interface IDispatcher

Parameters:

connector - The stream connector of the request.

session - The session data of the request.

openSession

public IStreamConnector openSession(ISession session)
                             throws java.io.IOException

Called to open a session with some remote system.

Specified by:

openSession in interface IStreamer

Parameters:

session - The session data object.

Returns:

A stream connector to the remote system.

Throws:

java.io.IOException - Thrown if an error occurs.

prepareSession

public boolean prepareSession(PluginDescription d,
                     NFCollection c,
                     ISession s)

Called to prepare a session to the specified remote device

Specified by:

prepareSession in interface IStreamer

Parameters:

d - The plugin descripton of the remote device.

c - The nf collection with the requirements.

s - The session data used to fill in requests.

Returns:

True if it is possible to contact the device.

setFilter

public void setFilter(IRoutingFilter filter)

Sets the gateway filter to the specified filter. If the filter is set to null, no filtering is performed at all.

Parameters:

filter - The gateway filter.

handleEvent

public void handleEvent(Event event)

Handles incoming route announcements.

Specified by:

handleEvent in interface IListener

Parameters:

event - Remote route announcements.

perform

public void perform(IMonitor monitor)

Perform continuous route announcements until this thing is deactivated.

Specified by:

perform in interface IOperation

Parameters:

monitor - The monitor to cancel.