org.eclipse.soda.dk.transport.service
Interface MessageListener

All Superinterfaces:

ErrorListener

All Known Subinterfaces:

ControllerService, MessageHandler, MultiplexMessageListener, MultiplexTransportListener, TransportListener

All Known Implementing Classes:

ConcreteSignal, DataCommand, DataSignal, MeasurementCommand, MessageCommand, MessageSignal, ParameterCommand, ParameterSignal, QueueDevice, ThreadDevice, TransformCommand, TransformSignal, TransportDevice, TransportTest, TransportTestcase

public interface MessageListener
extends ErrorListener

The MessageListener interface defines the methods to be called when a message is received. A MessageListener Interface is implemented by anyone who wishes to be notified whenever a valid MessageService is received by the TransportService.

Since:

1.0

Version:

1.2.0

See Also:

ErrorListener, MessageService, ParameterService, TransportService

Method Summary

void	messageReceived(TransportService transportService, java.lang.Object timestamp, MessageService message) This API will be called each time the TransportService receives a valid message.

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

errorOccurred

Method Detail

messageReceived

void messageReceived(TransportService transportService,
                     java.lang.Object timestamp,
                     MessageService message)

This API will be called each time the TransportService receives a valid message. 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.

The transport that received the message. The timestamp when the message was detected. The message received.

Parameters:

transportService - The transport service (TransportService) parameter.

timestamp - The time stamp (Object) parameter.

message - The message (MessageService) parameter.