1. 为什么需要使用全局捕获异常?
请看一下案列,这个是Controller层,
@RestController
public class ErrorController {
// private static final Logger logger =
// LoggerFactory.getLogger(JspController.class);
// 分布式日志收集系统##
// 全局捕获异常 使用AOP技术,采用异常通知
// 如果每个方法都可能会发生异常,每个方法上都加上try。
@RequestMapping("/getUser")
@ResponseBody
public String getser(int i) {
int j = 1 / i;
return j + " fvsdbf ";
}
@RequestMapping("/getMember")
public String getMember(String name, Integer age) {
// logger.info("name:" + name + ",age:" + age);
return "success";
}
}
当前端请求的参数i等于0的时候,这个时候就会出现异常,如下图所示:
这种异常的报告方式显然很不容易被用户接受,也显得很不专业,因此需要使用更加专业的异常报告方式。很多人就会说使用try····catch··进行异常的捕获,如下面的代码所示:
解决效果如下图所示:
但是这种解决方式不是很好。
因此我们就可以采用全局捕获异常的这个技术,整个项目请求全局捕获异常。
全局捕获异常的思路是什么?
使用AOP技术,异常通知的方式进行,通过新建一个类进行异常的捕获
第一种:捕获返回json格式的
第二种:捕获返回页面(比如:html,jsp等页面的异常)
具体代码如下:
/*------------@ControllerAdvice(basePackages = "com.itmayiedu.controller") -----这个代表springboot中的异常切入点,后面会跟扫包范围,最好是在controller的包中进行监控
// @ResponseBody 返回json格式
// modeAndView 返回页面
---------------*/
@ControllerAdvice(basePackages = "com.itmayiedu.controller")
public class GlobalExceptionHandler {
@ExceptionHandler(RuntimeException.class)
@ResponseBody
public Map
// 实际开发中,怎么 将错误记录在日志中。
Map
errorResultMap.put("errorCode", "500");
errorResultMap.put("errorMsg", "全局捕获异常系统错误!");
return errorResultMap;
}
}
但是,我们不能再使用try-----catch,必须使用原生的控制层代码。
@RestController
public class ErrorController {
// private static final Logger logger =
// LoggerFactory.getLogger(JspController.class);
// 分布式日志收集系统##
// 全局捕获异常 使用AOP技术,采用异常通知
// 如果每个方法都可能会发生异常,每个方法上都加上try。
@RequestMapping("/getUser")
@ResponseBody
public String getser(int i) {
int j = 1 / i;
return j + " fvsdbf ";
}
@RequestMapping("/getMember")
public String getMember(String name, Integer age) {
// logger.info("name:" + name + ",age:" + age);
return "success";
}
}
二、更详细的处理方式介绍(该处为借鉴别人)
Spring 统一异常处理有 3 种方式,分别为:
1.使用 @ ExceptionHandler 注解
2.实现 HandlerExceptionResolver 接口
3.使用 @controlleradvice 注解
我们知道,系统中异常包括:编译时异常和运行时异常RuntimeException,前者通过捕获异常从而获取异常信息,后者主要通过规范代码开发、测试通过手段减少运行时异常的发生。在开发中,不管是dao层、service层还是controller层,都有可能抛出异常,在springmvc中,能将所有类型的异常处理从各处理过程解耦出来,既保证了相关处理过程的功能较单一,也实现了异常信息的统一处理和维护。
(一) SimpleMappingExceptionResolver
使用这种方式具有集成简单、有良好的扩展性、对已有代码没有入侵性等优点,但该方法仅能获取到异常信息,若在出现异常时,对需要获取除异常以外的数据的情况不适用。
1 @Configuration 2 @EnableWebMvc 3 @ComponentScan(basePackages = {"com.balbala.mvc.web"}) 4 public class WebMVCConfig extends WebMvcConfigurerAdapter{ 5 @Bean 6 public SimpleMappingExceptionResolver simpleMappingExceptionResolver() 7 { 8 SimpleMappingExceptionResolver b = new SimpleMappingExceptionResolver(); 9 Properties mappings = new Properties(); 10 mappings.put("org.springframework.web.servlet.PageNotFound", "page-404"); 11 mappings.put("org.springframework.dao.DataAccessException", "data-access"); 12 mappings.put("org.springframework.transaction.TransactionException", "transaction-Failure"); 13 b.setExceptionMappings(mappings); 14 return b; 15 } 16 }
(二) HandlerExceptionResolver
相比第一种来说,HandlerExceptionResolver能准确显示定义的异常处理页面,达到了统一异常处理的目标
1.定义一个类实现HandlerExceptionResolver接口
1 public class GlobalHandlerExceptionResolver implements HandlerExceptionResolver { 2 private static final Logger LOG = LoggerFactory.getLogger(GlobalHandlerExceptionResolver.class); 3 /** 4 * 在这里处理所有得异常信息 5 */ 6 @Override 7 public ModelAndView resolveException(HttpServletRequest req, HttpServletResponse resp, Object o, Exception ex) { 8 ex.printStackTrace(); 9 if (ex instanceof AthenaException) { 10 //AthenaException为一个自定义异常 11 ex.printStackTrace(); 12 printWrite(ex.toString(), resp); 13 return new ModelAndView(); 14 } 15 //RspMsg为一个自定义处理异常信息的类 16 //ResponseCode为一个自定义错误码的接口 17 RspMsg unknownException = null; 18 if (ex instanceof NullPointerException) { 19 unknownException = new RspMsg(ResponseCode.CODE_UNKNOWN, "业务判空异常", null); 20 } else { 21 unknownException = new RspMsg(ResponseCode.CODE_UNKNOWN, ex.getMessage(), null); } 22 printWrite(unknownException.toString(), resp); 23 return new ModelAndView(); 24 } 25 26 /** 27 * 将错误信息添加到response中 28 * 29 * @param msg 30 * @param response 31 * @throws IOException 32 */ 33 public static void printWrite(String msg, HttpServletResponse response) { 34 try { 35 PrintWriter pw = response.getWriter(); 36 pw.write(msg); 37 pw.flush(); 38 pw.close(); 39 } catch (Exception e) { 40 e.printStackTrace(); 41 } 42 } 43 }
这种方式实现的异常处理,可以针对不同的异常和自己定义的异常码进行翻译,然后输出到response中,在前端展示。
(三)@ExceptionHandler
1.首先定义一个父类,实现一些基础的方法
1 public class BaseGlobalExceptionHandler { 2 protected static final Logger logger = null; 3 protected static final String DEFAULT_ERROR_MESSAGE = "系统忙,请稍后再试"; 4 5 protected ModelAndView handleError(HttpServletRequest req, HttpServletResponse rsp, Exception e, String viewName, HttpStatus status) throws Exception { 6 if (AnnotationUtils.findAnnotation(e.getClass(), ResponseStatus.class) != null) 7 throw e; 8 String errorMsg = e instanceof MessageException ? e.getMessage() : DEFAULT_ERROR_MESSAGE; 9 String errorStack = Throwables.getStackTraceAsString(e); 10 11 getLogger().error("Request: {} raised {}", req.getRequestURI(), errorStack); 12 if (Ajax.isAjax(req)) { 13 return handleAjaxError(rsp, errorMsg, status); 14 } 15 return handleViewError(req.getRequestURL().toString(), errorStack, errorMsg, viewName); 16 } 17 18 protected ModelAndView handleViewError(String url, String errorStack, String errorMessage, String viewName) { 19 ModelAndView mav = new ModelAndView(); 20 mav.addObject("exception", errorStack); 21 mav.addObject("url", url); 22 mav.addObject("message", errorMessage); 23 mav.addObject("timestamp", new Date()); 24 mav.setViewName(viewName); 25 return mav; 26 } 27 28 protected ModelAndView handleAjaxError(HttpServletResponse rsp, String errorMessage, HttpStatus status) throws IOException { 29 rsp.setCharacterEncoding("UTF-8"); 30 rsp.setStatus(status.value()); 31 PrintWriter writer = rsp.getWriter(); 32 writer.write(errorMessage); 33 writer.flush(); 34 return null; 35 } 36 37 public Logger getLogger() { 38 return LoggerFactory.getLogger(BaseGlobalExceptionHandler.class); 39 } 40 }
2.针对你需要捕捉的异常实现相对应的处理方式
1 @ControllerAdvice 2 public class GlobalExceptionHandler extends BaseGlobalExceptionHandler { 3 4 //比如404的异常就会被这个方法捕获 5 @ExceptionHandler(NoHandlerFoundException.class) 6 @ResponseStatus(HttpStatus.NOT_FOUND) 7 public ModelAndView handle404Error(HttpServletRequest req, HttpServletResponse rsp, Exception e) throws Exception { 8 return handleError(req, rsp, e, "error-front", HttpStatus.NOT_FOUND); 9 } 10 11 //500的异常会被这个方法捕获 12 @ExceptionHandler(Exception.class) 13 @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR) 14 public ModelAndView handleError(HttpServletRequest req, HttpServletResponse rsp, Exception e) throws Exception { 15 return handleError(req, rsp, e, "error-front", HttpStatus.INTERNAL_SERVER_ERROR); 16 } 17 18 //TODO 你也可以再写一个方法来捕获你的自定义异常 19 //TRY NOW!!! 20 21 @Override 22 public Logger getLogger() { 23 return LoggerFactory.getLogger(GlobalExceptionHandler.class); 24 } 25 26 }