Module io.github.mmm.value.observable

Package io.github.mmm.value.observable

Class AbstractObservableValue<V>

java.lang.Object

io.github.mmm.event.AbstractEventSource<ObservableEvent<V>,ObservableEventListener<? super V>>

io.github.mmm.event.AbstractEventSender<ObservableEvent<V>,ObservableEventListener<? super V>>

io.github.mmm.value.observable.AbstractObservableValue<V>

Type Parameters:

V - type of the observable value.

All Implemented Interfaces:

EventSource<ObservableEvent<V>,ObservableEventListener<? super V>>, ObservableValue<V>, ReadableValue<V>, Supplier<V>

Direct Known Subclasses:

AbstractWritableObservableValue, Binding

public abstract class AbstractObservableValue<V>
extends AbstractEventSender<ObservableEvent<V>,ObservableEventListener<? super V>>
implements ObservableValue<V>

Abstract base implementation of ObservableValue that handles ObservableEventListeners.

Since:

1.0.0

Constructor Summary

Constructors

Constructor	Description
AbstractObservableValue()	The constructor.

Method Summary

Modifier and Type	Method	Description
protected void	doAddListener(EventListener<ObservableEvent<V>> listener)
protected void	fireChange(Object change)	Fires a default value change event.
protected void	fireEvent()	Fires a default value change event.
protected boolean	fireEvent(ObservableEvent<V> event)
protected void	fireEventFor(AbstractObservableValue<?> observable)
protected <T> void	fireEventFor(AbstractObservableValue<T> observable, ObservableEvent<T> event)
protected void	fireEventWithOldValue(V oldValue)	Fires a default value change event if the old value is known (currently available anyhow).
protected boolean	hasChangeAwareListeners()
protected void	invalidate()	Invalidates this observable in case it's value is computed.
boolean	removeListener(ObservableEventListener<? super V> listener)
final String	toString()
void	toString(StringBuilder sb)

Methods inherited from class io.github.mmm.event.AbstractEventSender

getEventAdapter, hasListeners, makeReadOnly

Methods inherited from class io.github.mmm.event.AbstractEventSource

addListener

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.github.mmm.event.EventSource

addListener, addListener, addWeakListener

Methods inherited from interface io.github.mmm.value.ReadableValue

get, getFallbackSafeValue, getSafe, getValueClass

Constructor Details

AbstractObservableValue

public AbstractObservableValue()

The constructor.

Method Details

doAddListener

protected void doAddListener(EventListener<ObservableEvent<V>> listener)

Overrides:

doAddListener in class AbstractEventSender<ObservableEvent<V>,ObservableEventListener<? super V>>

removeListener

public boolean removeListener(ObservableEventListener<? super V> listener)

Specified by:

removeListener in interface EventSource<ObservableEvent<V>,ObservableEventListener<? super V>>

Overrides:

removeListener in class AbstractEventSender<ObservableEvent<V>,ObservableEventListener<? super V>>

hasChangeAwareListeners

protected boolean hasChangeAwareListeners()

Returns:

true if at least one ChangeAwareObservableEventListener is registered, false otherwise (to avoid building and sending changes for better performance).

fireEvent

protected void fireEvent()

Fires a default value change event.

See Also:

• fireEvent(ObservableEvent)

fireEventWithOldValue

protected void fireEventWithOldValue(V oldValue)

Fires a default value change event if the old value is known (currently available anyhow).

Parameters:

oldValue - the old value. May be null.

See Also:

• fireEvent(ObservableEvent)

fireChange

protected void fireChange(Object change)

Fires a default value change event.

Parameters:

change - the changed value.

See Also:

• fireEvent(ObservableEvent)

fireEvent

protected boolean fireEvent(ObservableEvent<V> event)

Overrides:

fireEvent in class AbstractEventSender<ObservableEvent<V>,ObservableEventListener<? super V>>

fireEventFor

protected <T> void fireEventFor(AbstractObservableValue<T> observable,
 ObservableEvent<T> event)

Type Parameters:

T - type of the observable value.

Parameters:

observable - the AbstractObservableValue where to invoke fireEvent(ObservableEvent) (if prevented due to visibility issues).

event - the ObservableEvent to send.

fireEventFor

protected void fireEventFor(AbstractObservableValue<?> observable)

Parameters:

observable - the AbstractObservableValue where to invoke fireEvent() (if prevented due to visibility issues).

invalidate

protected void invalidate()

Invalidates this observable in case it's value is computed.

toString

public final String toString()

Overrides:

toString in class Object

toString

public void toString(StringBuilder sb)

Specified by:

toString in interface ObservableValue<V>

Parameters:

sb - the StringBuilder where to append the details of this property for toString()-Representation.