org.codefx.libfx.nesting.listener

Class NestedChangeListenerHandle<T>

java.lang.Object

org.codefx.libfx.nesting.listener.NestedChangeListenerHandle<T>

Type Parameters:

T - the type of the value wrapped by the ObservableValue

All Implemented Interfaces:

ListenerAttachHandle, ListenerDetachHandle, ListenerHandle, NestedListenerHandle, Nested

public class NestedChangeListenerHandle<T>
extends Object
implements NestedListenerHandle

Contains a ChangeListener which is connected to a Nesting. Simply put, the listener is always added to the nesting's inner observable (more precisely, it is added to the ObservableValue instance contained in the optional value held by the nesting's innerObservable property).

Inner Observable's Value Changes

The listener is added to the nesting's inner observable. So when that observable's value changes, the listener is called as usual.

Inner Observable Is Replaced

When the nesting's inner observable is replaced by another, the listener is removed from the old and added to the new observable. If one of them is missing, the affected removal or add is not performed, which means the listener might not be added to any observable.

Note that if the observable is replaced, the listener is not called! If this is the desired behavior, a listener has to be added to a NestedProperty.

Property Summary

Type	Property and Description
javafx.beans.property.ReadOnlyBooleanProperty	innerObservablePresent The property indicating whether the nesting's inner observable is currently present, i.e.

Method Summary

Modifier and Type	Method and Description
void	attach() Adds the listener to the observable.
void	detach() Removes the listener from the observable.
javafx.beans.property.ReadOnlyBooleanProperty	innerObservablePresentProperty() The property indicating whether the nesting's inner observable is currently present, i.e.
boolean	isInnerObservablePresent() Gets the value of the property innerObservablePresent.

Methods inherited from class java.lang.Object

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

Property Detail

innerObservablePresent

public javafx.beans.property.ReadOnlyBooleanProperty innerObservablePresentProperty

The property indicating whether the nesting's inner observable is currently present, i.e. not null.

Specified by:

innerObservablePresentProperty in interface Nested

See Also:

isInnerObservablePresent()

Method Detail

attach

public void attach()

Description copied from interface: ListenerAttachHandle

Adds the listener to the observable. Calling this method when the listener is already added is a no-op and will not result in the listener being called more than once.

Specified by:

attach in interface ListenerAttachHandle

detach

public void detach()

Description copied from interface: ListenerDetachHandle

Removes the listener from the observable. Calling this method when the listener is not added is a no-op.

Specified by:

detach in interface ListenerDetachHandle

innerObservablePresentProperty

public javafx.beans.property.ReadOnlyBooleanProperty innerObservablePresentProperty()

The property indicating whether the nesting's inner observable is currently present, i.e. not null.

Specified by:

innerObservablePresentProperty in interface Nested

See Also:

isInnerObservablePresent()

isInnerObservablePresent

public boolean isInnerObservablePresent()

Gets the value of the property innerObservablePresent.

Specified by:

isInnerObservablePresent in interface Nested

Returns:

true if the inner observable is present, i.e. not null