第四章 Controller介面控制器詳解（2）

五柳-先生發表於2016-03-21
Controller


4.5、ServletForwardingController

將接收到的請求轉發到一個命名的servlet，具體示例如下：

 

java程式碼：
檢視複製到剪貼簿列印
  1. package cn.javass.chapter4.web.servlet;  
  2. public class ForwardingServlet extends HttpServlet {      
  3.     @Override  
  4.     protected void doGet(HttpServletRequest req, HttpServletResponse resp)  
  5.     throws ServletException, IOException {  
  6.   
  7.         resp.getWriter().write("Controller forward to Servlet");  
  8.           
  9.     }  
  10. }  

 

java程式碼：
檢視複製到剪貼簿列印
  1. <servlet>  
  2.     <servlet-name>forwarding</servlet-name>  
  3.     <servlet-class>cn.javass.chapter4.web.servlet.ForwardingServlet</servlet-class>  
  4. </servlet>  

 

java程式碼：
檢視複製到剪貼簿列印
  1. <!— 在chapter4-servlet.xml配置處理器 -->     
  2. <bean name="/forwardToServlet"   
  3. class="org.springframework.web.servlet.mvc.ServletForwardingController">  
  4.         <property name="servletName" value="forwarding"></property>  
  5. </bean>  

 

當我們請求/forwardToServlet時，會被轉發到名字為“forwarding”的servlet處理，該sevlet的servlet-mapping標籤配置是可選的。

 

4.6、BaseCommandController

命令控制器通用基類，提供了以下功能支援：

1、資料繫結：請求引數繫結到一個command object（命令物件，非GoF裡的命令設計模式），這裡的命令物件是指繫結請求引數的任何POJO物件；

   commandClass：表示命令物件實現類，如UserModel；

   commandName：表示放入請求的命令物件名字（預設command），request.setAttribute(commandName, commandObject);

 

2、驗證功能：提供Validator註冊功能，註冊的驗證器會驗證命令物件屬性資料是否合法；

   validators：通過該屬性注入驗證器，驗證器用來驗證命令物件屬性是否合法；

 

該抽象類沒有沒有提供流程功能，只是提供了一些公共的功能，實際使用時需要使用它的子類。

4.7、AbstractCommandController

命令控制器之一，可以實現該控制器來建立命令控制器，該控制器能把自動封裝請求引數到一個命令物件，而且提供了驗證功能。

 

1、建立命令類（就是普通的JavaBean類/POJO）

 

java程式碼：
檢視複製到剪貼簿列印
  1. package cn.javass.chapter4.model;  
  2. public class UserModel {  
  3.     private String username;  
  4.     private String password;  
  5.         //省略setter/getter  
  6. }  

 

2、實現控制器

 

java程式碼：
檢視複製到剪貼簿列印
  1. package cn.javass.chapter4.web.controller;  
  2. //省略import  
  3. public class MyAbstractCommandController extends AbstractCommandController {  
  4.     public MyAbstractCommandController() {  
  5.         //設定命令物件實現類  
  6.         setCommandClass(UserModel.class);  
  7.     }  
  8.     @Override  
  9.     protected ModelAndView handle(HttpServletRequest req, HttpServletResponse resp, Object command, BindException errors) throws Exception {  
  10.         //將命令物件轉換為實際型別  
  11.         UserModel user = (UserModel) command;  
  12.         ModelAndView mv = new ModelAndView();  
  13.         mv.setViewName("abstractCommand");  
  14.         mv.addObject("user", user);  
  15.         return mv;  
  16.     }  
  17. }   

 

java程式碼：
檢視複製到剪貼簿列印
  1. <!— 在chapter4-servlet.xml配置處理器 -->     
  2. <bean name="/abstractCommand"   
  3. class="cn.javass.chapter4.web.controller.MyAbstractCommandController">  
  4.         <!-- 也可以通過依賴注入 注入命令實現類 -->  
  5.         <!-- property name="commandClass" value="cn.javass.chapter4.model.UserModel"/-->  
  6. </bean>  

 

java程式碼：
檢視複製到剪貼簿列印
  1. <!— WEB-INF/jsp/abstractCommand.jsp檢視下的主要內容 -->     
  2.   
  3. ${user.username }-${user.password }  

當我們在瀏覽器中輸入“http://localhost:9080/springmvc-chapter4/abstractCommand?username=123&password=123”，會自動將請求引數username和password繫結到命令物件；繫結時按照JavaBean命名規範繫結；

4.8、AbstractFormController

用於支援帶步驟的表單提交的命令控制器基類，使用該控制器可以完成：

