info.pppc.base.plugin.common

Class ProactiveDiscovery

java.lang.Object

info.pppc.base.plugin.common.ProactiveDiscovery

All Implemented Interfaces:

IListener, IExtension, IOperation, IDiscovery, IPlugin

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

A discovery plug-in that performs a simple proactive announcement of plug-in descriptions. 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
ProactiveDiscovery() Creates a new simple discovery plug-in.
ProactiveDiscovery(int period) Creates a new plugin with the specified annoucement period.

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

ProactiveDiscovery

public ProactiveDiscovery()

Creates a new simple discovery plug-in.

ProactiveDiscovery

public ProactiveDiscovery(int period)

Creates a new plugin with the specified annoucement period.

Parameters:

period - The announcement period.

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.