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.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 AbstractEventSource<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
void	addListener(ObservableEventListener<? super V> listener, boolean weak)
protected void	fireChange(Object change)	Fires a default value change event.
protected void	fireEvent()	Fires a default value change event.
protected void	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.AbstractEventSource

getEventAdapter, hasListeners

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, addWeakListener

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

get, getSafe

Constructor Details

AbstractObservableValue

public AbstractObservableValue()

The constructor.

Method Details

addListener

public void addListener(ObservableEventListener<? super V> listener,
 boolean weak)

Specified by:

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

Overrides:

addListener in class AbstractEventSource<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 AbstractEventSource<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 change.

See Also:

• fireEvent(ObservableEvent)

fireEvent

protected void fireEvent(ObservableEvent<V> event)

Overrides:

fireEvent in class AbstractEventSource<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.