第四章 Controller接口控制器詳解（2）

4.5、ServletForwardingController

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

 

java代碼：

package cn.javass.chapter4.web.servlet;
public class ForwardingServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp)
    throws ServletException, IOException {

        resp.getWriter().write("Controller forward to Servlet");

    }
}

 

java代碼：

<servlet>
    <servlet-name>forwarding</servlet-name>
    <servlet-class>cn.javass.chapter4.web.servlet.ForwardingServlet</servlet-class>
</servlet>

 

java代碼：

<!— 在chapter4-servlet.xml配置處理器 -->
<bean name="/forwardToServlet"
class="org.springframework.web.servlet.mvc.ServletForwardingController">
        <property name="servletName" value="forwarding"></property>
</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代碼：

package cn.javass.chapter4.model;
public class UserModel {
    private String username;
    private String password;
        //省略setter/getter
}

 

2、實現控制器

 

java代碼：

package cn.javass.chapter4.web.controller;
//省略import
public class MyAbstractCommandController extends AbstractCommandController {
    public MyAbstractCommandController() {
        //設置命令對象實現類
        setCommandClass(UserModel.class);
    }
    @Override
    protected ModelAndView handle(HttpServletRequest req, HttpServletResponse resp, Object command, BindException errors) throws Exception {
        //將命令對象轉換爲實際類型
        UserModel user = (UserModel) command;
        ModelAndView mv = new ModelAndView();
        mv.setViewName("abstractCommand");
        mv.addObject("user", user);
        return mv;
    }
}

 

java代碼：

<!— 在chapter4-servlet.xml配置處理器 -->
<bean name="/abstractCommand"
class="cn.javass.chapter4.web.controller.MyAbstractCommandController">
        <!-- 也可以通過依賴注入 注入命令實現類 -->
        <!-- property name="commandClass" value="cn.javass.chapter4.model.UserModel"/-->
</bean>

 

java代碼：

<!— WEB-INF/jsp/abstractCommand.jsp視圖下的主要內容 -->

${user.username }-${user.password }

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

4.8、AbstractFormController

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

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

2、提交表單處理，當用戶提交表單內容後，AbstractFormController可以將用戶請求的數據綁定到命令對象，並可以驗證表單內容、對命令對象進行處理。

 

java代碼：

      @Override
rotected ModelAndView handleRequestInternal(HttpServletRequest request, HttpServletResponse response)
    throws Exception {
     //1、是否是表單提交？ 該方法實現爲（"POST".equals(request.getMethod())），即POST表示表單提交
if (isFormSubmission(request)) {
    try {
        Object command = getCommand(request);
        ServletRequestDataBinder binder = bindAndValidate(request, command);
        BindException errors = new BindException(binder.getBindingResult());
              //表單提交應該放到該方法實現
        return processFormSubmission(request, response, command, errors);
    }
    catch (HttpSessionRequiredException ex) {
              //省略部分代碼
        return handleInvalidSubmit(request, response);
    }
}
else {
    //2、表示是表單展示，該方法又轉調showForm方法，因此我們需要覆蓋showForm來完成表單展示
    return showNewForm(request, response);
}

 

    bindOnNewForm：是否在進行表單展示時綁定請求參數到表單對象，默認false，不綁定；

    sessionForm：session表單模式，如果開啓（true）則會將表單對象放置到session中，從而可以跨越多次請求保證數據不丟失（多步驟表單常使用該方式，詳解AbstractWizardFormController），默認false；

 

    Object formBackingObject(HttpServletRequest request) ：提供給表單展示時使用的表單對象（form object表單要展示的默認數據），默認通過commandName暴露到請求給展示表單；

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

 

java代碼：

protected Map referenceData(HttpServletRequest request) throws Exception {
             Map model = new HashMap();
             model.put("cityList", cityList);
             return model;
}

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

 

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

4.9、SimpleFormController

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

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

2、提交數據數據進行處理。

 

第一步，展示：

 

第二步，提交表單：

接下來咱們寫一個用戶註冊的例子學習一下：

（1、控制器

 

java代碼：

package cn.javass.chapter4.web.controller;
//省略import
public class RegisterSimpleFormController extends SimpleFormController {
    public RegisterSimpleFormController() {
        setCommandClass(UserModel.class); //設置命令對象實現類
        setCommandName("user");//設置命令對象的名字
    }
    //form object 表單對象，提供展示表單時的表單數據（使用commandName放入請求）
    protected Object formBackingObject(HttpServletRequest request) throws Exception {
        UserModel user = new UserModel();
        user.setUsername("請輸入用戶名");
        return user;
    }
    //提供展示表單時需要的一些其他數據
    protected Map referenceData(HttpServletRequest request) throws Exception {
        Map map = new HashMap();
        map.put("cityList", Arrays.asList("山東", "北京", "上海"));
        return map;
    }
    protected void doSubmitAction(Object command) throws Exception {
        UserModel user = (UserModel) command;
        //TODO 調用業務對象處理
        System.out.println(user);
    }
}

 

setCommandClass和setCommandName：分別設置了命令對象的實現類和名字；

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

doSubmitAction：用於執行表單提交動作，由onSubmit方法調用，如果不需要請求/響應對象或進行數據驗證，可以直接使用doSubmitAction方法進行功能處理。

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

java代碼：

<bean name="/simpleForm"
class="cn.javass.chapter4.web.controller.RegisterSimpleFormController">
        <property name="formView" value="register"/>
        <property name="successView" value="redirect:/success"/>
</bean>
<bean name="/success" class="cn.javass.chapter4.web.controller.SuccessController"/>

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

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

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

 

（3、視圖頁面

 

java代碼：

<!-- register.jsp 註冊展示頁面-->
<form method="post">
username:<input type="text" name="username" value="${user.username}"><br/>
password:<input type="password" name="username"><br/>
city:<select>
  <c:forEach items="${cityList }" var="city">
   <option>${city}</option>
  </c:forEach>
</select><br/>
<input type="submit" value="註冊"/>
</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代碼：

@Override
protected ModelAndView onCancel(Object command) throws Exception {
    UserModel user = (UserModel) command;
    //TODO 調用業務對象處理
    System.out.println(user);
    return super.onCancel(command);
}

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

 

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

 

java代碼：

<bean name="/canCancelForm"
class="cn.javass.chapter4.web.controller.CanCancelRegisterSimpleFormController">
        <property name="formView" value="register"/>
        <property name="successView" value="redirect:/success"/>
        <property name="cancelView" value="redirect:/cancel"/>
</bean>
<bean name="/cancel" class="cn.javass.chapter4.web.controller.CancelController"/>

cancelParamKey：用於判斷是否是取消的請求參數名，默認是_cancel，即如果請求參數數據中含有名字_cancel則表示是取消，將調用onCancel功能處理方法；

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

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

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

java代碼：

<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】