org.eclipse.soda.dk.device
Class DeviceListeners

java.lang.Object
  org.eclipse.soda.dk.core.EscObject
      org.eclipse.soda.dk.device.DeviceListeners

All Implemented Interfaces:

DeviceListener, MultiplexDeviceListener, ErrorListener

public class DeviceListeners
extends EscObject
implements MultiplexDeviceListener

The DeviceListeners class implements the DeviceListener interface.

Since:

1.0

Version:

1.2.0

See Also:

ErrorListener, DeviceListener

Field Summary

Fields inherited from class org.eclipse.soda.dk.core.EscObject

CLONE_EXCEPTION_RESOURCE, EMPTY_BYTES, EMPTY_STRING, ERROR_OCCURRED_EXCEPTION_RESOURCE, ID_FILTER_KEY, ID_KEY, ID_KEY_ANY, ID_NAME_KEY, INTEGER_TABLE, INTEGER_TABLE_SIZE, KEY_KEY, LOG_DEBUG, LOG_DEFAULT, LOG_ERROR, LOG_INFO, LOG_LEVEL_KEY, LOG_TRACE, LOG_WARNING, LONG_TABLE, LONG_TABLE_SIZE, PREFIX_KEY, READONLY_EMPTY_COLLECTION, READONLY_EMPTY_LIST, READONLY_EMPTY_MAP, RESOURCE_BUNDLE, SLEEP_EXCEPTION_RESOURCE, SYSTEM_INFO_RESOURCE, TO_STRING_CONFIGURATION_KEYS, TRACE_LEVEL_HIGH, TRACE_LEVEL_LOW, TRACE_LEVEL_MAX, TRACE_LEVEL_MIN, TRACE_LEVEL_NONE, TRACE_LEVEL_NORMAL, TRACELEVEL_KEY, UNKNOWN_ERROR_RESOURCE, Unmodifiable

Fields inherited from interface org.eclipse.soda.dk.device.service.DeviceListener

ADDED, CHANGED, REMOVED

Constructor Summary

DeviceListeners(DeviceListener[] objects)
Constructs an DeviceListeners object using the input parameter(s).

DeviceListeners(DeviceListener currentObject, DeviceListener newObject)
Constructs an DeviceListeners object using the input parameter(s).

Method Summary

static DeviceListener	add(DeviceListener currentObject, DeviceListener newObject) Perform the add method and return the DeviceListener result.
void	channelChanged(DeviceService source, java.lang.Object timestamp, ChannelService channel, int newState, int oldState) Channel changed with the specified source, timestamp, channel, new state and old state parameters.
void	controlChanged(DeviceService container, java.lang.Object timestamp, ControlService control, int code) The controlChanged method is called when a control was changed.
void	deviceChanged(DeviceService source, java.lang.Object timestamp, int newState, int oldState) This method will be called when the state of the DeviceService changes.
void	errorOccurred(java.lang.Object source, java.lang.Object timestamp, java.lang.Object data) The errorOccurred method is called when an error has occurred.
DeviceListener[]	getObjects() Gets the DeviceListener [] objects property value.
protected DeviceListener	remove(DeviceListener removeHandler) Perform the remove method and return the DeviceListener result.
static DeviceListener	remove(DeviceListener currentObject, DeviceListener removeObject) Perform the remove method and return the Object result.

Methods inherited from class org.eclipse.soda.dk.core.EscObject

attemptRecoveryFromError, createBoolean, createDefaultLogService, createException, createException, createInteger, createIntegerTable, createLong, createLongTable, createNumber, format, getBoolean, getByte, getChar, getConfigurationService, getCurrentTimestamp, getDefaultLogService, getDefaultResource, getDouble, getErrorSeverity, getFloat, getId, getIdName, getInt, getLoadLibraryName, getLogDetails, getLogDetails, getLogDetails0, getLogDetails1, getLogDetails2, getLogDetails3, getLogDetails4, getLogDetails5, getLogDetails6, getLogDetails7, getLogLevel, getLogService, getLong, getObject, getOutputName, getReadOnlyEmptyCollection, getReadOnlyEmptyList, getReadOnlyEmptyMap, getResource, getShort, getSimpleClassName, getStaticBoolean, getStaticByte, getStaticChar, getStaticDouble, getStaticFloat, getStaticInt, getStaticLong, getStaticObject, getStaticShort, getStaticString, getString, getTraceLevel, getVmLibraryVersion, handleError, handleError, handleError, handleError, handleErrorInternal, handleStaticError, handleStaticException, isBackward, isDebug, isLogging, isTrace, isUnmodifiable, loadService, log, log, log, report, report, report, report, report, report, report, reportError, reportSystemInfo, setBackward, setDebug, setDefaultLogService, setLogService, setTraceLevel, setUnmodifiable, shouldLog, sleep, startupEscStatic, toString, toStringConfigurationKeys, toStringInfo

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

