diff --git a/spring-webflow-reference/src/upgrade-guide.xml b/spring-webflow-reference/src/upgrade-guide.xml
index 56796a33..d5c6deaf 100644
--- a/spring-webflow-reference/src/upgrade-guide.xml
+++ b/spring-webflow-reference/src/upgrade-guide.xml
@@ -183,39 +183,79 @@ java org.springframework.webflow.engine.model.builder.xml.WebFlowUpgrader flowTo
]]>
- Custom View Resolvers
+ View Resolution
+
+ Web Flow 2.0 by default will both select and render views.
+ View were previously selected by Web Flow 1.0 and then rendered by a view resolver.
+
+
+ In order for 1.0 based flows to work in Web Flow 2.0 the default view resolver must be overridden.
+ A common use case is to use Apache Tiles for view resolution.
+ The following configuration will replace the default view resolver with a Tiles view resolver.
+ The tilesViewResolver in this example can be replaced with any other view resolver.
+
+
+ ...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ]]>
- Web Flow Concepts
+ New Web Flow Concepts
+
+ Automatic Model Binding
+
+ Web Flow 1.0 required Spring MVC based flows to manually calls to FormAction methods, mainly: setupForm, bind and bindAndValidate.
+ Web Flow 2.0 now supports automatic setup, binding and validation via the model attribute for view-states.
+ Please see the Binding to a Model section for details.
+
+ OGNL vs EL
Web Flow 1.0 used OGNL exclusively for expressions within the flow definitions.
Web Flow 2.0 adds support for Unified EL.
United EL is used when it is available, OGNL will continue to be used when a Unified EL implementation is not available.
+ Please see the Expression Language chapter for details.
Flash Scope
-
-
- External Redirects
-
-
- Views
- Views are handled differently in Web Flow 2.0.
- Previously, Web Flow returned a reference to the view to render.
- Then a view resolver would render the view.
- Web Flow 2.0 will both select and render views.
+ Flash scope in Web Flow 1.0 persisted across the current request and into the next request.
+ In Web Flow 2.0 flash scope is cleared after every view render.
+ This allows objects to persist across the POST-REDIRECT-GET pattern, while being independent of the next request.
- JavaServer Faces
+ Spring Faces
+
+ Web Flow 2.0 provides significant support for JavaServer Faces.
+ Please see the JSF Integration chapter for details.
+
-
- Automatic Model Binding
+
+ External Redirects
+
+ External redirects in Web Flow 1.0 were always considered context relative.
+ In Web Flow 2.0, if the redirect URL begins with a slash, it is considered absolute to the server root instead of the application context.
+ URLs without a leading slash are still context relative.
+
\ No newline at end of file