第四章 Controller介面控制器詳解(2)
4.5、ServletForwardingController
將接收到的請求轉發到一個命名的servlet,具體示例如下:
java程式碼: 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程式碼: 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程式碼: Java程式碼
- package cn.javass.chapter4.model;
- public class UserModel {
- private String username;
- private String password;
- //省略setter/getter
- }
2、實現控制器
java程式碼: 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程式碼: 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程式碼: 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程式碼: 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程式碼: 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程式碼: 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)
- <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程式碼: 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程式碼: 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程式碼: 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:表示取消時時顯示的頁面;