Controller接口控制器3

本文爲轉載學習

原文連接：http://jinnianshilongnian.iteye.com/blog/1622684

嚮導控制器類提供了多步驟（嚮導）表單的支持（如完善我的資料時分步驟填寫基本信息、工做信息、學校信息等）

假設如今作一個完善我的信息的功能，分三個頁面展現：

一、頁面1完善基本信息；

二、頁面2完善學校信息；

三、頁面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中，從而能夠跨越屢次請求獲得該命令對象。

接下來具體看一下如何使用吧。

一、修改咱們的模型數據以支持多步驟提交： 

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 cn.javass.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="cn.javass.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」，以此類推，從而能夠按步驟選擇要展現的視圖。

 四、嚮導中的每一步視圖

4.一、基本信息頁面(第一步) 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.二、學校信息頁面(第二步) 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.三、工做信息頁面(第三步) 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框架。

ParameterizableViewController

參數化視圖控制器，不進行功能處理（即靜態視圖），根據參數的邏輯視圖名直接選擇須要展現的視圖。 

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

該控制器接收到請求後直接選擇參數化的視圖，這樣的好處是在配置文件中配置，從而避免程序的硬編碼，好比像幫助頁面等不須要進行功能處理，所以直接使用該控制器映射到視圖。

AbstractUrlViewController

提供根據請求URL路徑直接轉化爲邏輯視圖名的支持基類，即不須要功能處理，直接根據URL計算出邏輯視圖名，並選擇具體視圖進行展現：

urlDecode：是否進行url解碼，不指定則默認使用服務器編碼進行解碼（如Tomcat默認ISO-8859-1）；

urlPathHelper：用於解析請求路徑的工具類，默認爲org.springframework.web.util.UrlPathHelper。

UrlFilenameViewController是它的一個實現者，所以咱們應該使用UrlFilenameViewController。

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。