Class WeakInvalidationListener

java.lang.Object

javafx.beans.WeakInvalidationListener

All Implemented Interfaces:: InvalidationListener, WeakListener

public final class WeakInvalidationListener extends Object implements InvalidationListener, WeakListener

A WeakInvalidationListener can be used if an Observable should only maintain a weak reference to the listener. This helps to avoid memory leaks that can occur if observers are not unregistered from observed objects after use.

A WeakInvalidationListener is created by passing in the original InvalidationListener. The WeakInvalidationListener should then be registered to listen for changes of the observed object.

Note: You have to keep a reference to the InvalidationListener that was passed in as long as it is in use, otherwise it can be garbage collected too soon.

Since:

JavaFX 2.0

See Also:

Constructor Summary

Constructor	Description
`WeakInvalidationListener(InvalidationListener listener)`	The constructor of `WeakInvalidationListener`.

Method Summary

Modifier and Type	Method	Description
`void`	`invalidated(Observable observable)`	This method needs to be provided by an implementation of `InvalidationListener`.
`boolean`	`wasGarbageCollected()`	Returns `true` if the linked listener was garbage-collected.

Methods declared in class java.lang.Object

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

Constructor Details

WeakInvalidationListener

public WeakInvalidationListener(InvalidationListener listener)

The constructor of WeakInvalidationListener.

Parameters:: listener - The original listener that should be notified

Method Details

wasGarbageCollected

public boolean wasGarbageCollected()

Returns true if the linked listener was garbage-collected. In this case, the listener can be removed from the observable.

Specified by:: wasGarbageCollected in interface WeakListener
Returns:: true if the linked listener was garbage-collected.

invalidated

public void invalidated(Observable observable)

This method needs to be provided by an implementation of InvalidationListener. It is called if an Observable becomes invalid.

In general, it is considered bad practice to modify the observed value in this method.

Specified by:: invalidated in interface InvalidationListener
Parameters:: observable - The Observable that became invalid

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.