Spring Webflow - 配置

  1. 本文基于Spring Web Flow 2.4.5，其它版本配置方式可能略有不同，请参考相应版本的官方文档
  2. Maven依赖
    maven库查询推荐地址：http://mvnrepository.com/
1
2
3
4
5
6
<dependency>
<!-- more -->
    <groupId>org.springframework.webflow</groupId>
    <artifactId>spring-webflow</artifactId>
    <version>2.4.5.RELEASE</version>
</dependency>

Web Flow嵌入到Spring MVC工作流简介

请求被DispatcherServlet拦截 -> 分发flow进行处理，返回view -> viewResolver解析 -> 返回请求

配置项预览

  • FlowRegistry：必须，注册流程，指明流程配置文件所在位置；指定流程id(用于请求访问标识)；指定流程属性；此外还可以传入FlowBuilderServices进行更多个性化配置
  • FlowBuilderServices：必须，用于设定流程配置文件中EL表达式的解析器、form属性绑定时的转换器、view-state的view解析器等，很重要
  • FlowExecutor：必须，用于执行流程，可指定执行监听器(可选，常用于流程安全和持久化)
  • FlowHandlerAdapter：必须，用于适配Spring MVC，配置时传入FlowExecutor
  • FlowHandlerMapping：必须，用于将请求映射到对应的flow，配置时传入FlowRegistry

配置I - 注册流程 - FlowRegistry

FlowRegistry用于注册流程实例，指定流程位置和流程id，并可自定义流程创建相关内容

注册flow的各种方式

  • 直接指定流程位置
    默认情况下，web-flow的id为其文件名减去后缀名，如下配置的id为booking。指定了基地址或使用了通配符时除外。

    1
    2
    <webflow:flow-location path="/WEB-INF/flows/booking/booking.xml" />
    // 注册了一个路径为/WEB-INF/flows/booking/booking.xml的流程，其余为默认配置。

  • 自定义id

1
<webflow:flow-location path="/WEB-INF/flows/booking/booking.xml" id="bookHotel" />

  • 定义流程属性
    如下定义了一个带有属性caption，其值为”Books a hotel”的流程。属性的使用方法暂时不了解

    1
    2
    3
    4
    5
    <webflow:flow-location path="/WEB-INF/flows/booking/booking.xml">
        <webflow:flow-definition-attributes>
            <webflow:attribute name="caption" value="Books a hotel" />
        </webflow:flow-definition-attributes>
    </webflow:flow-location>
    • 使用通配定义流程位置

使用该方法并没有正确实验出id，这点作为参考

1
<webflow:flow-location-pattern value="/WEB-INF/flows/**/*-flow.xml" />
  • 使用基地址
    使用基地址的flow的id为其path属性减去文件名，如下配置的id为/hotels/booking；如果path中没有路径信息，只有文件名，则id为文件名减去后缀。
    1
    2
    3
    <webflow:flow-registry id="flowRegistry" base-path="/WEB-INF">
        <webflow:flow-location path="/hotels/booking/booking.xml" />
    </webflow:flow-registry>

flow id属性总结

  1. id的作用
    id用于请求定位到某个确切的flow，如当请求路径为http://localhost:8090/Floyd/search-flow，其中Floyd是项目名，如果有id为search-flow的flow存在，则会访问该flow
  2. id的定义
    • 没有基地址或通配符时，flow的id为文件名减去后缀，如<webflow:flow-location path="/WEB-INF/flows/booking/booking.xml" />这里的id为booking
    • 有基地址时，id为path的值减去文件名，如基地址为/WEB-INF， path=/flows/booking/booking.xml时，id被确定为flows/booking
    • 有通配符时，该情况比较特殊，按照官方说明并没有验证通过，这里略过。
      当显式指定了id属性时，则使用指定的id。推荐自定义id

      FlowRegistry继承

      FlowRegistry是可以继承的，可以定义一个公用的注册器，在多个子注册器中继承该注册器
