oracle.adf.view.faces.component
Class UIXSingleStep

java.lang.Object
  |
  +--javax.faces.component.UIComponent
        |
        +--oracle.adf.view.faces.component.UIXComponent
              |
              +--oracle.adf.view.faces.component.UIXComponentBase
                    |
                    +--oracle.adf.view.faces.component.SingleStepBase
                          |
                          +--oracle.adf.view.faces.component.UIXSingleStep

All Implemented Interfaces:

javax.faces.component.ActionSource, javax.faces.component.StateHolder

Direct Known Subclasses:

CoreSingleStepButtonBar

public class UIXSingleStep

extends SingleStepBase

UIXSingleStep is a base abstraction for components that implement ActionSource and navigate back and forth through a sequence of known steps.

Events and Listeners

UIXSingleStep implements javax.faces.component.ActionSource, which means it is a source of javax.faces.event.ActionEvents. The ActionEvent is delivered during the Apply Request Values phase when navigating back, and during the Invoke Application phase when navigating forward. The nextAction/previousAction attributes are of type MethodBinding and must (if non-null) point to an action method. The nextAction method will be called when navigating forward, and the previousAction method will be called when navigating back with a singleStep component. JSF has a default javax.faces.event.ActionListener that passes the nextAction or previousAction outcome to the NavigationHandler. The nextActionListener/previousActionListener attributes are of type MethodBinding and must (in non-null) point to a method accepting an ActionEvent, with a return type of void. When navigating to the previous step, then the previousActionListener method is called. When navigating to the next step, the nextActionListener method is called.

Events:

Type	Phases	Description
javax.faces.event.ActionEvent	Invoke Application Apply Request Values	Event delivered when the "action" of the component has been invoked; for example, by clicking on a button. The action may result in page navigation.

Field Summary

static java.lang.String	COMPONENT_FAMILY
static java.lang.String	COMPONENT_TYPE
static PropertyKey	MAX_STEP_KEY
static PropertyKey	NEXT_ACTION_KEY
static PropertyKey	NEXT_ACTION_LISTENER_KEY
static PropertyKey	PREVIOUS_ACTION_KEY
static PropertyKey	PREVIOUS_ACTION_LISTENER_KEY
static PropertyKey	SELECTED_STEP_KEY
static PropertyKey	TEXT_KEY
static FacesBean.Type	TYPE

Fields inherited from class oracle.adf.view.faces.component.SingleStepBase

NEXT_ACTION_TYPE, PREVIOUS_ACTION_TYPE

Fields inherited from class oracle.adf.view.faces.component.UIXComponentBase

ID_KEY, RENDERED_KEY, RENDERER_TYPE_KEY, TRANSIENT_KEY

Constructor Summary

UIXSingleStep()
Construct an instance of the UIXSingleStep.

Method Summary

protected FacesBean.Type	getBeanType()
java.lang.String	getFamily()
int	getMaxStep() Gets the last possible step.
javax.faces.el.MethodBinding	getNextAction() Gets a reference to an action method that will be called when the singleStep component navigates to the next step, or the static outcome of the action.
javax.faces.el.MethodBinding	getNextActionListener() Gets a method reference to an action listener that will be calledthe singleStep component navigates to the next step.
javax.faces.el.MethodBinding	getPreviousAction() Gets a reference to an action method that will be called when the singleStep component navigates to the previous step, or the static outcome of the action.
javax.faces.el.MethodBinding	getPreviousActionListener() Gets a method reference to an action listener that will be called when the singleStep component navigates to the previous step.
int	getSelectedStep() Gets the current step.
java.lang.String	getText() Gets the text description of items being navigated.
void	setMaxStep(int maxStep) Sets the last possible step.
void	setMaxStep(long maxStep) Sets the last possible step.
void	setNextAction(javax.faces.el.MethodBinding nextAction) Sets a reference to an action method that will be called when the singleStep component navigates to the next step, or the static outcome of the action.
void	setNextActionListener(javax.faces.el.MethodBinding nextActionListener) Sets a method reference to an action listener that will be calledthe singleStep component navigates to the next step.
void	setPreviousAction(javax.faces.el.MethodBinding previousAction) Sets a reference to an action method that will be called when the singleStep component navigates to the previous step, or the static outcome of the action.
void	setPreviousActionListener(javax.faces.el.MethodBinding previousActionListener) Sets a method reference to an action listener that will be called when the singleStep component navigates to the previous step.
void	setSelectedStep(int selectedStep) Sets the current step.
void	setSelectedStep(long selectedStep) Sets the current step.
void	setText(java.lang.String text) Sets the text description of items being navigated.

Methods inherited from class oracle.adf.view.faces.component.SingleStepBase

addActionListener, broadcast, getAction, getActionListener, getActionListeners, getActionType, isImmediate, queueEvent, removeActionListener, saveState, setAction, setActionListener, setActionType, setImmediate

Methods inherited from class oracle.adf.view.faces.component.UIXComponentBase

