Spring Web Flow를 실행 시키기 위해 Flow Definition 파일이 있는 위치를 FlowRegistry에 등록하고 각각의 Flow Definition 파일에 대해 Flow ID를 부여한다. 필요에 따라 base-path를 지정해 줄 수도 있다.

<webflow:flow-registry id="flowRegistry" base-path="/WEB-INF/jsp/webflow">
    <webflow:flow-location path="/sales/product/addProduct-flow.xml"
            id="webflowAddProduct" />
</webflow:flow-registry>

[/WEB-INF/jsp/webflow/sales/category/category-flow.xml]' under id 'category'
[/WEB-INF/jsp/webflow/sales/category/category-flow.xml]' under id 'category-flow'

Flow를 실행 시키기 위해서 FlowExecutor 배포하여야 한다.

<webflow:flow-executor id="flowExecutor" /> 

Spring MVC 환경에서 Flow가 핸들링 될 수 있도록 해주기 위해 FlowHandlerAdaptor를 정의한다.

<bean class="org.springframework.webflow.mvc.servlet.FlowHandlerAdapter">
    <property name="flowExecutor" ref="flowExecutor" />
</bean>

요청에 대한 Flow를 매핑시켜 주기위해 FlowHandlingMapping을 정의 한다.

<bean class="org.springframework.webflow.mvc.servlet.FlowHandlerMapping">
    <property name="order" value="0" />
    <property name="flowRegistry" ref="flowRegistry" />
</bean>

<bean class="org.springframework.
            web.servlet.handler.SimpleUrlHandlerMapping">
    <property name="order" value="0"/>
    <property name="mappings">
        <value>
            /webflowProduct.do=flowController
        </value>
    </property>
    <property name="interceptors" ref="loginInterceptor" />
</bean>
<bean id="flowController" 
        class="org.springframework.webflow.mvc.servlet.FlowController">
    <!-- 필수 -->
    <property name="flowExecutor" ref="flowExecutor"/>
</bean>
<bean class="org.springframework.webflow.mvc.servlet.FlowHandlerMapping">
    <!-- order는 SimpleUrlHandlerMapping 보다 낮게 준다. -->
    <property name="order" value="1" />
    <property name="flowRegistry" ref="flowRegistry" />
</bean>
<bean id="loginInterceptor" class="common.LoginInterceptor" />

Spring MVC를 사용할 때 정의한 ViewResolver를 사용하기 위해 flow-builder-services를 등록하고 정의한 viewResolver를 참조하도록 한다. 정의하는 방법은 아래와 같은 Step을 따른다.

view-state는 flow의 step을 정의하며 해당 view를 출력해주는 역할을 한다.

<view-state id="addProductView" model="product"
        view="/WEB-INF/jsp/webflow/sales/product/viewProduct.jsp">
</view-state>

<var name="product" class="domain.Product" />

화면에서 일어난 event에 의해 다음으로 진행해야할 view-state에 대해 정의해준다.

<view-state id="confirmAddProduct"
    view="/WEB-INF/jsp/webflow/sales/product/reviewProduct.jsp">
    <transition on="revise" to="addProductView" />
    <transition on="confirm" to="backtolist" history="invalidate">
        <evaluate expression="coreProductService.add(product)" />
    </transition>
    <transition on="cancel" to="backtolist" />
</view-state>

<input type="submit" value="save"/>
<input type="hidden" name="_eventId" value="success" />

<input type="submit" name="_eventId_success" value="save" />

<a href="${flowExecutionUrl}&_eventId=success">success</a>

플로우를 종료시키기 위해 end-state를 정의해준다.

<end-state id="cancel" />

<webflow:flow-execution-repository max-executions="5" max0execution-snapshots="30" />

action을 실행시키기 위해서는 위에서 언급한 시점에서 <evaluate>를 사용하면 된다.

<evaluate expression="coreProductService.save(product)" />

<var name="list" class="java.util.ArrayList" />
<evaluate expression="list.add(product)" />

<evaluate expression="coreProductService.get(prodNo)" result="flowScope.product" />

action-state를 사용하면 action을 실행시킨 후 리턴 값에 의해 다음으로 진행될 transition을 정할 수 있다.

<action-state id="checkUserLogin">
    <evaluate expression="userService.isUserLogin(userId)"/>
    <transition on="yes" to="getCategory"/>
    <transition on="no" to="backtolist"/>
</action-state>

decision-state는 action-state와 같은 역할을 하지만 if/else 문을 사용할 수 있다. 위에서 정의한 코드를 decision-state로 정의하면 아래와 같은 코드가 된다.

<decision-state id="checkUserLogin">
    <if test="UserService.isUserLogin(userId)" then="getCategory" else="backtolist" />
</decision-state>

다음은 flow 파일 내에서 유용하게 사용할 수 있는 변수들이다.

먼저 subflow를 호출하게될 state에서 subflow-state를 정의하고 실행시킬 subflow의 id를 지정해 준다. 아래의 코드는 상위 플로우 정의 부분의 일부이다.

<subflow-state id="viewCategory" subflow="viewCategorySubFlow">
    <!-- transition 정의 -->
    <transition ... />
</subflow-state>

subflow에 전달해줄 객체가 있으면 input을 사용한다.

<subflow-state id="viewCategory" subflow="viewCategory">
    <!-- subflow에서 필요한 data를 input 값으로 정의  -->
    <input name="categoryNo" value="product.category.categoryNo"/>
    <!-- transition 정의 -->
    <transition ... />
</subflow-state>

<!-- 상위 플로우에서 받게 될 input값 정의  -->
<input name="categoryNo"/>
<view-state id="viewCategory"
        view="/WEB-INF/jsp/webflow/sales/category/viewCategoryForFlow.jsp">
    <on-render>
        <evaluate 
            expression="coreCategoryService.get(categoryNo)" 
            result="category"/>
        <set name="viewScope.category" value="category"/>
    </on-render>
    <transition ... />
</view-state>

하위 플로우에서 플로우를 진행시킨 후에 상위 플로우에 전달해 줄 객체가 있을 경우는 output으로 정의한다.

<end-state id="submit">
    <!-- 상위플로우에 전달해 줄 data를 output으로 셋팅 -->
    <output name="category" value="category" />
</end-state>

<output name="category" />

flow 레벨 상속은 여러개의 플로우 상속이 가능하다. 이 때 콤마(,)로 구분하여 정의한다.

<flow xmlns="http://www.springframework.org/schema/webflow"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.springframework.org/schema/webflow  
    http://www.springframework.org/schema/webflow/spring-webflow-2.0.xsd" 
    parent="webflowParent1, webflowParent2">

state 레벨 상속은 한 개의 state에서 한 개의 state만 상속받을 수 있다. 또한, child state와 parent state는 같은 타입이어야 한다. 예를 들어 child state가 view-state 이면 parent state도 view-state여야 한다. flow id와 state id간의 구분자는 "#"이다.

<view-state id="getProduct" model="product"
        view="/WEB-INF/jsp/webflow/sales/product
        /viewProduct.jsp" parent="webflowParent#stateParent">
        ...
</view-state>

해당 뷰에 대해 backtracking을 방지 한다.

<transition on="confirm" to="backtolist" history="discard">
    <evaluate expression="coreProductService.add(product)" />
</transition>

이전에 출력되었던 모든 뷰에 대한 backtracking을 방지 한다.

<transition on="confirm" to="backtolist" history="invalidate">
    <evaluate expression="coreProductService.add(product)" />
</transition>