globals.rmi

Class TriggerStub

java.lang.Object

util.PropertyContainer

util.PropertyResources

globals.parameter.AbstractParameter

globals.rmi.ParameterStub

globals.rmi.TriggerStub

All Implemented Interfaces:

Parameter, Trigger, Cloneable, Runnable, Remote, CancelRunnable, ExitCleaning, Initializable, PropertySupplying, Reloadable, ResourceSupplying, RmiListener, Triggering

Direct Known Subclasses:

SwitchStub

public class TriggerStub
extends ParameterStub
implements Trigger

An extension to parameter stub. This class casts the generic parameter stub to a trigger stub, meaning that the parameter value retrieved from the remote machine with RemoteParameter.remoteGet() is cast to a boolean value. All the unique Trigger functionality is available.

Nested Class Summary

Nested classes/interfaces inherited from class globals.rmi.ParameterStub

ParameterStub.Finger

Nested classes/interfaces inherited from class util.PropertyResources

PropertyResources.Load, PropertyResources.URLResource

Field Summary

Fields

Modifier and Type	Field and Description
static String	KEY_UNCONNECTED If this is set, we return a boolean value even if not connected.

Fields inherited from class globals.rmi.ParameterStub

KEY_BLOCK, KEY_FORMATCLASS, KEY_FORMATPATTERN, KEY_INITTRY, KEY_REMOTENAME, KEY_RETRY, KEY_SERVERDELAY, KEY_WAIT, sensor

Fields inherited from class globals.parameter.AbstractParameter

KEY_FORMAT, KEY_NAME, KEY_PRESERVE, UNKNOWN

Fields inherited from class util.PropertyResources

KEY_NOINITONCREATE, POSTFIX_ALPHABET, POSTFIX_BYTES, POSTFIX_DIR, POSTFIX_EXT, POSTFIX_FILE, POSTFIX_LIST, POSTFIX_MODTIME, POSTFIX_URL

Fields inherited from class util.PropertyContainer

KEY_LISTSEPARATOR, KEY_MAPKEYVALUECHAR, KEY_MAPSEPARATOR

Fields inherited from interface util.PropertySupplying

CONFIG, KEY_CLASS

Fields inherited from interface util.ResourceSupplying

KEY_URLRESOURCES, KEY_URLUSECONFIG, KEY_URLUSECURRENT, KEY_URLUSEHOME

Constructor Summary

Constructors

Constructor and Description
TriggerStub(Map<String,String> prop) Constructs a new trigger stub.
TriggerStub(String remotename) For convenience, we support a constructor with only the remote name.

Method Summary

Modifier and Type	Method and Description
Object	get() Casts the parameter value retrieved with get() to a Boolean.
long	getElapsedToggleTime() Returns the elapsed time since the last toggle event.
Date	getLastToggleTime() Returns the time of the last toggle event as a date.
Boolean	getTrigger() Casts the parameter value retrieved with get() to a Boolean.
boolean	isTrue() Returns the value of this trigger already interpreted as a primitive boolean.
Boolean	setTrigger(Boolean to) Operation not allowed.
Boolean	toggleTrigger() Operation not allowed.

Methods inherited from class globals.rmi.ParameterStub

cancel, disconnect, exit, getAsociatedThread, getFormatted, init, isConnected, maxTimeToCancel, rebind, rescanned, run, set

Methods inherited from class globals.parameter.AbstractParameter

createParameter, delivers, getFormatted, getName, getPreserveFile, getString, getString, overrideDefaultName, register, setName, toString

Methods inherited from class util.PropertyResources

clone, createFrom, createFrom, createFrom, createInstance, getApplet, getAsResources, getLocate, getPropertiesToKey, getPropertiesToKey, getResource, getResourceAsStream, getResourceFromKey, getResources, hasLocalURLs, initProperties, keyCreate, keyCreate, reload, setApplet

Methods inherited from class util.PropertyContainer

augment, augment, augment, augment, augment, defaultBoolean, defaultChar, defaultDouble, defaultFloat, defaultInt, defaultLong, defaultObject, defaultObject, defaultProperties, defaultProperty, getAsBoolean, getAsChar, getAsDouble, getAsEnums, getAsFloat, getAsInt, getAsList, getAsLong, getAsMap, getAsMap, getAsObject, getAsObject, getProperties, getProperty, has, isNew, parseObject, parseObject, reload, removeProperty, requires, setObject, setProperties, setProperty, stringProperties

Methods inherited from class java.lang.Object

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

Methods inherited from interface globals.Parameter

getFormatted, getName, getString, set

Methods inherited from interface util.PropertySupplying

defaultBoolean, defaultChar, defaultDouble, defaultFloat, defaultInt, defaultLong, defaultObject, defaultObject, defaultProperties, defaultProperty, getAsBoolean, getAsChar, getAsDouble, getAsFloat, getAsInt, getAsList, getAsLong, getAsMap, getAsObject, getAsObject, getProperties, getProperty, has, parseObject, removeProperty, setObject, setProperty, stringProperties

Methods inherited from interface util.Initializable

init

Methods inherited from interface util.Reloadable

reload

Field Detail

KEY_UNCONNECTED

public static final String KEY_UNCONNECTED

If this is set, we return a boolean value even if not connected.

See Also:

Constant Field Values

Constructor Detail

TriggerStub

public TriggerStub(String remotename)
            throws RemoteException,
                   InitException

For convenience, we support a constructor with only the remote name.

Throws:

InitException

RemoteException

TriggerStub

public TriggerStub(Map<String,String> prop)
            throws RemoteException

Constructs a new trigger stub. This trigger connects to a remote parameter. The value retrieved must be of type Boolean.

Throws:

RemoteException

Method Detail

getTrigger

public Boolean getTrigger()

Casts the parameter value retrieved with get() to a Boolean. Does not check if the returned value is of type Boolean.

Specified by:

getTrigger in interface Triggering

get

public Object get()

Casts the parameter value retrieved with get() to a Boolean. Does not check if the returned value is of type Boolean.

Specified by:

get in interface Parameter

Overrides:

get in class ParameterStub

isTrue

public boolean isTrue()

Returns the value of this trigger already interpreted as a primitive boolean. If the trigger was never set prior to this call, false is returned.

Specified by:

isTrue in interface Triggering

setTrigger

public Boolean setTrigger(Boolean to)

Operation not allowed.

Specified by:

setTrigger in interface Triggering

Throws:

UnsupportedOperationException - always.

toggleTrigger

public Boolean toggleTrigger()

Operation not allowed.

Specified by:

toggleTrigger in interface Triggering

Throws:

UnsupportedOperationException - always.

getLastToggleTime

public Date getLastToggleTime()

Returns the time of the last toggle event as a date. If this trigger was never toggled, i.e. its state changed from one logical state to the other, null is returned. Calls the RemoteTrigger.remoteToggleTime() method, without checking if the remote counterpart is registered.

Specified by:

getLastToggleTime in interface Triggering

getElapsedToggleTime

public long getElapsedToggleTime()

Returns the elapsed time since the last toggle event. If this trigger was never toggled, i.e. its state changed from one logical state to the other, -1 is returned. If the system is acceleerated, we multiply the elapsed time, simply because we are bound to another system with unknown acceleration.

Specified by:

getElapsedToggleTime in interface Triggering

Returns:

The time since the last toggle event, in ms.