org.omnifaces.util

Class Events

java.lang.Object

org.omnifaces.util.Events

public final class Events
extends Object

Collection of utility methods for the JSF API with respect to working with system and phase events.

Usage

Some examples:

 // Add a callback to the current view which should run during every after phase of the render response on same view.
 Events.subscribeToViewAfterPhase(PhaseId.RENDER_RESPONSE, new Callback.Void() {
    @Override
    public void invoke() {
        // ...
    }
 });
 

 // Add a callback to the current request which should run during before phase of the render response on current request.
 Events.subscribeToRequestBeforePhase(PhaseId.RENDER_RESPONSE, new Callback.Void() {
     @Override
     public void invoke() {
         // ...
     }
 });
 

 // Add a callback to the current view which should run during the pre render view event.
 Events.subscribeToViewEvent(PreRenderViewEvent.class, new Callback.Void() {
     @Override
     public void invoke() {
         // ...
     }
 });
 

Note that you can specify any phase ID or system event to your choice.

Author:

Arjan Tijms, Bauke Scholtz

Method Summary

Modifier and Type	Method and Description
static void	addRequestPhaseListener(PhaseListener listener) Adds the given phase listener to the current request.
static void	addViewPhaseListener(PhaseListener listener) Adds the given phase listener to the current view.
static void	subscribeToApplicationEvent(Class<? extends SystemEvent> type, Callback.Void callback) Subscribe the given callback to the current application that get invoked every time when the given system event type is published in the current application.
static void	subscribeToApplicationEvent(Class<? extends SystemEvent> type, Callback.WithArgument<SystemEvent> callback) Subscribe the given callback to the current application that get invoked every time when the given system event type is published in the current application.
static void	subscribeToApplicationEvent(Class<? extends SystemEvent> type, SystemEventListener listener) Subscribe the given system event listener to the current application that get invoked every time when the given system event type is published in the current application.
static void	subscribeToRequestAfterPhase(PhaseId phaseId, Callback.Void callback) Subscribe the given callback instance to the current request that get invoked after given phase ID.
static void	subscribeToRequestAfterPhase(PhaseId phaseId, Callback.WithArgument<PhaseEvent> callback) Subscribe the given callback instance to the current request that get invoked after given phase ID.
static void	subscribeToRequestBeforePhase(PhaseId phaseId, Callback.Void callback) Subscribe the given callback instance to the current request that get invoked before given phase ID.
static void	subscribeToRequestBeforePhase(PhaseId phaseId, Callback.WithArgument<PhaseEvent> callback) Subscribe the given callback instance to the current request that get invoked before given phase ID.
static void	subscribeToViewAfterPhase(PhaseId phaseId, Callback.Void callback) Subscribe the given callback instance to the current view that get invoked every time after given phase ID.
static void	subscribeToViewAfterPhase(PhaseId phaseId, Callback.WithArgument<PhaseEvent> callback) Subscribe the given callback instance to the current view that get invoked every time after given phase ID.
static void	subscribeToViewBeforePhase(PhaseId phaseId, Callback.Void callback) Subscribe the given callback instance to the current view that get invoked every time before given phase ID.
static void	subscribeToViewBeforePhase(PhaseId phaseId, Callback.WithArgument<PhaseEvent> callback) Subscribe the given callback instance to the current view that get invoked every time before given phase ID.
static void	subscribeToViewEvent(Class<? extends SystemEvent> type, Callback.Void callback) Subscribe the given callback to the current view that get invoked every time when the given system event type is published on the current view.
static void	subscribeToViewEvent(Class<? extends SystemEvent> type, Callback.WithArgument<SystemEvent> callback) Subscribe the given callback to the current view that get invoked every time when the given system event type is published on the current view.
static void	subscribeToViewEvent(Class<? extends SystemEvent> type, SystemEventListener listener) Subscribe the given system event listener to the current view that get invoked every time when the given system event type is published on the current view.

Methods inherited from class java.lang.Object

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

Method Detail

subscribeToApplicationEvent

public static void subscribeToApplicationEvent(Class<? extends SystemEvent> type,
                                               SystemEventListener listener)

Subscribe the given system event listener to the current application that get invoked every time when the given system event type is published in the current application.

Parameters:

type - The system event type to be observed.

listener - The system event listener to be subscribed.

Since:

2.0

See Also:

Application.subscribeToEvent(Class, SystemEventListener)

subscribeToApplicationEvent

public static void subscribeToApplicationEvent(Class<? extends SystemEvent> type,
                                               Callback.Void callback)

Subscribe the given callback to the current application that get invoked every time when the given system event type is published in the current application.

Parameters:

type - The system event type to be observed.

callback - The callback to be invoked.

Since:

2.0

See Also:

subscribeToApplicationEvent(Class, SystemEventListener)

subscribeToApplicationEvent

public static void subscribeToApplicationEvent(Class<? extends SystemEvent> type,
                                               Callback.WithArgument<SystemEvent> callback)

Subscribe the given callback to the current application that get invoked every time when the given system event type is published in the current application.

Parameters:

type - The system event type to be observed.

callback - The callback to be invoked.

Since:

2.0

See Also:

subscribeToApplicationEvent(Class, SystemEventListener)

