javax.faces.component
Class UICommand

java.lang.Object
  javax.faces.component.UIComponent
      javax.faces.component.UIComponentBase
          javax.faces.component.UICommand

All Implemented Interfaces:

ActionSource, StateHolder

Direct Known Subclasses:

HtmlCommandButton, HtmlCommandLink

public class UICommand
extends UIComponentBase
implements ActionSource

see Javadoc of JSF Specification

Version:

$Revision: 501845 $ $Date: 2007-01-31 14:54:23 +0100 (Mi, 31 Jän 2007) $

Author:

Manfred Geiler (latest modification by $Author: weber $)

Field Summary

static java.lang.String	COMPONENT_FAMILY
static java.lang.String	COMPONENT_TYPE

Constructor Summary

UICommand()

Method Summary

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.
MethodBinding	getAction()
MethodBinding	getActionListener()
ActionListener[]	getActionListeners()
java.lang.String	getFamily()
java.lang.Object	getValue()
boolean	isImmediate()
void	queueEvent(FacesEvent event)
void	removeActionListener(ActionListener listener)
void	restoreState(FacesContext context, java.lang.Object state) Invoked in the "restore view" phase, this initialises this object's members from the values saved previously into the provided state object.
java.lang.Object	saveState(FacesContext context) Invoked after the render phase has completed, this method returns an object which can be passed to the restoreState of some other instance of UIComponentBase to reset that object's state to the same values as this object currently has.
void	setAction(MethodBinding action)
void	setActionListener(MethodBinding actionListener)
void	setImmediate(boolean immediate)
void	setValue(java.lang.Object value)

Methods inherited from class javax.faces.component.UIComponentBase

addFacesListener, decode, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientId, getFacesContext, getFacesListeners, getFacet, getFacets, getFacetsAndChildren, getId, getParent, getRenderer, getRendererType, getRendersChildren, getValueBinding, isRendered, isTransient, processDecodes, processRestoreState, processSaveState, processUpdates, processValidators, removeFacesListener, restoreAttachedState, saveAttachedState, setId, setParent, setRendered, setRendererType, setTransient, setValueBinding

Methods inherited from class java.lang.Object

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

Field Detail

COMPONENT_TYPE

public static final java.lang.String COMPONENT_TYPE

See Also:

Constant Field Values

COMPONENT_FAMILY

public static final java.lang.String COMPONENT_FAMILY

See Also:

Constant Field Values

Constructor Detail

UICommand

public UICommand()

Method Detail

setAction

public void setAction(MethodBinding action)

Specified by:

setAction in interface ActionSource

getAction

public MethodBinding getAction()

Specified by:

getAction in interface ActionSource

setActionListener

public void setActionListener(MethodBinding actionListener)

Specified by:

setActionListener in interface ActionSource

getActionListener

public MethodBinding getActionListener()

Specified by:

getActionListener in interface ActionSource

addActionListener

public void addActionListener(ActionListener listener)

Specified by:

addActionListener in interface ActionSource

getActionListeners

public ActionListener[] getActionListeners()

Specified by:

getActionListeners in interface ActionSource

removeActionListener

public void removeActionListener(ActionListener listener)

Specified by:

removeActionListener in interface ActionSource

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

queueEvent

public void queueEvent(FacesEvent event)

Overrides:

queueEvent in class UIComponentBase

getFamily

public java.lang.String getFamily()

Specified by:

getFamily in class UIComponent

setImmediate

public void setImmediate(boolean immediate)

Specified by:

setImmediate in interface ActionSource

isImmediate

public boolean isImmediate()

Specified by:

isImmediate in interface ActionSource

setValue

public void setValue(java.lang.Object value)

getValue

public java.lang.Object getValue()

saveState

public java.lang.Object saveState(FacesContext context)

Description copied from class: UIComponentBase

Invoked after the render phase has completed, this method returns an object which can be passed to the restoreState of some other instance of UIComponentBase to reset that object's state to the same values as this object currently has.

Specified by:

saveState in interface StateHolder

Overrides:

saveState in class UIComponentBase

restoreState

public void restoreState(FacesContext context,
                         java.lang.Object state)

Description copied from class: UIComponentBase

Invoked in the "restore view" phase, this initialises this object's members from the values saved previously into the provided state object.

Specified by:

restoreState in interface StateHolder

Overrides:

restoreState in class UIComponentBase

state - is an object previously returned by the saveState method of this class.