---
title: "Spring MVC 中的 MultiActionController 用法详解"
author: "mywebcode"
date: "2010-11-16T11:12:00Z"
tags: []
slug: "spring-mvc-multiactioncontroller"
draft: false
lastmod: "2013-05-08T10:38:52Z"
id: 1863296
url: "https://mywebcode.iteye.com/blog/1863296"
---

Spring MVC 中 Controller 的层次实在是多，有些眼花缭乱了。在单个的基础上，再新加两三个叫做丰富，再多就未必是好事，反而会令人缩手新闻片脚，无从定夺。多数 Controller 都是只完成一个任务，不过也有一个像 Struts 的 DispatchAction 的那样的 Conntroller，org.springframework.web.servlet.mvc.multiaction.MultiActionController，意即在一个 Controller 中处理多个动作，如同一个业务的增、删、改可以放在一起了。不至于增、删、改各自为政，造成代码混乱、重复难以维护。

本文中的 web.xml 的 org.springframework.web.servlet.DispatcherServlet 所处理的 url-pattern 是 \*.html，如何搭建 Spring MVC 项目不细加说明，可参考我前面同系列的文章。

例如，下面的 UserController，有两个签名一样的 updateUser() 和 deleteUser() 方法

01. **public** **class** UserController **extends** MultiActionController {
02. **public** ModelAndView updateUser(HttpServletRequest request,
03. HttpServletResponse response) {
04. System.out.println("updateUser");//方便于跟踪执行了哪个方法
05. **return** **new** ModelAndView("userList","from","updateUser");
06. }
07. **public** ModelAndView deleteUser(HttpServletRequest request,
08. HttpServletResponse response) {
09. System.out.println("deleteUser");//方便于跟踪执行了哪个方法
10. **return** **new** ModelAndView("userList","from","deleteUser");
11. }
12. }

