org.eclipse.soda.dk.signal.service
Interface SignalListener

All Superinterfaces:

ErrorListener

All Known Subinterfaces:

MultiplexSignalListener

All Known Implementing Classes:

Adapter, AdapterTest, AgentTest, ChildMeasurement, Command, CommandMeasurement, Commands, ConcreteMeasurement, ConcreteSignalFieldSignal, ControlsMeasurement, CountMeasurement, DataCommand, DeviceAdapter, DeviceCommand, DeviceProfile, DeviceTest, DeviceTestcase, MeasurementCommand, MessageCommand, MethodCommand, NotificationController, ParameterCommand, Profile, ReadMeasurement, SignalBridge, SignalBridge, SignalFieldSignal, SignalListeners, SignalListenerTestcase, SignalMeasurement, Signals, SimpleDataCommand, SimpleMeasurementCommand, SimpleMessageCommand, SimpleParameterCommand, SimpleTransformCommand, SleepCommand, StateCommand, TestAdapter, TotalMeasurement, TransformCommand, Wire

public interface SignalListener
extends ErrorListener

The SignalListener interface defines the methods to be called when signal notification occurs. A SignalListener is implemented by any class which wishes to be notified whenever a particular SignalService is received. This can be useful for a GUI, which may wish to update, when a particular SignalService, such as the RPMs changes.

Since:

1.0

Version:

1.2.0

See Also:

ControlService, ErrorListener, SignalService

Method Summary

void	signalOccurred(SignalService source, java.lang.Object timestamp, java.lang.Object data) This method is fired to all Listeners each time the signal triggered.

Methods inherited from interface org.eclipse.soda.dk.transport.service.ErrorListener

errorOccurred

Method Detail

signalOccurred

void signalOccurred(SignalService source,
                    java.lang.Object timestamp,
                    java.lang.Object data)

This method is fired to all Listeners each time the signal triggered. The signal can be triggered when a message is received from the hardware or when the trigger method is invoked by the application. Since other notifications are blocked until this method returns, implementors of this method should:

• Not cause the device or transport to be blocked (e.g. calling read on a measurement).
• Handle this call quickly and return.

Parameters:

source - The SignalService which fired.

timestamp - The time at which the signal was detected.

data - Contains any data which was contained within the signal.