Spring MVC學習(四)-------Controller接口控制器詳解3

4.十一、AbstractWizardFormController

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

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

一、頁面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框架。

 

4.十二、ParameterizableViewController

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

 

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

 

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

4.1三、AbstractUrlViewController

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

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

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

 

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

 

4.1四、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。