day14-异常处理
异常处理
1.基本介绍
-
SpringMVC 通过 HandlerExceptionResolver 处理程序的异常,包括 Handler映射、数据绑定以及目标方法执行时发生的异常
-
有两种方案来进行异常处理:
a.在本类编写处理异常的方法,将抛出的异常视为局部异常处理
b.额外编写处理异常的类,将抛出的异常视为全局异常处理
-
主要处理的是 Handler 中使用了 @ExceptionHandler 注解修饰的方法(局部异常处理)
-
ExceptionHandlerMethodResolver 内部若找不到上述 @ExceptionHandler 注解修饰的方法,就会去找有 @ControllerAdvice 注解修饰的类中含有 @ExceptionHandler 注解的方法,被 @ControllerAdvice 修饰的类称为全局处理器(全局异常处理)
-
异常处理时,局部异常优先级高于全局异常
2.局部异常
2.1应用实例
(1)创建 MyExceptionHandler.java,在这个 Handler 中模拟各种出现的异常,并在本类添加处理可能出现的异常的方法(局部异常)
局部异常的处理方法只能处理本类中出现的异常。
package com.li.web.exception;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RequestMapping;
import javax.servlet.http.HttpServletRequest;
/**
* @author 李
* @version 1.0
*/
@Controller
public class MyExceptionHandler {
/**
* 1.localException()方法处理局部异常
* 2.指定处理 算术异常、空指针异常
* 3. Exception ex 本类生成的异常对象,会传递给ex,通过ex可以拿到相关信息,
* 在这里可以加入业务逻辑
* @param ex
* @param request
* @return
*/
@ExceptionHandler({ArithmeticException.class, NullPointerException.class})
public String localException(Exception ex, HttpServletRequest request) {
System.out.println("局部异常信息是=" + ex.getMessage());
//如何将异常的信息带到下一个页面(根据你的业务逻辑)
request.setAttribute("reason", ex.getMessage());
return "exception_mes";
}
/**
* 1.编写方法,模拟异常-算术异常
* 2.如果我们不做异常处理,是由tomcat默认页面处理
* @param num
* @return
*/
@RequestMapping(value = "/testException01")
public String test01(Integer num) {
int i = 9 / num;
return "success";
}
}
(2)exception_mes.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>异常信息</title>
</head>
<body>
<h1>异常信息提示</h1>
<h4>${requestScope.reason}</h4>
</body>
</html>
(3)测试,直接访问 http://localhost:8080/springmvc/testException01?num=0
,显示结果如下:
捕获到了异常,SpringMVC 底层反射调用了 localException 方法进行异常处理,跳转到了 exception_mes.jsp 页面提示异常信息。
如果我们没有处理异常,默认是由 tomcat 进行异常处理
2.2执行流程
从发生异常到捕获异常并调用处理方法,局部异常处理的整个执行流程是怎样的呢?
第一步:浏览器访问目标方法,如果出现异常,会到 ExceptionHandlerMethodResolver 类中执行 resolveMethodByExceptionType() 方法
第二步:执行resolveMethodByExceptionType() 方法,得到处理异常的方法。
@Nullable
public Method resolveMethodByExceptionType(Class<? extends Throwable> exceptionType) {
//获取目标方法出现的异常类型 exceptionType
//然后通过map去找有没有一个默认的方法去处理这个异常
Method method = this.exceptionLookupCache.get(exceptionType);
if (method == null) {//如果没有默认方法
//getMappedMethod 得到该异常映射的处理方法,如例子中的 localException() 方法
method = getMappedMethod(exceptionType);
//将找到的这个方法作为 该异常的处理方法,放入到map中
this.exceptionLookupCache.put(exceptionType, method);
}
//返回这个方法
return (method != NO_MATCHING_EXCEPTION_HANDLER_METHOD ? method : null);
}
第三步:将得到的异常数据放入到该方法的参数中,底层反射调用处理异常的该方法
第四步:根据处理异常方法,执行自定义的业务逻辑。如例子中跳到某个页面并提示异常信息。
3.全局异常
3.1应用实例
演示全局异常处理机制。
ExceptionHandlerMethodResolver 内部若找不到 @ExceptionHandler 注解的方法,就会找 @ControllerAdvice 类的 @ExceptionHandler 注解方法,这样就相当于一个全局处理器,全局处理器可以处理不同的 Handler 出现的异常。
(1)自定义一个全局处理器 MyGlobalException.java
package com.li.web.exception;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import javax.servlet.http.HttpServletRequest;
/**
* @author 李
* @version 1.0
* 如果一个类上标注了 @ControllerAdvice,那么这个类就是一个全局异常处理器
*/
@ControllerAdvice
public class MyGlobalException {
/**
* 1.不管是哪个 Handler抛出的异常,全局异常都可以捕获
* 2.@ExceptionHandler({这里是可以捕获的异常类型})
* @param ex 接收抛出的异常对象
* @return
*/
@ExceptionHandler({NumberFormatException.class, ClassCastException.class})
public String globalException(Exception ex, HttpServletRequest request) {
System.out.println("全局异常处理=" + ex.getMessage());
//业务处理-将异常信息带到下一个页面并显示
request.setAttribute("reason", ex.getMessage());
return "exception_mes";
}
}
(2)在 Handler 的目标方法中模拟异常
package com.li.web.exception;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RequestMapping;
import javax.servlet.http.HttpServletRequest;
/**
* @author 李
* @version 1.0
*/
@Controller
public class MyExceptionHandler {
//局部异常处理方法
@ExceptionHandler({ArithmeticException.class, NullPointerException.class})
public String localException(Exception ex, HttpServletRequest request) {
System.out.println("局部异常信息是=" + ex.getMessage());
//如何将异常的信息带到下一个页面(根据你的业务逻辑)
request.setAttribute("reason", ex.getMessage());
return "exception_mes";
}
//目标方法
@RequestMapping(value = "testGlobalException")
public String global() {
//模拟一个 NumberFormatException异常,若该异常不能在局部异常方法处理,
//就会被交到全局异常处理器中处理
int num = Integer.parseInt("hello");
return "success";
}
}
(3)exception_mes.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>异常信息</title>
</head>
<body>
<h1>异常信息提示</h1>
<h4>${requestScope.reason}</h4>
</body>
</html>
(3)在浏览器中访问目标方法 http://localhost:8080/springmvc/testGlobalException
,可以看到页面提示了异常信息,同时后台输出为 全局异常处理=For input string: "hello"
,这说明是全局异常处理器捕获到的异常,局部异常方法没有捕获到。
3.2执行流程
从发生异常到捕获异常并调用处理方法,全局异常处理的流程如下:
(1)浏览器访问目标方法,若出现异常,会到 ExceptionHandlerExceptionResolver 类的 ServletInvocableHandlerMethod() 方法进行处理:
(2)上述方法首先会到 ExceptionHandlerMethodResolver 类中执行 resolveMethod 方法
(3)resolveMethod 方法又调用本类的 resolveMethodByThrowable 方法
(4)resolveMethodByThrowable 继续调用本类的 resolveMethodByExceptionType() 方法:
@Nullable
public Method resolveMethodByExceptionType(Class<? extends Throwable> exceptionType) {
//获取目标方法的异常类型 exceptionType
//通过map去找处理该异常的默认的方法
Method method = this.exceptionLookupCache.get(exceptionType);
if (method == null) {//若没有默认方法
//得到该异常映射的处理方法,这一步如果没有在Handler类中找到处理方法,
//如局部异常方法不匹配该异常,就会返回一个 noMatchingExceptionHandler() 的方法
method = getMappedMethod(exceptionType);
//将找到的这个方法作为 该异常的处理方法,放入到map中
this.exceptionLookupCache.put(exceptionType, method);
}
//若 method为 noMatchingExceptionHandler(),则返回一个 null
return (method != NO_MATCHING_EXCEPTION_HANDLER_METHOD ? method : null);
}
(5)如果 resolveMethodByExceptionType() 方法没有在本类 Handler 中匹配到可以解决出现的异常的方法,就返回 null
@Nullable
public Method resolveMethodByThrowable(Throwable exception) {
//如果 mothod 返回 null
Method method = resolveMethodByExceptionType(exception.getClass());
if (method == null) {
//获取出现异常的原因
Throwable cause = exception.getCause();
if (cause != null) {
//根据异常找匹配的方法
method = resolveMethodByThrowable(cause);
}
}
//如果返回null
return method;
}
(6)一路返回到 ExceptionHandlerExceptionResolver 类的 ServletInvocableHandlerMethod() 方法,如果获取到的 method 仍为 null,就会去遍历带有 @ControllerAdvice 注解修饰的类(全局处理器),然后全局处理器中根据 @ExceptionHandler 注解,获取可以处理异常的方法。
这里的 entry.getKey() 就是 @ControllerAdvice 注解修饰的类对象。
(7)最后反射调用找到的全局处理器中的方法。
4.自定义异常
可以通过 @ResponseStatus 注解,来自定义异常的说明
4.1应用实例
(1)自定义异常
package com.li.web.exception;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ResponseStatus;
/**
* @author 李
* @version 1.0
*/
@ResponseStatus(reason = "年龄需要在1-120之间",value = HttpStatus.BAD_REQUEST)
public class AgeException extends RuntimeException{
}
(2)修改 MyExceptionHandler.java,增加方法进行测试
package com.li.web.exception;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
/**
* @author 李
* @version 1.0
*/
@Controller
public class MyExceptionHandler {
@RequestMapping(value = "/testException02")
public String test02() {
throw new AgeException();
}
}
(3)浏览器访问 http://localhost:8080/springmvc/testException02
,测试显示如下:
访问目标方法,抛出异常,异常的信息就是你指定的信息,状态码也是你指定的数据
4.2拓展
自定义异常可以被局部异常处理和全局异常处理接管,只需要在 @ExceptionHandler 注解中添加自定义异常的.class即可
1.当然,如果想要拿到 ex.getMessage() 信息,需要在自定义的异常类创建带有 message 参数的构造器
自定义异常的 reason,value 属性是给 tomcat 的默认页面显示的,而构造器的 messgae 属性是传入对象的
2.然后在创建异常类对象的时候放入提示信息:
自定义异常本质就是异常,它的处理流程由 它被局部异常还是全局异常接管 而定。如果两者都没有接管,就会被 tomcat 来处理,然后 tomcat 显示一个默认的页面。
5.SimpleMappingExceptionResolver
5.1基本说明
- 如果希望对所有异常进行统一处理,可以使用 SimpleMappingExceptionResolver
- 它将异常类名映射为视图名,即发生异常时使用对应的视图报告异常
- 需要在 spring 的容器文件中配置
5.2应用实例
需求:使用 SimpleMappingExceptionResolver 对数据越界异常进行统一处理
(1)修改 MyExceptionHandler.java,增加方法 test03
//模拟数据下标越界异常
@RequestMapping(value = "/testException03")
public String test03() {
int[] arr = {3, 8, 18, 20};
System.out.println(arr[99]);
return "success";
}
(2)在 spring 容器文件配置
<!--配置统一异常处理的bean-->
<bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">
<property name="exceptionMappings">
<props>
<!--key为处理的异常的全路径,
arrEx为出现异常后要跳转的页面(页面所在的目录要和你的视图解析器的前后缀匹配)-->
<prop key="java.lang.ArrayIndexOutOfBoundsException">arrEx</prop>
</props>
</property>
</bean>
(3)arrEx.jsp,该页面显示异常信息
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>数组下标越界异常</title>
</head>
<body>
异常信息:数组下标越界异常
</body>
</html>
(4)浏览器访问目标方法,返回的页面显示:跳转到了 arrEx.jsp 页面。
目标方法发生异常—>先去局部异常方法处理—>如果不行,到全局异常处理器处理—>如果不行,到容器文件配置统一异常处理的 bean 处理—>都不行,最后由 tomcat 处理
5.3对未知异常进行统一处理
在实际开发中,异常的种类非常多,我们的异常处理方法可能不能捕获到所有的异常。
如何处理没有归类(未知的)的异常?
仍然可以使用 SimpleMappingExceptionResolver 进行处理。只需要在配置的时候,将捕获的异常范围扩大,如Exception。
例子
(1)修改 MyExceptionHandler.java,增加方法 test04
//如果发生了没有归类的异常,可以给出统一的提示页面
@RequestMapping(value = "/testException04")
public String test04() {
String str = "hello";
//StringIndexOutOfBoundsException
char c = str.charAt(10);
return "success";
}
(2)容器文件配置处理异常的bean时,扩大捕获范围
<!--配置统一异常处理的bean-->
<bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">
<property name="exceptionMappings">
<props>
<prop key="java.lang.ArrayIndexOutOfBoundsException">arrEx</prop>
<!--捕获未知异常-->
<prop key="java.lang.Exception">allEx</prop>
</props>
</property>
</bean>
(3)allEx.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>异常通知</title>
</head>
<body>
<h1>系统发生了未知异常..</h1>
</body>
</html>
(4)浏览器访问目标方法,访问结果如下:
5.4异常处理的优先级
局部异常处理 > 全局异常处理 > SimpleMappingExceptionResolver 处理 > tomcat 默认机制处理