ca.odell.glazedlists

Interface ObservableElementList.Connector<E>

Enclosing class:

ObservableElementList<E>

public static interface ObservableElementList.Connector<E>

An interface defining the methods required for registering and unregistering change listeners on list elements within an ObservableElementList. The ObservableElementList implementation needs to implement ObservableElementChangeHandler. Connector implementations typically install a single listener, such as a PropertyChangeListener on list elements to detect changes in the state of the element. The installed listener implementation in turn calls ObservableElementChangeHandler.elementChanged(Object) in order to have the list broadcast an update at the index of the object.

Method Summary

Modifier and Type	Method and Description
java.util.EventListener	installListener(E element) Start listening for events from the specified element.
void	setObservableElementList(ObservableElementChangeHandler<? extends E> list) Sets the ObservableElementChangeHandler to notify when changes occur on elements.
void	uninstallListener(E element, java.util.EventListener listener) Stop listening for events from the specified element.

Method Detail

installListener

java.util.EventListener installListener(E element)

Start listening for events from the specified element. Alternatively, if the element does not require a listener to be attached to it (e.g. the element is immutable), null may be returned to signal that no listener was installed.

Parameters:

element - the element to be observed

Returns:

the listener that was installed on the element to be used as a parameter to uninstallListener(Object, EventListener). null is taken to mean no listener was installed and thus uninstallListener(Object, EventListener) need not be called.

uninstallListener

void uninstallListener(E element,
                       java.util.EventListener listener)

Stop listening for events from the specified element.

Parameters:

element - the element to be observed

listener - the listener as returned by installListener(Object).

setObservableElementList

void setObservableElementList(ObservableElementChangeHandler<? extends E> list)

Sets the ObservableElementChangeHandler to notify when changes occur on elements.

Parameters:

list - the ObservableElementList implementing ObservableElementChangeHandler containing the elements to observe