1
2
3
4
5
6
7
8
9
<!-- my-system-config.xml -->
<webflow:flow-registry id="flowRegistry" parent="sharedFlowRegistry">
    <webflow:flow-location path="/WEB-INF/flows/booking/booking.xml" />
</webflow:flow-registry>

<!-- shared-config.xml -->
<webflow:flow-registry id="sharedFlowRegistry">
    <!-- Global flows shared by several applications -->
</webflow:flow-registry>

配置II - 使用FlowBuilder services

使用FlowBuilder Services可以在build流程时自定义服务，比如视图解析器、EL表达式解析器、类型格式化和转换服务等。如无显式设定FlowBuilder Services，系统将使用默认实现。

1
2
3
4
5
6
7
8
9
10
11
12
<webflow:flow-registry id="flowRegistry" flow-builder-services="flowBuilderServices">
    <webflow:flow-location path="/WEB-INF/flows/booking/booking.xml" />
</webflow:flow-registry>

<webflow:flow-builder-services id="flowBuilderServices"
    conversion-service="conversionService"
    expression-parser="expressionParser"
    view-factory-creator="viewFactoryCreator" />

<bean id="conversionService" class="..." />
<bean id="expressionParser" class="..." />
<bean id="viewFactoryCreator" class="..." />

自定义视图解析器 view-factory-creator

view-factory-creator用于视图解析工作，默认的creator可以支持Spring MVC支持的几种视图类型：JSP, Velocity，FreeMarker等。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
<webflow:flow-registry id="flowRegistry" flow-builder-services="flowBuilderServices">
	<webflow:location path="/WEB-INF/hotels/booking/booking.xml" />
</webflow:flow-registry>

<!-- 尤其注意这里的development，设置为true时表示开启开发模式，该模式下会在flow定义改变时自动re-load，甚至flow中引用的resource bundle发生了变化都会热重载 -->
<webflow:flow-builder-services id="flowBuilderServices" view-factory-creator="mvcViewFactoryCreator" development="true"/>

<bean id="mvcViewFactoryCreator" class="org.springframework.webflow.mvc.builder.MvcViewFactoryCreator">
	<!-- myExistingViewResolverToUseForFlows就是我们常用的视图解析器，注意这里引用的是一个列表 -->
	<property name="viewResolvers" ref="myExistingViewResolverToUseForFlows"/>
</bean>

... ... 
... ...
<!-- 做验证时使用的是javaconfig的形式，这种形式并没有验证过 -->
<property name="myExistingViewResolverToUseForFlows">
    <list>
        <ref bean="viewResolver" />
    </list>
</property>

<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
   <property name="prefix" value="/WEB-INF/"/>
   <property name="suffix" value=".jsp"/>
</bean>

自定义表达式解析器 expression-parser

expression-parser用于定义表达式解析器，默认的解析器使用逻辑：当类路径下有Unified EL解析器时，则使用；没有时，则使用OGNL表达式解析器(官方文档在EL表达式一章和系统设置一章关于默认表达式解析说法有出入，自己认为比较可信的是Spring Web Flow 2.1以后，默认使用Spring EL表达式解析器)。
下面是手动配置成Unified EL解析器的方式：

1
2
3
4
5
6
7
<webflow:flow-builder-services expression-parser="expressionParser"/>

<bean id="expressionParser" class="org.springframework.webflow.expression.el.WebFlowELExpressionParser">
    <constructor-arg>
        <bean class="org.jboss.el.ExpressionFactoryImpl" />
    </constructor-arg>
</bean>

自定义类型转换器 conversion-service

详细内容参见本系列视图渲染相关章节或官方文档

1
2
3
4
5
6
7
8
9
<webflow:flow-registry id="flowRegistry" flow-builder-services="flowBuilderServices" ... />

<webflow:flow-builder-services id="flowBuilderServices" conversion-service="defaultConversionService" ... />

<bean id="defaultConversionService" class="org.springframework.binding.convert.service.DefaultConversionService">
	<constructor-arg ref="applicationConversionSevice"/>
