1.0.0

org.eclipse.soda.dk.signal
Class Signal

java.lang.Object
  extended by org.eclipse.soda.dk.core.EscObject
      extended by org.eclipse.soda.dk.device.Control
          extended by org.eclipse.soda.dk.signal.Signal
All Implemented Interfaces:
ControlService, SignalService, ErrorListener
Direct Known Subclasses:
MessageSignal, MethodSignal, Signals

public class Signal
extends Control
implements SignalService

The Signal class implements the SignalService interface.

Version:
1.0.0
See Also:
Control, ControlService, ErrorListener, MessageHandler, SignalService

Field Summary
 
Fields inherited from class org.eclipse.soda.dk.device.Control
EXCEPTION_READ_FAILED_RESOURCE, SETVALUEEXCEPTION_RESOURCE
 
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, INTEGER_TABLE, KEY_KEY, LOG_DEBUG, LOG_ERROR, LOG_INFO, LOG_TRACE, LOG_WARNING, PREFIX_KEY, 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
 
Constructor Summary
Signal(java.lang.String key)
          Constructs an Signal object using the input parameter(s).
 
Method Summary
 void addSignalListener(SignalListener signalListener)
          Adds the specified listener to receive listener notification.
 void fireErrorOccurred(java.lang.Object timestamp, java.lang.Object data)
          Fire error occurred with the specified timestamp and data parameters.
protected  void fireErrorOccurred(SignalListener signalListener, java.lang.Object timestamp, java.lang.Object data)
          Fire error occurred with the specified signal listener, timestamp and data parameters.
 void fireSignalOccurred(SignalListener signalListener, java.lang.Object timestamp)
          Perform the fireSignalOccurred with no data action method.
 void fireSignalOccurred(SignalListener signalListener, java.lang.Object timestamp, java.lang.Object data)
          Perform the fireSignalOccurred action method.
protected  SignalListener getSignalListener()
          Gets the SignalListener signalListener property value.
 void removeSignalListener(SignalListener signalListener)
          Removes the specified listener from receiving listener notification.
protected  void reportError(int errorNumber, java.lang.Throwable error, java.lang.Object[] errorObjects)
          Report error with the specified error number, error and error objects parameters.
 void setSignalListener(SignalListener signalListener)
          Sets the signalListener.
 void trigger()
          Perform the trigger action method.
 void trigger(java.lang.Object value)
          Perform the trigger action method.
 void trigger(java.lang.Object data, java.lang.Object timestamp)
          Perform the trigger action method.
 
Methods inherited from class org.eclipse.soda.dk.device.Control
attemptRecoveryFromError, equalsValue, errorOccurred, getCodeKey, getErrorSeverity, getKey, getQualifiedKey, getResource, setKey, setQualifiedKey, toString
 
Methods inherited from class org.eclipse.soda.dk.core.EscObject
createDefaultLogService, createException, createException, createInteger, createIntegerTable, createNumber, format, getBoolean, getConfigurationService, getCurrentTimestamp, getDefaultLogService, getDefaultResource, getFloat, getInt, getLoadLibraryName, getLogDetails, getLogDetails0, getLogDetails1, getLogDetails2, getLogDetails3, getLogDetails4, getLogDetails5, getLogDetails6, getLogDetails7, getLogService, getLong, getObject, getOutputName, getSimpleClassName, getStaticBoolean, getStaticFloat, getStaticInt, getStaticLong, getStaticObject, getStaticString, getString, getTraceLevel, getVmLibraryVersion, handleError, handleError, handleError, handleStaticError, handleStaticException, isDebug, isTrace, loadService, log, log, report, report, report, report, report, report, reportSystemInfo, setDebug, setDefaultLogService, setLogService, setTraceLevel, shouldLog, sleep, startupEscStatic, toStringConfigurationKeys, toStringInfo
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface org.eclipse.soda.dk.device.service.ControlService
getKey
 

Constructor Detail

Signal

public Signal(java.lang.String key)
Constructs an Signal object using the input parameter(s).

Parameters:
key - java.lang.String
Method Detail

addSignalListener

public void addSignalListener(SignalListener signalListener)
Adds the specified listener to receive listener notification.