DeviceListeners

public DeviceListeners(DeviceListener currentObject,
                       DeviceListener newObject)

Constructs an DeviceListeners object using the input parameter(s).

Parameters:

currentObject - The current object (DeviceListener) parameter.

newObject - The new object (DeviceListener) parameter.

See Also:

DeviceListeners(DeviceListener[])

DeviceListeners

public DeviceListeners(DeviceListener[] objects)

Constructs an DeviceListeners object using the input parameter(s).

Parameters:

objects - The objects (DeviceListener[]) parameter.

See Also:

DeviceListeners(DeviceListener,DeviceListener)

Method Detail

add

public static DeviceListener add(DeviceListener currentObject,
                                 DeviceListener newObject)

Perform the add method and return the DeviceListener result.

Parameters:

currentObject - The current object (DeviceListener) parameter.

newObject - The new object (DeviceListener) parameter.

Returns:

Results of the add (DeviceListener) value.

remove

public static DeviceListener remove(DeviceListener currentObject,
                                    DeviceListener removeObject)

Perform the remove method and return the Object result.

Parameters:

currentObject - The current object (DeviceListener) parameter.

removeObject - The remove object (DeviceListener) parameter.

Returns:

Results of the remove (DeviceListener) value.

See Also:

remove(DeviceListener)

channelChanged

public void channelChanged(DeviceService source,
                           java.lang.Object timestamp,
                           ChannelService channel,
                           int newState,
                           int oldState)

Channel changed with the specified source, timestamp, channel, new state and old state parameters.

Specified by:

channelChanged in interface MultiplexDeviceListener

Parameters:

source - The source (DeviceService) parameter.

timestamp - The time stamp (Object) parameter.

channel - The channel (ChannelService) parameter.

newState - The new state (int) parameter.

oldState - The old state (int) parameter.

Since:

1.2

See Also:

controlChanged(DeviceService,Object,ControlService,int), deviceChanged(DeviceService,Object,int,int)

controlChanged

public void controlChanged(DeviceService container,
                           java.lang.Object timestamp,
                           ControlService control,
                           int code)

The controlChanged method is called when a control was changed. A notification method to all DeviceListeners that a ControlService, specified by the control argument, and contained within the DeviceService, specified in the device arguement, was Added, Removed, or Modified, specified by the code argument in accordance with the above constants, at the time specified by the timestamp argument. In English : A control of the DeviceService was changed in the following manner at this time. 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.

Specified by:

controlChanged in interface DeviceListener

Parameters:

container - The container (DeviceService) parameter.

timestamp - The time stamp (Object) parameter.

control - The control (ControlService) parameter.

code - The code (int) parameter.

See Also:

channelChanged(DeviceService,Object,ChannelService,int,int), deviceChanged(DeviceService,Object,int,int)

deviceChanged

public void deviceChanged(DeviceService source,
                          java.lang.Object timestamp,
                          int newState,
                          int oldState)

This method will be called when the state of the DeviceService changes. 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.

Because of the multiple threads and quickly changing states, the current state of the device may not be the same as the newState input parameter.

Specified by:

deviceChanged in interface DeviceListener

Parameters:

source - The source (DeviceService) parameter.

timestamp - The time stamp (Object) parameter.

newState - The new state (int) parameter.

oldState - The old state (int) parameter.

See Also:

channelChanged(DeviceService,Object,ChannelService,int,int), controlChanged(DeviceService,Object,ControlService,int)

errorOccurred

public void errorOccurred(java.lang.Object source,
                          java.lang.Object timestamp,
                          java.lang.Object data)

The errorOccurred method is called when an error has occurred. 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.

Specified by:

errorOccurred in interface ErrorListener

Parameters:

source - The source (Object) parameter.

timestamp - The time stamp (Object) parameter.

data - The data (Object) parameter.

getObjects

public DeviceListener[] getObjects()

Gets the DeviceListener [] objects property value.

Returns:

Results of the get objects (DeviceListener[]) value.

remove

protected DeviceListener remove(DeviceListener removeHandler)

Perform the remove method and return the DeviceListener result.

Parameters:

removeHandler - The remove handler (DeviceListener) parameter.

Returns:

Results of the remove (DeviceListener) value.

See Also:

remove(DeviceListener,DeviceListener)