</bean>

<bean id="applicationConversionService" class="somepackage.ApplicationConversionServiceFactoryBean">
1
2
3
4
5
6
public class ApplicationConversionServiceFactoryBean extends FormattingConversionServiceFactoryBean {
    @Override
    protected void installFormatters(FormatterRegistry registry) {
        // ...
    }
}

配置III - 发布流程执行器 - FlowExecutor

FlowExecutor用于执行flow并管理flow执行过程，常见的自定义项有：设置监听器，监听流程执行过程并作出相应，如security监听器，用于监听并控制流程的访问权限；调整flow的部分持久化选项等。

  • 注册监听器
1
2
3
4
<!-- 这里是为特定的flow应用该监听器，当不设criteria属性时，将对所有flow应用 -->
<webflow:flow-execution-listeners>
    <webflow:listener ref="securityListener" criteria="securedFlow1,securedFlow2"/>
</webflow:flow-execution-listeners>
  • 调整持久化参数
    • max-executions： 设定为每个用户保留的执行数(没错，就是执行数)，当超过该数量时，最先的那个执行会被清除。(这里的执行，我认为是一个新开的且处于激活状态下的flow实例)
    • max-execution-snapshots： 设定每个执行保留的最大快照数。不允许保留时，设为0。允许无线保留时，设为-1。(快照用于浏览器的返回按钮)
      1
      2
      3
      <webflow:flow-executor id="flowExecutor" flow-registry="flowRegistry">
          <webflow:flow-execution-repository max-executions="5" max-execution-snapshots="30" />
      </webflow:flow-executor>

配置IV - Spring MVC集成

基础配置（将请求转发给flow）

  • Spring MVC基础配置
1
2
3
4
5
6
7
8
9
10
11
12
13
14
<servlet>
	<servlet-name>Spring MVC Dispatcher Servlet</servlet-name>
	<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
	<init-param>
		<param-name>contextConfigLocation</param-name>
		<param-value>/WEB-INF/web-application-config.xml</param-value>
	</init-param>
</servlet>

