第四章 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 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)：允許覆蓋默認的綁定參數到命令對象和驗證流程。

（3、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、嚮導中的每一步視圖

（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。

 

私塾在線學習網原創內容（http://sishuok.com）

原創內容，轉載請註明私塾在線【http://sishuok.com/forum/blogPost/list/5254.html】