帮助我们一步步完成相应的部件创建,在某些Web应用程序中,也存在类似的操作场景,比如要注册某个网站的会员,注册过程
可能就包括多步,每一步会提示输入某一方面的信息,以帮助我们简化操作流程。对于这种向导式的简单的多页面流程实现,
我们可以求助于AbstractWizardFormController,它可以帮助我们简化类似场景的开发工作。
其实,AbstractWizardFormController实现类就是要处理组成向导流程的所有页面所发起的Web请求,但与SimpleFormController
处理单个页面不同,AbstractWizardFormController要管理多个表单的显示以及提交数据的处理工作
AbstractWizardFormController将根据每个页面请求后包含的特定参数来决定如何对当前请求进行处理,这些特定参数可以分为如下三类:
PARAM_TARGET PARAM_TARGET用于指定目标页面,它的形式为_target后缀页面索引,比如_target0,_target1,当AbstractWizardFormController
接受到这种类型的参数的时候,它只是将当前请求中的相应参数绑定到Command对象上,然后根据PARAM_TARGET参数后缀的目标页面索引显示相应页面
PARAM_FINISH参数:PARAM_FINISH参数的表现形式为_finish ,当AbstractWizardFormController接受到这种类型的参数的时候
则表示整个向导流程结束,可以调用processFinish()方法处理最终的表单数据,并将页面转向任何一个想要转到的页面
PARAM_CANCEL参数:PARAM_CANCEL参数的形式为_cancel,当接受到该参数的时候,表示用户要取消当前的向导流程,默认情况下
AbstractWizardFormController不支持该参数的处理,但我们可以通过覆写processCancel()方法来改变这种默认的行为,唯一要做的
可能只是返回一个ModelAndView实例,其中只包含了一个逻辑视图名
实际上,AbstractWizardFormController实现类本质上依然是像SimpleFormController那样,分两个阶段来管理表单页面的处理,
只不过从逻辑上将单个表单页面划分为了多个表单页面,而最终绑定数据的Command对象只有一个,AbstractWizardFormController
将根据_targetX参数决定显示表单页面的某一部分,对应到视图那就是显示哪个导向页面。在提交请求之后,AbstractWizardFormController
会把它显示并提交的那部分数据绑定到唯一的那个Command那个对象上,只有在所有导向页面都提交之后,Command对象的数据
才算绑定完成。
在向导最终结束的画面提交_finish参数之后,AbstractWizardFormController将从Command对象获取到所有导向页面收集来的数据
,然后可以调用processFinish方法开始”压轴戏“,实际上,在实现AbstractWizardFormController的时候,也只有processFinish
方法是我们必须要去实现的。
下面是我从别人博客上看到,我实现的例子
首先是 springMVC.xml
bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
<property name="mappings">
<props>
<prop key="login.do">registerController</prop>
</props>
</property>
</bean>
<!-- 对于pages属性,定义了所有的表单页,注意顺序,在填写时,将按照这个顺序进行。 -->
<bean id="registerController" class="com.web.springMVC.controller.RegisterController">
<property name="successView">
<value>success</value>
</property>
<property name="cancelView">
<value>main</value>
</property>
<property name="commandClass">
<value>com.web.springMVC.model.RegisterInfo</value>
</property>
<property name="pages">
<list>
<value>main</value>
<value>register1</value>
<value>register2</value>
<value>register3</value>
</list>
</property>
</bean>
<bean
class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"></bean>
<!-- HandlerAdapter -->
<bean
class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"></bean>
<!-- 定义跳转后的前后缀 -->
<bean id="viewResolver"
class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/jsp/"></property>
<property name="suffix" value=".jsp"></property>
</bean>
对于pages属性,定义了所有的表单页,注意顺序,在填写时,将按照这个顺序进行。
继承自AbstractWizardFormController的controller类如下:
public class RegisterController extends AbstractWizardFormController{
/**
* successView是特地添加的一个属性,用于提供问卷结束后应该导向的视图名称,不要将它与SimpleFormC ontroller
* 的successView混淆,SimpleFormController已经为我们定义了这么一个属性,而AbstractWizardFormController没有
* 所以我们得自己定义
*/
private String successView;
private String cancelView;
public String getSuccessView() {
return successView;
}
public void setSuccessView(String successView) {
this.successView = successView;
}
public String getCancelView() {
return cancelView;
}
public void setCancelView(String cancelView) {
this.cancelView = cancelView;
}
/**
* 实现一个AbstractWizardFormController必须要提供的覆写方法是processFinish()
* 在该方法中调用服务对象将当前的调查结果告知系统,然后将返回的总的问卷的调查情况,通过ModelAndView
* 公开给下一个页面,也就是successView对应的最终的结果显示页面
*/
protected ModelAndView processFinish(HttpServletRequest req,HttpServletResponse res,Object command,BindException errs )throws Exception{
RegisterInfo registerInfo=(RegisterInfo)command;
return new ModelAndView(this.getSuccessView(),"registerInfo",registerInfo);
}
protected ModelAndView processCancel(HttpServletRequest req,HttpServletResponse res,Object command,BindException errs)throws Exception{
return new ModelAndView(this.getCancelView());
}
/**
* RegisterController继承了AbstractWizardFormController,所以必须实现他的abstract method---processFinish。也就是说,如果继承了AbstractWizardFormController
* 仅需要实现这个方法,当所有的页面表单填写完将调用这个方法,processCancel方法不是必须实现的,他是在你填写某一步表单时想取消,按取消按钮时调用。
*/
}
RegisterController继承了AbstractWizardFormController,所以必须实现他的abstract mothed---processFinish。也就是说,若果继承了AbstractWizardFormController,你仅需要实现这个方法。
当所有的页面表单填写完将调用这个方法。 processCancel方法不是必须实现的,他是在你填写某一步表单时想取消,按取消按钮时调用。
下面是表单类RegisterInfo
public class RegisterInfo {
private String name;
private int age;
private char sex;
private String adress;
private String phone;
private String email;
private String favor;
省略getter和setter
注意,它可不是某一页的表单类,而是所有页的表单信息的总和。
下面就是页面了/WEB-INF/jsp/main.jsp:
<body>
<form action="login.do" method="post">
<table>
<tr>
<td>注册信息,请认真填写! <input type="submit" value="开始" name="_target1" />
<!-- name 属性用于对提交到服务器后的表单数据进行标识,或者在客户端通过 JavaScript 引用表单数据 -->
</td>
</tr>
</table>
</form>
</body>
下面就是页面了/WEB-INF/jsp/register1.jsp:
<body>
<form action="login.do" method="post">
<table>
<tbody>
<tr>
<td>姓名:<input name="name" type="text" />
</td>
</tr>
<tr>
<td>年龄:<input name="age" type="text" />
</td>
</tr>
<tr>
<td>性别: <select name="sex">
<option value="Y">男</option>
<option value="X">女</option>
</select>
</td>
</tr>
<tr>
<td align="center">
<input type="submit" value="上一步"name="_target0" />
<input type="submit" value="下一步"name="_target2" />
<input type="submit" value="取消" name="_cancel" />
</td>
</tr>
</tbody>
</table>
</form>
</body>
下面就是页面了/WEB-INF/jsp/register2.jsp:
<body>
<form action="login.do" method="post">
<table>
<tbody>
<tr>
<td>地址:<input name="adress" type="text" />
</td>
</tr>
<tr>
<td>电话:<input name="phone" type="text" />
</td>
</tr>
<tr>
<td>电子邮件:<input name="emial" type="text" />
</td>
</tr>
<tr>
<td align="center">
<input type="submit" value="上一步" name="_target1" />
<input type="submit" value="下一步" name="_target3" />
<input type="submit" value="取消" name="_cancel" />
</td>
</tr>
</tbody>
</table>
</form>
</body>
下面就是页面了/WEB-INF/jsp/register3.jsp:
<body>
<form action="login.do" method="post">
<tr>
<td>喜好:<br> <textarea rows="8" cols="40" name="favor"
style="background-color: D7F8AB"></textarea>
</td>
</tr>
<tr>
<td align="center"><input type="submit" value="上一步"
name="_target2" /> <input type="submit" value="完成" name="_finish" />
<input type="submit" value="取消" name="_cancel" /></td>
</tr>
</form>
</body>
下面就是页面了/WEB-INF/jsp/success.jsp:
<body>
<table>
<tbody>
<tr>
<td>User Info:</td>
</tr>
<tr>
<td><c:out value="${registerInfo.name}"></c:out></td>
</tr>
<tr>
<td><c:out value="${registerInfo.age}"></c:out></td>
</tr>
<tr>
<td><c:out value="${registerInfo.sex}"></c:out></td>
</tr>
<tr>
<td><c:out value="${registerInfo.adress}"></c:out></td>
</tr>
<tr>
<td><c:out value="${registerInfo.phone}"></c:out></td>
</tr>
<tr>
<td><c:out value="${registerInfo.email}"></c:out></td>
</tr>
<tr>
<td><c:out value="${registerInfo.favor}"></c:out></td>
</tr>
</tbody>
</table>
</body>
注意用input的name属性,其中_target加数字指示的是RegisterController的bean配置文件里pages属性里定义的页面。
注意_target的数字是从0开始的,也就是说_target0代表main.jsp,_target1代表register1.jsp,_target2代表register2.jsp,
_target3代表register3.jsp。当点击相应的按钮时会转到name指示的页面。还有两个name属性值需要说明,_finish表示完成,
点击其按钮会调用controller的processFinish方法,_cancel表示取消,点击其按钮会调用controller的processCancel方法。
至此AbstractWizardFormController的基本原理已经算是介绍清楚了。