This class provides convenience methods for adding various listeners, both strong and weak, as well as a single disconnect() method to remove all listeners.

There are two usage patterns:

Client code registers a number of listeners and removes them all at once via disconnect() call.
Client code registers a number of listeners and removes one via its IDisconnectable instance.

This class is currently used for clean replacement of Skins. We should consider making this class a part of the public API in javax.base, since it proved itself useful in removing listeners and handlers in bulk at the application level.

Nested and Inner Type Summary

Modifier and Type	Class and Description
private abstract static class	ListenerHelper.ChLi<T>
private abstract class	ListenerHelper.EvHa<T extends Event>
private abstract static class	ListenerHelper.InLi
private abstract static class	ListenerHelper.LiChLi<T>
private abstract static class	ListenerHelper.MaChLi<K, V>
private abstract static class	ListenerHelper.SeChLi<T>

Field Summary

Modifier and Type	Field and Description
private static Function<SkinBase<?>, ListenerHelper>	accessor
private final ArrayList<IDisconnectable>	items
private WeakReference<Object>	ownerRef

Constructor Summary

Access	Constructor and Description
public	ListenerHelper(Object owner)
public	ListenerHelper()

Method Summary

Modifier and Type	Method and Description
public IDisconnectable	addChangeListener(Runnable callback, ObservableValue<?>... props)
public IDisconnectable	addChangeListener(Runnable onChange, boolean fireImmediately, ObservableValue<?>... props)
public <T> IDisconnectable	addChangeListener(ObservableValue<T> prop, ChangeListener<T> listener)
public <T> IDisconnectable	addChangeListener(ObservableValue<T> prop, boolean fireImmediately, ChangeListener<T> listener)
public <T> IDisconnectable	addChangeListener(ObservableValue<T> prop, Consumer<T> callback)
public <T> IDisconnectable	addChangeListener(ObservableValue<T> prop, boolean fireImmediately, Consumer<T> callback)
public IDisconnectable	addDisconnectable(Runnable r)
public <T extends Event> IDisconnectable	addEventFilter(EventTarget x, EventType<T> t, EventHandler<T> handler)
public <T extends Event> IDisconnectable	addEventHandler(EventTarget x, EventType<T> t, EventHandler<T> handler)
public IDisconnectable	addInvalidationListener(Runnable callback, ObservableValue<?>... props)
public IDisconnectable	addInvalidationListener(Runnable callback, boolean fireImmediately, ObservableValue<?>... props)
public <T> IDisconnectable	addInvalidationListener(ObservableValue<T> prop, InvalidationListener listener)
public <T> IDisconnectable	addInvalidationListener(ObservableValue<T> prop, boolean fireImmediately, InvalidationListener listener)
public <T> IDisconnectable	addListChangeListener(ObservableList<T> list, ListChangeListener<T> listener)
public <K, V> IDisconnectable	addMapChangeListener(ObservableMap<K, V> list, MapChangeListener<K, V> listener)
public <T> IDisconnectable	addSetChangeListener(ObservableSet<T> set, SetChangeListener<T> listener)
public void	disconnect() Implements com.sun.javafx.scene.control.IDisconnectable.disconnect. Disconnects what has been connected.
public static ListenerHelper	get(SkinBase<?> skin)
private boolean	isAliveOrDisconnect()
public static void	setAccessor(Function<SkinBase<?>, ListenerHelper> a)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

accessor	back to summary
private static Function<SkinBase<?>, ListenerHelper> accessor

items	back to summary
private final ArrayList<IDisconnectable> items

ownerRef	back to summary
private WeakReference<Object> ownerRef

Constructor Detail

ListenerHelper	back to summary
public ListenerHelper(Object owner)

ListenerHelper	back to summary
public ListenerHelper()

Method Detail

addChangeListener	back to summary
public IDisconnectable addChangeListener(Runnable callback, ObservableValue<?>... props)

addChangeListener	back to summary
public IDisconnectable addChangeListener(Runnable onChange, boolean fireImmediately, ObservableValue<?>... props)

addChangeListener	back to summary
public <T> IDisconnectable addChangeListener(ObservableValue<T> prop, ChangeListener<T> listener)

addChangeListener	back to summary
public <T> IDisconnectable addChangeListener(ObservableValue<T> prop, boolean fireImmediately, ChangeListener<T> listener)

addChangeListener	back to summary
public <T> IDisconnectable addChangeListener(ObservableValue<T> prop, Consumer<T> callback)

