Module io.github.mmm.value.observable

Package io.github.mmm.value.observable

Class Binding<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>

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

Type Parameters:

V - type of the observable value.

All Implemented Interfaces:

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

Direct Known Subclasses:

BooleanBinding, DurationBinding, InstantBinding, LocalDateBinding, LocalDateTimeBinding, LocalTimeBinding, NumberBinding, OffsetDateTimeBinding, OffsetDateTimeBinding, PatternBinding, StringBinding, ZonedDateTimeBinding

public abstract class Binding<V>
extends AbstractObservableValue<V>
implements Expression<V>

Expression that calculates its value dynamically from other ObservableValues (dependencies).

Since:

1.0.0

Constructor Summary

Constructors

Constructor	Description
Binding(Supplier<? extends V> expression, ObservableValue<?>... dependencies)	The constructor.

Method Summary

Modifier and Type	Method	Description
protected final void	bind(ObservableValue<?>... observables)	Start observing the dependencies for changes.
void	dispose()	Called if this Expression will not be used anymore and any references can be removed.
V	get()
protected final void	invalidate()	Invalidates this observable in case it's value is computed.
protected final boolean	isValid()
void	toString(StringBuilder sb)
protected final void	unbind(ObservableValue<?>... observables)	Stop observing the dependencies for changes.

Methods inherited from class io.github.mmm.value.observable.AbstractObservableValue

doAddListener, fireChange, fireEvent, fireEvent, fireEventFor, fireEventFor, fireEventWithOldValue, hasChangeAwareListeners, removeListener, toString

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

Methods inherited from interface io.github.mmm.value.observable.Expression

asString, isEqualTo, isEqualTo, isNotEqualTo, isNotEqualTo, isNotNull, isNull

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

getFallbackSafeValue, getSafe, getValueClass

Constructor Details

Binding

public Binding(Supplier<? extends V> expression,
 ObservableValue<?>... dependencies)

The constructor.

Parameters:

expression - the Supplier to compute the value.

dependencies - the ObservableValues the expression depends on.

Method Details

bind

protected final void bind(ObservableValue<?>... observables)

Start observing the dependencies for changes. If the value of one of the dependencies changes, the binding is marked as invalid.

Parameters:

observables - the dependencies to observe

unbind

protected final void unbind(ObservableValue<?>... observables)

Stop observing the dependencies for changes.

Parameters:

observables - the dependencies to stop observing

dispose

public void dispose()

Description copied from interface: Expression

Called if this Expression will not be used anymore and any references can be removed. Any ObservableEventListener added to dependent ObservableValues will be removed.

Specified by:

dispose in interface Expression<V>

get

public V get()

Specified by:

get in interface ReadableValue<V>

Specified by:

get in interface Supplier<V>

invalidate

protected final void invalidate()

Description copied from class: AbstractObservableValue

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

Overrides:

invalidate in class AbstractObservableValue<V>

isValid

protected final boolean isValid()

Returns:

true if the cached value is still valid, false otherwise (re-calculation required).

toString

public void toString(StringBuilder sb)

Specified by:

toString in interface ObservableValue<V>

Overrides:

toString in class AbstractObservableValue<V>

Parameters:

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