public interface ActionSource
ActionSource is an interface that may be implemented by any concrete UIComponent
that wishes
to be a source of ActionEvent
s, including the ability to invoke application actions via the default
ActionListener
mechanism.
Modifier and Type | Method and Description |
---|---|
void |
addActionListener(ActionListener listener)
Add a new
ActionListener to the set of listeners interested in being notified when ActionEvent s
occur. |
ActionListener[] |
getActionListeners()
Return the set of registered
ActionListener s for this ActionSource instance. |
boolean |
isImmediate()
Return a flag indicating that the default
ActionListener provided by the Jakarta Faces implementation
should be executed immediately (that is, during Apply Request Values phase of the request processing
lifecycle), rather than waiting until the Invoke Application phase. |
void |
removeActionListener(ActionListener listener)
Remove an existing
ActionListener (if any) from the set of listeners interested in being notified when
ActionEvent s occur. |
void |
setImmediate(boolean immediate)
Set the "immediate execution" flag for this
UIComponent . |
boolean isImmediate()
Return a flag indicating that the default ActionListener
provided by the Jakarta Faces implementation
should be executed immediately (that is, during Apply Request Values phase of the request processing
lifecycle), rather than waiting until the Invoke Application phase. The default value for this property must
be false
.
true
if immediate, false
otherwise.void setImmediate(boolean immediate)
Set the "immediate execution" flag for this UIComponent
.
immediate
- The new immediate execution flagvoid addActionListener(ActionListener listener)
Add a new ActionListener
to the set of listeners interested in being notified when ActionEvent
s
occur.
listener
- The ActionListener
to be addedjava.lang.NullPointerException
- if listener
is null
ActionListener[] getActionListeners()
Return the set of registered ActionListener
s for this ActionSource
instance. If there are no
registered listeners, a zero-length array is returned.
void removeActionListener(ActionListener listener)
Remove an existing ActionListener
(if any) from the set of listeners interested in being notified when
ActionEvent
s occur.
listener
- The ActionListener
to be removedjava.lang.NullPointerException
- if listener
is null