From 55ae985655f28e529f9846ed04e7aa0873501a31 Mon Sep 17 00:00:00 2001
From: Keith Donald <kdonald@vmware.com>
Date: Fri, 6 Jun 2008 04:52:45 +0000
Subject: [PATCH] doco

---
 spring-webflow-reference/src/views.xml | 32 ++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/spring-webflow-reference/src/views.xml b/spring-webflow-reference/src/views.xml
index ae323975..3b1f8a37 100644
--- a/spring-webflow-reference/src/views.xml
+++ b/spring-webflow-reference/src/views.xml
@@ -239,6 +239,38 @@ public class BookingValidator {
 			</sect3>
 		</sect2>
 	</sect1>
+	<sect1 id="transition-actions">
+		<title>Transition actions</title>
+		<para>
+			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.
+		</para>
+		<para>
+			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:
+		</para>
+		<programlisting language="xml"><![CDATA[
+<transition on="submit" to="bookingConfirmed">
+    <evaluate expression="bookingAction.makeBooking(booking, messageContext)" />
+</transition>]]>
+		</programlisting>
+		<programlisting language="java"><![CDATA[
+public class BookingAction {
+   public boolean makeBooking(Booking booking, MessageContext context) {
+       try {
+           bookingService.make(booking);
+           return true;
+       } catch (RoomNotAvailableException e) {
+           context.addMessage(builder.error().
+               .defaultText("No room is available at this hotel").build());
+           return false;
+       }
+   }
+}]]>
+		</programlisting>
+	</sect1>
 	<sect1 id="simple-event-handlers">
 		<title>Handling events</title>
 		<para>