JavaFX 24 · com.sun.javafx.binding.LazyObjectBinding

Modifier and Type	Field and Description
private Subscription	subscription
private boolean	wasObserved

Access	Constructor and Description
pack-priv	LazyObjectBinding()

Method Summary

Modifier and Type	Method and Description
public void	addListener(ChangeListener<? super T> The listener to register listener) Overrides javafx.beans.binding.ObjectBinding.addListener. Implements javafx.beans.value.ObservableValue.addListener. Adds a `ChangeListener` which will be notified whenever the value of the `ObservableValue` changes.
public void	addListener(InvalidationListener The listener to register listener) Overrides javafx.beans.binding.ObjectBinding.addListener. Implements javafx.beans.Observable.addListener. Adds an `InvalidationListener` which will be notified whenever the `Observable` becomes invalid.
protected boolean	allowValidation() Overrides javafx.beans.binding.ObjectBinding.allowValidation. Checks if the binding is allowed to become valid.
protected abstract Subscription	Returns: a `Subscription` which will be cancelled when this binding no longer has any observers, never null observeSources() Called when this binding was previously not observed and a new observer was added.
public void	removeListener(ChangeListener<? super T> The listener to remove listener) Overrides javafx.beans.binding.ObjectBinding.removeListener. Implements javafx.beans.value.ObservableValue.removeListener. Removes the given listener from the list of listeners that are notified whenever the value of the `ObservableValue` changes.
public void	removeListener(InvalidationListener The listener to remove listener) Overrides javafx.beans.binding.ObjectBinding.removeListener. Implements javafx.beans.Observable.removeListener. Removes the given listener from the list of listeners, that are notified whenever the value of the `Observable` becomes invalid.
private void	updateSubscriptionAfterAdd() Called after a listener was added to start observing inputs if they're not observed already.
private void	updateSubscriptionAfterRemove() Called after a listener was removed to stop observing inputs if this was the last listener observing this binding.

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

subscription	back to summary
private Subscription subscription

wasObserved	back to summary
private boolean wasObserved

LazyObjectBinding	back to summary
pack-priv LazyObjectBinding()

Method Detail

addListener back to summary

addListener	back to summary
public void addListener(ChangeListener<? super T> listener) Overrides javafx.beans.binding.ObjectBinding.addListener. Implements javafx.beans.value.ObservableValue.addListener. Doc from javafx.beans.value.ObservableValue.addListener. Adds a `ChangeListener` which will be notified whenever the value of the `ObservableValue` changes. If the same listener is added more than once, then it will be notified more than once. That is, no check is made to ensure uniqueness. Note that the same actual `ChangeListener` instance may be safely registered for different `ObservableValues`. The `ObservableValue` stores a strong reference to the listener which will prevent the listener from being garbage collected and may result in a memory leak. It is recommended to either unregister a listener by calling `removeListener` after use or to use an instance of `WeakChangeListener` avoid this situation. Parameters listener:ChangeListener<? super T> The listener to register Annotations @Override

public void addListener(ChangeListener<? super T> listener)

Overrides javafx.beans.binding.ObjectBinding.addListener.

Implements javafx.beans.value.ObservableValue.addListener.

Doc from javafx.beans.value.ObservableValue.addListener.

Adds a ChangeListener which will be notified whenever the value of the ObservableValue changes. If the same listener is added more than once, then it will be notified more than once. That is, no check is made to ensure uniqueness.

Note that the same actual ChangeListener instance may be safely registered for different ObservableValues.

The ObservableValue stores a strong reference to the listener which will prevent the listener from being garbage collected and may result in a memory leak. It is recommended to either unregister a listener by calling removeListener after use or to use an instance of WeakChangeListener avoid this situation.

Parameters

listener:ChangeListener<? super T>: The listener to register

Annotations

@Override

addListener back to summary

addListener	back to summary
public void addListener(InvalidationListener listener) Overrides javafx.beans.binding.ObjectBinding.addListener. Implements javafx.beans.Observable.addListener. Doc from javafx.beans.Observable.addListener. Adds an `InvalidationListener` which will be notified whenever the `Observable` becomes invalid. If the same listener is added more than once, then it will be notified more than once. That is, no check is made to ensure uniqueness. Note that the same actual `InvalidationListener` instance may be safely registered for different `Observables`. The `Observable` stores a strong reference to the listener which will prevent the listener from being garbage collected and may result in a memory leak. It is recommended to either unregister a listener by calling `removeListener` after use or to use an instance of `WeakInvalidationListener` avoid this situation. Parameters listener:InvalidationListener The listener to register Annotations @Override

public void addListener(InvalidationListener listener)

Overrides javafx.beans.binding.ObjectBinding.addListener.

Implements javafx.beans.Observable.addListener.

Doc from javafx.beans.Observable.addListener.

