org.eclipse.core.databinding.observable.value
Class DuplexingObservableValue

java.lang.Object
  

org.eclipse.core.databinding.observable.AbstractObservable
      

org.eclipse.core.databinding.observable.value.AbstractObservableValue
          
org.eclipse.core.databinding.observable.value.DuplexingObservableValue

All Implemented Interfaces:

IObservable, IObservableValue

public abstract class DuplexingObservableValue
extends 
AbstractObservableValue

Since:

1.2

Constructor Summary
DuplexingObservableValue ( IObservableList target)
DuplexingObservableValue ( IObservableList target, Object valueType)

 

Method Summary
void	addChangeListener ( IChangeListener listener)           Adds the given change listener to the list of change listeners.
protected  void	addListener ( Object listenerType, IObservablesListener listener)
void	addValueChangeListener ( IValueChangeListener listener)
protected   Object	clone ()
protected abstract   Object	coalesceElements ( Collection elements)
void	dispose ()           Disposes of this observable object, removing all listeners registered with this object, and all listeners this object might have registered on other objects.
protected   Object	doGetValue ()
protected  void	doSetValue ( Object value)           Template method for setting the value of the observable.
protected  void	fireEvent ( ObservableEvent event)
protected  void	firstListenerAdded ()
Realm	getRealm ()
Object	getValueType ()           The value type of this observable value, or null if this observable value is untyped.
protected  boolean	hasListeners ()
boolean	isStale ()           Returns whether the state of this observable is stale and is expected to change soon.
protected  void	lastListenerRemoved ()
protected  void	makeDirty ()
protected  void	removeListener ( Object listenerType, IObservablesListener listener)
static  DuplexingObservableValue	withDefaults ( IObservableList target, Object emptyValue, Object multiValue)           Returns a DuplexingObservableValue implementation with predefined values to use if the list is empty or contains multiple different values.

 

Methods inherited from class org.eclipse.core.databinding.observable.value. AbstractObservableValue
fireChange, fireValueChange, getValue, removeValueChangeListener, setValue

 

Methods inherited from class org.eclipse.core.databinding.observable. AbstractObservable
addDisposeListener, addStaleListener, checkRealm, fireStale, isDisposed, removeChangeListener, removeDisposeListener, removeStaleListener

 

Methods inherited from class java.lang. Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

Methods inherited from interface org.eclipse.core.databinding.observable. IObservable
addDisposeListener, addStaleListener, getRealm, isDisposed, removeChangeListener, removeDisposeListener, removeStaleListener

 

Constructor Detail

DuplexingObservableValue

public DuplexingObservableValue(
IObservableList target)

Parameters:

target -

DuplexingObservableValue

public DuplexingObservableValue(
IObservableList target,
                                
Object valueType)

Parameters:

target -

valueType -

withDefaults

public static 
DuplexingObservableValue withDefaults(
IObservableList target,
                                                    
Object emptyValue,
                                                    
Object multiValue)

Returns a DuplexingObservableValue implementation with predefined values to use if the list is empty or contains multiple different values.

Parameters:

target - the observable list

emptyValue - the value to use when the target list is empty

multiValue - the value to use when the target list contains multiple values that are not equivalent to eachother.

Returns:

a DuplexingObservableValue implementation with predefined values to use if the list is empty or contains multiple different values.

firstListenerAdded

protected void firstListenerAdded()

lastListenerRemoved

protected void lastListenerRemoved()

makeDirty

protected final void makeDirty()

isStale

public boolean isStale()

Description copied from interface: IObservable

Returns whether the state of this observable is stale and is expected to change soon. A non-stale observable that becomes stale will notify its stale listeners. A stale object that becomes non-stale does so by changing its state and notifying its change listeners, it does not notify its stale listeners about becoming non-stale. Clients that do not expect asynchronous changes may ignore staleness of observable objects.

Specified by:

isStale in interface IObservable

Overrides:

isStale in class AbstractObservableValue

Returns:

true if this observable's state is stale and will change soon.

doGetValue

protected 
Object doGetValue()

Specified by:

doGetValue in class AbstractObservableValue

coalesceElements

protected abstract 
Object coalesceElements(
Collection elements)

doSetValue

protected void doSetValue(
Object value)

Description copied from class: AbstractObservableValue

Template method for setting the value of the observable. By default the method throws an UnsupportedOperationException .

Overrides:

doSetValue in class AbstractObservableValue

getValueType

public 
Object getValueType()

Description copied from interface: IObservableValue

The value type of this observable value, or null if this observable value is untyped.

Returns:

the value type, or null

public void addChangeListener(
IChangeListener listener)

public void addValueChangeListener(
IValueChangeListener listener)

public void dispose()

protected void addListener(
Object listenerType,
                           
IObservablesListener listener)

protected void removeListener(
Object listenerType,
                              
IObservablesListener listener)

protected boolean hasListeners()

protected void fireEvent(
ObservableEvent event)

public 
Realm getRealm()

protected 
Object clone()
                throws 
CloneNotSupportedException