org.geotools.gce.imagemosaic

Class ImageMosaicEventHandlers

Object

ImageMosaicEventHandlers

public class ImageMosaicEventHandlers
extends Object

Base class to handle events

Author:

carlo cancellieri - GeoSolutions SAS

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ImageMosaicEventHandlers.ExceptionEvent Event launched when an exception occurs.
static class	ImageMosaicEventHandlers.FileProcessingEvent A special ProcessingEvent raised when a file has completed/failed ingestion
static class	ImageMosaicEventHandlers.ProcessingEvent
static class	ImageMosaicEventHandlers.ProcessingEventListener
protected static class	ImageMosaicEventHandlers.ProgressEventDispatchThreadEventLauncher Private Class which simply fires the events using a copy of the listeners list in order to avoid problems with listeners that remove themselves or are removed by someone else
static class	ImageMosaicEventHandlers.URLProcessingEvent A special ProcessingEvent raised when a url has completed/failed ingestion

Field Summary

Fields

Modifier and Type	Field and Description
protected List<ImageMosaicEventHandlers.ProcessingEventListener>	notificationListeners List containing all the objects that want to be notified during processing.
protected boolean	sendDelayedMessages Set this to false for command line UIs where the delayed event sending may prevent some messages to be seen before the tool exits, to true for real GUI where you don't want the processing to be blocked too long, or when you have slow listeners in general.

Constructor Summary

Constructors

Constructor and Description
ImageMosaicEventHandlers()

Method Summary

Modifier and Type	Method and Description
void	addProcessingEventListener(ImageMosaicEventHandlers.ProcessingEventListener listener) Adding a listener to the ImageMosaicEventHandlers.ProcessingEventListeners' list.
protected void	fireEvent(Level level, String inMessage, double percentage) Firing an event to listeners in order to inform them about what we are doing and about the percentage of work already carried out.
protected void	fireException(Exception ex) Firing an exception event to listeners in order to inform them that processing broke and we can no longer proceed.
protected void	fireFileEvent(Level level, File file, boolean ingested, String inMessage, double percentage) Firing an event to listeners in order to inform them about what we are doing and about the percentage of work already carried out.
protected void	fireUrlEvent(Level level, URL url, boolean ingested, String inMessage, double percentage) Firing an event to listeners in order to inform them about what we are doing and about the percentage of work already carried out.
boolean	isSendDelayedMessages()
void	removeAllProcessingEventListeners() Removing all the listeners.
void	removeProcessingEventListener(ImageMosaicEventHandlers.ProcessingEventListener listener) Removing a ImageMosaicEventHandlers.ProcessingEventListener from the listeners' list.
void	setSendDelayedMessages(boolean sendDelayedMessages)

Methods inherited from class Object

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

Field Detail

notificationListeners

protected List<ImageMosaicEventHandlers.ProcessingEventListener> notificationListeners

List containing all the objects that want to be notified during processing.

sendDelayedMessages

protected boolean sendDelayedMessages

Set this to false for command line UIs where the delayed event sending may prevent some messages to be seen before the tool exits, to true for real GUI where you don't want the processing to be blocked too long, or when you have slow listeners in general.

Constructor Detail

ImageMosaicEventHandlers

public ImageMosaicEventHandlers()

Method Detail

addProcessingEventListener

public final void addProcessingEventListener(ImageMosaicEventHandlers.ProcessingEventListener listener)

Adding a listener to the ImageMosaicEventHandlers.ProcessingEventListeners' list.

Parameters:

listener - to add to the list of listeners.

fireEvent

protected void fireEvent(Level level,
                         String inMessage,
                         double percentage)

Firing an event to listeners in order to inform them about what we are doing and about the percentage of work already carried out.

Parameters:

inMessage - The message to show.

percentage - The percentage for the process.

fireFileEvent

protected void fireFileEvent(Level level,
                             File file,
                             boolean ingested,
                             String inMessage,
                             double percentage)

Firing an event to listeners in order to inform them about what we are doing and about the percentage of work already carried out.

Parameters:

inMessage - The message to show.

percentage - The percentage for the process.

fireUrlEvent

protected void fireUrlEvent(Level level,
                            URL url,
                            boolean ingested,
                            String inMessage,
                            double percentage)

Firing an event to listeners in order to inform them about what we are doing and about the percentage of work already carried out.

Parameters:

inMessage - The message to show.

percentage - The percentage for the process.

fireException

protected void fireException(Exception ex)

Firing an exception event to listeners in order to inform them that processing broke and we can no longer proceed. This is a convenience method, it will call fireException(String, double, Exception) with the exception message and -1 as percentage.

Parameters:

ex - the actual exception occurred

isSendDelayedMessages

public boolean isSendDelayedMessages()

setSendDelayedMessages

public void setSendDelayedMessages(boolean sendDelayedMessages)

removeAllProcessingEventListeners

public void removeAllProcessingEventListeners()

Removing all the listeners.

removeProcessingEventListener

public void removeProcessingEventListener(ImageMosaicEventHandlers.ProcessingEventListener listener)

Removing a ImageMosaicEventHandlers.ProcessingEventListener from the listeners' list.

Parameters:

listener - ImageMosaicEventHandlers.ProcessingEventListener to remove from the list of listeners.