ca.odell.glazedlists

Interface ObservableElementList.Connector<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. Implementations typically install a single listener, such as a java.beans.PropertyChangeListener on list elements to detect changes in the state of the element. The installed listener implementation in turn calls ObservableElementList.elementChanged(Object) in order to have the list broadcast an update at the index of the object.

Method Summary

EventListener
installListener(E element)
Start listening for events from the specified element.
void
setObservableElementList(ObservableElementList list)
Sets the ObservableElementList to notify when changes occur on elements.
void
uninstallListener(E element, EventListener listener)
Stop listening for events from the specified element.

Method Details

installListener

public 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.

setObservableElementList

public void setObservableElementList(ObservableElementList list)
Sets the ObservableElementList to notify when changes occur on elements.
Parameters:
list - the ObservableElementList containing the elements to observe

uninstallListener

public void uninstallListener(E element,
                              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).

Glazed Lists, Copyright © 2003-2006 publicobject.com, O'Dell Engineering.
Documentation build by pbuilder at 2007-12-21 23:49