subscribeToViewEvent

public static void subscribeToViewEvent(Class<? extends SystemEvent> type,
                                        SystemEventListener listener)

Subscribe the given system event listener to the current view that get invoked every time when the given system event type is published on the current view.

Parameters:

type - The system event type to be observed.

listener - The system event listener to be subscribed.

Since:

1.2

See Also:

UIViewRoot.subscribeToViewEvent(Class, SystemEventListener)

subscribeToViewEvent

public static void subscribeToViewEvent(Class<? extends SystemEvent> type,
                                        Callback.Void callback)

Subscribe the given callback to the current view that get invoked every time when the given system event type is published on the current view.

Parameters:

type - The system event type to be observed.

callback - The callback to be invoked.

Since:

1.2

See Also:

subscribeToViewEvent(Class, SystemEventListener)

subscribeToViewEvent

public static void subscribeToViewEvent(Class<? extends SystemEvent> type,
                                        Callback.WithArgument<SystemEvent> callback)

Subscribe the given callback to the current view that get invoked every time when the given system event type is published on the current view.

Parameters:

type - The system event type to be observed.

callback - The callback to be invoked.

Since:

2.0

See Also:

subscribeToViewEvent(Class, SystemEventListener)

addViewPhaseListener

public static void addViewPhaseListener(PhaseListener listener)

Adds the given phase listener to the current view. The difference with addRequestPhaseListener(PhaseListener) is that the given phase listener is invoked during every (postback) request on the same view instead of only during the current request.

Parameters:

listener - The phase listener to be added to the current view.

Since:

2.0

See Also:

UIViewRoot.addPhaseListener(PhaseListener)

subscribeToViewBeforePhase

public static void subscribeToViewBeforePhase(PhaseId phaseId,
                                              Callback.Void callback)

Subscribe the given callback instance to the current view that get invoked every time before given phase ID.

Parameters:

phaseId - The phase ID to be observed.

callback - The callback to be invoked.

Since:

2.0

See Also:

addViewPhaseListener(PhaseListener)

subscribeToViewBeforePhase

public static void subscribeToViewBeforePhase(PhaseId phaseId,
                                              Callback.WithArgument<PhaseEvent> callback)

Subscribe the given callback instance to the current view that get invoked every time before given phase ID.

Parameters:

phaseId - The phase ID to be observed.

callback - The callback to be invoked.

Since:

2.0

See Also:

addViewPhaseListener(PhaseListener)

subscribeToViewAfterPhase

public static void subscribeToViewAfterPhase(PhaseId phaseId,
                                             Callback.Void callback)

Subscribe the given callback instance to the current view that get invoked every time after given phase ID.

Parameters:

phaseId - The phase ID to be observed.

callback - The callback to be invoked.

Since:

2.0

See Also:

addViewPhaseListener(PhaseListener)

subscribeToViewAfterPhase

public static void subscribeToViewAfterPhase(PhaseId phaseId,
                                             Callback.WithArgument<PhaseEvent> callback)

Subscribe the given callback instance to the current view that get invoked every time after given phase ID.

Parameters:

phaseId - The phase ID to be observed.

callback - The callback to be invoked.

Since:

2.0

See Also:

addViewPhaseListener(PhaseListener)

addRequestPhaseListener

public static void addRequestPhaseListener(PhaseListener listener)

Adds the given phase listener to the current request. The difference with addViewPhaseListener(PhaseListener) is that the given phase listener is invoked only during the current request instead of during every (postback) request on the same view.

Parameters:

listener - The phase listener to be added to the current request.

Since:

2.0

See Also:

CallbackPhaseListener

subscribeToRequestBeforePhase

public static void subscribeToRequestBeforePhase(PhaseId phaseId,
                                                 Callback.Void callback)

Subscribe the given callback instance to the current request that get invoked before given phase ID.

Parameters:

phaseId - The phase ID to be observed.

callback - The callback to be invoked.

Since:

2.0

See Also:

addRequestPhaseListener(PhaseListener)

subscribeToRequestBeforePhase

public static void subscribeToRequestBeforePhase(PhaseId phaseId,
                                                 Callback.WithArgument<PhaseEvent> callback)

Subscribe the given callback instance to the current request that get invoked before given phase ID.

Parameters:

phaseId - The phase ID to be observed.

callback - The callback to be invoked.

Since:

2.0

See Also:

addRequestPhaseListener(PhaseListener)

subscribeToRequestAfterPhase

public static void subscribeToRequestAfterPhase(PhaseId phaseId,
                                                Callback.Void callback)

Subscribe the given callback instance to the current request that get invoked after given phase ID.

Parameters:

phaseId - The phase ID to be observed.

callback - The callback to be invoked.

Since:

2.0

See Also:

addRequestPhaseListener(PhaseListener)

subscribeToRequestAfterPhase

public static void subscribeToRequestAfterPhase(PhaseId phaseId,
                                                Callback.WithArgument<PhaseEvent> callback)

Subscribe the given callback instance to the current request that get invoked after given phase ID.

Parameters:

phaseId - The phase ID to be observed.

callback - The callback to be invoked.

Since:

2.0

See Also:

addRequestPhaseListener(PhaseListener)