jakarta.faces.event

Class ActionEvent

java.lang.Object

java.util.EventObject

jakarta.faces.event.FacesEvent

jakarta.faces.event.ActionEvent

All Implemented Interfaces:

Serializable

public class ActionEvent
extends FacesEvent

An ActionEvent represents the activation of a user interface component (such as a UICommand).

See Also:

Serialized Form

Field Summary

Fields inherited from class java.util.EventObject

source

Constructor Summary

Constructors

Constructor and Description
ActionEvent(FacesContext facesContext, UIComponent component) Construct a new event object from the Faces context, specified source component and action command.
ActionEvent(UIComponent component) Construct a new event object from the specified source component and action command.

Method Summary

Modifier and Type	Method and Description
boolean	isAppropriateListener(FacesListener listener) Return true if this FacesListener is an instance of a listener class that this event supports.
void	processListener(FacesListener listener) Broadcast this FacesEvent to the specified FacesListener, by whatever mechanism is appropriate.

Methods inherited from class jakarta.faces.event.FacesEvent

getComponent, getFacesContext, getPhaseId, queue, setPhaseId

Methods inherited from class java.util.EventObject

getSource, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

ActionEvent

public ActionEvent(UIComponent component)

Construct a new event object from the specified source component and action command.

Parameters:

component - Source UIComponent for this event

Throws:

IllegalArgumentException - if component is null

ActionEvent

public ActionEvent(FacesContext facesContext,
                   UIComponent component)

Construct a new event object from the Faces context, specified source component and action command.

Parameters:

facesContext - the Faces context.

component - Source UIComponent for this event.

Throws:

IllegalArgumentException - if component is null

Since:

2.3

Method Detail

isAppropriateListener

public boolean isAppropriateListener(FacesListener listener)

Description copied from class: FacesEvent

Return true if this FacesListener is an instance of a listener class that this event supports. Typically, this will be accomplished by an "instanceof" check on the listener class.

Specified by:

isAppropriateListener in class FacesEvent

Parameters:

listener - FacesListener to evaluate

Returns:

true if it is the appropriate instance, false otherwise.

processListener

public void processListener(FacesListener listener)

Description copied from class: FacesEvent

Broadcast this FacesEvent to the specified FacesListener, by whatever mechanism is appropriate. Typically, this will be accomplished by calling an event processing method, and passing this FacesEvent as a paramter.

Specified by:

processListener in class FacesEvent

Parameters:

listener - FacesListener to send this FacesEvent to

Throws:

AbortProcessingException - Signal the Jakarta Server Faces implementation that no further processing on the current event should be performed