我们的代码中,总是会抛出各种异常,例如HttpRequestMethodNotSupportedException、HttpMediaTypeNotSupportedException,或者是自己定义的BusinessException。这些异常,如果我们不将它们try catch进行处理,就会导致http的状态码变成非20x,并返回SpringMvc默认的异常信息格式。
场景1,业务部门对返回值进行了统一的规定,例如:{"code":200, "message": "success", "data": {}},当发生异常的时候,并不希望http状态码变成非20x,而是保持200,通过code来表达调用是否成功,通过message来返回失败的原因。
场景2,业务部门希望发生异常的时候,返回异常信息使用的不是SpringMvc默认的格式,而是自定义自己的格式,返回更多辅助排查问题的信息。
这两种场景,都需要对未捕获的异常进行处理,这就需要利用上SpringMvc的异常处理拓展点。
接下来基于spring-webmvc-5.3.8来分析一下异常处理~
DispatcherServlet是SpringMvc的入口,所有请求都经过DispatcherServlet,再进入我们定义的@Controller接口中,进行处理。接口发生异常时,也由DispatcherServlet的handlerExceptionResolvers属性所持有的HandlerExceptionResolver来处理。
在DispatcherServlet.initHandlerExceptionResolvers中,对handlerExceptionResolers进行初始化:
默认情况下,detectAllHandlerExceptionResolvers为true,而Spring容器里也会有三个HandlerExceptionResolver:
当前两个解析器没有成功处理,则该处理器会处理一些指定的异常类型,例如HttpRequestMethodNotSupportedException、HttpMediaTypeNotSupportedException、HttpMediaTypeNotAcceptableException等等;通过HttpServletResponse.sendError来返回异常信息。
异常处理器的的处理能力来自于持有的ExceptionHandlerMethodResolver对象,有两个属性持有该类型的对象:
Map
ExceptionHandlerMethodResolver封装。
在处理异常的方法doResolveHandlerMethodException中,会调用getExceptionHandlerMethod方法,从exceptionHandlerCache和exceptionHandlerAdviceCache获得ServletInvocableHandlerMethod。如果ServletInvocableHandlerMethod不为空,则用ServletInvocableHandlerMethod.invokeAndHandle处理异常。
所以重点就是在这两个属性的内容来源!!!
exceptionHandlerCache的内容,是在解析异常的时候才被逐步初始化,类似懒加载:
handlerMethod是抛异常的@Controller注解类的方法,handlerType就是@Controller注解的类。
注意!!!由于handlerType就是@Controller注解的类,所以new出来的ExceptionHandlerMethodResolver只会处理倒该@Controller注解的类抛出的异常(exceptionHandlerCache的key是handlerType)。
exceptionHandlerAdviceCache属性的的初始在,是在afterPropertiesSet中调用initExceptionHandlerAdviceCache,会获取Spring容器中所有加了@ControllerAdvice注解的bean,如果这些bean中有加了@ExceptionHandler注解的方法,则会被放到exceptionHandlerAdviceCache中。
再分析一下ExceptionHandlerMethodResolver的能力~
在构造函数中,会根据handlerType,通过反射的方式,选择类中加了@ExceptionHandler注解的方法,将@ExceptionHandler中的异常类型作为key,方法本身作为value,设置到mappedMethods中。
而excptionLookupCache则作为根据Throwable类型→method处理方法的缓存:
自定义异常处理的方式有三种:
1、自定义HandlerExceptionResolver类,注册到Spring容器上下文中,这样就会被DispatcherServlet检测到,放到handlerExceptionResolvers属性中,只要优先级高于SpringMvc默认的HandlerExceptionResolver,就可以优先处理异常。
2、在@Controller的类中,添加@ExceptionHandler注解的方法。这样,该方法就会处理其所在controller类抛出的异常。
3、在@ControllerAdvice类中增加@ExceptionHandler注解的方法。@ControllerAdvice类有几个选择属性,basePackages、basePackageClasses、assignableTypes和annotations;如果设置了这几个属性,则只有匹配这些属性规则的@Controller类的异常才会被处理。默认都为空,所有类的异常都会被处理。
1、@ExceptionHandler注解的方法返回值可以有多种类型,研究ServletInvocableHandlerMethod是怎么处理各种返回值类型的。