SpringMVC全局异常处理器

常识告诉我们，如果不进行外加干涉，事务总是倾向增加它的无序度。 ——《时间简史》

1、概述

在J2EE项目的开发中，不管是对底层的数据库操作过程，还是业务层的处理过程，还是控制层的处理过程，都不可避免会遇到各种可预知的、不可预知的异常需要处理。每个过程都单独处理异常，系统的代码耦合度高，工作量大且不好统一，维护的工作量也很大。下面将介绍使用Spring MVC统一处理异常的解决和实现过程。

有以下三种方式进行全局异常处理：
（1）使用Spring MVC提供的简单异常处理器SimpleMappingExceptionResolver；
（2）实现Spring的异常处理接口HandlerExceptionResolver 自定义自己的异常处理器；
（3）使用@ExceptionHandler注解实现异常处理；

2、简单异常处理器SimpleMappingExceptionResolver

在Spring的配置文件中applicationContext.xml中增加以下内容：

<bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">  
      <!-- 定义默认的异常处理页面，当该异常类型的注册时使用 -->  
      <property name="defaultErrorView" value="error"></property>  
      <!-- 定义异常处理页面用来获取异常信息的变量名，默认名为exception -->  
      <property name="exceptionAttribute" value="ex"></property>  
      <!-- 定义需要特殊处理的异常，用类名或完全路径名作为key，异常也页名作为值 -->  
      <property name="exceptionMappings">  
       <props>  
             <prop key="cn.basttg.core.exception.BusinessException">error-business</prop>  
             <prop key="cn.basttg.core.exception.ParameterException">error-parameter</prop>  
              <!-- 这里还可以继续扩展对不同异常类型的处理 -->  
          </props>  
      </property>  
   </bean>  

优缺点：使用SimpleMappingExceptionResolver进行异常处理，具有集成简单、有良好的扩展性、对已有代码没有入侵性等优点，但该方法仅能获取到异常信息，若在出现异常时，对需要获取除异常以外的数据的情况不适用。

3、自定义异常处理器HandlerExceptionResolver

（1）实现Spring的异常处理接口HandlerExceptionResolver

public class GlobalExceptionReslover implements HandlerExceptionResolver {

    Logger logger = LoggerFactory.getLogger(GlobalExceptionReslover.class);

    @Override
    public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler,
            Exception ex) {
        //写日志文件
        logger.error("系统发生异常", ex);
        //发邮件、发短信
        //Jmail：可以查找相关的资料
        //需要在购买短信。调用第三方接口即可。
        //展示错误页面
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.addObject("message", "系统发生异常，请稍后重试");
        modelAndView.setViewName("error/exception");
        return modelAndView;
    }

}

（2）在SpringMVC中配置

<!--全局异常处理器-->
<bean class="GlobalExceptionReslover"/>

优缺点：从上面的集成过程可知，使用实现HandlerExceptionResolver接口的异常处理器进行异常处理，具有集成简单、有良好的扩展性、对已有代码没有入侵性等优点，同时，在异常处理时能获取导致出现异常的对象，有利于提供更详细的异常处理信息。

4、@ExceptionHandler注解

（1）增加BaseController类，并在类中使用@ExceptionHandler注解声明异常处理，代码如下：

  public class BaseController {  
      /** 基于@ExceptionHandler异常处理 */  
       @ExceptionHandler  
       public String exp(HttpServletRequest request, Exception ex) {             
           request.setAttribute("ex", ex);             
          // 根据不同错误转向不同页面  
           if(ex instanceof BusinessException) {  
               return "error-business";  
           }else if(ex instanceof ParameterException) {  
               return "error-parameter";  
           } else {  
               return "error";  
           }  
       }  
   }  

（2）修改代码，使所有需要异常处理的Controller都继承该类，如下所示，修改后的TestController类继承于BaseController：

public class TestController extends BaseController  

（3）启动测试项目，经验证，Dao层、Service层、Controller层抛出的异常（业务异常BusinessException、参数异常ParameterException和其它的异常Exception）都能准确显示定义的异常处理页面，达到了统一异常处理的目标。

优缺点：从上面的集成过程可知，使用@ExceptionHandler注解实现异常处理，具有集成简单、有扩展性好（只需要将要异常处理的Controller类继承于BaseController即可）、不需要附加Spring配置等优点，但该方法对已有代码存在入侵性（需要修改已有代码，使相关类继承于BaseController），在异常处理时不能获取除异常以外的数据。

5、未能捕获的异常

对于Unchecked Exception而言，由于代码不强制捕获，往往被忽略，如果运行期产生了Unchecked Exception，而代码中又没有进行相应的捕获和处理，则我们可能不得不面对尴尬的404、500……等服务器内部错误提示页面。
我们需要一个全面而有效的异常处理机制。目前大多数服务器也都支持在Web.xml中通过(Websphere/Weblogic)或者(Tomcat)节点配置特定异常情况的显示页面。修改web.xml文件，增加以下内容：

   <!-- 出错页面定义 -->  
   <error-page>  
       <exception-type>java.lang.Throwable</exception-type>  
      <location>/500.jsp</location>  
   </error-page>  
   <error-page>  
       <error-code>500</error-code>  
       <location>/500.jsp</location>  
 </error-page>  
   <error-page>  
      <error-code>404</error-code>  
       <location>/404.jsp</location>  
   </error-page>  
  <!-- 这里可继续增加服务器错误号的处理及对应显示的页面 -->  

6、总结

综合上述可知，SpringMVC集成异常处理3种方式都可以达到统一异常处理的目标。从3种方式的优缺点比较，若只需要简单的集成异常处理，推荐使用SimpleMappingExceptionResolver即可；若需要集成的异常处理能够更具个性化，提供给用户更详细的异常信息，推荐自定义实现HandlerExceptionResolver接口的方式；若不喜欢Spring配置文件或要实现“零配置”，且能接受对原有代码的适当入侵，则建议使用@ExceptionHandler注解方式。对于未能捕获的异常，在Web.xml中通过(Websphere/Weblogic)或者(Tomcat)节点配置特定异常情况的显示页面。