第四章 Controller接口控制器详解(5)
2015-12-22 15:51
260 查看
4.15、MultiActionController
之前学过的控制器如AbstractCommandController、SimpleFormController等一般对应一个功能处理方法(如新增),如果我要实现比如最简单的用户增删改查(CRUDCreate-Read-Update-Delete),那该怎么办呢?4.15.1解决方案
1、每一个功能对应一个控制器,如果是CRUD则需要四个控制器,但这样我们的控制器会暴增,肯定不可取;2、使用SpringWebMVC提供的MultiActionController,用于支持在一个控制器里添加多个功能处理方法,即将多个请求的处理方法放置到一个控制器里,这种方式不错。
4.15.2问题
1、MultiActionController如何将不同的请求映射不同的请求的功能处理方法呢?SpringWebMVC提供了MethodNameResolver(方法名解析器)用于解析当前请求到需要执行的功能处理方法的方法名。默认使用InternalPathMethodNameResolver实现类,另外还提供了ParameterMethodNameResolver和PropertiesMethodNameResolver,当然我们也可以自己来实现,稍候我们仔细研究下它们是如何工作的。
2、那我们的功能处理方法应该怎么写呢?
public(ModelAndView|Map|String|void)actionName(HttpServletRequestrequest,HttpServletResponseresponse,[,HttpSessionsession][,AnyObject]);
哦,原来如此,我们只需要按照如上格式写我们的功能处理方法即可;此处需要注意一下几点:
1、返回值:即模型和视图部分;
ModelAndView:模型和视图部分,之前已经见过了;
Map:只返回模型数据,逻辑视图名会根据RequestToViewNameTranslator实现类来计算,稍候讨论;
String:只返回逻辑视图名;
void:表示该功能方法直接写出response响应(如果其他返回值类型(如Map)返回null则和void进行相同的处理);
2、actionName:功能方法名字;由methodNameResolver根据请求信息解析功能方法名,通过反射调用;
3、形参列表:顺序固定,“[]”表示可选,我们来看看几个示例吧:
//表示到新增页面
publicModelAndViewtoAdd(HttpServletRequestrequest,HttpServletResponseresponse);
//表示新增表单提交,在最后可以带着命令对象
publicModelAndViewadd(HttpServletRequestrequest,HttpServletResponseresponse,UserModeluser);
//列表,但只返回模型数据,视图名会通过RequestToViewNameTranslator实现来计算
publicMaplist(HttpServletRequestrequest,HttpServletResponseresponse);
//文件下载,返回值类型为void,表示该功能方法直接写响应
publicvoidfileDownload(HttpServletRequestrequest,HttpServletResponseresponse)
//第三个参数可以是session
publicModelAndViewsessionWith(HttpServletRequestrequest,HttpServletResponseresponse,HttpSessionsession);
//如果第三个参数是session,那么第四个可以是命令对象,顺序必须是如下顺序
publicvoidsessionAndCommandWith(HttpServletRequestrequest,HttpServletResponseresponse,HttpSessionsession,UserModeluser)
4、异常处理方法,MultiActionController提供了简单的异常处理,即在请求的功能处理过程中遇到异常会交给异常处理方法进行处理,式如下所示:
publicModelAndViewanyMeaningfulName(HttpServletRequestrequest,HttpServletResponseresponse,ExceptionClassexception)
MultiActionController会使用最接近的异常类型来匹配对应的异常处理方法,示例如下所示:
//处理PayException
publicModelAndViewprocessPayException(HttpServletRequestrequest,HttpServletResponseresponse,PayExceptionex)
//处理Exception
publicModelAndViewprocessException(HttpServletRequestrequest,HttpServletResponseresponse,Exceptionex)
4.15.3MultiActionController类实现
类定义:publicclassMultiActionControllerextendsAbstractControllerimplementsLastModified,继承了AbstractController,并实现了LastModified接口,默认返回-1;核心属性:
delegate:功能处理的委托对象,即我们要调用请求处理方法所在的对象,默认是this;
methodNameResolver:功能处理方法名解析器,即根据请求信息来解析需要执行的delegate的功能处理方法的方法名。
核心方法:
Java代码
//判断方法是否是功能处理方法
privatebooleanisHandlerMethod(Methodmethod){
//得到方法返回值类型
ClassreturnType=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(HttpServletRequestrequest,HttpServletResponseresponse),这个方法是由系统调用
return(parameterTypes.length>=2&&
HttpServletRequest.class.equals(parameterTypes[0])&&
HttpServletResponse.class.equals(parameterTypes[1])&&
!("handleRequest".equals(method.getName())&¶meterTypes.length==2));
}
returnfalse;
}
Java代码
//是否是异常处理方法
privatebooleanisExceptionHandlerMethod(Methodmethod){
//异常处理方法必须是功能处理方法且参数长度为3、第三个参数类型是Throwable子类
return(isHandlerMethod(method)&&
method.getParameterTypes().length==3&&
Throwable.class.isAssignableFrom(method.getParameterTypes()[2]));
}
Java代码
privatevoidregisterHandlerMethods(Objectdelegate){
//缓存Map清空
this.handlerMethodMap.clear();
this.lastModifiedMethodMap.clear();
this.exceptionHandlerMap.clear();
//得到委托对象的所有public方法
Method[]methods=delegate.getClass().getMethods();
for(Methodmethod:methods){
//验证是否是异常处理方法,如果是放入exceptionHandlerMap缓存map
if(isExceptionHandlerMethod(method)){
registerExceptionHandlerMethod(method);
}
//验证是否是功能处理方法,如果是放入handlerMethodMap缓存map
elseif(isHandlerMethod(method)){
registerHandlerMethod(method);
registerLastModifiedMethodIfExists(delegate,method);
}
}
}
Java代码
protectedModelAndViewhandleRequestInternal(HttpServletRequestrequest,HttpServletResponseresponse)
throwsException{
try{
//1、使用methodNameResolver方法名解析器根据请求解析到要执行的功能方法的方法名
StringmethodName=this.methodNameResolver.getHandlerMethodName(request);
//2、调用功能方法(通过反射调用,此处就粘贴代码了)
returninvokeNamedMethod(methodName,request,response);
}
catch(NoSuchRequestHandlingMethodExceptionex){
returnhandleNoSuchRequestHandlingMethod(ex,request,response);
}
}
接下来,我们看一下MultiActionController如何使用
MethodNameResolver来解析请求到功能处理方法的方法名。
4.15.4MethodNameResolver
1、InternalPathMethodNameResolver:
MultiActionController的默认实现,提供从请求URL路径解析功能方法的方法名,从请求的最后一个路径(/)开始,并忽略扩展名;如请求URL是“/user/list.html”,则解析的功能处理方法名为“list”,即调用list方法。该解析器还可以指定前缀和后缀,通过prefix和suffix属性,如指定prefix=”test_”,则功能方法名将变为test_list;
2、ParameterMethodNameResolver:
提供从请求参数解析功能处理方法的方法名,并按照如下顺序进行解析:
(1、
methodParamNames:
根据请求的参数名解析功能方法名(功能方法名和参数名同名);
Java代码
<propertyname="methodParamNames"value="list,create,update"/>
如上配置时,如果请求中含有参数名list、create、update时,则功能处理方法名为list、create、update,这种方式的可以在当一个表单有多个提交按钮时使用,不同的提交按钮名字不一样即可。
ParameterMethodNameResolver也考虑到图片提交按钮提交问题:
<inputtype="image"name="list">和submit类似可以提交表单,单击该图片后会发送两个参数“list.x=x轴坐标”和“list.y=y轴坐标”(如提交后会变为list.x=7&list.y=5);因此我们配置的参数名(如list)在会加上“.x”和“.y”进行匹配。
Java代码
for(Stringsuffix:SUBMIT_IMAGE_SUFFIXES){//SUBMIT_IMAGE_SUFFIXES{“.x”,“.y”}
if(request.getParameter(name+suffix)!=null){//name是我们配置的methodParamNames
returntrue;
}
}
(2、paramName:
根据请求参数名的值解析功能方法名,默认的参数名是action,即请求的参数中含有“action=query”,则功能处理方法名为query;
(3、logicalMappings:
逻辑功能方法名到真实功能方法名映射,如下所示:
Java代码
<propertyname="logicalMappings">
<props>
<propkey="doList">list</prop>
</props>
</property>
即如果步骤1或2解析出逻辑功能方法名为doList(逻辑的),将会被重新映射为list功能方法名(真正执行的)。
(4、defaultMethodName:
默认的方法名,当以上策略失败时默认调用的方法名。
3、PropertiesMethodNameResolver:
提供自定义的从请求URL解析功能方法的方法名,使用一组用户自定义的模式到功能方法名的映射,映射使用Properties对象存放,具体配置示例如下:
Java代码
<beanid="propertiesMethodNameResolver"
class="org.springframework.web.servlet.mvc.multiaction.PropertiesMethodNameResolver">
<propertyname="mappings">
<props>
<propkey="/create">create</prop>
<propkey="/update">update</prop>
<propkey="/delete">delete</prop>
<propkey="/list">list</prop>
<!--默认的行为-->
<propkey="/**">list</prop>
</props>
</property>
</bean>
对于/create请求将调用create方法,Spring内部使用PathMatcher进行匹配(默认实现是AntPathMatcher)。
4.15.5RequestToViewNameTranslator
用于直接将请求转换为逻辑视图名。默认实现为DefaultRequestToViewNameTranslator。
1、DefaultRequestToViewNameTranslator:
将请求URL转换为逻辑视图名,默认规则如下:
http://localhost:9080/web上下文/list------->逻辑视图名为list
http://localhost:9080/web上下文/list.html------->逻辑视图名为list(默认删除扩展名)
http://localhost:9080/web上下文/user/list.html------->逻辑视图名为user/list
4.15.6示例
(1、控制器UserController
Java代码
packagecn.javass.chapter4.web.controller;
//省略import
publicclassUserControllerextendsMultiActionController{
//用户服务类
privateUserServiceuserService;
//逻辑视图名通过依赖注入方式注入,可配置
privateStringcreateView;
privateStringupdateView;
privateStringdeleteView;
privateStringlistView;
privateStringredirectToListView;
//省略setter/getter
publicStringcreate(HttpServletRequestrequest,HttpServletResponseresponse,UserModeluser){
if("GET".equals(request.getMethod())){
//如果是get请求我们转向新增页面
returngetCreateView();
}
userService.create(user);
//直接重定向到列表页面
returngetRedirectToListView();
}
publicModelAndViewupdate(HttpServletRequestrequest,HttpServletResponseresponse,UserModeluser){
if("GET".equals(request.getMethod())){
//如果是get请求我们转向更新页面
ModelAndViewmv=newModelAndView();
//查询要更新的数据
mv.addObject("command",userService.get(user.getUsername()));
mv.setViewName(getUpdateView());
returnmv;
}
userService.update(user);
//直接重定向到列表页面
returnnewModelAndView(getRedirectToListView());
}
publicModelAndViewdelete(HttpServletRequestrequest,HttpServletResponseresponse,UserModeluser){
if("GET".equals(request.getMethod())){
//如果是get请求我们转向删除页面
ModelAndViewmv=newModelAndView();
//查询要删除的数据
mv.addObject("command",userService.get(user.getUsername()));
mv.setViewName(getDeleteView());
returnmv;
}
userService.delete(user);
//直接重定向到列表页面
returnnewModelAndView(getRedirectToListView());
}
publicModelAndViewlist(HttpServletRequestrequest,HttpServletResponseresponse){
ModelAndViewmv=newModelAndView();
mv.addObject("userList",userService.list());
mv.setViewName(getListView());
returnmv;
}
//如果使用委托方式,命令对象名称只能是command
protectedStringgetCommandName(Objectcommand){
//命令对象的名字默认command
return"command";
}
}
增删改:如果是GET请求方法,则表示到展示页面,POST请求方法表示真正的功能操作;
getCommandName:表示是命令对象名字,默认command,对于委托对象实现方式无法改变,因此我们就使用默认的吧。
(2、spring配置文件chapter4-servlet.xml
Java代码
<beanid="userService"class="cn.javass.chapter4.service.UserService"/>
<beanname="/user/**"class="cn.javass.chapter4.web.controller.UserController">
<propertyname="userService"ref="userService"/>
<propertyname="createView"value="user/create"/>
<propertyname="updateView"value="user/update"/>
<propertyname="deleteView"value="user/delete"/>
<propertyname="listView"value="user/list"/>
<propertyname="redirectToListView"value="redirect:/user/list"/>
<!--使用PropertiesMethodNameResolver来解析功能处理方法名-->
<!--propertyname="methodNameResolver"ref="propertiesMethodNameResolver"/-->
</bean>
userService:用户服务类,实现业务逻辑;
依赖注入:对于逻辑视图页面通过依赖注入方式注入,redirectToListView表示增删改成功后重定向的页面,防止重复表单提交;
默认使用InternalPathMethodNameResolver解析请求URL到功能方法名。
(3、视图页面
(3.1、list页面(WEB-INF/jsp/user/list.jsp)
Java代码
<ahref="${pageContext.request.contextPath}/user/create">用户新增</a><br/>
<tableborder="1"width="50%">
<tr>
<th>用户名</th>
<th>真实姓名</th>
<th>操作</th>
</tr>
<c:forEachitems="${userList}"var="user">
<tr>
<td>${user.username}</td>
<td>${user.realname}</td>
<td>
<ahref="${pageContext.request.contextPath}/user/update?username=${user.username}">更新</a>
|
<ahref="${pageContext.request.contextPath}/user/delete?username=${user.username}">删除</a>
</td>
</tr>
</c:forEach>
</table>
(3.2、update页面(WEB-INF/jsp/user/update.jsp)
Java代码
<formaction="${pageContext.request.contextPath}/user/update"method="post">
用户名:<inputtype="text"name="username"value="${command.username}"/><br/>
真实姓名:<inputtype="text"name="realname"value="${command.realname}"/><br/>
<inputtype="submit"value="更新"/>
</form>
(4、测试:
默认的InternalPathMethodNameResolver将进行如下解析:
我们可以将默认的InternalPathMethodNameResolver改为PropertiesMethodNameResolver:
Java代码
<beanid="propertiesMethodNameResolver"
class="org.springframework.web.servlet.mvc.multiaction.PropertiesMethodNameResolver">
<propertyname="mappings">
<props>
<propkey="/user/create">create</prop>
<propkey="<spanstyle="font-size:1em;line-height:1.5;">/user/</span><spanstyle="font-size:1em;line-height:1.5;">update">update</prop></span>
<propkey="<spanstyle="font-size:1em;line-height:1.5;">/user/</span><spanstyle="font-size:1em;line-height:1.5;">delete">delete</prop></span>
<propkey="<spanstyle="font-size:1em;line-height:1.5;">/user/</span><spanstyle="font-size:1em;line-height:1.5;">list">list</prop></span>
<propkey="/**">list</prop><!--默认的行为-->
</props>
</property>
<propertyname="alwaysUseFullPath"value="false"/><!--不使用全路径-->
</bean>
<beanname="/user/**"class="cn.javass.chapter4.web.controller.UserController">
<!—省略其他配置,详见配置文件-->
<!--使用PropertiesMethodNameResolver来解析功能处理方法名-->
<propertyname="methodNameResolver"ref="propertiesMethodNameResolver"/>
</bean>
/**表示默认解析到list功能处理方法。
如上配置方式可以很好的工作,但必须继承MultiActionController,SpringWebMVC提供给我们无需继承MultiActionController实现方式,即使有委托对象方式,继续往下看吧。
4.15.7、委托方式实现
(1、控制器UserDelegate
将UserController复制一份,改名为UserDelegate,并把继承MultiActionController去掉即可,其他无需改变。
(2、spring配置文件chapter4-servlet.xml
Java代码
<!—委托对象-->
<beanid="userDelegate"class="cn.javass.chapter4.web.controller.UserDelegate">
<propertyname="userService"ref="userService"/>
<propertyname="createView"value="user2/create"/>
<propertyname="updateView"value="user2/update"/>
<propertyname="deleteView"value="user2/delete"/>
<propertyname="listView"value="user2/list"/>
<propertyname="redirectToListView"value="redirect:/user2/list"/>
</bean>
<!—控制器对象-->
<beanname="/user2/**"
class="org.springframework.web.servlet.mvc.multiaction.MultiActionController">
<propertyname="delegate"ref="userDelegate"/>
<propertyname="methodNameResolver"ref="parameterMethodNameResolver"/>
</bean>
delegate:
控制器对象通过delegate属性指定委托对象,即实际调用delegate委托对象的功能方法。
methodNameResolver:此处我们使用ParameterMethodNameResolver解析器;
Java代码
<!—ParameterMethodNameResolver-->
<beanid="parameterMethodNameResolver"
class="org.springframework.web.servlet.mvc.multiaction.ParameterMethodNameResolver">
<!--1、根据请求参数名解析功能方法名-->
<propertyname="methodParamNames"value="create,update,delete"/>
<!--2、根据请求参数名的值解析功能方法名-->
<propertyname="paramName"value="action"/>
<!--3、逻辑方法名到真实方法名的映射-->
<propertyname="logicalMappings">
<props>
<propkey="doList">list</prop>
</props>
</property>
<!—4、默认执行的功能处理方法-->
<propertyname="defaultMethodName"value="list"/>
</bean>
1、methodParamNames:create,update,delete,当请求中有参数名为这三个的将被映射为功能方法名,如“<inputtype="submit"name="create"value="新增"/>”提交后解析得到的功能方法名为create;
2、paramName:当请求中有参数名为action,则将值映射为功能方法名,如“<inputtype="hidden"name="action"value="delete"/>”,提交后解析得到的功能方法名为delete;
3、logicalMappings:逻辑功能方法名到真实功能方法名的映射,如:
http://localhost:9080/springmvc-chapter4/user2?action=doList;
首先请求参数“action=doList”,则第二步解析得到逻辑功能方法名为doList;
本步骤会把doList再转换为真实的功能方法名list。
4、defaultMethodName:以上步骤如果没有解析到功能处理方法名,默认执行的方法名。
(3、视图页面
(3.1、list页面(WEB-INF/jsp/user2/list.jsp)
Java代码
<ahref="${pageContext.request.contextPath}/user2?action=create">用户新增</a><br/>
<tableborder="1"width="50%">
<tr>
<th>用户名</th>
<th>真实姓名</th>
<th>操作</th>
</tr>
<c:forEachitems="${userList}"var="user">
<tr>
<td>${user.username}</td>
<td>${user.realname}</td>
<td>
<ahref="${pageContext.request.contextPath}/user2?action=update&username=${user.username}">更新</a>
|
<ahref="${pageContext.request.contextPath}/user2?action=delete&username=${user.username}">删除</a>
</td>
</tr>
</c:forEach>
</table>
(3.2、update页面(WEB-INF/jsp/user2/update.jsp)
Java代码
<formaction="${pageContext.request.contextPath}/user2"method="post">
<inputtype="hidden"name="action"value="update"/>
用户名:<inputtype="text"name="username"value="${command.username}"/><br/>
真实姓名:<inputtype="text"name="realname"value="${command.realname}"/><br/>
<inputtype="submit"value="更新"/>
</form>
通过参数name="action"value="update"
来指定要执行的功能方法名update。
(3.3、create页面(WEB-INF/jsp/user2/create.jsp)
Java代码
<formaction="${pageContext.request.contextPath}/user2"method="post">
用户名:<inputtype="text"name="username"value="${command.username}"/><br/>
真实姓名:<inputtype="text"name="realname"value="${command.realname}"/><br/>
<inputtype="submit"name="create"value="新增"/>
</form>
通过参数name="create"
来指定要执行的功能方法名create。
(4、测试:
使用ParameterMethodNameResolver将进行如下解析:
相关文章推荐
- fastboot
- ubuntu下修改hostname
- UML建模之时序图(Sequence Diagram)
- mysql order by 查询优化
- NSFileManager—基本的路径操作
- tp-上传图片,自带截取图片
- Android开发_关于中英文切换
- 1.Android入门学习
- 摘抄一些看雪坛友的经典语录
- vs2012修复问题
- Windows下安装和使用redis
- 判断一个点是否在线段上
- LayoutInflater 用法
- 用十条命令在一分钟内检查Linux服务器性能
- CoOS使用教程——任务的状态
- Android使用FTP实现断点续传
- NSArray, NSDictionary语法糖
- iOS9 企业级账号 无法安装的问题
- docker【7】docker运行简单的应用程序(tomcat)以及怎么把宿主机的文件copy到容器
- web开发style中,z-index:2的使用