用过 Struts 的 DispatchAction 的都知道，是通过 [http://.../userAction.do?method=updateUser](http://.../userAction.do?method=updateUser) 的方式来指定执行哪个方法。那 Spring MVC中是如何定位到所需方法上呢？

Spring MVC 除了有一个叫做 HandlerMapping(把 URL 解析到 Controller) 的东西，还要把操作进一步解析到方法名上，即要找到的 Controller 上的哪个方法并执行之。缺省的方法名解析器是 InternalPathMethodNameResolver，它根据 URL 样式解析方法名。

在缺省的 BeanNameUrlHandlerMapping 和缺省的 **InternalPathMethodNameResolver** 协调之下，Bean 上下文可以这样配置：

1. **&lt;bean** name="/updateUser.html" class="com.unmi.UserController"**/&gt;**
2. **&lt;bean** name="/deleteUser.html" class="com.unmi.UserController"**/&gt;**

&lt;bean name="/updateUser.html" class="com.unmi.UserController"/&gt; &lt;bean name="/deleteUser.html" class="com.unmi.UserController"/&gt;

这样分别通过下面的 URL 就能执行到正确的方法上去了：

[http://.../updateUser.html](http://.../updateUser.html) -- 将被 UserController.updateUser() 处理  
[http://.../deleteUser.html](http://.../deleteUser.html) -- 将被 UserController.deleteUser() 处理

但是，你应该注意到了，上面的 com.unmi.UserController 配置了两次，一来碍眼、二来原来只要 Singleton 的 UserController 实例不再是那么回事了。所以要引入 SimpleUrlHandlerMapping 对 Bean 配置进一步紧凑一下：

1. **&lt;bean** id="userController" class="com.unmi.UserController"**/&gt;**
2. **&lt;bean** id="simpleUrlMapping" class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping"**&gt;**
3. **&lt;property** name="mappings"**&gt;**
4. **&lt;props&gt;**
5. **&lt;prop** key="/updateUser.html"**&gt;**userController**&lt;/prop&gt;**
6. **&lt;prop** key="/deleteUser.html"**&gt;**userController**&lt;/prop&gt;**
7. **&lt;/props&gt;**
8. **&lt;/property&gt;**
9. **&lt;/bean&gt;**

说是紧凑，倒不如说 Bean 配置复杂了，反正不用配置两个相同的 UserController 实例了。还是通过上面那两个 URL 来访问执行到相应的方法。

除了缺省的方法名解析器 InternalPathMethodNameResolver(注意了，Spring 中缺省的 XXX 很多用 InternalXXX 的命名)，还有两种其他类型的方法名解析器：

·ParameterMethodNameResolver -- 根据请求中的参数解析执行方法名，相当于 Struts 的 DispathAction  
·PropertiesMethodNameResolver -- 根据查询一个 key/value 列表解析执行方法名，相当于 Struts 的 MappingDispatchAction(用得很少)

下面逐一介绍使用上面两种方法名解析器时的 Bean 配置及相应访问的 URL。

**使用 ParameterMethodNameResolver** 时的 Bean 配置(为简单起见，又用回了缺省的 HandlerMapping)：

01. **&lt;bean** name="/user.html" class="com.unmi.UserController"**&gt;**
02. **&lt;property** name="methodNameResolver"**&gt;**
03. **&lt;ref** bean="methodNameResolver"**/&gt;**
04. **&lt;/property&gt;**
05. **&lt;/bean&gt;**
06. **&lt;bean** name="methodNameResolver" class="org.springframework.web.servlet.mvc.multiaction.ParameterMethodNameResolver"**&gt;**
07. **&lt;property** name="paramName"**&gt;**
08. **&lt;value&gt;**method**&lt;/value&gt;**
09. **&lt;/property&gt;**
10. **&lt;/bean&gt;**

这时候分别用下面的 URL 就能访问到相应的方法

[http://.../user.html?method=updateUser](http://.../user.html?method=updateUser) -- 将被 UserController.updateUser() 处理  
[http://.../user.html?method=deleteUser](http://.../user.html?method=deleteUser) -- 将被 UserController.deleteUser() 处理

通过参数的方式使得 HTML 表单表现用户选择成为可能，例如把 method 参数可放在一个下拉框或隐藏域中。

**使用 PropertiesMethodNameResolver 时**的 Bean 配置

01. **&lt;bean** id="userController" class="com.unmi.UserController" **/&gt;**
02. **&lt;bean** id="simpleUrlMapping" class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping"**&gt;**
03. **&lt;property** name="mappings"**&gt;**
04. **&lt;props&gt;**
05. **&lt;prop** key="/updateUser.html"**&gt;**userController**&lt;/prop&gt;**
06. **&lt;prop** key="/deleteUser.html"**&gt;**userController**&lt;/prop&gt;**
07. **&lt;/props&gt;**
08. **&lt;/property&gt;**
09. **&lt;/bean&gt;**
10. **&lt;bean** id="methodNameResolver"class="org.springframework.web.servlet.mvc.multiaction.PropertiesMethodNameResolver"**&gt;**
11. **&lt;property** name="mappings"**&gt;**
12. **&lt;props&gt;**
13. **&lt;prop** key="/updateUser.html"**&gt;**updateUser**&lt;/prop&gt;**
14. **&lt;prop** key="/deleteUser.html"**&gt;**deleteUser**&lt;/prop&gt;**
15. **&lt;/props&gt;**
16. **&lt;/property&gt;**
17. **&lt;/bean&gt;**

这种配置有点复杂，PropertiesMethodNameResolver 不仅与 SimpleUrlHandlerMapping 相仿又有重叠，而且必须把 SimpleUrlHandlerMapping 拉进来，无法使用默认的 HandlerMapping。从上面的配置我们可以明显的看出 HandlerMapping 和 MethodNameResolver 不同职责了，一个是定位 Controller，一个是定位 Method。

这时候分别用下面的 URL 来访问到相应 Controller 的方法

[http://.../updateUser.html](http://.../updateUser.html) -- 将被 UserController.updateUser() 处理  
[http://.../deleteUser.html](http://.../deleteUser.html) -- 将被 UserController.deleteUser() 处理

这里的 URL 恰巧和使用 InternalPathMethodNameResolver 时是一样的，但一定要理解其实他们的机制是一样的。

PropertiesMethodNameResolver 把事性搞这么复杂，被誉为最复杂的方法名解析器。可我还真看不出它还有什么独到之处，或值得一用的理由，同时也不难理解 Struts 的 MappingDispatchAction 鲜为人知的缘由了。