In this post we will see the major concepts relates to Spring web flow. Spring flow is an approach to implement multi page flow web applications like shopping portal.\u00a0 For example in shopping portal application a user may involve in the below steps.<\/p>\n

\n
1. Login to the application<\/li>\n
2. Surf among the products<\/li>\n
3. Add needed products to the cart<\/li>\n
4. view\/edit cart if needed<\/li>\n
5. Click checkout<\/li>\n
6. Provide contact information<\/li>\n
7. Payment<\/li>\n
8. End<\/li>\n<\/ol>\n

   As there are multiple pages involved in the shopping flow, the data needs to be carried throughout multiple pages. If we handle this task manually it will be tedious task. We will go out of our indented business logic. To implement these kinds of tasks easily Spring provides the web flow framework.<\/p>\n

   A flow is nothing but a set of tasks to be done in a particular order. In webflow it is an xml file which tells the exactly how this flow should works. If we configure our application flow in spring web flow, the data carrying portion as well as the page navigation issues will be taken care by spring web flow itself. We can concentrate on our business logic rather than spending time on working those mundane tasks.<\/p>\n

   Spring web flow can be configured only via xml file. Currently it is not feasible to configure via only java.<\/p>\n

   The first thing to setup a web flow is configuration. A flow configuration involves below major components. Let’s go through them.<\/p>\n

   Flow executor:\u00a0<\/strong>Flow executor is responsible to drive the flow.\u00a0 The syntax will be like below.<\/p>\n

   <flow:flow-executor id=\"flowExecutor\"\/><\/pre>\n
   Flow Registry:\u00a0<\/strong>Flow registry is responsible to load the flow definitions. For example if all flows under folder\u00a0WEB-INF\/flows<\/span>\u00a0needs to be loaded it has to be configured like\u00a0 below.<\/p>\n
   <flow:flow-registry id=\"flowRegistry\" base-path=\"\/WEB-INF\/flows\">\n<flow:flow-location-pattern value = \"**\/*-flow.xml\"\/> \n<\/flow:flow-registry><\/pre>\n
   Here one important thing to note is the url path to the flow will be determined by the path of the flow location.\u00a0 For example if the path of a flow is\u00a0\/WEB-INF\/flows\/order\/order-flow.xml<\/span>\u00a0 then the id will be order<\/span>\u00a0 (relative to the base path.) So the flow will be triggered while accessing the url http:\/\/{url}\/{contextpath}\/order<\/span><\/p>\n
   Instead of the pattern the path of the flow file also can be configured. For example to load\u00a0order-flow.xml<\/span>\u00a0flow it can be configured like below.<\/p>\n
   <flow:flow-registry id=\"flowRegistry\"> <flow:flow-location path = \"\/WEB-INF\/flows\/order\/order-flow.xml\"\/> <\/flow:flow-registry><\/pre>\n
   If the full path is specified then the filename will become the id of that flow. In the above case it will be order-flow<\/span>\u00a0. If id needs to be different from the path it can be specified with id attribute like below.<\/p>\n
   <flow:flow-location path = \"\/WEB-INF\/flows\/order\/order-flow.xml\" id=\"custom\/path\/flow\"\/><\/pre>\n
   As per the above code the flow will be triggered when the url {contextPath}\/custom\/path\/<\/span>\u00a0flow is entered.<\/p>\n
   Flow Handler Mapping :\u00a0<\/strong>Like DispatcherServlet<\/span>\u00a0 for controller mapping, there is a class FlowHandlerMapping<\/span>\u00a0 for URL to flow mapping for web flow.<\/p>\n
   Flow Handler Adapter :\u00a0<\/strong>Like Controllers for handling the requests, there is a class FlowHandlerAdapter<\/span>\u00a0 to handle the flow requests<\/p>\n
   The next important thing is the flow.\u00a0\u00a0A Flow is an xml file which tells the exactly how this flow should works. A flow will have three major components.<\/p>\n
   \n
   State<\/li>\n
   Transition<\/li>\n
   Data<\/li>\n<\/ol>\n
   State :\u00a0<\/strong>As per the name it is the state of the flow, which means the flows should be in a state.\u00a0 There are five types of states possible.<\/p>\n
   \n
   View-state<\/strong>\n
   \n
   To display some pages to the user<\/li>\n
   <view-state id=”welcome”\/><\/span>\u00a0will\u00a0redirect to the view named welcome<\/span><\/li>\n
   <view-state id=”welcome” view=”success”\/><\/span>\u00a0will\u00a0redirect to the view named\u00a0success<\/span><\/li>\n
   <view-state id=”welcome” view=”success” model=”flowScope.paymentDetails”\/><\/span>\u00a0will\u00a0redirect to the view named\u00a0\u00a0success<\/span>\u00a0 with model attribute paymentDetails<\/span>\u00a0
   
   <\/li>\n<\/ul>\n<\/li>\n
   Action-state<\/strong>\n
   \n
   To execute logical conditions. The syntax will be like below.\n
   <action-state id=\"saveOrder\">\n    <evaluate expression=\"pizzaFlowActions.saveOrder(order)\"\/>\n    <transition to=\"thankYou\"\/>\n<\/action-state><\/pre>\n<\/li>\n
   When flow reaches\u00a0 the above state the method\u00a0pizzaFlowActions.saveOrder(order)<\/span>\u00a0 will be executed and once done thankYou<\/span>\u00a0 state will be invoked.<\/li>\n<\/ul>\n<\/li>\n
   Decision-state<\/strong>\n
   \n
   To decide which path to proceed based on particular condition. Can be of only two paths. Either True or false\n
   <decision-state id=\"checkDeliveryArea\">\n    <if test=\"pizzaFlowActions.checkDeliveryArea(customer.zipCode)\" \n    then=\"addCustomer\" else=\"deliveryWarning\"\/>\n<\/decision-state><\/pre>\n<\/li>\n<\/ul>\n<\/li>\n
   Subflow-state<\/strong>\n
   \n
   To trigger a sub-flow from the current flow. Once the sub-flow ends the current flow will resume\n
   <subflow-state id=\"order\" subflow=\"pizza\/order\">\n    <input name=\"order\" value=\"order\"\/>\n    <transition on=\"orderCreated\" to=\"payment\"\/>\n<\/subflow-state><\/pre>\n<\/li>\n<\/ul>\n<\/li>\n
   End-state<\/strong>\n
   \n
   To denote the end of the flow. Syntax will be like below.<\/li>\n
   <end-state id=”customerReady”\/><\/span><\/li>\n
   If this is the sub flow the parent flow will resume once this flow ends.<\/li>\n
   If this is not sub flow and has a view\u00a0it will be rendered.<\/li>\n
   If view name is prefixed with externalRedirect:<\/span>\u00a0 it will redirect to that page outside the flow<\/li>\n
   If view name is prefixed with flowRedirect:<\/span>\u00a0 it will redirect to that page to another\u00a0flow<\/li>\n
   If this is not sub flow and there is no view, then the flow will end and go to the first\u00a0state of the flow\u00a0as a new flow.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n
   Transition:\u00a0<\/strong>To move from one state to another state the transition element will be used.<\/p>\n
   \n
   It will be child element of the state elements view-state,subflow-state or action-state. The syntax will be like below.<\/li>\n
   <transition to=”customerReady”><\/span>\u00a0 –\u00a0If no on event is attached, it will be the default transition.<\/li>\n
   <transition on=”submit” to=”customerReady”><\/span>\u00a0 –\u00a0On submit event\u00a0it will be fired<\/li>\n
   <transition on-exception=”org.span.server.UserNotFoundException” to=”registrationForm”><\/span>\u00a0 – On UserNotfoundException<\/span>\u00a0 this event will be fired.<\/li>\n
   \u00a0Instead of repeating same transitions on multiple states we can use global transitions like below. It will be applied to all states by default.\n
   <global-transitions>\n   <transition on=\"cancel\" to=\"endState\"\/>\n<\/global-transitions><\/pre>\n<\/li>\n<\/ul>\n
   Data: <\/strong>To store and pass data through out the flow the data elements will be used. The syntax will be <var name=”customer” class=”org.span.domain.Customer”\/><\/span><\/p>\n
   \n
   In the above example a new Customer object will be created and assigned to customer. Also will be available across all state in that flow<\/li>\n
   Also <evaluate><\/span>\u00a0 can be used on a view state or action state like below<\/li>\n
   <evaluate result=”viewScope.toppingsList” expression=”T(org.span.domain.pizza.Topping).asList()”\/><\/span><\/li>\n
   Also <set><\/span>\u00a0 can be used to set a variable’s value.<\/li>\n
   <set name=”flowScope.pizza” value=”new org.span.domain.Pizza()”\/><\/span><\/li>\n
   We can set the scope of the variables. It can be any one of the five types as below\n
   \n
   Conversion Scope<\/span>\u00a0 \u00a0 \u00a0->\u00a0 \u00a0 \u00a0Created at the top level and destroyed\u00a0when top flow ends. Available under all sub flows too.<\/li>\n
   Flow Scope\u00a0<\/span>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 ->\u00a0 \u00a0 \u00a0Created at the flow level and available only within that level<\/li>\n
   Request Scope<\/span>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0->\u00a0 \u00a0 \u00a0Created when a request is made into a flow and destroyed when the flow returns<\/li>\n
   Flash Scope\u00a0<\/span>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0->\u00a0 \u00a0 \u00a0Created when a flow starts and destroyed when flow ends. It is also cleared when a view state is rendered<\/li>\n
   View Scope<\/span>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0\u00a0\u00a0 \u00a0 \u00a0->\u00a0 \u00a0 \u00a0Created when a view state is entered, and destroyed when the state exists. Visible only to the view state.<\/li>\n<\/ol>\n<\/li>\n
   Default scope of variable declared via <var><\/span>\u00a0 tag will be flow scope.<\/li>\n
   Default scope of variable declared via <set><\/span>\u00a0,<evaluate><\/span>\u00a0 will be mentioned along with the variable name like <set name=”flowScope.totalMarks” value=”499″\/><\/span><\/li>\n<\/ul>\n
   That is all about the major components of the web flow. Also web flow can be secured as well. To secure a flow it has to be configured like below.<\/p>\n
   <view-state id=\"restricted\" view=\"paymentdetails\">\n    <secured attributes=\"ROLE_ADMIN,ROLE_FINANCE\" match=\"all\"\/>\n<\/view-state><\/pre>\n
   attributes<\/span>\u00a0 are comma separated roles. match<\/span>\u00a0\u00a0can be ‘any’ – At least one role required<\/span>\u00a0 or ‘all’ – All roles required<\/span>\u00a0.<\/p>\n
   In this section we have discussed the concepts of Spring web flow. In the next tutorial we will implement a simple web flow application to understand all the discussed concepts.<\/p>\n","protected":false},"excerpt":{"rendered":"
   In this post we will see the major concepts relates to Spring web flow. Spring flow is an approach to implement multi page flow web applications like shopping portal.\u00a0 For example in shopping portal application a user may involve in … Continue reading →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[38,37],"tags":[39,40],"_links":{"self":[{"href":"https:\/\/tech.learnerandtutor.com\/wp-json\/wp\/v2\/posts\/646"}],"collection":[{"href":"https:\/\/tech.learnerandtutor.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tech.learnerandtutor.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tech.learnerandtutor.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/tech.learnerandtutor.com\/wp-json\/wp\/v2\/comments?post=646"}],"version-history":[{"count":19,"href":"https:\/\/tech.learnerandtutor.com\/wp-json\/wp\/v2\/posts\/646\/revisions"}],"predecessor-version":[{"id":684,"href":"https:\/\/tech.learnerandtutor.com\/wp-json\/wp\/v2\/posts\/646\/revisions\/684"}],"wp:attachment":[{"href":"https:\/\/tech.learnerandtutor.com\/wp-json\/wp\/v2\/media?parent=646"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tech.learnerandtutor.com\/wp-json\/wp\/v2\/categories?post=646"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tech.learnerandtutor.com\/wp-json\/wp\/v2\/tags?post=646"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}