addFacesListener, createFacesBean, decode, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttribute, getAttributes, getBooleanProperty, getChildCount, getChildren, getClientId, getFacesBean, getFacesContext, getFacesListeners, getFacet, getFacets, getFacetsAndChildren, getId, getIntProperty, getLocalClientId, getParent, getProperty, getPropertyKey, getRenderer, getRendererType, getRendersChildren, getValueBinding, isRendered, isTransient, processDecodes, processRestoreState, processSaveState, processUpdates, processValidators, removeFacesListener, restoreState, setAttribute, setBooleanProperty, setId, setIntProperty, setParent, setProperty, setRendered, setRendererType, setTransient, setValueBinding, toString

Methods inherited from class java.lang.Object

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

Field Detail

TYPE

public static final FacesBean.Type TYPE

SELECTED_STEP_KEY

public static final PropertyKey SELECTED_STEP_KEY

MAX_STEP_KEY

public static final PropertyKey MAX_STEP_KEY

TEXT_KEY

public static final PropertyKey TEXT_KEY

PREVIOUS_ACTION_LISTENER_KEY

public static final PropertyKey PREVIOUS_ACTION_LISTENER_KEY

NEXT_ACTION_LISTENER_KEY

public static final PropertyKey NEXT_ACTION_LISTENER_KEY

NEXT_ACTION_KEY

public static final PropertyKey NEXT_ACTION_KEY

PREVIOUS_ACTION_KEY

public static final PropertyKey PREVIOUS_ACTION_KEY

COMPONENT_FAMILY

public static final java.lang.String COMPONENT_FAMILY

See Also:

Constant Field Values

COMPONENT_TYPE

public static final java.lang.String COMPONENT_TYPE

See Also:

Constant Field Values

Constructor Detail

UIXSingleStep

public UIXSingleStep()

Construct an instance of the UIXSingleStep.

Method Detail

getSelectedStep

public final int getSelectedStep()

Gets the current step. It defaults to "1".

setSelectedStep

public final void setSelectedStep(int selectedStep)

Sets the current step. It defaults to "1".

setSelectedStep

public final void setSelectedStep(long selectedStep)

Sets the current step. It defaults to "1".

getMaxStep

public final int getMaxStep()

Gets the last possible step. If this value is not known, it should be set to MAX_VALUE_UNKNOWN, which is also the default value.

setMaxStep

public final void setMaxStep(int maxStep)

Sets the last possible step. If this value is not known, it should be set to MAX_VALUE_UNKNOWN, which is also the default value.

setMaxStep

public final void setMaxStep(long maxStep)

Sets the last possible step. If this value is not known, it should be set to MAX_VALUE_UNKNOWN, which is also the default value.

getText

public final java.lang.String getText()

Gets the text description of items being navigated. The default is "Step".

setText

public final void setText(java.lang.String text)

Sets the text description of items being navigated. The default is "Step".

getPreviousActionListener

public final javax.faces.el.MethodBinding getPreviousActionListener()

Gets a method reference to an action listener that will be called when the singleStep component navigates to the previous step.

Specified by:

getPreviousActionListener in class SingleStepBase

setPreviousActionListener

public final void setPreviousActionListener(javax.faces.el.MethodBinding previousActionListener)

Sets a method reference to an action listener that will be called when the singleStep component navigates to the previous step.

Specified by:

setPreviousActionListener in class SingleStepBase

getNextActionListener

public final javax.faces.el.MethodBinding getNextActionListener()

Gets a method reference to an action listener that will be calledthe singleStep component navigates to the next step.

Specified by:

getNextActionListener in class SingleStepBase

setNextActionListener

public final void setNextActionListener(javax.faces.el.MethodBinding nextActionListener)

Sets a method reference to an action listener that will be calledthe singleStep component navigates to the next step.

Specified by:

setNextActionListener in class SingleStepBase

getNextAction

public final javax.faces.el.MethodBinding getNextAction()

Gets a reference to an action method that will be called when the singleStep component navigates to the next step, or the static outcome of the action.

Specified by:

getNextAction in class SingleStepBase

setNextAction

public final void setNextAction(javax.faces.el.MethodBinding nextAction)

Sets a reference to an action method that will be called when the singleStep component navigates to the next step, or the static outcome of the action.

Specified by:

setNextAction in class SingleStepBase

getPreviousAction

public final javax.faces.el.MethodBinding getPreviousAction()

Gets a reference to an action method that will be called when the singleStep component navigates to the previous step, or the static outcome of the action.

Specified by:

getPreviousAction in class SingleStepBase

setPreviousAction

public final void setPreviousAction(javax.faces.el.MethodBinding previousAction)

Sets a reference to an action method that will be called when the singleStep component navigates to the previous step, or the static outcome of the action.

Specified by:

setPreviousAction in class SingleStepBase

getFamily

public java.lang.String getFamily()

Specified by:

getFamily in class UIXComponentBase

getBeanType

protected FacesBean.Type getBeanType()

Overrides:

getBeanType in class UIXComponentBase