org.itsnat.core.event

Interface ItsNatEventListenerChain

public interface ItsNatEventListenerChain

This interface is used to control the flow of event listeners processing.

ItsNat provides a default implementation returned by ItsNatEvent.getItsNatEventListenerChain().

Methods of this object must be called only inside the processing of an event listener and must not be saved beyond the lifetime of the related event.

Usually global event listeners and event listeners registered with ItsNatComponent.addEventListener(String,org.w3c.dom.events.EventListener) can benefit of this feature.

Author:

Jose Maria Arranz Santamaria

Method Summary

Methods

Modifier and Type	Method and Description
void	continueChain() If called, the listener dispatching flow will follow this path, that is to say, next listeners will be executed before returning this method.
boolean	isStopped() Informs whether the processing of this event is stopped.
void	stop() Instructs ItsNat to stop the normal event listener flow, next listeners are not dispatched.

Method Detail

continueChain

void continueChain()

If called, the listener dispatching flow will follow this path, that is to say, next listeners will be executed before returning this method.

This method can be used to catch exceptions thrown by followin listeners, to open/commit transactions before/after calling this method etc.

stop

void stop()

Instructs ItsNat to stop the normal event listener flow, next listeners are not dispatched.

isStopped

boolean isStopped()

Informs whether the processing of this event is stopped.

Returns:

true whether event processing is stopped.