异常是每一个应用必须要处理的问题。
Spring MVC项目,如果不做任何的异常处理的话,发生异常后,异常堆栈信息会直接抛出到页面。
比如,我们在Controller写一个异常:
@GetMapping(value="/hello",produces={"text/html; charset=UTF-8"})@ResponseBodypublic String hello(ModelAndView model){int c = 100 / 0;return "<h1>User info</h1>";}
浏览器访问:
用户体验相当不好,所以一般情况下,应用必须要想办法处理异常。
异常处理方式
常见的异常处理方式,无非:
- 应用中对所有可能发生异常的地方,都try catch,捕获异常后做相应的处理。
- 集中处理异常。
第一种方式显然不好,一方面是代码中需要到处都写try catch,万一某一段代码由于程序员的疏忽没有写,异常就会抛出到前台,很不好。
另外,某些情况下异常是不能捕获的,比如需要事务处理的代码,捕获异常后会影响到事务回滚。
所以,我们还是需要想办法用第2中方式来处理异常。n多年前曾经做过一个摩托罗拉的项目,其中一项需求就是对一个线上系统的异常做处理、不允许异常信息抛出到前台页面。当初那个项目并没有采用类似SpringMVC的框架,所以最终提出了用filter、在filter中拦截异常的处理方案并且被客户采纳。
其实SpringMVC的统一异常处理方案和我上面项目中采用的方案非常类似。
SpringMVC的异常处理
Spring MVC提供了如下异常处理选项:
- @ExceptionHandle
- @ExceptionHandle + @ControllerAdvice
- 自定义异常处理器HandlerExceptionResolver
@ExceptionHandle
@ExceptionHandle可以作用在Controller中,比如,在上面发生异常的Controller中增加一个@ExceptionHandle注解的方法:
@GetMapping(value="/hello",produces={"text/html; charset=UTF-8"})@ResponseBodypublic String hello(ModelAndView model){int c = 100 / 0;return "<h1>User info</h1>";}@ExceptionHandler(Exception.class)@ResponseBodypublic String handle(Exception ex){return "错了在helloworld Controller error msg is ===";}
运行:
说明Hello方法中发生的异常,已经被handle方法处理,前台页面不再会出现异常信息。
问题解决了!
但是@ExceptionHandle只在当前Controller文件中生效,也就是说,当前Controller中的方法、或者方法调用的service层、dao层等发生的异常,才会被捕获到。其他Controller中发生的异常依然不会被捕获。
这样的话,就需要对每一个Controller增加@ExceptionHandle进行处理,处理起来还是有点麻烦。
统一异常处理
@ExceptionHandle + @ControllerAdvice可以实现统一异常处理。
@ControllerAdvice注解可以实现:
On startup, RequestMappingHandlerMapping and ExceptionHandlerExceptionResolver detect controller advice beans and apply them at runtime. Global @ExceptionHandler methods, from an @ControllerAdvice, are applied after local ones, from the @Controller. By contrast, global @ModelAttribute and @InitBinder methods are applied before local ones.
SpringMVC启动的过程中,RequestMappingHandlerMapping和ExceptionHandlerExceptionResolver会检测到advice bean并且在运行时会使用他们。在@ControllerAdvice中的@ExceptionHandler会变成一个全局的异常处理器、在本地异常处理器之后生效。并且,@ModelAttribute和 @InitBinder会在本地的之后生效。
这段话的意思就是,@ExceptionHandle + @ControllerAdvice之后,@ExceptionHandle就会变成全局异常处理器。所谓的本地异常处理器,就是写在Controller中的@ExceptionHandle异常处理器。
这个工作是ExceptionHandlerExceptionResolver干的,源码中可以看到:
@Nullableprotected ServletInvocableHandlerMethod getExceptionHandlerMethod(@Nullable HandlerMethod handlerMethod, Exception exception) {Class<?> handlerType = null;//先找"local"异常处理器if (handlerMethod != null) {// Local exception handler methods on the controller class itself.// To be invoked through the proxy, even in case of an interface-based proxy.handlerType = handlerMethod.getBeanType();ExceptionHandlerMethodResolver resolver = this.exceptionHandlerCache.get(handlerType);if (resolver == null) {resolver = new ExceptionHandlerMethodResolver(handlerType);this.exceptionHandlerCache.put(handlerType, resolver);}Method method = resolver.resolveMethod(exception);if (method != null) {return new ServletInvocableHandlerMethod(handlerMethod.getBean(), method);}// For advice applicability check below (involving base packages, assignable types// and annotation presence), use target class instead of interface-based proxy.if (Proxy.isProxyClass(handlerType)) {handlerType = AopUtils.getTargetClass(handlerMethod.getBean());}}//再找advice的异常处理器for (Map.Entry<ControllerAdviceBean, ExceptionHandlerMethodResolver> entry : this.exceptionHandlerAdviceCache.entrySet()) {ControllerAdviceBean advice = entry.getKey();if (advice.isApplicableToBeanType(handlerType)) {ExceptionHandlerMethodResolver resolver = entry.getValue();Method method = resolver.resolveMethod(exception);if (method != null) {return new ServletInvocableHandlerMethod(advice.resolveBean(), method);}}}return null;}
验证一下。
加一个MyGlobalExceptionController:
@ControllerAdvice
public class MyGlobalExceptionController {@ExceptionHandler(Exception.class)@ResponseBodypublic String handle(Exception ex){return return "错了MyGlobalExceptionController error msg is ===";}
}
先不去掉HelloWorldController中的异常处理器,运行hello:
生效的是HelloWorldController中的异常处理器。
然后去掉HelloWorldController中的异常处理器:
写在MyGlobalExceptionController中的全局异常处理器生效!
自定义异常处理器HandlerExceptionResolver
实现接口HandlerExceptionResolver,或者扩展虚拟类AbstractHandlerMethodExceptionResolver(勉强可以考虑),定义自己的异常处理器。
其实,非必要(没想到有什么必要性)不建议!
上一篇 Spring MVC 九:Context层级(基于配置)