alma.ACS.impl

Class CommonComparableMonitorImpl

java.lang.Object

alma.ACS.impl.CommonMonitorImpl

alma.ACS.impl.CommonComparableMonitorImpl

All Implemented Interfaces:

BACIDispatchAction.DispatchFailedListener, BACITimer.TimerRunnable, DataAccess.ValueChangeListener, PrioritizedRunnable, java.lang.Runnable

Direct Known Subclasses:

MonitorbooleanImpl, MonitordoubleImpl, MonitorfloatImpl, MonitorlongImpl, MonitorlongLongImpl, MonitorpatternImpl, MonitorstringImpl, MonitorstringSeqImpl, MonitoruLongLongImpl

public class CommonComparableMonitorImpl
extends CommonMonitorImpl
implements DataAccess.ValueChangeListener

Implementation of common compareable (notifies on change) monitor.

Author:

Matej Sekoranja

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	CommonComparableMonitorImpl.PoolTimer Pool timer implementation.

Field Summary

Fields

Modifier and Type	Field and Description
protected CommonComparablePropertyImpl	comparableProperty Cache - casted property to CommonComparablePropertyImpl.
static long	DEFAULT_POOL_TIME Default pool time (if on-change notification are not supported) in ms.
protected java.lang.Object	deltaValue Current required delta.
protected boolean	enabled Enabled status (might be true even if disabled (if suspended)) - user status.
protected java.lang.Object	oldValue Last pooled (notified) value.
protected boolean	onEveryChange Flag if notification has to be done on every value change.
protected java.lang.Object	poolTimerTask Monitor timer task.

Fields inherited from class alma.ACS.impl.CommonMonitorImpl

dispatchAction, isDestroyed, isSuspended, monitorTimerTask, property, queuedKeyTime, startTime, timeTrigger, userControlledStartTime

Constructor Summary

Constructors

Constructor and Description
CommonComparableMonitorImpl(CommonPropertyImpl property, Callback callback, CBDescIn descIn) Constructor with immediate monitor notification (synchronized monitors supported).
CommonComparableMonitorImpl(CommonPropertyImpl property, Callback callback, CBDescIn descIn, long startTime) Constructor.

Method Summary

Modifier and Type	Method and Description
protected void	disable() Disable on-change monitoring/pooling.
protected void	enable() Enable on-change monitoring/pooling.
java.lang.Object	getValueTrigger(org.omg.CORBA.BooleanHolder enableHolder)
void	resume()
void	setValueTrigger(boolean enable) Enable on-change monitoring.
void	setValueTrigger(java.lang.Object delta, boolean enable) Enable on-delta-change monitoring, requires to operatie on CommonComparableProperty.
void	suspend()
void	valueChanged(DataAccess source, java.lang.Object oldValue, java.lang.Object newValue) Method called on value change.

Methods inherited from class alma.ACS.impl.CommonMonitorImpl

alignStartTime, destroy, dispatchFailed, get_timer_trigger, getPriority, initialize, retrieveValueAndDispatch, run, schedule, set_timer_trigger, setTimeTrigger, start_time, timeout

Methods inherited from class java.lang.Object

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

Field Detail

deltaValue

protected java.lang.Object deltaValue

Current required delta.

onEveryChange

protected boolean onEveryChange

Flag if notification has to be done on every value change. NOTE: this mode is explicitly used for non-comparable properties, i.e. properties is implementing CommonComparablePropertyImpl.

comparableProperty

protected CommonComparablePropertyImpl comparableProperty

Cache - casted property to CommonComparablePropertyImpl.

oldValue

protected java.lang.Object oldValue

Last pooled (notified) value.

enabled

protected boolean enabled

Enabled status (might be true even if disabled (if suspended)) - user status.

poolTimerTask

protected java.lang.Object poolTimerTask

Monitor timer task.

DEFAULT_POOL_TIME

public static final long DEFAULT_POOL_TIME

Default pool time (if on-change notification are not supported) in ms.

See Also:

Constant Field Values

Constructor Detail

CommonComparableMonitorImpl

public CommonComparableMonitorImpl(CommonPropertyImpl property,
                                   Callback callback,
                                   CBDescIn descIn)

Constructor with immediate monitor notification (synchronized monitors supported).

Parameters:

property - property to be monitored, non-null.

callback - callback, non-null.

descIn - callback in-descriptor.

CommonComparableMonitorImpl

public CommonComparableMonitorImpl(CommonPropertyImpl property,
                                   Callback callback,
                                   CBDescIn descIn,
                                   long startTime)

Constructor.

Parameters:

property - property to be monitored, non-null.

callback - callback, non-null.

descIn - callback in-descriptor.

startTime - startTime (OMG time), values less or equal to current time mean immediately, value 0 means that start time should be controlled automatically (synchronized monitors).

Method Detail

enable

protected void enable()

Enable on-change monitoring/pooling.

disable

protected void disable()

Disable on-change monitoring/pooling.

valueChanged

public void valueChanged(DataAccess source,
                         java.lang.Object oldValue,
                         java.lang.Object newValue)

Description copied from interface: DataAccess.ValueChangeListener

Method called on value change. NOTE: method should complete as soon as possible!

Specified by:

valueChanged in interface DataAccess.ValueChangeListener

Parameters:

source - DataAccess instance firing this event.

oldValue - old value.

newValue - new value.

See Also:

DataAccess.ValueChangeListener.valueChanged(alma.ACS.jbaci.DataAccess, java.lang.Object, java.lang.Object)

resume

public void resume()

Overrides:

resume in class CommonMonitorImpl

See Also:

alma.ACS.SubscriptionOperations#resume()

suspend

public void suspend()

Overrides:

suspend in class CommonMonitorImpl

See Also:

alma.ACS.SubscriptionOperations#suspend()

setValueTrigger

public void setValueTrigger(boolean enable)

Enable on-change monitoring.

Parameters:

enable - switch to enable/disable

See Also:

alma.ACS.MonitorOperations#set_value_trigger(, boolean)

setValueTrigger

public void setValueTrigger(java.lang.Object delta,
                            boolean enable)

Enable on-delta-change monitoring, requires to operatie on CommonComparableProperty.

Parameters:

delta - delta value, non-null.

enable - switch to enable/disable

See Also:

alma.ACS.MonitorOperations#set_value_trigger(, boolean)

getValueTrigger

public java.lang.Object getValueTrigger(org.omg.CORBA.BooleanHolder enableHolder)

Parameters:

enableHolder - holder to be set current 'enable' status of the monitor.

Returns:

deltaValue current delta value, can be null.

See Also:

alma.ACS.MonitorOperations#get_value_trigger(org.omg.CORBA.Holder, org.omg.CORBA.BooleanHolder)