diff --git a/spring-webflow-reference/src/actions.xml b/spring-webflow-reference/src/actions.xml index 4a9fa26f..2d541cff 100644 --- a/spring-webflow-reference/src/actions.xml +++ b/spring-webflow-reference/src/actions.xml @@ -16,7 +16,7 @@ - + @@ -36,16 +36,16 @@ - + - + - + @@ -63,7 +63,7 @@ - + ]]> @@ -163,7 +163,8 @@ - + @@ -188,7 +189,8 @@ - + @@ -212,7 +214,8 @@ - + diff --git a/spring-webflow-reference/src/defining-flows.xml b/spring-webflow-reference/src/defining-flows.xml index 2774cfa0..ebe33291 100644 --- a/spring-webflow-reference/src/defining-flows.xml +++ b/spring-webflow-reference/src/defining-flows.xml @@ -340,7 +340,7 @@ public interface FlowOutcome { ; + http://www.springframework.org/schema/webflow/spring-webflow-2.0.xsd"> diff --git a/spring-webflow-reference/src/spring-js.xml b/spring-webflow-reference/src/spring-js.xml index b204f024..26f4eb02 100644 --- a/spring-webflow-reference/src/spring-js.xml +++ b/spring-webflow-reference/src/spring-js.xml @@ -99,10 +99,10 @@ An AjaxEventDecoration applies a client-side event listener that fires a remote Ajax request to the server. It also auto-registers a callback function to link in the response: Previous Results +Previous ]]> diff --git a/spring-webflow-reference/src/spring-webflow-reference.xml b/spring-webflow-reference/src/spring-webflow-reference.xml index 3d6f9e51..3442fd13 100644 --- a/spring-webflow-reference/src/spring-webflow-reference.xml +++ b/spring-webflow-reference/src/spring-webflow-reference.xml @@ -22,10 +22,10 @@ - Spring Web Flow 2 Reference Guide - Reference Documentation + Spring Web Flow Reference Guide + Spring Web Flow Version 2.0.4 - August 2008 + September 2008 Keith diff --git a/spring-webflow-reference/src/testing.xml b/spring-webflow-reference/src/testing.xml index a62f8cf1..fa20cee7 100644 --- a/spring-webflow-reference/src/testing.xml +++ b/spring-webflow-reference/src/testing.xml @@ -26,7 +26,7 @@ public class BookingFlowExecutionTests extends AbstractXmlFlowExecutionTests { @@ -50,7 +50,7 @@ protected void configureFlowBuilderContext(MockFlowBuilderContext builderContext @Override protected FlowDefinitionResource[] getModelResources(FlowDefinitionResourceFactory resourceFactory) { return new FlowDefinitionResource[] { - resourceFactory.createFileResource("src/main/webapp/WEB-INF/flows/common/common.xml") + resourceFactory.createFileResource("src/main/webapp/WEB-INF/common/common.xml") }; }]]> diff --git a/spring-webflow-reference/src/upgrade-guide.xml b/spring-webflow-reference/src/upgrade-guide.xml index c36c44fd..dfa42f58 100644 --- a/spring-webflow-reference/src/upgrade-guide.xml +++ b/spring-webflow-reference/src/upgrade-guide.xml @@ -180,9 +180,9 @@ java org.springframework.webflow.upgrade.WebFlowUpgrader flow-to-upgrade.xml - + - + ]]> @@ -206,14 +206,14 @@ java org.springframework.webflow.upgrade.WebFlowUpgrader flow-to-upgrade.xml + view-factory-creator="viewFactoryCreator"/> - - + + - + diff --git a/spring-webflow-reference/src/views.xml b/spring-webflow-reference/src/views.xml index 9e8a78ce..b25a9a59 100644 --- a/spring-webflow-reference/src/views.xml +++ b/spring-webflow-reference/src/views.xml @@ -40,7 +40,7 @@ Specifying view identifiers - Use the view attribute to explictly specify the id of the view to render. + Use the view attribute to specify the id of the view to render explicitly. Flow relative view ids @@ -113,7 +113,8 @@ - + @@ -335,25 +336,36 @@ public class BookingValidator { In this example, data binding will still occur on back but validation will be suppressed. - - - Transition actions + + + Executing view transitions - A view-state transition can execute one or more actions before executing. - These actions may return an error result to prevent the transition itself from executing. - If an error result occurs, the view will re-render and should typically display an appropriate error message to the user. + Define one or more transition elements to handle user events that may occur on the view. + A transition may take the user to another view, or it may simply execute an action and re-render the current view. + A transition may also request the rendering of parts of a view called "fragments" when handling an Ajax event. + Finally, "global" transitions that are shared across all views may also be defined. - If the transition action invokes a plain Java method, the invoked method may return false to prevent the transition from executing. - This technique can be used to handle exceptions thrown by service-layer methods. - The example below invokes an action that calls a service and handles an exceptional situation: + Implementing view transitions is illustrated in the following sections. - + Transition actions + + A view-state transition can execute one or more actions before executing. + These actions may return an error result to prevent the transition from exiting the current view-state. + If an error result occurs, the view will re-render and should display an appropriate message to the user. + + + If the transition action invokes a plain Java method, the invoked method may return false to prevent the transition from executing. + This technique can be used to handle exceptions thrown by service-layer methods. + The example below invokes an action that calls a service and handles an exceptional situation: + + ]]> - - + - - - - Handling events - - From a view-state, transitions without targets can also be defined. Such transitions are called "event handlers": - - - -]]> - - - These event handlers do not change the state of the flow. - They simply execute their actions and re-render the current view or one or more fragments of the current view. - - - Rendering partials - - Use the render element to request partial re-rendering of a view after handling an event: - - - - -]]> - - The fragments attribute should reference the ID(s) of the view element(s) you wish to re-render. - Specify multiple elements to re-render by separating them with a comma delimiter. - - - Such partial rendering is often used with events signaled by Ajax to update a specific zone of the view. - - Handling global events + Global transitions - Use the flow's global-transitions element to create event handlers that apply across all views. + Use the flow's global-transitions element to create transitions that apply across all views. Global-transitions are often used to handle global menu links that are part of the layout. ]]> - + + + Event handlers + + From a view-state, transitions without targets can also be defined. Such transitions are called "event handlers": + + + +]]> + + + These event handlers do not change the state of the flow. + They simply execute their actions and re-render the current view or one or more fragments of the current view. + + + + Rendering fragments + + Use the render element within a transition to request partial re-rendering of the current view after handling the event: + + + + +]]> + + + The fragments attribute should reference the id(s) of the view element(s) you wish to re-render. + Specify multiple elements to re-render by separating them with a comma delimiter. + + + Such partial rendering is often used with events signaled by Ajax to update a specific zone of the view. + + Working with messages