org.omnifaces.eventlistener

Class InvokeActionEventListener

java.lang.Object

org.omnifaces.eventlistener.DefaultPhaseListener

org.omnifaces.eventlistener.InvokeActionEventListener

All Implemented Interfaces:

Serializable, EventListener, FacesListener, PhaseListener, SystemEventListener

public class InvokeActionEventListener
extends DefaultPhaseListener
implements SystemEventListener

This phase listener takes care that the PreInvokeActionEvent and PostInvokeActionEvent events are properly been published.

This phase listener is already registered by OmniFaces own faces-config.xml and thus get auto-initialized when OmniFaces JAR is bundled in webapp, so endusers do not need to register this phase listener explicitly themself.

Since:

1.1

Author:

Bauke Scholtz

See Also:

PreInvokeActionEvent, PostInvokeActionEvent, Serialized Form

Constructor Summary

Constructors

Constructor and Description
InvokeActionEventListener() This constructor instructs the DefaultPhaseListener to hook on PhaseId.INVOKE_APPLICATION and subscribes this instance as a SystemEventListener to the PostValidateEvent event.

Method Summary

Methods

Modifier and Type	Method and Description
void	afterPhase(PhaseEvent event) Publish the PostInvokeActionEvent event on the components which are been collected in processEvent(SystemEvent).
void	beforePhase(PhaseEvent event) Publish the PreInvokeActionEvent event on the components which are been collected in processEvent(SystemEvent).
boolean	isListenerForSource(Object source) Returns true only when the given source is an instance of UIViewRoot, UIForm, UIInput or UICommand.
void	processEvent(SystemEvent event) If the validation has not failed for the current faces context, then check if the UIComponent which passed the isListenerForSource(Object) check has any listeners for the PreInvokeActionEvent and/or PostInvokeActionEvent events and then add them to a set in the current faces context.

Methods inherited from class org.omnifaces.eventlistener.DefaultPhaseListener

getPhaseId

Methods inherited from class java.lang.Object

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

Constructor Detail

InvokeActionEventListener

public InvokeActionEventListener()

This constructor instructs the DefaultPhaseListener to hook on PhaseId.INVOKE_APPLICATION and subscribes this instance as a SystemEventListener to the PostValidateEvent event. This allows collecting the components eligible for PreInvokeActionEvent or PostInvokeActionEvent inside the processEvent(SystemEvent) method.

Method Detail

isListenerForSource

public boolean isListenerForSource(Object source)

Returns true only when the given source is an instance of UIViewRoot, UIForm, UIInput or UICommand.

Specified by:

isListenerForSource in interface SystemEventListener

processEvent

public void processEvent(SystemEvent event)
                  throws AbortProcessingException

If the validation has not failed for the current faces context, then check if the UIComponent which passed the isListenerForSource(Object) check has any listeners for the PreInvokeActionEvent and/or PostInvokeActionEvent events and then add them to a set in the current faces context.

Specified by:

processEvent in interface SystemEventListener

Throws:

AbortProcessingException

beforePhase

public void beforePhase(PhaseEvent event)

Publish the PreInvokeActionEvent event on the components which are been collected in processEvent(SystemEvent).

Specified by:

beforePhase in interface PhaseListener

Overrides:

beforePhase in class DefaultPhaseListener

afterPhase

public void afterPhase(PhaseEvent event)

Publish the PostInvokeActionEvent event on the components which are been collected in processEvent(SystemEvent).

Specified by:

afterPhase in interface PhaseListener

Overrides:

afterPhase in class DefaultPhaseListener