AbstractWizardFormController(向导控制器)

向导控制器类提供了多步骤(向导)表单的支持(如完善个人资料时分步骤填写基本信息、工作信息、学校信息等)。

更多精彩内容请看 web前端中文站
www.lisa33xiaoq.net 可按Ctrl + D 进行收藏

假设现在做一个完善个人信息的功能,分三个页面展示:

  • 页面1完善基本信息;
  • 页面2完善学校信息;
  • 页面3完善工作信息。

这里我们要注意的是当用户跳转到页面2时页面1的信息是需要保存起来的,还记得AbstractFormController中的sessionForm吗? 如果为true则表单数据存放到session中,AbstractWizardFormController就是使用了这个特性。

AbstractWizardFormController(向导控制器)

向导中的页码从0开始。

  • PARAM_TARGET = "_target":用于选择向导中的要使用的页面参数名前缀,如“_target0”则选择第0个页面显示,即图中的“wizard/baseInfo”,以此类推,如“_target1”将选择第1页面,要得到的页码为去除前缀“_target”后的数字即是;
  • PARAM_FINISH = "_finish":如果请求参数中有名为“_finish”的参数,表示向导成功结束,将会调用processFinish方法进行完成时的功能处理;
  • PARAM_CANCEL = "_cancel":如果请求参数中有名为“_cancel”的参数,表示向导被取消,将会调用processCancel方法进行取消时的功能处理;
  • 向导中的命令对象:向导中的每一个步骤都会把相关的参数绑定到命令对象,该表单对象默认放置在session中,从而可以跨越多次请求得到该命令对象。

接下来具体看一下如何使用吧。先接下来具体看一下如何使用吧。

 public class UserModel {       private String username;       private String password;       private String realname; //真实姓名       private WorkInfoModel workInfo;       private SchoolInfoModel schoolInfo;       //省略getter/setter   }  
 public class SchoolInfoModel {       private String schoolType; //学校类型:高中、中专、大学       private String schoolName; //学校名称       private String specialty; //专业    //省略getter/setter   }
 public class WorkInfoModel {       private String city; //所在城市       private String job; //职位       private String year; //工作年限    //省略getter/setter   }

接下来看看控制器的实现代码。

 package com.lisa33xiaoq.net.chapter4.web.controller;   //省略import   public class InfoFillWizardFormController extends AbstractWizardFormController {           public InfoFillWizardFormController() {           setCommandClass(UserModel.class);           setCommandName("user");       }       protected Map referenceData(HttpServletRequest request, int page) throws Exception {           Map map = new HashMap();           if(page==1) { //如果是填写学校信息页 需要学校类型信息               map.put("schoolTypeList", Arrays.asList("高中", "中专", "大学"));           }           if(page==2) {//如果是填写工作信息页 需要工作城市信息               map.put("cityList", Arrays.asList("济南", "北京", "上海"));           }           return map;       }          protected void validatePage(Object command, Errors errors, int page) {           //提供每一页数据的验证处理方法       }       protected void postProcessPage(HttpServletRequest request,    Object command,    Errors errors, int page) throws Exception {           //提供给每一页完成时的后处理方法       }       protected ModelAndView processFinish(HttpServletRequest req,    HttpServletResponse resp,    Object command, BindException errors) throws Exception {           //成功后的处理方法           System.out.println(command);           return new ModelAndView("redirect:/success");       }       protected ModelAndView processCancel(HttpServletRequest request,    HttpServletResponse response,    Object command, BindException errors) throws Exception {           //取消后的处理方法           System.out.println(command);           return new ModelAndView("redirect:/cancel");       }   } 
  • page页码:是根据请求中以“_target”开头的参数名来确定的,如“_target0”,则页码为0;
  • referenceData:提供每一页需要的表单支持对象,如完善学校信息需要学校类型,page页码从0开始(而且根据请求参数中以“_target”开头的参数来确定当前页码,如_target1,则page=1);
  • validatePage:验证当前页的命令对象数据,验证应根据page页码来分步骤验证;
  • postProcessPage:验证成功后的后处理;
  • processFinish:成功时执行的方法,此处直接重定向到/success控制器(详见CancelController);
  • processCancel:取消时执行的方法,此处直接重定向到/cancel控制器(详见SuccessController);
  • allowDirtyBack和allowDirtyForward:决定在当前页面验证失败时,是否允许向导前移和后退,默认false不允许;
  • onBindAndValidate(HttpServletRequest request, Object command, BindException errors, int page):允许覆盖默认的绑定参数到命令对象和验证流程。

spring配置文件(chapter4-servlet.xml)

 <bean name="/infoFillWizard"    class="com.lisa33xiaoq.net.chapter4.web.controller.InfoFillWizardFormController">       <property name="pages">           <list>               <value>wizard/baseInfo</value>               <value>wizard/schoolInfo</value>               <value>wizard/workInfo</value>          </list>       </property>   </bean>   
  • pages:表示向导中每一个步骤的逻辑视图名,当InfoFillWizardFormController的page=0,则将会选择“wizard/baseInfo”,以此类推,从而可以按步骤选择要展示的视图。

向导中的每一步视图

基本信息页面(第一步) baseInfo.jsp:

 <form method="post">   真实姓名:<input type="text" name="realname" value="${user.realname}"><br/>   <input type="submit" name="_target1" value="下一步"/>   </form> 

当前页码为0;
name="_target1":表示向导下一步要显示的页面的页码为1;

学校信息页面(第二步) schoolInfo.jsp:

 <form method="post">   学校类型:<select name="schoolInfo.schoolType">     <c:forEach items="${schoolTypeList }" var="schoolType">      <option value="${schoolType }"           <c:if test="${user.schoolInfo.schoolType eq schoolType}">              selected="selected"          </c:if>      >          ${schoolType}      </option>     </c:forEach>   </select><br/>   学校名称:<input type="text" name="schoolInfo.schoolName" value="${user.schoolInfo.schoolName}"/><br/>   专业:<input type="text" name="schoolInfo.specialty" value="${user.schoolInfo.specialty}"/><br/>   <input type="submit" name="_target0" value="上一步"/>   <input type="submit" name="_target2" value="下一步"/>   </form>  

工作信息页面(第三步) workInfo.jsp:

 <form method="post">   所在城市:<select name="workInfo.city">     <c:forEach items="${cityList }" var="city">      <option value="${city }"           <c:if test="${user.workInfo.city eq city}">selected="selected"</c:if>      >        ${city}      </option>     </c:forEach>   </select><br/>   职位:<input type="text" name="workInfo.job" value="${user.workInfo.job}"/><br/>   工作年限:<input type="text" name="workInfo.year" value="${user.workInfo.year}"/><br/>   <input type="submit" name="_target1" value="上一步"/>   <input type="submit" name="_finish" value="完成"/>   <input type="submit" name="_cancel" value="取消"/>   </form>  

当前页码为2。

  • name="_target1":上一步,表示向导上一步要显示的页面的页码为1;
  • name="_finish":向导完成,表示向导成功,将会调用向导控制器的processFinish方法;
  • name="_cancel":向导取消,表示向导被取消,将会调用向导控制器的processCancel方法;

到此向导控制器完成,此处的向导流程比较简单,如果需要更复杂的页面流程控制,可以选择使用Spring Web Flow框架。

【注:本文源自网络文章资源,由站长整理发布】

0
如无特殊说明,文章均为原作者原创,转载请注明出处

该文章由 发布

这货来去如风,什么鬼都没留下!!!
发表我的评论

Hi,请填写昵称和邮箱!

取消评论
代码 贴图 加粗 链接 删除线 签到