本文涉及SpringMVC异常处理体系源码分析,SpringMVC异常处理相关类的设计模式,实际工作中异常处理的实践。

问题场景

假设我们的SpringMVC应用中有如下控制器:

代码示例-1
@RestController("/order")
public class OrderController{ @RequestMapping("/detail")
public Object orderDetail(int orderId){
// ...
} }

这个控制器中接收了一个参数:int 类型的orderId。假设我在请求的使传递的参数为orderId=99999999999或者orderId=53844181132132asdf。很显然,我们的第一个参数超出了int的范围,第二个参数类型不符合。这时肯定会报400错误,假设我们的应用是部署在tomcat里边的,我们会得到的错误页面是这样的:

代码示例-2
<html>
<head><title>Apache Tomcat/7.0.42 - Error report</title>
<style>
<!--H1 {font-family:Tahoma,Arial,sans-serif;color:white;background-color:#525D76;font-size:22px;} H2 {font-family:Tahoma,Arial,sans-serif;color:white;background-color:#525D76;font-size:16px;} H3 {font-family:Tahoma,Arial,sans-serif;color:white;background-color:#525D76;font-size:14px;} BODY {font-family:Tahoma,Arial,sans-serif;color:black;background-color:white;} B {font-family:Tahoma,Arial,sans-serif;color:white;background-color:#525D76;} P {font-family:Tahoma,Arial,sans-serif;background:white;color:black;font-size:12px;}A {color : black;}A.name {color : black;}HR {color : #525D76;}-->
</style>
</head>
<body>
<h1>HTTP Status 400 - </h1>
<HR size="1" noshade="noshade">
<p><b>type</b> Status report</p>
<p><b>message</b> <u></u></p>
<p>
<b>description</b>
<u>The request sent by the client was syntactically incorrect.</u>
</p><HR size="1" noshade="noshade">
<h3>Apache Tomcat/7.0.42</h3>
</body>
</html>

当我们碰到这个错的时候,实际上都没有进入目标方法,控制台也看不到controller方法执行的日志相关信息。根据经验,我们知道这是请求错误,是请求参数不匹配导致的(实际抛出的异常是:org.springframework.beans.TypeMismatchException: Failed to convert value of type)。也许你会说解决这个问题,只需要传递正确的参数就可以了,但是spring是怎么处理这个错误的,流程是怎样?如果了解这些,对于我们解决问题更有帮助。

源码调试分析

为了追踪处理过程,我会使用断点调试的方式。我们知道,SpringMVC的核心是DispatchServlet。所有的请求会被DispatchServlet接收,并在其doDispatch(...)方法中处理。doDispatch()方法会找到对应的handler,然后invoke。所以我们在doDispatch方法中打个断点。我们使用postman发起一个请求,并传递一个错误的参数。先贴一点doDispatch()方法的代码:

代码示例-3
protected void doDispatch(HttpServletRequest request, HttpServletResponse response) throws Exception {
//删除一些代码
try {
ModelAndView mv = null;
Exception dispatchException = null; try {
// 删除一些代码方便阅读
try {
// Actually invoke the handler.
mv = ha.handle(processedRequest, response, mappedHandler.getHandler());
}
finally {
if (asyncManager.isConcurrentHandlingStarted()) {
return;
}
}
applyDefaultViewName(request, mv);
mappedHandler.applyPostHandle(processedRequest, response, mv);
}
catch (Exception ex) {
dispatchException = ex; // 这里捕获了异常TypeMismatchException
}
processDispatchResult(processedRequest, response, mappedHandler, mv, dispatchException);
}
catch (Exception ex) {
}
finally {
// 删除一些代码
}
}

当请求进入doDispatch()方法之后,单步执行发现,发生了一个异常,然后,这个异常被catch住了,catch块里边进行了如下操作:

代码示例-4
dispatchException = ex;

异常的详细信息是:

代码示例-5
org.springframework.beans.TypeMismatchException: Failed to convert value of type 'java.lang.String' to required type 'java.lang.Integer'; nested exception is java.lang.NumberFormatException: For input string: "53844181132132asdf"

继续执行,走出了catch块之后,便进入了processDispatchResult方法:

代码示例-5
private void processDispatchResult(HttpServletRequest request, HttpServletResponse response,
HandlerExecutionChain mappedHandler, ModelAndView mv, Exception exception) throws Exception {
boolean errorView = false;
if (exception != null) {
if (exception instanceof ModelAndViewDefiningException) {
logger.debug("ModelAndViewDefiningException encountered", exception);
mv = ((ModelAndViewDefiningException) exception).getModelAndView();
}
else {
Object handler = (mappedHandler != null ? mappedHandler.getHandler() : null);
mv = processHandlerException(request, response, handler, exception);// 执行这个方法
errorView = (mv != null);
}
}
// 方便阅读,删除了其他代码 }

这个方法中对异常进行判断,发现不是“ModelAndViewDefiningException”就交给processHandlerException()方法继续处理。processHandlerException方法代码如下:

代码示例-6
protected ModelAndView processHandlerException(HttpServletRequest request, HttpServletResponse response,
Object handler, Exception ex) throws Exception {
// Check registered HandlerExceptionResolvers...
ModelAndView exMv = null;
for (HandlerExceptionResolver handlerExceptionResolver : this.handlerExceptionResolvers) {
exMv = handlerExceptionResolver.resolveException(request, response, handler, ex);
if (exMv != null) {
break;
}
}
// 去掉了一些代码
throw ex;
}

这里的for循环是为了找一个handler来处理这个异常。这里的handler列表有:

  • ExceptionHandlerExceptionResolver
  • ResponseStatusExceptionResolver
  • DefaultHandlerExceptionResolver
  • 自定义的ExceptionResolver 1
  • ...
  • 自定义的ExceptionResolver N

异常体系的设计模式

在上面的代码中,通过for循环需要在众多的handler中找一个HandlerExceptionResolver的实现类来处理异常。这里的handler列表是在应用初始化的时候就创建了,前三个是spring内部自带的,后面是我们自定义的(如果有的话)。处理异常的方法是resolveException(),它其实是在HandlerExceptionResolver接口中定义的,该接口只有一个方法resolveException(),代码如下:

代码示例-7
public interface HandlerExceptionResolver {
ModelAndView resolveException(
HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex);
}

Spring自带的ExceptionHandlerExceptionResolverResponseStatusExceptionResolverDefaultHandlerExceptionResolver都是继承自AbstractHandlerExceptionResolver类,这个类是一个抽象类,它实现了HandlerExceptionResolver接口,它对HandlerExceptionResolver接口约定的方法的所实现代码是这样的:

代码示例-8
public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response,
Object handler, Exception ex) {
if (shouldApplyTo(request, handler)) { logException(ex, request);
prepareResponse(ex, response);
return doResolveException(request, response, handler, ex);
}
else {
return null;
}
}

这个方法其实是一个模板,这里使用的是模板方法设计模式。这个模板定义了处理异常的逻辑,return null或者进入if执行“三步走”,看上面代码,这三步分别是:

  • logException(ex, request);
  • prepareResponse(ex, response);
  • doResolveException(request, response, handler, ex);

这里的第三部doResolveException(request, response, handler, ex)是一个抽象方法,它也是我们的模板方法。它的声明是这样的:

代码示例-9
protected abstract ModelAndView doResolveException(HttpServletRequest request,
HttpServletResponse response, Object handler, Exception ex);

这个抽象方法就是留个子类来实现的。模板我定好了,子类想咋处理就怎么实现。无论你咋实现,反正我这“三步走”是已经定好的了。所以,模板方法设计模式就是这样:“定义一个操作中的算法的骨架,而将一些步骤延迟到子类中。TemplateMethod使得子类可以不改变一个算法的结构即可重定义该算法的某些特定步骤。”

继续回到代码逻辑,刚才讲到,我们的for循环遍历当前的handler,并调用当前handler的resolveException方法。正如 [代码示例-8 ] 所示这个resolveException方法是个模板方法,它的第一步就是一个if判断,这个判断的方法代码如下:

代码示例-10
protected boolean shouldApplyTo(HttpServletRequest request, Object handler) {
if (handler != null) {
if (this.mappedHandlers != null && this.mappedHandlers.contains(handler)) {
return true;
}
if (this.mappedHandlerClasses != null) {
for (Class handlerClass : this.mappedHandlerClasses) {
if (handlerClass.isInstance(handler)) {
return true;
}
}
}
}
return (this.mappedHandlers == null && this.mappedHandlerClasses == null);
}

this.mappedHandlers 是一个 Set ,它存储了当前异常处理器有哪些handler。如果这个set不为空,并且包含了当前的目标handler,那就说明这个异常处理器可以处理当前的目标handler。(这里所说的handler其实就是controller的目标方法,以开篇的例子来说,这个handler类包含的信息、目标方法,总之handler指明我们要调用的是OrderController类的orderDetail方法)。

于是,我们的for循环,依次发现了ExceptionHandlerExceptionResolver不能处理,ResponseStatusExceptionResolver也不能处理,下一个轮到DefaultHandlerExceptionResolver的时候,可以了,进入了if里边的“三步走”。最终执行了该类对模板方法doResolveException的实现代码,这个代码是这样的:

代码示例-11
@Override
protected ModelAndView doResolveException(HttpServletRequest request, HttpServletResponse response,
Object handler, Exception ex) { try {
if (ex instanceof NoSuchRequestHandlingMethodException) {
return handleNoSuchRequestHandlingMethod(...);
}
// 删除部分else if instanceof 判断
else if (ex instanceof TypeMismatchException) {
// 执行到了这里
return handleTypeMismatch((TypeMismatchException) ex, request, response, handler);
}
// 删除部分else if instanceof 判断
else if (ex instanceof BindException) {
return handleBindException((BindException) ex, request, response, handler);
}
}
catch (Exception handlerException) {
}
return null;
}

这个方法,对异常类型进行判断,上面提到,由于我们传递的错误参数导致了TypeMismatchException异常,所以,根据上面的代码,我们本次的错误被handleTypeMismatch()方法处理了。handleTypeMismatch方法的代码非常的简单,全部代码如下:

protected ModelAndView handleTypeMismatch(TypeMismatchException ex,
HttpServletRequest request, HttpServletResponse response, Object handler) throws IOException { response.sendError(HttpServletResponse.SC_BAD_REQUEST);
return new ModelAndView();
}

执行到这里,最终返回了一个 new ModelAndView()对象。根据 [ 代码示例-6 ] 中的代码所示,程序终于可以跳出这个for循环了。进入下面的if语句之后,由于得到的是一个空的 ModelAndView对象,所以执行了exMv.isEmpty()的代码,return 了null。

接下来程序便回到了processDispatchResult方法,调用了mappedHandler.triggerAfterCompletion(request, response, null);之后,一切便结束了。这里的方法调用是责任链设计模式,本篇不在过多的解释,意思就是异常处理之后,继续交给后续的intercepter处理。最终,我们便看到了开篇所给出的400页面。

如何解决参数异常导致的400错误

经过上面的分析,我们已经知道了这个400错误是如何发生的。那么改如何解决呢?通常情况下,我们的应用都会有很多controller和方法,这么多的controller和方法我们不可能一个个的去处理。所以,通常来说,定义一个全局的处理器会是一个比较好的选择。spring给了我们很多的选择。(感兴趣的可以看:https://spring.io/blog/2013/11/01/exception-handling-in-spring-mvc)

本例中,我为了处理这个400错误,使用了如下的方式。新建一个类GlobalDefaultExceptionHandler,并保证该类可以被spring容器初始化,其代码如下:

@ControllerAdvice
public class GlobalDefaultExceptionHandler {
@ExceptionHandler(value = TypeMismatchException.class)
@ResponseBody
public Object defaultErrorHandler1(HttpServletRequest req, Exception e) throws Exception { if (AnnotationUtils.findAnnotation(e.getClass(), ResponseStatus.class) != null) {
throw e;
}
ResaultBean res = new ResaultBean("请求的参数中有格式错误");
return res;
} @ExceptionHandler(value = HttpRequestMethodNotSupportedException.class)
public Object defaultErrorHandler2(HttpServletRequest req, Exception e) throws Exception { if (AnnotationUtils.findAnnotation(e.getClass(), ResponseStatus.class) != null) {
throw e;
}
ModelAndView mav = new ModelAndView();
mav.addObject("exception", e);
mav.addObject("url", req.getRequestURL());
mav.setViewName("error");
return mav;
} }

本例中将@ ControllerAdvice 和 @ ExceptionHandler搭配使用,实现了对TypeMismatchException和HttpRequestMethodNotSupportedException的处理。当有这两个异常发生时,分别会执行这里的逻辑,并返回我们自定义的结果。

注意,在defaultErrorHandler1()方法中,我们还搭配了@ ResponseBody注解,使用过springmvc的同学都知道,到我们在controller的某个方法上注解@ ResponseBody的时候,表示这个方法返回的是json,而不是某个视图页面。同理,这里的异常处理加上@ ResponseBody注解,表示对这个异常的处理结果返回的也是。开发api的同学需要正是这个配置,而不是在“正常情况下返回json,错误的情况下400页面html”那就很糟糕了。另外@ ExceptionHandler 搭配 ResponseBody使用好像是在spring 3.1之后才支持的,之前是只能返回ModelAndView 和String ( 也是一个页面配置)。但是这个可以忽略,因为现在大家用的都是高版本的了。

defaultErrorHandler2()中,返回的是ModelAndView。即,我们可以也可以指定返回某个页面。在这个例子中,我使用了两个@ExceptionHandler注解分别处理了两个异常情况。你当然可以使用@ExceptionHandler(value = Exception.class)来处理所有的异常了。

@ExceptionHandler的原理其实就是,就是将其所注解的处理类,配置到了ExceptionHandlerExceptionResolver类的exceptionHandlerCache中,上面说的for循环在挑选处理器的时候,会找到ExceptionHandlerExceptionResolver来处理。后面就映射到了我们自定义处理类GlobalDefaultExceptionHandler中的相应方法。然后我们看到的结果就是:

{
"code": 10001,
"message": "请求的参数中有格式错误"
}

至此,400错误的发生和解决算是粗略的讲完了。这里我虽然是调试了代码,并分析了相关的执行流程,以及设计模式。但是还是感觉略知一二。要想完全弄清楚,还是需要继续深入的。Spring真的强大的,设计的好,功能全,代码写的也漂亮。值得学习啊。

附加一点:

如何处理请求处理过程中发送的异常

本文主要是想通过源码来分析400错误发生的过程,顺带的了解一下SpringMVC异常处理方面的设计。这里补充一点,如果我们想处理请求过程中发生的异常。那么我们只需要实现HandlerExceptionResolver接口即可。实现的方法如下:

public class ApiHandlerExceptionResolver implements HandlerExceptionResolver {
@Override
public ModelAndView resolveException(HttpServletRequest request,
HttpServletResponse response, Object handler, Exception exception) {
ModelAndView model = new ModelAndView();
// do something ... return model;
}
}

通过这个ApiHandlerExceptionResolver,当我们的controller方法在执行过程中,抛出了异常(自己并未try,catch捕获的)比如说空指针异常,数组越界异常等。就可以走这里了,而不是返回一个tomcat 500错误页面。这个配置算是比较常用的,所以不再解释。反而是上面所说的400处理,即请求处理之前的错误一些应用中并未配置。

SpringMVC源码分析-400异常处理流程及解决方法的更多相关文章

  1. springmvc源码分析系列-请求处理流程

    接上一篇-springmvc源码分析开头片 上一节主要说了一下springmvc与struts2的作为MVC中的C(controller)控制层的一些区别及两者在作为控制层方面的一些优缺点.今天就结合 ...

  2. SpringMVC源码分析和启动流程

    https://yq.aliyun.com/articles/707995 在Spring的web容器启动时会去读取web.xml文件,相关启动顺序为:<context-param> -- ...

  3. springMVC源码分析--异常处理机制HandlerExceptionResolver执行原理(二)

    上一篇博客springMVC源码分析--异常处理机制HandlerExceptionResolver简单示例(一)中我们简单地实现了一个异常处理实例,接下来我们要介绍一下HandlerExceptio ...

  4. SpringMVC源码分析(3)DispatcherServlet的请求处理流程

    <springmvc源码分析(2)dispatcherservlet的初始化>初始化DispatcherServlet的多个组件. 本文继续分析DispatcherServlet解析请求的 ...

  5. 8、SpringMVC源码分析(3):分析ModelAndView的形成过程

    首先,我们还是从DispatcherServlet.doDispatch(HttpServletRequest request, HttpServletResponse response) throw ...

  6. 7、SpringMVC源码分析(2):分析HandlerAdapter.handle方法,了解handler方法的调用细节以及@ModelAttribute注解

    从上一篇 SpringMVC源码分析(1) 中我们了解到在DispatcherServlet.doDispatch方法中会通过 mv = ha.handle(processedRequest, res ...

  7. springMVC源码分析--HandlerAdapter(一)

    HandlerAdapter的功能实际就是执行我们的具体的Controller.Servlet或者HttpRequestHandler中的方法. 类结构如下:

  8. springMVC源码分析--视图AbstractView和InternalResourceView(二)

    上一篇博客springMVC源码分析--视图View(一)中我们介绍了简单介绍了View的结构实现及运行流程,接下来我们介绍一下View的实现类做的处理操作. AbstractView实现了rende ...

  9. springMVC源码分析--视图View(一)

    之前的博客springMVC源码分析--HttpMessageConverter数据转化(一)中我们已经介绍了数据返回值的处理,在博客springMVC源码分析--ViewResolver视图解析器( ...

随机推荐

  1. Nginx-反向代理实现

    Nginx 反向代理操作案例 Nginx反向代理的组件模块 upstream模块介绍->点我< http_proxy_module模块介绍->点我< 环境准备 1)四台服务器都 ...

  2. JavaScript手工编写滚动条组件

    0 前言 上周的一个练习,由于没来得及编写笔记,这里补充一下~ 虽然CSS3中提供了overflow:scroll; 来实现滚动条,但是这里可以使用原生JS来编写一个,以达到练习组件编写的效果. 练习 ...

  3. java 11 实现RFC7539中指定的ChaCha20和Poly1305两种加密算法, 代替RC4

    实现 RFC 7539的ChaCha20 and ChaCha20-Poly1305加密算法 RFC7748定义的秘钥协商方案更高效, 更安全. JDK增加两个新的接口 XECPublicKey 和 ...

  4. logstash 自动重新加载配置

    自动重新加载配置 为了可以自动检测配置文件的变动和自动重新加载配置文件,需要在启动的时候使用以下命令: ./bin/lagstash -f configfile.conf --config.reloa ...

  5. loj6074 子序列

    题目链接 思路 首先考虑暴力\(dp\) 用\(f[i][j]\)表示前\(i\)个字符,以\(j\)这个字符结尾的本质不同的字符串个数. 然后就有如下的转移 \(if(s_i==j)\) \[f_{ ...

  6. 第五周java学习总结

    学号 20175206<Java程序设计>第五周学习总结 教材学习内容总结 6.1 接口 为了克服Java单继承的缺点,Java使用了接口,一个类可以实现多个接口. 使用关键字interf ...

  7. 状压dp(状态压缩&&dp结合)学习笔记(持续更新)

    嗯,作为一只蒟蒻,今天再次学习了状压dp(学习借鉴的博客) 但是,依旧懵逼·································· 这篇学习笔记是我个人对于状压dp的理解,如果有什么不对的 ...

  8. 基于jeesite的cms系统(四):使用Beetl模版引擎在后端渲染数据

    一.Beetl简介 1. 什么是Beetl Beetl目前版本是2.9.3,相对于其他java模板引擎,具有功能齐全,语法直观,性能超高,以及编写的模板容易维护等特点.使得开发和维护模板有很好的体验. ...

  9. javascript 获取字符递增

    比如A->B,AA->AB,Z->AA 参考https://blog.csdn.net/xiaotao2004/article/details/75096607 C#版本,改写为ja ...

  10. R语言数据集的技术

    特征值选择技术要点 特征值选择技术要点(特征值分解) 作者:王立敏 文章来源:xiahouzuoxin 一.特征值分解 1.特征值分解 线性代数中,特征分解(Eigendecomposition),又 ...