<servlet-mapping>
	<servlet-name>Spring MVC Dispatcher Servlet</servlet-name>
	<!-- 不能使用类型/*的通配符进行匹配，否则会出现jsp不解析直接回发给浏览器的情况 -->
	<url-pattern>/</url-pattern>
</servlet-mapping>

FlowHandlerAdapter

该步骤是使得Web Flow能够适配Spring MVC
当一个对flow的请求被接收到时，FlowHandlerAdapter会决定是启动一个全新的flow还是继续之前的流程(如从一个view-state跳转到下一个state就属于继续之前的流程)，继续之前的flow是需要在请求有相关信息才行。有关这一方面，web flow默认有如下设定：
  1.Http请求参数在任何情况下都是可以使用的
  2.当一个flow执行结束，且结束时没有想浏览器发送最后的响应时，默认的handler会尝试在同一个request中启动一个新的flow执行
  3.除了NoSuchFlowExecutionException异常外，所有其它异常都会以冒泡的方式抛到Dispatcher中。这是因为默认的handler会尝试自动从该异常中恢复过来，恢复的方式是新开一个全新的flow执行
针对大多数设定，都可以通过实现FlowHandlerAdapter类的子类进行自定义。

1
2
3
4
5
<!-- Enables FlowHandler URL mapping -->
<bean class="org.springframework.webflow.mvc.servlet.FlowHandlerAdapter">
	<!-- flowExecutor就是前文声明的执行器 -->
	<property name="flowExecutor" ref="flowExecutor" />
</bean>

配置V - FlowHandlerMapping

1
2
3
4
5
6
7
<!-- Maps request paths to flows in the flowRegistry;
	e.g. a path of /hotels/booking looks for a flow with id "hotels/booking" -->
<bean class="org.springframework.webflow.mvc.servlet.FlowHandlerMapping">
	<!-- flowRegistry就是前文声明的注册器 -->
	<property name="flowRegistry" ref="flowRegistry"/>
	<property name="order" value="0"/>
</bean>

有了Flow的基本配置和这里的两个Spring MVC的集成配置，请求就能够映射到flow中了。接下来就是写Flow了。想要快速上手的可忽略本文后面的内容，转而直接看本系列其它文章。

配置VI - 实现自定义的FlowHandler

  • FlowHandler讲解
    FlowHandler可用于自定义flow在HTTP Servlert环境中执行的方式，FlowHandler在FlowHandlerAdapter中被使用，主要负责如下内容：

      - 返回flow的id以用于执行该flow
      - 在新流程开始时创建输入
      - 在流程结束时处理流程的输出
      - 在流程发生异常时，处理这些异常

    其主要方法如下：

1
2
3
4
5
6
7
8
9
10
11
12
public interface FlowHandler {

	public String getFlowId();

	public MutableAttributeMap createExecutionInputMap(HttpServletRequest request);

	public String handleExecutionOutcome(FlowExecutionOutcome outcome,
		HttpServletRequest request, HttpServletResponse response);

	public String handleException(FlowException e,
		HttpServletRequest request, HttpServletResponse response);
}

  该接口的直接实现为AbstractFlowHandler，当我们想要自定义某个设定时，继承该抽象类并重写其中的方法即可。

  • 发布一个FlowHandler
    一个FlowHandler负责一个flow，发布方式是在Spring环境中声明一个bean，该bean的name必须和我们想要处理的flow的id一致，配置好后，当方位该flow的id，则会定位到新发布的FlowHandler中，我们自定义的方法也就生效了。
1
2
<!-- 这里的BookingHandler只是一个例子，实际用时替换成我们自己的Handler -->
<bean name="hotels/booking" class="org.springframework.webflow.samples.booking.BookingFlowHandler" />
  • 着重讲一下FlowHandler中handleExecutionOutcome(…)方法
    该方法用于处理flow结束时产生的FlowExecutionOutcome(系统自动产生)，我们常用它来在流程结束后进行重定向，比如
1
2
3
4
5
6
7
8
9
10
11
12
public class BookingFlowHandler extends AbstractFlowHandler {
	// handlExecutionOutcome()方法返回的String代表的是重定向的地址
	public String handleExecutionOutcome(FlowExecutionOutcome outcome,
										HttpServletRequest request, HttpServletResponse response) {
		if (outcome.getId().equals("bookingConfirmed")) {
			return "/booking/show";
		} else {
			return "/hotels/index";
		}
	}
}
// 当flow id为bookinConfirmed时，重定向到/booking/show，否则重定向到/hotels/index

  默认情况下，该方法返回的地址是相关于当前Servlet的。但是我们也可以显式地指定一些前缀来扩展重定向的范围

   – servletRelative: - 相对于当前Servlet重定向
   – contextRelative: - 相对于当前应用重定向
   – serverRelative: - 相对于当前服务器的基地址重定向
   – http:// or https:// - 重定向到一个完整的URI地址

  相同的前缀同样适用于声明state时的view属性配上externalRedirect的情况

1
2
<end-state view="externalRedirect:http://springframework.org"/>
<!-- 在流程结束时，跳转到spring首页 -->

—————————————————–手动分割线——————————————————————————————

一个能用的配置(采用Java config的方式配置)

WebInitializer（与web.xml作用类似）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
public class WebInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {

	@Override
	protected Class<?>[] getRootConfigClasses() {
		return null;
	}

	@Override
	protected Class<?>[] getServletConfigClasses() {
		return new Class<?>[] {MainConfig.class, RegisterConfig.class};
	}

	@Override
	protected String[] getServletMappings() {
		return new String[] {"/"};
	}

}

MainConfig（Spring的主要配置文件）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
@Configuration
@EnableWebMvc
@ComponentScan("cn.floyd.pw")
public class MainConfig extends WebMvcConfigurerAdapter{

	@Bean(name="viewResolver")
	public ViewResolver getViewResolver() {
		InternalResourceViewResolver resolver = new InternalResourceViewResolver();
		resolver.setPrefix("/WEB-INF/jsp/");
		resolver.setSuffix(".jsp");
		return resolver;
	}
	
	@Bean
	public MultipartResolver multipartResolver() throws IOException {
	    CommonsMultipartResolver resolver = new CommonsMultipartResolver();
	    return resolver;
	}

	// enable the static resource
	@Override
	public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
		configurer.enable();
	}
	
	@Bean
    public FlowHandlerAdapter flowHandlerAdapter(@Autowired FlowExecutor flowExecutor) {
	    System.out.println("init flowHandlerAdapter");
        FlowHandlerAdapter adapter = new FlowHandlerAdapter();
        adapter.setFlowExecutor(flowExecutor);
        
        return adapter;
    }
    
    @Bean
    public FlowHandlerMapping flowHandlerMapping(@Autowired FlowDefinitionRegistry flowRegistry) {
        System.out.println("init flowHandlerMapping");
        FlowHandlerMapping mapping = new FlowHandlerMapping();
        mapping.setOrder(0);
        mapping.setFlowRegistry(flowRegistry);
        
        return mapping;
    }
	
}

RegisterConfig（配置FlowRegister和flowExecutor）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
@Configuration
public class RegisterConfig extends AbstractFlowConfiguration {

    // 用于注册flow
    @Bean("flowRegistry")
    public FlowDefinitionRegistry flowRegistry(@Autowired FlowBuilderServices flowBuilderServices) {
        
        return getFlowDefinitionRegistryBuilder()
                .setBasePath("/WEB-INF/jsp/flow")
                .addFlowLocation("/config/search-flow.xml")
                .setFlowBuilderServices(flowBuilderServices)
                .build();
    }
    
    @Bean
    public FlowBuilderServices flowBuilderServices(@Autowired MvcViewFactoryCreator mvcViewFactoryCreator) {
        return getFlowBuilderServicesBuilder()
                .setViewFactoryCreator(mvcViewFactoryCreator)
                .build();
    }
    
    @Bean
    public MvcViewFactoryCreator mvcViewFactoryCreator(@Autowired ViewResolver viewResolver) {
        MvcViewFactoryCreator creator = new MvcViewFactoryCreator();
        List<ViewResolver> list = new ArrayList<ViewResolver>();
        list.add(viewResolver);
        creator.setViewResolvers(list);
        
        return creator;
    }
    
    @Bean
    public FlowExecutor flowExecutor(@Autowired FlowDefinitionRegistry flowRegistry) {
        return getFlowExecutorBuilder(flowRegistry).build();
    }
    
}

配置时踩过的坑

flow id的坑

最开始对flow id的认识不够，导致不知道到底该如何定位到flow，其实访问方式就是 …/appName/flowId

Web MVC Environment null not supported

启动时正常，访问flow时报异常java.lang.IllegalStateException: Web MVC Environment null not supported
是在创建viewFactory时出错，由于我没有采用在config中声明bean的方式创建MvcViewFactoryCreator，因此出现找不到mvc环境的问题，原来是spring在自动检测并创建bean时，会同时设置该bean的环境，因此不能自己随意采用new的方式创建这些配置类

JSP文件不解析

出现JSP文件不经过解析就直接传送给了浏览器的问题(对如下阐述的原理并不是很清楚)
url-pattern为”/*”时，能够匹配到任何路径，因此当controller返回.jsp文件时，也会被拦截，从而返回jsp源码(这里不是很理解，主要是跟自己认识的spring mvc处理流程有差别)。
url-pattern为”/“时，只能够匹配不带后缀的路径，因此jsp就不会被dispatcherServlet拦截，而是会被jspServlet拦截并处理。但是”/“在配置使能的情况下也能够拦截并允许静态资源的访问

留言

⬆︎TOP