• 欢迎访问web前端中文站,JavaScript,CSS3,HTML5,web前端demo
  • 如果您觉得本站非常有看点,那么赶紧使用Ctrl+D 收藏web前端中文站吧

SpringMVC中的MultiActionController控制器

JAVA web前端中文站 3年前 (2017-07-24) 1033次浏览 已收录 0个评论

前面我们学过的控制器如 AbstractCommandController、SimpleFormController 等一般对应一个功能处理方法(如新增),如果我要实现比如最简单的用户增删改查(CRUD Create-Read-Update-Delete),那该怎么办呢?

更多精彩内容请看 web 前端中文站
http://www.lisa33xiaoq.net 可按 Ctrl + D 进行收藏

每一个功能对应一个控制器,如果是 CRUD 则需要四个控制器,但这样我们的控制器会暴增,肯定不可取;

使用 Spring Web MVC 提供的 MultiActionController,用于支持在一个控制器里添加多个功能处理方法,即将多个请求的处理方法放置到一个控制器里,这种方式不错。

MultiActionController 如何将不同的请求映射不同的请求的功能处理方法呢?

Spring Web MVC 提供了 MethodNameResolver(方法名解析器)用于解析当前请求到需要执行的功能处理方法的方法名。默认使用 InternalPathMethodNameResolver 实现类,另外还提供了 ParameterMethodNameResolver 和 PropertiesMethodNameResolver,当然我们也可以自己来实现,稍候我们仔细研究下它们是如何工作的。

那我们的功能处理方法应该怎么写呢?

 public (ModelAndView | Map | String | void) actionName(HttpServletRequest request, HttpServletResponse response, [,HttpSession session] [,AnyObject]);

按照如上格式写我们的功能处理方法即可;此处需要注意一下几点:

返回值:即模型和视图部分。

  • ModelAndView:模型和视图部分,之前已经见过了;
  • Map:只返回模型数据,逻辑视图名会根据 RequestToViewNameTranslator 实现类来计算,稍候讨论;
  • String:只返回逻辑视图名;
  • void:表示该功能方法直接写出 response 响应(如果其他返回值类型(如 Map)返回 null 则和 void 进行相同的处理);

actionName:功能方法名字;由 methodNameResolver 根据请求信息解析功能方法名,通过反射调用;
形参列表:顺序固定,“[]”表示可选,我们来看看几个示例吧:

 //表示到新增页面 public ModelAndView toAdd(HttpServletRequest request, HttpServletResponse response); //表示新增表单提交,在最后可以带着命令对象 public ModelAndView add(HttpServletRequest request, HttpServletResponse response, UserModel user); //列表,但只返回模型数据,视图名会通过 RequestToViewNameTranslator 实现来计算 public Map list(HttpServletRequest request, HttpServletResponse response); //文件下载,返回值类型为 void,表示该功能方法直接写响应 public void fileDownload(HttpServletRequest request, HttpServletResponse response) //第三个参数可以是 session public ModelAndView sessionWith(HttpServletRequest request, HttpServletResponse response, HttpSession session); //如果第三个参数是 session,那么第四个可以是命令对象,顺序必须是如下顺序 public void sessionAndCommandWith(HttpServletRequest request, HttpServletResponse response, HttpSession session, UserModel user)

异常处理方法,MultiActionController 提供了简单的异常处理,即在请求的功能处理过程中遇到异常会交给异常处理方法进行处理,式如下所示:

 public ModelAndView anyMeaningfulName(HttpServletRequest request, HttpServletResponse response, ExceptionClass exception)

MultiActionController 会使用最接近的异常类型来匹配对应的异常处理方法,示例如下所示:

 //处理 PayException public ModelAndView processPayException(HttpServletRequest request, HttpServletResponse response, PayException ex) //处理 Exception public ModelAndView processException(HttpServletRequest request, HttpServletResponse response,  Exception ex)

MultiActionController 类实现

类定义:public class MultiActionController extends AbstractController implements LastModified ,继承了 AbstractController,并实现了 LastModified 接口,默认返回-1;

核心属性:

  • delegate:功能处理的委托对象,即我们要调用请求处理方法所在的对象,默认是 this;
  • methodNameResolver:功能处理方法名解析器,即根据请求信息来解析需要执行的 delegate 的功能处理方法的方法名。