addChangeListener	back to summary
public <T> IDisconnectable addChangeListener(ObservableValue<T> prop, boolean fireImmediately, Consumer<T> callback)

addDisconnectable	back to summary
public IDisconnectable addDisconnectable(Runnable r)

addEventFilter	back to summary
public <T extends Event> IDisconnectable addEventFilter(EventTarget x, EventType<T> t, EventHandler<T> handler)

addEventHandler	back to summary
public <T extends Event> IDisconnectable addEventHandler(EventTarget x, EventType<T> t, EventHandler<T> handler)

addInvalidationListener	back to summary
public IDisconnectable addInvalidationListener(Runnable callback, ObservableValue<?>... props)

addInvalidationListener	back to summary
public IDisconnectable addInvalidationListener(Runnable callback, boolean fireImmediately, ObservableValue<?>... props)

addInvalidationListener	back to summary
public <T> IDisconnectable addInvalidationListener(ObservableValue<T> prop, InvalidationListener listener)

addInvalidationListener	back to summary
public <T> IDisconnectable addInvalidationListener(ObservableValue<T> prop, boolean fireImmediately, InvalidationListener listener)

addListChangeListener	back to summary
public <T> IDisconnectable addListChangeListener(ObservableList<T> list, ListChangeListener<T> listener)

addMapChangeListener	back to summary
public <K, V> IDisconnectable addMapChangeListener(ObservableMap<K, V> list, MapChangeListener<K, V> listener)

addSetChangeListener	back to summary
public <T> IDisconnectable addSetChangeListener(ObservableSet<T> set, SetChangeListener<T> listener)

disconnect	back to summary
public void disconnect() Implements com.sun.javafx.scene.control.IDisconnectable.disconnect. Doc from com.sun.javafx.scene.control.IDisconnectable.disconnect. Disconnects what has been connected. May be called multiple times, only the first invocation actually disconnects. Annotations @Override

disconnect

back to summary

public void disconnect()

Implements com.sun.javafx.scene.control.IDisconnectable.disconnect.

Doc from com.sun.javafx.scene.control.IDisconnectable.disconnect.

Disconnects what has been connected. May be called multiple times, only the first invocation actually disconnects.

Annotations

@Override

get	back to summary
public static ListenerHelper get(SkinBase<?> skin)

isAliveOrDisconnect	back to summary
private boolean isAliveOrDisconnect()

setAccessor	back to summary
public static void setAccessor(Function<SkinBase<?>, ListenerHelper> a)

com.sun.javafx.scene.control back to summary

private abstract Class ListenerHelper.ChLi<T>

Class Inheritance

extends Object
implements IDisconnectable, ChangeListener<T>

java.lang.Object
com.sun.javafx.scene.control.ListenerHelper.ChLi

All Implemented Interfaces

javafx.beans.value.ChangeListener, com.sun.javafx.scene.control.IDisconnectable

Constructor Summary

Access	Constructor and Description
private	ChLi()

Method Summary

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Constructor Detail

ChLi	back to summary
private ChLi()

com.sun.javafx.scene.control back to summary

private abstract Class ListenerHelper.EvHa<T extends Event>

Class Inheritance

extends Object
implements IDisconnectable, EventHandler<T extends Event>

java.lang.Object
com.sun.javafx.scene.control.ListenerHelper.EvHa

All Implemented Interfaces

javafx.event.EventHandler, java.util.EventListener, com.sun.javafx.scene.control.IDisconnectable

Field Summary

Modifier and Type	Field and Description
private final EventHandler<T>	handler

Constructor Summary

Access	Constructor and Description
public	EvHa(EventHandler<T> h)

Method Summary

Modifier and Type	Method and Description
public void	handle(T the event which occurred ev) Implements javafx.event.EventHandler.handle. Invoked when a specific event of the type for which this handler is registered happens.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

handler	back to summary
private final EventHandler<T> handler

Constructor Detail

EvHa	back to summary
public EvHa(EventHandler<T> h)

Method Detail

handle	back to summary
public void handle(T ev) Implements javafx.event.EventHandler.handle. Doc from javafx.event.EventHandler.handle. Invoked when a specific event of the type for which this handler is registered happens. Parameters ev:T the event which occurred Annotations @Override

handle

back to summary

public void handle(T ev)

Implements javafx.event.EventHandler.handle.

Doc from javafx.event.EventHandler.handle.

Invoked when a specific event of the type for which this handler is registered happens.

Parameters