info.pppc.base.plugin.common

Class TimedDiscovery

java.lang.Object

info.pppc.base.plugin.common.TimedDiscovery

All Implemented Interfaces:

IListener, IExtension, IOperation, IDiscovery, IPlugin

public class TimedDiscovery
extends java.lang.Object
implements IDiscovery, IListener, IOperation

A discovery plug-in that performs proactive announcement of plug-in descriptions. Thereby it assumes a periodic reception of plug-in descriptions from other plug-ins. If a description is not received, it sends a negative acknowledgement which will then be confirmed by the corresponding device. In order to keep the message overhead low, other devices overhear the negative acknowledgements and suppress their own if they would send one too. It listens to state changes within the plug-in manager (additions and removals of plug-ins) and it detects enabled/disabled transceivers and starts or stops discovery operations depending on the state.

Author:

Marcus Handte

Field Summary

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
TimedDiscovery() Creates a new simple discovery plug-in.

Method Summary

Methods

Modifier and Type	Method and Description
PluginDescription	getPluginDescription() Returns the plug-in description of this plug-in.
void	handleEvent(Event event) Implementation of the plug-in listener that listens to the discovery listener to detect the addition of new transceiver plug-ins and an implementation of a transceiver listener that listens to transceivers that are enabled and disabled.
void	perform(IMonitor monitor) Performs discovery and waits for the monitor to be canceled.
void	setDiscoveryManager(IDiscoveryManager manager) Sets the plug-in manager that is used to monitor the installation of new plug-ins.
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

Constructor Detail

TimedDiscovery

public TimedDiscovery()

Creates a new simple discovery plug-in.

Method Detail

start

public void start()

Called to start the plug-in. This method initializes the plug-in and starts a thread that announces plug-ins.

Specified by:

start in interface IPlugin

stop

public void stop()

Called to stop the plug-in. After this method has been called, all open calls will fail.

Specified by:

stop in interface IPlugin

perform

public void perform(IMonitor monitor)

Performs discovery and waits for the monitor to be canceled.

Specified by:

perform in interface IOperation

Parameters:

monitor - The monitor used to determine whether the operation should be still performed.

setDiscoveryManager

public void setDiscoveryManager(IDiscoveryManager manager)

Sets the plug-in manager that is used to monitor the installation of new plug-ins.

Specified by:

setDiscoveryManager in interface IDiscovery

Parameters:

manager - The plug-in manager.

getPluginDescription

public PluginDescription getPluginDescription()

Returns the plug-in description of this plug-in. There will be only one instance of the plug-in description per instance of this plug-in.

Specified by:

getPluginDescription in interface IPlugin

Returns:

The plug-in description of this plug-in.

handleEvent

public void handleEvent(Event event)

Implementation of the plug-in listener that listens to the discovery listener to detect the addition of new transceiver plug-ins and an implementation of a transceiver listener that listens to transceivers that are enabled and disabled. If a transceiver is added to the plug-in manager, a transceiver listener will be added. If a plug-in is removed, the listener will be removed. Whenever a transceiver is enabled, a discovery operation is started and whenever it is disabled, the corresponding discovery operation is aborted.

Specified by:

handleEvent in interface IListener

Parameters:

event - The event that has been thrown by the plug-in manager. At the present time, the implementation registers for addition and removal events of plug-ins.