Spring MVC 异常处理-优快云博客

对异常的处理方法一共提供了两种：一种是使用HandlerExceptionResolver接口；一种是在Controller类内部使用@ExceptionHandler注解。使用第一种方式可以实现全局异常控制，并且Spring已经提供了一个默认的实现类SimpleMappingExceptionResolver；使用第二种方式可以在Controller内部实现更个性化点异常处理方式，灵活性更高。一般来说，项目中只需要采用第一种方式就可以了，每个人都自己定义异常的展现方式，太过个性了，不统一。

1. 基于HandlerExceptionResolver接口的异常处理

使用这种方式只需要实现resolveException方法，该方法返回一个ModelAndView对象，在方法内部对异常的类型进行判断，然后常见合适的ModelAndView对象，如果该方法返回了null，则Spring会继续寻找其他的实现了HandlerExceptionResolver接口的Bean。换句话说，Spring会搜索所有注册在其环境中的实现了HandlerExceptionResolver接口的Bean，逐个执行，直到返回了一个ModelAndView对象。

示例代码：

**
 * 基于HandlerExceptionResolver接口的异常处理类
 * @author ZYWANG 2011-4-2
 */
public class CustomExceptionHandler implements HandlerExceptionResolver {
     
    @Override
    public ModelAndView resolveException(HttpServletRequest request,
            HttpServletResponse response, Object object, Exception exception) {
        if(exception instanceof IOException){
            return new ModelAndView("ioexp");
        }else if(exception instanceof SQLException){
            return new ModelAndView("sqlexp");
        }
        return null;
    }
     
}

这个类必须声明到Spring中去，让Spring管理它，你可以使用@Component标签，也可以使用<bean/>节点。为了简单的进行异常处理，Spring提供了SimpleMappingExceptionResolver类，该类实现了HandlerExceptionResolver接口，需要使用时只需要使用<bean/>节点进行声明即可，示例如下：

<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="IOException">error/ioexp</prop>
            <prop key="java.sql.SQLException">error/sqlexp</prop>
        </props>
      </property>

     <!-- 相关状态码对应的错误页面 -->
     <property name="statusCodes">
        <props>
            <prop key="errors/500">500</prop>
            <prop key="errors/404">404</prop>
        </props>
     </property>

    <!-- 设置日志输出级别，不定义则默认不输出警告等错误日志信息 -->
    <property name="warnLogCategory" value="WARN" />

    <!-- 默认HTTP状态码 -->
    <property name="defaultStatusCode" value="500" />
 
</bean>

2. 基于@ExceptionHandler的异常处理

该方法需要定义在Controller内部，然后创建一个方法并用@ExceptionHandler注解来修饰用来处理异常，这个方法基本和@RequestMapping修饰的方法差不多，只是可以多一个类型为Exception的参数，@ExceptionHandler中可以添加一个或多个异常的类型，如果为空的话则认为可以触发所有的异常类型错误。

示例代码：

/**
 * 基于@ExceptionHandler异常处理
 * @author ZYWANG 2011-4-2
 */
@Controller
public class ExceptionHandlerController {
         
    @ExceptionHandler(value={IOException.class,SQLException.class})
    public String exp(Exception ex,HttpServletRequest request) {
        request.setAttribute("ex", ex);
        return "/error.jsp";
    }
     
}

这种方法可以定义在BaseController中，使所有需要异常处理的Controller都继承该类，达到了统一异常处理的目标。@ExceptionHandler进行处理有一个不好的地方是进行异常处理的方法必须与出错的方法在同一个Controller里面。

优先级

既然在SpringMVC中有两种处理异常的方式，那么就存在一个优先级的问题：

当发生异常的时候，SpringMVC会如下处理：

（1）SpringMVC会先从配置文件找异常解析器HandlerExceptionResolver

（2）如果找到了异常异常解析器，那么接下来就会判断该异常解析器能否处理当前发生的异常

（3）如果可以处理的话，那么就进行处理，然后给前台返回对应的异常视图

（4）如果没有找到对应的异常解析器或者是找到的异常解析器不能处理当前的异常的时候，就看当前的Controller中有没有提供对应的异常处理器，如果提供了就由Controller自己进行处理并返回对应的视图

（5）如果配置文件里面没有定义对应的异常解析器，而当前Controller中也没有定义的话，那么该异常就会被抛出来。

3 . <error-page>标签

此标签可以指定错误码和具体异常对应的错误页面

<error-page>  

    <exception-type>java.lang.Exception</exception-type>  

    <location>/jsp/error.jsp</location>  

</error-page>  

<error-page>  

    <error-code>404</error-code>  

    <location>/jsp/error.jsp</location>  

</error-page>

4. @ControllerAdvice

此注解用来统一处理全局异常，@ControllerAdvice注解类中可以使用 @ExceptionHandler、@InitBinder、@ModelAttribute注解方法，并将应用到所有 @RequestMapping注解的方法，不过只有 @ExceptionHandler最有用，另外两个用处不大。例如：

@ControllerAdvice  
public class GlobalExceptionHandler {  

    private final static AsJEELogger LOG = AsJEELoggerFactory.getLogger(GlobalExceptionHandler.class);  

    private final static String EXPTION_MSG_KEY = "message";  


    @ExceptionHandler(BusinessException.class)  
    @ResponseBody  
    public void handleBizExp(HttpServletRequest request, Exception ex){  

         LOG.info("Business exception handler  " + ex.getMessage() );  

         request.getSession(true).setAttribute(EXPTION_MSG_KEY, ex.getMessage());  

    }  

      

    @ExceptionHandler(SQLException.class)  
    public ModelAndView handSql(Exception ex){  

            LOG.info("SQL Exception " + ex.getMessage());  

            ModelAndView mv = new ModelAndView();  

            mv.addObject("message", ex.getMessage());  

            mv.setViewName("sql_error");  

            return mv;  
    }  
}

在Controller中抛出的异常，当没有被catch处理时，GlobalExceptionHandler中定义的处理方法可以起作用，在方法写明注解@ExceptionHandler，并注明其异常类即可。此种方法不仅可以作用于Controller，同样的在DAO层、service层也可，都可以由GlobalExceptionHandler进行处理。此种写法减少代码的入侵，值得推荐。