Specified by:
addSignalListener in interface SignalService
Parameters:
signalListener - The org.eclipse.soda.dk.signal.service.SignalListener listener to be added.
See Also:
SignalService.addSignalListener(org.eclipse.soda.dk.signal.service.SignalListener), getSignalListener(), removeSignalListener(SignalListener), setSignalListener(SignalListener)

fireErrorOccurred

public void fireErrorOccurred(java.lang.Object timestamp,
                              java.lang.Object data)
Fire error occurred with the specified timestamp and data parameters.

Parameters:
timestamp - The timestamp (Object) parameter.
data - The data (Object) parameter.
See Also:
fireErrorOccurred(SignalListener,Object,Object)

fireErrorOccurred

protected void fireErrorOccurred(SignalListener signalListener,
                                 java.lang.Object timestamp,
                                 java.lang.Object data)
Fire error occurred with the specified signal listener, timestamp and data parameters.

Parameters:
signalListener - The signal listener (SignalListener) parameter.
timestamp - The timestamp (Object) parameter.
data - The data (Object) parameter.
See Also:
fireErrorOccurred(Object,Object)

fireSignalOccurred

public void fireSignalOccurred(SignalListener signalListener,
                               java.lang.Object timestamp)
Perform the fireSignalOccurred with no data action method.

Parameters:
signalListener - The signal listener (must not be null).
timestamp - java.lang.Object
See Also:
fireSignalOccurred(SignalListener,Object,Object)

fireSignalOccurred

public void fireSignalOccurred(SignalListener signalListener,
                               java.lang.Object timestamp,
                               java.lang.Object data)
Perform the fireSignalOccurred action method.

Parameters:
signalListener - The signal listener (must not be null).
timestamp - java.lang.Object
data - java.lang.Object
See Also:
fireSignalOccurred(SignalListener,Object)

getSignalListener

protected SignalListener getSignalListener()
Gets the SignalListener signalListener property value.

Returns:
Results of the get signal listener (SignalListener) value.
See Also:
addSignalListener(SignalListener), removeSignalListener(SignalListener), setSignalListener(SignalListener)

removeSignalListener

public void removeSignalListener(SignalListener signalListener)
Removes the specified listener from receiving listener notification.

Specified by:
removeSignalListener in interface SignalService
Parameters:
signalListener - The org.eclipse.soda.dk.signal.service.SignalListener listener to be removed.
See Also:
SignalService.removeSignalListener(org.eclipse.soda.dk.signal.service.SignalListener), addSignalListener(SignalListener), getSignalListener(), setSignalListener(SignalListener)

reportError

protected void reportError(int errorNumber,
                           java.lang.Throwable error,
                           java.lang.Object[] errorObjects)
                    throws java.lang.RuntimeException
Report error with the specified error number, error and error objects parameters.

Overrides:
reportError in class EscObject
Parameters:
errorNumber - The error number (int) parameter.
error - The error (Throwable) parameter.
errorObjects - The error objects (Object[]) parameter.
Throws:
java.lang.RuntimeException - Runtime Exception.
See Also:
EscObject.handleStaticError(String), EscObject.attemptRecoveryFromError(int,Throwable), EscObject.handleError(Throwable,int), EscObject.handleError(Throwable,int,Object), EscObject.handleError(Throwable,int,Object[])

setSignalListener

public void setSignalListener(SignalListener signalListener)
Sets the signalListener.

Parameters:
signalListener - The signalListener to set
See Also:
addSignalListener(SignalListener), getSignalListener(), removeSignalListener(SignalListener)

trigger

public void trigger()
Perform the trigger action method.

Specified by:
trigger in interface SignalService
See Also:
SignalService.trigger(), trigger(Object), trigger(Object,Object)

trigger

public void trigger(java.lang.Object value)
Perform the trigger action method.

Specified by:
trigger in interface SignalService
Parameters:
value - java.lang.Object
See Also:
SignalService.trigger(), trigger(), trigger(Object,Object)

trigger

public void trigger(java.lang.Object data,
                    java.lang.Object timestamp)
Perform the trigger action method.

Parameters:
data - java.lang.Object
timestamp - java.lang.Object
See Also:
trigger(), trigger(Object)

1.0.0

Copyright (c) 1999, 2007 IBM