GemsFX 3.10.1 · com.dlsc.gemsfx.binding.AbstractNestedListBinding

Provides a base for creating bindings based on a nested structure of observable lists. This abstract class handles the addition and removal of listeners to these nested observable lists to facilitate easy updates and maintenance of bindings that depend on their content.

The class uses weak listeners to prevent memory leaks and ensure that lists can be garbage collected when no longer in use. Changes in any of the nested lists will trigger an invalidation in the binding, prompting a re-computation of its value based on the specific implementation of computeValue() in the subclass.

Field Summary

Modifier and Type	Field and Description
private final ListChangeListener<T>	innerListChangeListener
private final ListChangeListener<ObservableList<T>>	outerListChangeListener
protected final ObservableList<ObservableList<T>>	source
private final WeakListChangeListener<T>	weakInnerListChangeListener
private final WeakListChangeListener<ObservableList<T>>	weakOuterListChangeListener

Constructor Summary

Access	Constructor and Description
public	AbstractNestedListBinding(ObservableList<ObservableList<T>> The observable list of observable lists that serves as the source for this binding. source) Constructs an AbstractNestedListBinding with the specified source of nested observable lists.

Method Summary

Modifier and Type	Method and Description
public void	dispose() Overrides javafx.beans.binding.ObjectBinding.dispose. Implements javafx.beans.binding.Binding.dispose. A default implementation of `dispose()` that is empty.
protected Stream<T>	flattenSource()
protected void	initListeners() Initializes listeners on the source list and any existing nested lists.
private void	safeAddListener(ObservableList<T> list)
private void	safeRemoveListener(ObservableList<T> list)

Inherited from javafx.beans.binding.ObjectBinding:: addListener addListener allowValidation bind computeValue get getDependencies invalidate isObserved isValid onInvalidating removeListener removeListener toString unbind

Field Detail

innerListChangeListener	back to summary
private final ListChangeListener<T> innerListChangeListener

outerListChangeListener	back to summary
private final ListChangeListener<ObservableList<T>> outerListChangeListener

source	back to summary
protected final ObservableList<ObservableList<T>> source

weakInnerListChangeListener	back to summary
private final WeakListChangeListener<T> weakInnerListChangeListener

weakOuterListChangeListener	back to summary
private final WeakListChangeListener<ObservableList<T>> weakOuterListChangeListener

Constructor Detail

AbstractNestedListBinding	back to summary
public AbstractNestedListBinding(ObservableList<ObservableList<T>> source) Constructs an AbstractNestedListBinding with the specified source of nested observable lists. Parameters source:ObservableList<ObservableList<T>> The observable list of observable lists that serves as the source for this binding.

AbstractNestedListBinding

back to summary

public AbstractNestedListBinding(ObservableList<ObservableList<T>> source)

Constructs an AbstractNestedListBinding with the specified source of nested observable lists.

Parameters

source:ObservableList<ObservableList<T>>: The observable list of observable lists that serves as the source for this binding.

Method Detail

dispose back to summary

dispose	back to summary
public void dispose() Overrides javafx.beans.binding.ObjectBinding.dispose. Implements javafx.beans.binding.Binding.dispose. Doc from javafx.beans.binding.ObjectBinding.dispose. A default implementation of `dispose()` that is empty. Annotations @Override

public void dispose()

Overrides javafx.beans.binding.ObjectBinding.dispose.

Implements javafx.beans.binding.Binding.dispose.

Doc from javafx.beans.binding.ObjectBinding.dispose.

A default implementation of dispose() that is empty.

Annotations

@Override

flattenSource	back to summary
protected Stream<T> flattenSource()

initListeners	back to summary
protected void initListeners() Initializes listeners on the source list and any existing nested lists. This method should be called after subclass constructors have fully initialized any necessary fields to ensure that listeners interact with a fully initialized object.

safeAddListener	back to summary
private void safeAddListener(ObservableList<T> list)