4.5、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>
- <!— 在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)
- package cn.javass.chapter4.model;
- public class UserModel {
- private String username;
- private String password;
- //省略setter/getter
- }
2、實現控制器
- 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;
- }
- }
- <!— 在chapter4-servlet.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綁定到命令對象;綁定時按照JavaBean命名規範綁定;
4.8、AbstractFormController
用於支持帶步驟的表單提交的命令控制器基類,使用該控制器可以完成:
1、定義表單處理(表單的渲染),並從控制器獲取命令對象構建表單;
2、提交表單處理,當用戶提交表單內容後,AbstractFormController可以將用戶請求的數據綁定到命令對象,並可以驗證表單內容、對命令對象進行處理。
- @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):展示表單時需要的一些引用數據(比如用戶註冊,可能需要選擇工作地點,這些數據可以通過該方法提供),如:
- 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、控制器
- 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)
- <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、視圖頁面
- <!-- 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,添加取消功能處理方法實現:
- @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)
- <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)
- <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。