Adds an InvalidationListener which will be notified whenever the Observable becomes invalid. If the same listener is added more than once, then it will be notified more than once. That is, no check is made to ensure uniqueness.

Note that the same actual InvalidationListener instance may be safely registered for different Observables.

The Observable stores a strong reference to the listener which will prevent the listener from being garbage collected and may result in a memory leak. It is recommended to either unregister a listener by calling removeListener after use or to use an instance of WeakInvalidationListener avoid this situation.

Parameters

listener:InvalidationListener: The listener to register

Annotations

@Override

allowValidation back to summary

allowValidation	back to summary
protected boolean allowValidation() Overrides javafx.beans.binding.ObjectBinding.allowValidation. Doc from javafx.beans.binding.ObjectBinding.allowValidation. Checks if the binding is allowed to become valid. Overriding classes can prevent a binding from becoming valid. This is useful in subclasses which do not always listen for invalidations of their dependencies and prefer to recompute the current value instead. This can also be useful if caching of the current computed value is not desirable. The default implementation always allows bindings to become valid. Returns:boolean `true` if this binding is allowed to become valid, otherwise `false` Annotations @Override

protected boolean allowValidation()

Overrides javafx.beans.binding.ObjectBinding.allowValidation.

Doc from javafx.beans.binding.ObjectBinding.allowValidation.

Checks if the binding is allowed to become valid. Overriding classes can prevent a binding from becoming valid. This is useful in subclasses which do not always listen for invalidations of their dependencies and prefer to recompute the current value instead. This can also be useful if caching of the current computed value is not desirable.

The default implementation always allows bindings to become valid.

Returns:boolean

true if this binding is allowed to become valid, otherwise false

Annotations

@Override

observeSources back to summary

observeSources	back to summary
protected abstract Subscription observeSources() Called when this binding was previously not observed and a new observer was added. Implementors must return a `Subscription` which will be cancelled when this binding no longer has any observers. Returns:Subscription a `Subscription` which will be cancelled when this binding no longer has any observers, never null

protected abstract Subscription observeSources()

Called when this binding was previously not observed and a new observer was added. Implementors must return a Subscription which will be cancelled when this binding no longer has any observers.

Returns:Subscription: a Subscription which will be cancelled when this binding no longer has any observers, never null

removeListener back to summary

removeListener	back to summary
public void removeListener(ChangeListener<? super T> listener) Overrides javafx.beans.binding.ObjectBinding.removeListener. Implements javafx.beans.value.ObservableValue.removeListener. Doc from javafx.beans.value.ObservableValue.removeListener. Removes the given listener from the list of listeners that are notified whenever the value of the `ObservableValue` changes. If the given listener has not been previously registered (i.e. it was never added) then this method call is a no-op. If it had been previously added then it will be removed. If it had been added more than once, then only the first occurrence will be removed. Parameters listener:ChangeListener<? super T> The listener to remove Annotations @Override

public void removeListener(ChangeListener<? super T> listener)

Overrides javafx.beans.binding.ObjectBinding.removeListener.

Implements javafx.beans.value.ObservableValue.removeListener.

Doc from javafx.beans.value.ObservableValue.removeListener.

Removes the given listener from the list of listeners that are notified whenever the value of the ObservableValue changes.

If the given listener has not been previously registered (i.e. it was never added) then this method call is a no-op. If it had been previously added then it will be removed. If it had been added more than once, then only the first occurrence will be removed.

Parameters

listener:ChangeListener<? super T>: The listener to remove

Annotations

@Override

removeListener back to summary

removeListener	back to summary
public void removeListener(InvalidationListener listener) Overrides javafx.beans.binding.ObjectBinding.removeListener. Implements javafx.beans.Observable.removeListener. Doc from javafx.beans.Observable.removeListener. Removes the given listener from the list of listeners, that are notified whenever the value of the `Observable` becomes invalid. If the given listener has not been previously registered (i.e. it was never added) then this method call is a no-op. If it had been previously added then it will be removed. If it had been added more than once, then only the first occurrence will be removed. Parameters listener:InvalidationListener The listener to remove Annotations @Override

public void removeListener(InvalidationListener listener)

Overrides javafx.beans.binding.ObjectBinding.removeListener.

Implements javafx.beans.Observable.removeListener.

Doc from javafx.beans.Observable.removeListener.

Removes the given listener from the list of listeners, that are notified whenever the value of the Observable becomes invalid.

Parameters

listener:InvalidationListener: The listener to remove

Annotations

@Override

updateSubscriptionAfterAdd	back to summary
private void updateSubscriptionAfterAdd() Called after a listener was added to start observing inputs if they're not observed already.

updateSubscriptionAfterRemove	back to summary
private void updateSubscriptionAfterRemove() Called after a listener was removed to stop observing inputs if this was the last listener observing this binding.

pack-priv abstract Class LazyObjectBinding<T>

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail