第四章 Controller接口控制器详解（2）——跟着开涛学SpringMVC

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

评论

34 楼 corey_jk 2017-02-16  

mapc我 写道

比较头疼的是，spring4mvc，这里面很多类好像都没有了，这节没法用例子演示了，除非换成spring3的。不过为了方便学习，我还是换成3的演示一遍，加深理解 

开涛讲的这些类，在spring4.0基本都是显示过期了，所以JAR包里面都没有了。

33 楼 mapc我 2016-04-06  

比较头疼的是，spring4mvc，这里面很多类好像都没有了，这节没法用例子演示了，除非换成spring3的。不过为了方便学习，我还是换成3的演示一遍，加深理解 

32 楼 chengze0123 2015-10-27  

这个 springmvc jar是多少版本的呀

31 楼 machao299 2015-04-13  

jinnianshilongnian 写道

newboy2004 写道

继承SimpleFormController 没法重写OnCancel方法啊？？？

可以啊

应该是继承 CancellableFormController 重写 onCancel方法吧。
我自己写的例子继承SimpleFormController 也是不能重写 onCancel 方法。

30 楼 867530559 2014-10-20  

问一个问题：控制器在返回的ModelAndView对象中添加的Object，具体是放在哪里了？request肯定没有，只能通过EL表达式获取吗？

29 楼 jinnianshilongnian 2014-01-07  

wujin905 写道

我在运行您的示例的进候，总出现如下警告：
警告: No mapping found for HTTP request with URI [/springmvc-chapter4/simpleForm] in DispatcherServlet with name 'chapter4'
上网查过提示说可能web.xml里servlet醒置可能出现问题，但是改过很多方式都不行，不知道为什么？我的web.xml的醒置如下：
<servlet>
  <servlet-name>chapter4</servlet-name>
  <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  <init-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/chapter4-servlet.xml</param-value>
  </init-param>
  <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
  <servlet-name>chapter4</servlet-name>
  <url-pattern>/</url-pattern>
</servlet-mapping>

把代码站内信我 看下吧

28 楼 wujin905 2014-01-07  

我在运行您的示例的进候，总出现如下警告：
警告: No mapping found for HTTP request with URI [/springmvc-chapter4/simpleForm] in DispatcherServlet with name 'chapter4'
上网查过提示说可能web.xml里servlet醒置可能出现问题，但是改过很多方式都不行，不知道为什么？我的web.xml的醒置如下：
<servlet>
  <servlet-name>chapter4</servlet-name>
  <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  <init-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/chapter4-servlet.xml</param-value>
  </init-param>
  <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
  <servlet-name>chapter4</servlet-name>
  <url-pattern>/</url-pattern>
</servlet-mapping>

27 楼 jinnianshilongnian 2013-06-14  

newboy2004 写道

继承SimpleFormController 没法重写OnCancel方法啊？？？

可以啊

26 楼 newboy2004 2013-06-14  

继承SimpleFormController 没法重写OnCancel方法啊？？？

25 楼 jinnianshilongnian 2013-06-14  

newboy2004 写道

我问一下，这部分的转到成功或取消控制器的代码在哪里？？？

http://jinnianshilongnian.iteye.com/blog/1752171

24 楼 newboy2004 2013-06-14  

我问一下，这部分的转到成功或取消控制器的代码在哪里？？？

23 楼 jinnianshilongnian 2013-01-04  

关耳丘山川 写道

jinnianshilongnian 写道

关耳丘山川 写道

楼主，请问你有没有一些springMVC基本的项目（例如简单实现增删改查的例子）源代码可以参考一下，谢谢啊。。。

http://jinnianshilongnian.iteye.com/blog/1423971

非常感谢，对了，我真的好奇怪，我把你的项目导入，都有一个红色的x在项目名那里，但是下面就是没有提示哪出错。在tomcat也跑不起来。

都有一个红色的x在项目名那里 这个是eclipse验证如jsp等的问题，可以再validate下看看； 还可能是Java Build Path设置的问题

2、在tomcat也跑不起来 上异常

22 楼 关耳丘山川 2013-01-03  

jinnianshilongnian 写道

关耳丘山川 写道

楼主，请问你有没有一些springMVC基本的项目（例如简单实现增删改查的例子）源代码可以参考一下，谢谢啊。。。

http://jinnianshilongnian.iteye.com/blog/1423971

非常感谢，对了，我真的好奇怪，我把你的项目导入，都有一个红色的x在项目名那里，但是下面就是没有提示哪出错。在tomcat也跑不起来。

21 楼 jinnianshilongnian 2013-01-03  

关耳丘山川 写道

楼主，请问你有没有一些springMVC基本的项目（例如简单实现增删改查的例子）源代码可以参考一下，谢谢啊。。。

http://jinnianshilongnian.iteye.com/blog/1423971

20 楼 关耳丘山川 2013-01-02  

楼主，请问你有没有一些springMVC基本的项目（例如简单实现增删改查的例子）源代码可以参考一下，谢谢啊。。。

19 楼 dreampower 2012-12-30  

很不错的文章，很详细，看一次，顶一次，空溜溜的来，汲取了精华，说声谢谢，告知博主，  坦荡荡而去

18 楼 jinnianshilongnian 2012-12-23  

hxhnarkissos 写道

SimpleFormController已经不推荐使用了，有什么替代的么

直接看注解部分

17 楼 hxhnarkissos 2012-12-23  

SimpleFormController已经不推荐使用了，有什么替代的么

16 楼 jinnianshilongnian 2012-11-21  

縌流而上的魚 写道

freezingsky 写道

这一部分基于controller的，怪不得在3.0后提供了新的操作方式。如果一直是如此的话，估计用struts2的人还是会多些！

提供了什么新的操作方式啊？能简单说明下，或者有相关文章链接发下么？

注解方式 你到第六章看看

15 楼 縌流而上的魚 2012-11-21  

freezingsky 写道

这一部分基于controller的，怪不得在3.0后提供了新的操作方式。如果一直是如此的话，估计用struts2的人还是会多些！

提供了什么新的操作方式啊？能简单说明下，或者有相关文章链接发下么？