1、定義表單處理（表單的渲染），並從控制器獲取命令物件構建表單；

2、提交表單處理，當使用者提交表單內容後，AbstractFormController可以將使用者請求的資料繫結到命令物件，並可以驗證表單內容、對命令物件進行處理。

 

java程式碼：
檢視複製到剪貼簿列印
  1.       @Override  
  2. rotected ModelAndView handleRequestInternal(HttpServletRequest request, HttpServletResponse response)  
  3.     throws Exception {  
  4.      //1、是否是表單提交？ 該方法實現為（"POST".equals(request.getMethod())），即POST表示表單提交  
  5. if (isFormSubmission(request)) {  
  6.     try {  
  7.         Object command = getCommand(request);  
  8.         ServletRequestDataBinder binder = bindAndValidate(request, command);  
  9.         BindException errors = new BindException(binder.getBindingResult());  
  10.               //表單提交應該放到該方法實現  
  11.         return processFormSubmission(request, response, command, errors);  
  12.     }  
  13.     catch (HttpSessionRequiredException ex) {  
  14.               //省略部分程式碼  
  15.         return handleInvalidSubmit(request, response);  
  16.     }  
  17. }  
  18. else {  
  19.     //2、表示是表單展示，該方法又轉調showForm方法，因此我們需要覆蓋showForm來完成表單展示  
  20.     return showNewForm(request, response);  
  21. }  

 

    bindOnNewForm：是否在進行表單展示時繫結請求引數到表單物件，預設false，不繫結；

    sessionForm：session表單模式，如果開啟（true）則會將表單物件放置到session中，從而可以跨越多次請求保證資料不丟失（多步驟表單常使用該方式，詳解AbstractWizardFormController），預設false；

 

    Object formBackingObject(HttpServletRequest request) ：提供給表單展示時使用的表單物件（form object表單要展示的預設資料），預設通過commandName暴露到請求給展示表單；

    Map referenceData(HttpServletRequest request, Object command, Errors errors)：展示表單時需要的一些引用資料（比如使用者註冊，可能需要選擇工作地點，這些資料可以通過該方法提供），如：

 

java程式碼：
檢視複製到剪貼簿列印
  1. protected Map referenceData(HttpServletRequest request) throws Exception {  
  2.              Map model = new HashMap();  
  3.              model.put("cityList", cityList);  
  4.              return model;  
  5. }  

    這樣就可以在表單展示頁面獲取cityList資料。

 

SimpleFormController繼承該類，而且提供了更簡單的表單流程控制。

4.9、SimpleFormController

提供了更好的兩步表單支援：

1、準備要展示的資料，併到表單展示頁面；

2、提交資料資料進行處理。

 

第一步，展示：

 

第二步，提交表單：

接下來我們們寫一個使用者註冊的例子學習一下：

（1、控制器

 

java程式碼：
檢視複製到剪貼簿列印
  1. package cn.javass.chapter4.web.controller;  
  2. //省略import  
  3. public class RegisterSimpleFormController extends SimpleFormController {      
  4.     public RegisterSimpleFormController() {  
  5.         setCommandClass(UserModel.class); //設定命令物件實現類  
  6.         setCommandName("user");//設定命令物件的名字  
  7.     }  
  8.     //form object 表單物件，提供展示表單時的表單資料（使用commandName放入請求）  
  9.     protected Object formBackingObject(HttpServletRequest request) throws Exception {  
  10.         UserModel user = new UserModel();  
  11.         user.setUsername("請輸入使用者名稱");  
  12.         return user;  
  13.     }  
  14.     //提供展示表單時需要的一些其他資料    
  15.     protected Map referenceData(HttpServletRequest request) throws Exception {  
  16.         Map map = new HashMap();  
  17.         map.put("cityList", Arrays.asList("山東", "北京", "上海"));  
  18.         return map;  
  19.     }  
  20.     protected void doSubmitAction(Object command) throws Exception {  
  21.         UserModel user = (UserModel) command;  
  22.         //TODO 呼叫業務物件處理  
  23.         System.out.println(user);  
  24.     }  
  25. }  

 

setCommandClass和setCommandName：分別設定了命令物件的實現類和名字；

formBackingObject和referenceData：提供了表單展示需要的檢視；

doSubmitAction：用於執行表單提交動作，由onSubmit方法呼叫，如果不需要請求/響應物件或進行資料驗證，可以直接使用doSubmitAction方法進行功能處理。

（2、spring配置（chapter4-servlet.xml）


java程式碼：
檢視複製到剪貼簿列印
  1. <bean name="/simpleForm"   
  2. class="cn.javass.chapter4.web.controller.RegisterSimpleFormController">  
  3.         <property name="formView" value="register"/>  
  4.         <property name="successView" value="redirect:/success"/>  
  5. </bean>  
  6. <bean name="/success" class="cn.javass.chapter4.web.controller.SuccessController"/>  

formView：表示展示表單時顯示的頁面；

successView：表示處理成功時顯示的頁面；“redirect:/success”表示成功處理後重定向到/success控制器；防止表單重複提交；

“/success” bean的作用是顯示成功頁面，此處就不列舉了。

 

（3、檢視頁面

 

java程式碼：
檢視複製到剪貼簿列印
  1. <!-- register.jsp 註冊展示頁面-->  
  2. <form method="post">  
  3. username:<input type="text" name="username" value="${user.username}"><br/>  
  4. password:<input type="password" name="username"><br/>  
  5. city:<select>  
  6.   <c:forEach items="${cityList }" var="city">  
  7.    <option>${city}</option>  
  8.   </c:forEach>  
  9. </select><br/>  
  10. <input type="submit" value="註冊"/>  
  11. </form>  

此處可以使用${user.username}獲取到formBackingObject設定的表單物件、使用${cityList}獲取referenceData設定的表單支援資料；

 

到此一個簡單的兩步表單到此結束，但這個表單有重複提交表單的問題，而且表單物件到頁面的繫結是通過手工繫結的，後邊我們會學習spring標籤庫（提供自動繫結表單物件到頁面）。

4.10、CancellableFormController

一個可取消的表單控制器，繼承SimpleFormController，額外提供取消表單功能。

 

1、表單展示：和SimpleFormController一樣；

2、表單取消：和SimpleFormController一樣；

3、表單成功提交：取消功能處理方法為：onCancel(Object command)，而且預設返回cancelView屬性指定的邏輯檢視名。

   那如何判斷是取消呢？如果請求中有引數名為“_cancel”的引數，則表示表單取消。也可以通過cancelParamKey來修改引數名（如“_cancel.x”等）。

示例：

 

（1、控制器

複製RegisterSimpleFormController一份命名為CanCancelRegisterSimpleFormController，新增取消功能處理方法實現：

 

java程式碼：
檢視複製到剪貼簿列印
  1. @Override  
  2. protected ModelAndView onCancel(Object command) throws Exception {  
  3.     UserModel user = (UserModel) command;  
  4.     //TODO 呼叫業務物件處理  
  5.     System.out.println(user);  
  6.     return super.onCancel(command);  
  7. }  

onCancel：在該功能方法內實現取消邏輯，父類的onCancel方法預設返回cancelView屬性指定的邏輯檢視名。

 

（2、spring配置（chapter4-servlet.xml）

 

java程式碼：
檢視複製到剪貼簿列印
  1. <bean name="/canCancelForm"   
  2. class="cn.javass.chapter4.web.controller.CanCancelRegisterSimpleFormController">  
  3.         <property name="formView" value="register"/>  
  4.         <property name="successView" value="redirect:/success"/>  
  5.         <property name="cancelView" value="redirect:/cancel"/>  
  6. </bean>  
  7. <bean name="/cancel" class="cn.javass.chapter4.web.controller.CancelController"/>  

cancelParamKey：用於判斷是否是取消的請求引數名，預設是_cancel，即如果請求引數資料中含有名字_cancel則表示是取消，將呼叫onCancel功能處理方法；

cancelView：表示取消時時顯示的頁面；“redirect:/cancel”表示成功處理後重定向到/cancel控制器；防止表單重複提交；

“/cancel” bean的作用是顯示取消頁面，此處就不列舉了（詳見程式碼）。

（3、檢視頁面（修改register.jsp）


java程式碼：
檢視複製到剪貼簿列印
  1. <input type="submit" name="_cancel" value="取消"/>  


該提交按鈕的作用是取消，因為name="_cancel"，即請求後會有一個名字為_cancel的引數，因此會執行onCancel功能處理方法。

（4、測試：

在瀏覽器輸入“http://localhost:9080/springmvc-chapter4/canCancelForm”，則首先到展示檢視頁面，點選“取消按鈕”將重定向到“http://localhost:9080/springmvc-chapter4/cancel”，說明取消成功了。

 

 

實際專案可能會出現比如一些網站的完善個人資料都是多個頁面（即多步），那應該怎麼實現呢？接下來讓我們看一下spring Web MVC提供的對多步表單的支援類AbstractWizardFormController。



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

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

相關文章