Controller接口控制器學習2

本文爲轉載學習

原文連接：http://jinnianshilongnian.iteye.com/blog/1611743

ServletForwardingController

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

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");
}
}

<servlet>
<servlet-name>forwarding</servlet-name>
        <servlet-class>cn.javass.chapter4.web.servlet.ForwardingServlet</servlet-class>
</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標籤配置是可選的。

BaseCommandController命令控制器通用基類，提供瞭如下功能支持：

一、數據綁定：請求參數綁定到一個command object（命令對象，非GoF裏的命令設計模式），這裏的命令對象是指綁定請求參數的任何POJO對象；

   commandClass：表示命令對象實現類，如UserModel；

   commandName：表示放入請求的命令對象名字（默認command），request.setAttribute(commandName, commandObject);

二、驗證功能：提供Validator註冊功能，註冊的驗證器會驗證命令對象屬性數據是否合法；

   validators：經過該屬性注入驗證器，驗證器用來驗證命令對象屬性是否合法；

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

AbstractCommandController

命令控制器之一，能夠實現該控制器來建立命令控制器，該控制器能把自動封裝請求參數到一個命令對象，並且提供了驗證功能

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

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

二、實現控制器

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;
}
}

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

<!— WEB-INF/jsp/abstractCommand.jsp視圖下的主要內容 -->   
${user.username }-${user.password }

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

AbstractFormController

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

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

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

@Override
protected ModelAndView handleRequestInternal(HttpServletRequest request, HttpServletResponse response)throws Exception {
    //一、是不是表單提交？ 該方法實現爲（"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 {
        //二、表示是表單展現，該方法又轉調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)：展現表單時須要的一些引用數據（好比用戶註冊，可能須要選擇工做地點，這些數據能夠經過該方法提供），如：

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

這樣就能夠在表單展現頁面獲取cityList數據。

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

SimpleFormController

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

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

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

第一步，展現：

第二步，提交表單：

接下來寫一個用戶註冊的例子：

一、控制器

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方法進行功能處理。

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

<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的做用是顯示成功頁面，此處就不列舉了。

 三、視圖頁面

<!-- 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標籤庫（提供自動綁定表單對象到頁面）。

CancellableFormController

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

一、表單展現：和SimpleFormController同樣；

二、表單取消：和SimpleFormController同樣；

三、表單成功提交：取消功能處理方法爲：onCancel(Object command)，並且默認返回cancelView屬性指定的邏輯視圖名。

那如何判斷是取消呢？若是請求中有參數名爲「_cancel」的參數，則表示表單取消。也能夠經過cancelParamKey來修改參數名（如「_cancel.x」等）。

示例：

一、控制器

複製RegisterSimpleFormController一份命名爲CanCancelRegisterSimpleFormController，添加取消功能處理方法實現：

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

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

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

<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的做用是顯示取消頁面，此處就不列舉了（詳見代碼）。

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

<input type="submit" name="_cancel" value="取消"/>

該提交按鈕的做用是取消，由於name="_cancel"，即請求後會有一個名字爲_cancel的參數，所以會執行onCancel功能處理方法。

四、測試：

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

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