cascading.cascade
Interface CascadeListener

public interface CascadeListener

Interface CascadeListener provides hooks for receiving events on various stages of a Cascade execution.

Any RuntimeException thrown from any of the listener methods will force the given cascade to stop by calling Cascade.stop().

Method Summary

void	onCompleted(Cascade cascade) The onCompleted event is fired when a Cascade instance has completed all work whether if was success or failed.
void	onStarting(Cascade cascade) The onStarting event is fired when a Cascade instance receives the start() message.
void	onStopping(Cascade cascade) The onStopping event is fired when a Cascade instance receives the stop() message.
boolean	onThrowable(Cascade cascade, Throwable throwable) The onThrowable event is fired if any child Flow throws a Throwable type.

Method Detail

onStarting

void onStarting(Cascade cascade)

The onStarting event is fired when a Cascade instance receives the start() message.

Parameters:

cascade - the current Cascade

onStopping

void onStopping(Cascade cascade)

The onStopping event is fired when a Cascade instance receives the stop() message.

Parameters:

cascade - the current Cascade

onCompleted

void onCompleted(Cascade cascade)

The onCompleted event is fired when a Cascade instance has completed all work whether if was success or failed. If there was a thrown exception, onThrowable will be fired before this event.

Parameters:

cascade - the current Cascade

onThrowable

boolean onThrowable(Cascade cascade,
                    Throwable throwable)

The onThrowable event is fired if any child Flow throws a Throwable type. This throwable is passed as an argument to the event. This event method should return true if the given throwable was handled and should not be rethrown from the Cascade.complete() method.

Parameters:

cascade - the current Cascade

throwable - the current error

Returns:

returns true if this listener has handled the given throwable