核心方法:

 //判断方法是否是功能处理方法   private boolean isHandlerMethod(Method method) {       //得到方法返回值类型       Class returnType = method.getReturnType();       //返回值类型必须是 ModelAndView、Map、String、void 中的一种,否则不是功能处理方法       if (ModelAndView.class.equals(returnType) || Map.class.equals(returnType) || String.class.equals(returnType) ||               void.class.equals(returnType)) {           Class[] parameterTypes = method.getParameterTypes();           //功能处理方法参数个数必须>=2,且第一个是 HttpServletRequest 类型、第二个是 HttpServletResponse           //且不能 Controller 接口的 handleRequest(HttpServletRequest request, HttpServletResponse response),这个方法是由系统调用           return (parameterTypes.length >= 2 &&                   HttpServletRequest.class.equals(parameterTypes[0]) &&                   HttpServletResponse.class.equals(parameterTypes[1]) &&                   !("handleRequest".equals(method.getName()) && parameterTypes.length == 2));       }       return false;   }
 //是否是异常处理方法   private boolean isExceptionHandlerMethod(Method method) {       //异常处理方法必须是功能处理方法 且 参数长度为 3、第三个参数类型是 Throwable 子类       return (isHandlerMethod(method) &&               method.getParameterTypes().length == 3 &&               Throwable.class.isAssignableFrom(method.getParameterTypes()[2]));   } 
 private void registerHandlerMethods(Object delegate) {       //缓存 Map 清空       this.handlerMethodMap.clear();       this.lastModifiedMethodMap.clear();       this.exceptionHandlerMap.clear();          //得到委托对象的所有 public 方法       Method[] methods = delegate.getClass().getMethods();       for (Method method : methods) {           //验证是否是异常处理方法,如果是放入 exceptionHandlerMap 缓存 map           if (isExceptionHandlerMethod(method)) {               registerExceptionHandlerMethod(method);           }           //验证是否是功能处理方法,如果是放入 handlerMethodMap 缓存 map           else if (isHandlerMethod(method)) {               registerHandlerMethod(method);               registerLastModifiedMethodIfExists(delegate, method);           }       }   }  
 protected ModelAndView handleRequestInternal(HttpServletRequest request, HttpServletResponse response)           throws Exception {       try {           //1、使用 methodNameResolver 方法名解析器根据请求解析到要执行的功能方法的方法名           String methodName = this.methodNameResolver.getHandlerMethodName(request);           //2、调用功能方法(通过反射调用,此处就粘贴代码了)           return invokeNamedMethod(methodName, request, response);       }       catch (NoSuchRequestHandlingMethodException ex) {           return handleNoSuchRequestHandlingMethod(ex, request, response);       }   }  

接下来,我们看一下 MultiActionController 如何使用 MethodNameResolver 来解析请求到功能处理方法的方法名。

MethodNameResolver

  • InternalPathMethodNameResolver:MultiActionController 的默认实现,提供从请求 URL 路径解析功能方法的方法名,从请求的最后一个路径(/)开始,并忽略扩展名;如请求 URL 是“/user/list.html”,则解析的功能处理方法名为“list”,即调用 list 方法。该解析器还可以指定前缀和后缀,通过 prefix 和 suffix 属性,如指定 prefix=”test_”,则功能方法名将变为 test_list;
  • ParameterMethodNameResolver:提供从请求参数解析功能处理方法的方法名,并按照如下顺序进行解析:

methodParamNames:根据请求的参数名解析功能方法名(功能方法名和参数名同名)

 <property name="methodParamNames" value="list,create,update"/>

如上配置时,如果请求中含有参数名 list、create、update 时,则功能处理方法名为 list、create、update,这种方式的可以在当一个表单有多个提交按钮时使用,不同的提交按钮名字不一样即可。
ParameterMethodNameResolver 也考虑到图片提交按钮提交问题:

<input type="image" name="list"> 和 submit 类似可以提交表单,单击该图片后会发送两个参数“list.x=x 轴坐标”和“list.y=y 轴坐标”(如提交后会变为 list.x=7&list.y=5);因此我们配置的参数名(如 list)在会加上“.x” 和 “.y”进行匹配。

 for (String suffix : SUBMIT_IMAGE_SUFFIXES)  {//SUBMIT_IMAGE_SUFFIXES {“.x”, “.y”}       if (request.getParameter(name + suffix) != null) {// name 是我们配置的 methodParamNames           return true;       }   }  

paramName:根据请求参数名的值解析功能方法名,默认的参数名是 action,即请求的参数中含有“action=query”,则功能处理方法名为 query;
logicalMappings:逻辑功能方法名到真实功能方法名映射,如下所示:

 <property name="logicalMappings">       <props>           <prop key="doList">list</prop>       </props>   </property>

即如果步骤 1 或 2 解析出逻辑功能方法名为 doList(逻辑的),将会被重新映射为 list 功能方法名(真正执行的)。
defaultMethodName:默认的方法名,当以上策略失败时默认调用的方法名。

PropertiesMethodNameResolver:提供自定义的从请求 URL 解析功能方法的方法名,使用一组用户自定义的模式到功能方法名的映射,映射使用 Properties 对象存放,具体配置示例如下:

 <bean id="propertiesMethodNameResolver" class="org.springframework.web.servlet.mvc.multiaction.PropertiesMethodNameResolver">     <property name="mappings">         <props>               <prop key="/create">create</prop>               <prop key="/update">update</prop>               <prop key="/delete">delete</prop>               <prop key="/list">list</prop>               <!-- 默认的行为 -->               <prop key="/**">list</prop>         </props>     </property> </bean>

对于/create 请求将调用 create 方法,Spring 内部使用 PathMatcher 进行匹配(默认实现是 AntPathMatcher)。

RequestToViewNameTranslator

用于直接将请求转换为逻辑视图名。默认实现为 DefaultRequestToViewNameTranslator。

DefaultRequestToViewNameTranslator:将请求 URL 转换为逻辑视图名,默认规则如下:

http://localhost:9080/web 上下文/list ——-> 逻辑视图名为 list
http://localhost:9080/web 上下文/list.html ——-> 逻辑视图名为 list(默认删除扩展名)
http://localhost:9080/web 上下文/user/list.html ——-> 逻辑视图名为 user/list

控制器 UserController

 package com.lisa33xiaoq.net.chapter4.web.controller;   //省略 import   public class UserController extends MultiActionController {       //用户服务类       private UserService userService;       //逻辑视图名 通过依赖注入方式注入,可配置       private String createView;       private String updateView;       private String deleteView;       private String listView;       private String redirectToListView;       //省略 setter/getter       public String create(HttpServletRequest request, HttpServletResponse response, UserModel user) {           if("GET".equals(request.getMethod())) {               //如果是 get 请求 我们转向 新增页面               return getCreateView();           }           userService.create(user);           //直接重定向到列表页面           return getRedirectToListView();       }       public ModelAndView update(HttpServletRequest request, HttpServletResponse response, UserModel user) {           if("GET".equals(request.getMethod())) {               //如果是 get 请求 我们转向更新页面               ModelAndView mv = new ModelAndView();               //查询要更新的数据               mv.addObject("command", userService.get(user.getUsername()));               mv.setViewName(getUpdateView());               return mv;           }           userService.update(user);           //直接重定向到列表页面           return new ModelAndView(getRedirectToListView());       }     public ModelAndView delete(HttpServletRequest request, HttpServletResponse response, UserModel user) {           if("GET".equals(request.getMethod())) {               //如果是 get 请求 我们转向删除页面               ModelAndView mv = new ModelAndView();               //查询要删除的数据               mv.addObject("command", userService.get(user.getUsername()));               mv.setViewName(getDeleteView());               return mv;           }           userService.delete(user);           //直接重定向到列表页面           return new ModelAndView(getRedirectToListView());       }          public ModelAndView list(HttpServletRequest request, HttpServletResponse response) {           ModelAndView mv = new ModelAndView();           mv.addObject("userList", userService.list());           mv.setViewName(getListView());           return mv;       }       //如果使用委托方式,命令对象名称只能是 command       protected String getCommandName(Object command) {           //命令对象的名字 默认 command           return "command";       }   }  

增删改:如果是 GET 请求方法,则表示到展示页面,POST 请求方法表示真正的功能操作;
getCommandName:表示是命令对象名字,默认 command,对于委托对象实现方式无法改变,因此我们就使用默认的吧。

spring 配置文件 chapter4-servlet.xml

 <bean id="userService" class="com.lisa33xiaoq.net.chapter4.service.UserService"/>   <bean name="/user/**" class="com.lisa33xiaoq.net.chapter4.web.controller.UserController">       <property name="userService" ref="userService"/>       <property name="createView" value="user/create"/>       <property name="updateView" value="user/update"/>       <property name="deleteView" value="user/delete"/>       <property name="listView" value="user/list"/>       <property name="redirectToListView" value="redirect:/user/list"/>       <!-- 使用 PropertiesMethodNameResolver 来解析功能处理方法名 -->              <!--property name="methodNameResolver" ref="propertiesMethodNameResolver"/-->   </bean> 
  • userService:用户服务类,实现业务逻辑;
  • 依赖注入:对于逻辑视图页面通过依赖注入方式注入,redirectToListView 表示增删改成功后重定向的页面,防止重复表单提交;默认使用 InternalPathMethodNameResolver 解析请求 URL 到功能方法名。

list 页面(WEB-INF/jsp/user/list.jsp)

 <a href="${pageContext.request.contextPath}/user/create">用户新增</a><br/>   <table border="1" width="50%">      <tr>         <th>用户名</th>         <th>真实姓名</th>         <th>操作</th>      </tr>       <c:forEach items="${userList}" var="user">      <tr>         <td>${user.username }</td>         <td>${user.realname }</td>         <td>             <a href="${pageContext.request.contextPath}/user/update?username=${user.username}">更新</a>             |             <a href="${pageContext.request.contextPath}/user/delete?username=${user.username}">删除</a>         </td>      </tr>      </c:forEach>      </table>  

update 页面(WEB-INF/jsp/user/update.jsp)

 <form action="${pageContext.request.contextPath}/user/update" method="post">   用户名: <input type="text" name="username" value="${command.username}"/><br/>   真实姓名:<input type="text" name="realname" value="${command.realname}"/><br/>   <input type="submit" value="更新"/>   </form>  

默认的 InternalPathMethodNameResolver 将进行如下解析:
http://localhost:9080/springmvc-chapter4/user/list————>list 方法名;
http://localhost:9080/springmvc-chapter4/user/create————>create 方法名;
http://localhost:9080/springmvc-chapter4/user/update————>update 功能处理方法名;
http://localhost:9080/springmvc-chapter4/user/delete————>delete 功能处理方法名。

我们可以将默认的 InternalPathMethodNameResolver 改为 PropertiesMethodNameResolver:

 <bean id="propertiesMethodNameResolver"    class="org.springframework.web.servlet.mvc.multiaction.PropertiesMethodNameResolver">       <property name="mappings">           <props>                 <prop key="/user/create">create</prop>                 <prop key="/user/update">update</prop></span>                 <prop key="/user/delete">delete</prop></span>                 <prop key="/user/list">list</prop></span>                 <prop key="/**">list</prop><!-- 默认的行为 -->             </props>       </property>       <property name="alwaysUseFullPath" value="false"/><!-- 不使用全路径 -->   </bean>      <bean name="/user/**" class="com.lisa33xiaoq.net.chapter4.web.controller.UserController">    <!—省略其他配置,详见配置文件-->    <!-- 使用 PropertiesMethodNameResolver 来解析功能处理方法名 -->           <property name="methodNameResolver" ref="propertiesMethodNameResolver"/>   </bean>

/**表示默认解析到 list 功能处理方法。
如上配置方式可以很好的工作,但必须继承 MultiActionController,Spring Web MVC 提供给我们无需继承 MultiActionController 实现方式,即使有委托对象方式,继续往下看吧。

控制器 UserDelegate 将 UserController 复制一份,改名为 UserDelegate,并把继承 MultiActionController 去掉即可,其他无需改变。

spring 配置文件 chapter4-servlet.xml

 <!—委托对象-->   <bean id="userDelegate" class="com.lisa33xiaoq.net.chapter4.web.controller.UserDelegate">      <property name="userService" ref="userService"/>      <property name="createView" value="user2/create"/>      <property name="updateView" value="user2/update"/>      <property name="deleteView" value="user2/delete"/>      <property name="listView" value="user2/list"/>      <property name="redirectToListView" value="redirect:/user2/list"/>   </bean>   <!—控制器对象-->   <bean name="/user2/**"    class="org.springframework.web.servlet.mvc.multiaction.MultiActionController">   <property name="delegate" ref="userDelegate"/>       <property name="methodNameResolver" ref="parameterMethodNameResolver"/>   </bean>  
  • delegate:控制器对象通过 delegate 属性指定委托对象,即实际调用 delegate 委托对象的功能方法。
  • methodNameResolver:此处我们使用 ParameterMethodNameResolver 解析器;
 <!—ParameterMethodNameResolver --> <bean id="parameterMethodNameResolver" class="org.springframework.web.servlet.mvc.multiaction.ParameterMethodNameResolver"> <!-- 1、根据请求参数名解析功能方法名 -->       <property name="methodParamNames" value="create,update,delete"/>       <!-- 2、根据请求参数名的值解析功能方法名 -->       <property name="paramName" value="action"/>   <!-- 3、逻辑方法名到真实方法名的映射 -->       <property name="logicalMappings">          <props>              <prop key="doList">list</prop>          </props>       </property>       <!—4、默认执行的功能处理方法 -->       <property name="defaultMethodName" value="list"/>   </bean>
  • methodParamNames:create,update,delete,当请求中有参数名为这三个的将被映射为功能方法名,如“<input type="submit" name="create" value="新增"/>”提交后解析得到的功能方法名为 create;
  • paramName:当请求中有参数名为 action,则将值映射为功能方法名,如“<input type="hidden" name="action" value="delete"/>”,提交后解析得到的功能方法名为 delete;
  • logicalMappings:逻辑功能方法名到真实功能方法名的映射,如:http://localhost:9080/springmvc-chapter4/user2?action=doList;首先请求参数“action=doList”,则第二步解析得到逻辑功能方法名为 doList;本步骤会把 doList 再转换为真实的功能方法名 list。
  • defaultMethodName:以上步骤如果没有解析到功能处理方法名,默认执行的方法名。

list 页面(WEB-INF/jsp/user2/list.jsp)

 <a href="${pageContext.request.contextPath}/user2?action=create">用户新增</a><br/>   <table border="1" width="50%">      <tr>         <th>用户名</th>         <th>真实姓名</th>         <th>操作</th>      </tr>       <c:forEach items="${userList}" var="user">      <tr>         <td>${user.username }</td>         <td>${user.realname }</td>         <td>             <a href="${pageContext.request.contextPath}/user2?action=update&username=${user.username}">更新</a>             |             <a href="${pageContext.request.contextPath}/user2?action=delete&username=${user.username}">删除</a>         </td>      </tr>      </c:forEach>      </table>   

update 页面(WEB-INF/jsp/user2/update.jsp)

 <form action="${pageContext.request.contextPath}/user2" method="post">   <input type="hidden" name="action" value="update"/>   用户名: <input type="text" name="username" value="${command.username}"/><br/>   真实姓名:<input type="text" name="realname" value="${command.realname}"/><br/>   <input type="submit" value="更新"/>   </form> 

通过参数 name="action" value="update"来指定要执行的功能方法名 update。

create 页面(WEB-INF/jsp/user2/create.jsp)

 <form action="${pageContext.request.contextPath}/user2" method="post">   用户名: <input type="text" name="username" value="${command.username}"/><br/>   真实姓名:<input type="text" name="realname" value="${command.realname}"/><br/>   <input type="submit" name="create" value="新增"/>   </form>  

通过参数 name="create"来指定要执行的功能方法名 create。

使用 ParameterMethodNameResolver 将进行如下解析:
http://localhost:9080/springmvc-chapter4/user2?create      ————>create 功能处理方法名(参数名映射);
http://localhost:9080/springmvc-chapter4/user2?action=create————>create 功能处理方法名(参数值映射);
http://localhost:9080/springmvc-chapter4/user2?update      ————>update 功能处理方法名;
http://localhost:9080/springmvc-chapter4/user2?action=update————>update 功能处理方法名;
http://localhost:9080/springmvc-chapter4/user2?delete      ————>delete 功能处理方法名;
http://localhost:9080/springmvc-chapter4/user2?action=delete————>delete 功能处理方法名;
http://localhost:9080/springmvc-chapter4/user2?doList      ————>通过 logicalMappings 解析为 list 功能处理方法。
http://localhost:9080/springmvc-chapter4/user2?action=doList————>通过 logicalMappings 解析为 list 功能处理方法。
http://localhost:9080/springmvc-chapter4/user2————>默认的功能处理方法名 list(默认)。

【注:本文源自网络文章资源,由站长整理发布】


web 前端中文站 , 版权所有丨如未注明 , 均为原创丨本网站采用BY-NC-SA协议进行授权
转载请注明原文链接:SpringMVC 中的 MultiActionController 控制器
喜欢 (0)
发表我的评论
取消评论
表情 贴图 加粗 删除线 居中 斜体 签到

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址