| |||||||
FRAMES NO FRAMES |
<%@ taglib prefix="j" uri="http://java.sun.com/jsf/flow" %>
<anyxmlelement xmlns:j="http://java.sun.com/jsf/flow" />
Elements for defining faces flows. When these elements are used in VDL views, they must be nested within the
<f:metada>
section. The meaning of these elements in VDL views is functionally equivalent to the same content in the Application Configuration Resources. Throughout the specification of these elements, the term "faces-config" is equivalent to "Application Configuration Resources".Usage example
<f:metadata> <j:faces-flow-definition> <j:start-node>router1</j:start-node> <j:faces-flow-return id="success"> <j:navigation-case> <j:from-outcome>/complete</j:from-outcome> </j:navigation-case> </j:faces-flow-return> <j:faces-flow-return id="errorOccurred"> <j:navigation-case> <j:from-outcome>error</j:from-outcome> </j:navigation-case> </j:faces-flow-return> <!-- If a customerId was specified then we'll edit it, otherwise create a new customer. --> <j:switch id="router1"> <j:navigation-case> <j:if>#{facesFlowScope.customerId == null}</j:if> <j:from-outcome>create-customer</j:from-outcome> </j:navigation-case> </j:switch> <j:view id="create-customer"> <j:vdl-document>create-customer.xhtml</j:vdl-document> </j:view> <j:view id="maintain-customer-record"> <j:vdl-document>maintain-customer-record.xhtml</j:vdl-document> </j:view> <j:initializer>#{maintainCustomerBean.initializeFlow}</j:initializer> <j:finalizer>#{maintainCustomerBean.cleanUpFlow}</j:finalizer> </j:faces-flow-definition> </f:metadata>
Tag Library Information | |
Display Name | Faces Flows |
Version | 2.2 |
Short Name | j |
URI | http://java.sun.com/jsf/flow |
Tag Summary | |
faces-flow-definition | Define a faces flow. VDL usage Several conventions apply when using this element in a VDL view, but in all cases, the presence of this element in a VDL view indicates that this view must be considered as a Identifying the flow defining view The flow defining view must be the first view in a flow that is encountered during a user's traversal of the application. If this VDL view resides in a directory whose name is equal to the filename of the VDL view, the directory name is taken to be the id of the flow, and the value of the id attribute of the If this VDL view does not reside in a directory, or resides in a directory whose name is not equal to the filename of the VDL view, the id and faces-config usage The entire flow is defined as child elements, or references to other elements of this element. |
start-node | Declare the id of the starting node in the flow graph. The start node may be any of the node types mentioned in the class javadocs for VDL usage This element is optional when used in VDL views. See the element documentation for faces-config usage This element is required when used a in a faces-config. |
faces-flow-return | Define a return node in a flow graph. VDL usage This element must contain exactly one faces-config usage The semantics are identical when used in a faces-config. |
navigation-case | Define a navigation case for a faces flow. This element is used within
The semantics of this element are identical whether it is used in a VDL view or in a faces-config file. |
switch | Define a switch node in a flow graph. VDL usage This element must contain one or more faces-config usage The semantics are identical when used in a faces-config. |
if | The content of this element must be an EL expression that may be invoked when the containing swich is activated. If the expresion returns The semantics of this element are identical whether it is used in a VDL view or in a faces-config file. |
from-outcome | Define a node id to which control will be passed. The meaning of this element depends on the element in which it resides.
The semantics of this element are identical whether it is used in a VDL view or in a faces-config file. |
view | Define a view node in a flow graph. VDL usage This element must contain exactly one faces-config usage The semantics are identical when used in a faces-config. |
vdl-document | Define the vdl-document for the enclosing view.
The semantics of this element are identical whether it is used in a VDL view or in a faces-config file. |
initializer | A
The semantics of this element are identical whether it is used in a VDL view or in a faces-config file. |
finalizer | A
The semantics of this element are identical whether it is used in a VDL view or in a faces-config file. |
| |||||||
FRAMES NO FRAMES |