天天看點

第四章、SpringMVC學習-Controller接口控制器詳解(3)

4.11、AbstractWizardFormController

向導控制器類提供了多步驟(向導)表單的支援(如完善個人資料時分步驟填寫基本資訊、工作資訊、學校資訊等)

假設現在做一個完善個人資訊的功能,分三個頁面展示:

1、頁面1完善基本資訊;

2、頁面2完善學校資訊;

3、頁面3完善工作資訊。

這裡我們要注意的是當使用者跳轉到頁面2時頁面1的資訊是需要儲存起來的,還記得AbstractFormController中的sessionForm嗎? 如果為true則表單資料存放到session中,哈哈,AbstractWizardFormController就是使用了這個特性。

第四章、SpringMVC學習-Controller接口控制器詳解(3)

向導中的頁碼從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。