The IProgressMonitor interface is implemented
by objects that monitor the progress of a external process;
the methods in this interface are invoked by code that performs the external
process handling.
A request to cancel the external process can be signaled using the
setCanceled method. Operations taking a progress monitor are
expected to poll the monitor (using isCanceled) periodically and
abort at their earliest convenience. Operation can however choose to ignore
cancelation requests.
Since notification is synchronous with the external process itself, the
listener should provide a fast and robust implementation. If the handling of
notifications would involve blocking operations, or operations which might
throw uncaught exceptions, the notifications should be queued, and the actual
processing deferred (or perhaps delegated to a separate thread).
Clients may implement this interface.
author:
Nico Klasens (Finalist IT Group)
version:
$Id: IProgressMonitor.java,v 1.3 2003/05/12 13:10:48 kees Exp $
since:
MMBase-1.6 |