Package ucar.unidata.util

Class AsynchronousPropertyChangeWrapper

java.lang.Object

ucar.unidata.util.AsynchronousPropertyChangeWrapper

All Implemented Interfaces:

PropertyChangeListener, Runnable, EventListener

public final class AsynchronousPropertyChangeWrapper
extends Object
implements Runnable, PropertyChangeListener

Provides support for the asynchronous handling of property-change events. Property-change events are placed in a one-element event-queue for later, asynchronous processing by a wrapped PropertyChangeListener. If more than one event is received while the asynchronous, wrapped PropertyChangeListener is processing an event, then all events but the last are discarded. This implementation is good for PropertyChangeEvents that are self-contained and completely independent of one another.

Version:

$Revision: 1.7 $ $Date: 2006/05/05 19:19:32 $

Author:

Steven R. Emmerson

Constructor Summary

Constructors

Constructor	Description
AsynchronousPropertyChangeWrapper(PropertyChangeListener listener)	Constructs from nothing.

Method Summary

Modifier and Type	Method	Description
void	doRemove()	_more_
final void	propertyChange(PropertyChangeEvent event)	Receives a PropertyChangeEvent for asynchronous handling.
final void	run()	Executes the asynchronous, PropertyChangeEvent-handling thread.

Methods inherited from class java.lang.Object

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

Constructor Details

AsynchronousPropertyChangeWrapper

public AsynchronousPropertyChangeWrapper(PropertyChangeListener listener)

Constructs from nothing. The PropertyChangeEvent thread will be started.

Parameters:

listener - The listener to be wrapped.

Throws:

NullPointerException - if the listener is null.

Method Details

doRemove

public void doRemove()

_more_

run

public final void run()

Executes the asynchronous, PropertyChangeEvent-handling thread.

Specified by:

run in interface Runnable

propertyChange

public final void propertyChange(PropertyChangeEvent event)

Receives a PropertyChangeEvent for asynchronous handling. The event is placed on the event-queue, replacing any previous event.

Specified by:

propertyChange in interface PropertyChangeListener

Parameters:

event - The event to receive. May be null.