第四章 Controller接口控制器详解(3)

4.11、AbstractWizardFormController

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

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

1、页面1完善基本信息;

2、页面2完善学校信息;

3、页面3完善工作信息。

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


向导中的页码从0开始;

PARAM_TARGET = "_target":

用于选择向导中的要使用的页面参数名前缀,如“_target0”则选择第0个页面显示,即图中的“wizard/baseInfo”,以此类推,如“_target1”将选择第1页面,要得到的页码为去除前缀“_target”后的数字即是;

PARAM_FINISH = "_finish":

如果请求参数中有名为“_finish”的参数,表示向导成功结束,将会调用processFinish方法进行完成时的功能处理;

PARAM_CANCEL = "_cancel":

如果请求参数中有名为“_cancel”的参数,表示向导被取消,将会调用processCancel方法进行取消时的功能处理;

向导中的命令对象:

向导中的每一个步骤都会把相关的参数绑定到命令对象,该表单对象默认放置在session中,从而可以跨越多次请求得到该命令对象。

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

(1、修改我们的模型数据以支持多步骤提交: 

    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  
    }  

(2、控制器

package xx.xx.xx.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):允许覆盖默认的绑定参数到命令对象和验证流程。

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

<bean name="/infoFillWizard"   
class="xx.xx.xx.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”,以此类推,从而可以按步骤选择要展示的视图。

(4、向导中的每一步视图

(4.1、基本信息页面(第一步) 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;

(4.2、学校信息页面(第二步) 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>  

(4.3、工作信息页面(第三步) 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框架。

4.12、ParameterizableViewController

参数化视图控制器,不进行功能处理(即静态视图),根据参数的逻辑视图名直接选择需要展示的视图。 

<bean name="/parameterizableView" class="org.springframework.web.servlet.mvc.ParameterizableViewController">  
    <property name="viewName" value="success"/>  
</bean>

该控制器接收到请求后直接选择参数化的视图,这样的好处是在配置文件中配置,从而避免程序的硬编码,比如像帮助页面等不需要进行功能处理,因此直接使用该控制器映射到视图。

4.13、AbstractUrlViewController

提供根据请求URL路径直接转化为逻辑视图名的支持基类,即不需要功能处理,直接根据URL计算出逻辑视图名,并选择具体视图进行展示:

urlDecode:是否进行url解码,不指定则默认使用服务器编码进行解码(如Tomcat默认ISO-8859-1);

urlPathHelper:用于解析请求路径的工具类,默认为org.springframework.web.util.UrlPathHelper。

UrlFilenameViewController是它的一个实现者,因此我们应该使用UrlFilenameViewController。

4.14、UrlFilenameViewController

将请求的URL路径转换为逻辑视图名并返回的转换控制器,即不需要功能处理,直接根据URL计算出逻辑视图名,并选择具体视图进行展示:

根据请求URL路径计算逻辑视图名; 

    <bean name="/index1/*"  class="org.springframework.web.servlet.mvc.UrlFilenameViewController"/>  
    <bean name="/index2/**" class="org.springframework.web.servlet.mvc.UrlFilenameViewController"/>  
    <bean name="/*.html" class="org.springframework.web.servlet.mvc.UrlFilenameViewController"/>  
    <bean name="/index3/*.html" class="org.springframework.web.servlet.mvc.UrlFilenameViewController"/>  

/index1/*:可以匹配/index1/demo,但不匹配/index1/demo/demo,如/index1/demo逻辑视图名为demo;

/index2/**:可以匹配/index2路径下的所有子路径,如匹配/index2/demo,或/index2/demo/demo,“/index2/demo”的逻辑视图名为demo,而“/index2/demo/demo”逻辑视图名为demo/demo;

/*.html:可以匹配如/abc.html,逻辑视图名为abc,后缀会被删除(不仅仅可以是html);

/index3/*.html:可以匹配/index3/abc.html,逻辑视图名也是abc;

上述模式为Spring Web MVC使用的Ant-style 模式进行匹配的:

    ?    匹配一个字符,如/index? 可以匹配 /index1 , 但不能匹配 /index 或 /index12  
    *    匹配零个或多个字符,如/index1/*,可以匹配/index1/demo,但不匹配/index1/demo/demo 
    **   匹配零个或多个路径,如/index2/**:可以匹配/index2路径下的所有子路径,如匹配/index2/demo,或/index2/demo/demo 
     
    如果我有如下模式,那Spring该选择哪一个执行呢?当我的请求为“/long/long”时如下所示: 
    /long/long 
    /long/**/abc  
    /long/** 
    /** 
    Spring的AbstractUrlHandlerMapping使用:最长匹配优先; 
    如请求为“/long/long” 将匹配第一个“/long/long”,但请求“/long/acd” 则将匹配 “/long/**”,如请求“/long/aa/abc”则匹配“/long/**/abc”,如请求“/abc”则将匹配“/**”  

UrlFilenameViewController还提供了如下属性:

prefix:生成逻辑视图名的前缀;

suffix:生成逻辑视图名的后缀;

    protected String postProcessViewName(String viewName) {  
            return getPrefix() + viewName + getSuffix();  
    }  

    <bean name="/*.htm" class="org.springframework.web.servlet.mvc.UrlFilenameViewController">  
            <property name="prefix" value="test"/>  
            <property name="suffix" value="test"/>  
    </bean>  

prefix=“test”,suffix=“test”,如上所示的 /*.htm:可以匹配如/abc.htm,但逻辑视图名将变为testabctest.
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值