jakarta.faces.component

Class UIViewAction

java.lang.Object

jakarta.faces.component.UIComponent

jakarta.faces.component.UIComponentBase

jakarta.faces.component.UIViewAction

All Implemented Interfaces:

ActionSource, ActionSource2, PartialStateHolder, StateHolder, TransientStateHolder, ComponentSystemEventListener, FacesListener, SystemEventListenerHolder, EventListener

@JSFComponent(name="f:viewAction")
public class UIViewAction
extends UIComponentBase
implements ActionSource2

Since:

2.2

Field Summary

Fields

Modifier and Type	Field and Description
static String	COMPONENT_FAMILY
static String	COMPONENT_TYPE

Fields inherited from class jakarta.faces.component.UIComponent

ATTRS_WITH_DECLARED_DEFAULT_VALUES, BEANINFO_KEY, bindings, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, CURRENT_COMPONENT, CURRENT_COMPOSITE_COMPONENT, FACETS_KEY, HONOR_CURRENT_COMPONENT_ATTRIBUTES_PARAM_NAME, VIEW_LOCATION_KEY

Constructor Summary

Constructors

Constructor and Description
UIViewAction()

Method Summary

Modifier and Type	Method and Description
void	addActionListener(ActionListener listener)
void	broadcast(FacesEvent event) Invoke any listeners attached to this object which are listening for an event whose type matches the specified event's runtime type.
void	decode(FacesContext context) Check the submitted form parameters for data associated with this component.
MethodBinding	getAction() Deprecated.
jakarta.el.MethodExpression	getActionExpression()
MethodBinding	getActionListener() Deprecated.
ActionListener[]	getActionListeners()
String	getFamily()
String	getPhase()
boolean	isImmediate()
boolean	isOnPostback()
static boolean	isProcessingBroadcast(FacesContext context)
boolean	isRendered() A boolean value that indicates whether this component should be rendered.
void	removeActionListener(ActionListener listener)
void	setAction(MethodBinding action) Deprecated. Use setActionExpression instead.
void	setActionExpression(jakarta.el.MethodExpression actionExpression)
void	setActionListener(MethodBinding actionListener) Deprecated.
void	setImmediate(boolean immediate)
void	setOnPostback(boolean onPostback)
void	setPhase(String phase)
void	setRendered(boolean condition)

Methods inherited from class jakarta.faces.component.UIComponentBase

addClientBehavior, addFacesListener, clearInitialState, encodeAll, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getDefaultEventName, getEventNames, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getParent, getPassThroughAttributes, getRenderer, getRendererType, getRendersChildren, getValueBinding, invokeOnComponent, isTransient, markInitialState, processDecodes, processRestoreState, processSaveState, processUpdates, processValidators, queueEvent, removeFacesListener, restoreAttachedState, restoreState, saveAttachedState, saveState, setId, setParent, setRendererType, setTransient, setValueBinding, visitTree

Methods inherited from class jakarta.faces.component.UIComponent

getClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getListenersForEventClass, getNamingContainer, getPassThroughAttributes, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, getValueExpression, initialStateMarked, isCompositeComponent, isInView, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView, setValueExpression, subscribeToEvent, unsubscribeFromEvent

Methods inherited from class java.lang.Object

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

Field Detail

COMPONENT_FAMILY

public static final String COMPONENT_FAMILY

See Also:

Constant Field Values

COMPONENT_TYPE

public static final String COMPONENT_TYPE

See Also:

Constant Field Values

Constructor Detail

UIViewAction

public UIViewAction()

Method Detail

isRendered

public boolean isRendered()

Description copied from class: UIComponentBase

A boolean value that indicates whether this component should be rendered. Default value: true.

Overrides:

isRendered in class UIComponentBase

setRendered

public void setRendered(boolean condition)

Overrides:

setRendered in class UIComponentBase

broadcast

public void broadcast(FacesEvent event)
               throws AbortProcessingException

Description copied from class: UIComponentBase

Invoke any listeners attached to this object which are listening for an event whose type matches the specified event's runtime type.

This method does not propagate the event up to parent components, ie listeners attached to parent components don't automatically get called.

If any of the listeners throws AbortProcessingException then that exception will prevent any further listener callbacks from occurring, and the exception propagates out of this method without alteration.

ActionEvent events are typically queued by the renderer associated with this component in its decode method; ValueChangeEvent events by the component's validate method. In either case the event's source property references a component. At some later time the UIViewRoot component iterates over its queued events and invokes the broadcast method on each event's source object.

Overrides:

broadcast in class UIComponentBase

Parameters:

event - must not be null.

Throws:

AbortProcessingException

decode

public void decode(FacesContext context)

Description copied from class: UIComponentBase

Check the submitted form parameters for data associated with this component. This default implementation delegates to this component's renderer if there is one, and otherwise ignores the call.

Overrides:

decode in class UIComponentBase

getAction

@Deprecated
public MethodBinding getAction()

Deprecated.

Specified by:

getAction in interface ActionSource

setAction

@Deprecated
public void setAction(MethodBinding action)

Deprecated. Use setActionExpression instead.

Specified by:

setAction in interface ActionSource

isImmediate

@JSFProperty
public boolean isImmediate()

Specified by:

isImmediate in interface ActionSource

setImmediate

public void setImmediate(boolean immediate)

Specified by:

setImmediate in interface ActionSource

getActionExpression

@JSFProperty(stateHolder=true,
             returnSignature="java.lang.Object",
             jspName="action",
             clientEvent="action")
public jakarta.el.MethodExpression getActionExpression()

Specified by:

getActionExpression in interface ActionSource2

setActionExpression

public void setActionExpression(jakarta.el.MethodExpression actionExpression)

Specified by:

setActionExpression in interface ActionSource2

getActionListener

@Deprecated
 @JSFProperty(stateHolder=true,
             returnSignature="void",
             methodSignature="jakarta.faces.event.ActionEvent")
public MethodBinding getActionListener()

Deprecated.

Specified by:

getActionListener in interface ActionSource

setActionListener

@Deprecated
 @JSFProperty(returnSignature="void",
             methodSignature="jakarta.faces.event.ActionEvent")
public void setActionListener(MethodBinding actionListener)

Deprecated.

Specified by:

setActionListener in interface ActionSource

addActionListener

public void addActionListener(ActionListener listener)

Specified by:

addActionListener in interface ActionSource

removeActionListener

public void removeActionListener(ActionListener listener)

Specified by:

removeActionListener in interface ActionSource

getActionListeners

@JSFListener(event="jakarta.faces.event.ActionEvent",
             phases="Invoke Application, Apply Request Values")
public ActionListener[] getActionListeners()

Specified by:

getActionListeners in interface ActionSource

getPhase

@JSFProperty
public String getPhase()

setPhase

public void setPhase(String phase)

isOnPostback

@JSFProperty
public boolean isOnPostback()

setOnPostback

public void setOnPostback(boolean onPostback)

isProcessingBroadcast

public static boolean isProcessingBroadcast(FacesContext context)

getFamily

public String getFamily()

Specified by:

getFamily in class UIComponent