Spring 中异常处理的各种姿势

1. 前言

统一的异常处理对于应用的重要性不言而喻。今天我们来介绍一下 Spring 如何来进行统一的 Rest 异常处理。同时我们也会简单比较一下它们之间的优劣。

2. @Controller 结合 @ExceptionHandler

在控制器中声明一个方法然后用 @ExceptionHandler 注解标记即可:

 @Controller
 @RequestMapping("/test")
 public class TestController {
  
     @RequestMapping("/err")
     @ResponseBody
     public Object demo1(){
         int i = 1 / 0;
         return new Date();
     }
  
     @ExceptionHandler({RuntimeException.class})
     public ModelAndView fix(Exception ex){
         System.out.println(ex.getMessage());
         return new ModelAndView("error",new ModelMap("ex",ex.getMessage()));
     }
 }

优点:

  • 优先级最高。

  • @ExceptionHandler 标记的方法返回值类型支持多种。可以是视图,也可以是 json 等。

缺点:

  • 一个 Controller 中的 @ExceptionHandler 注解上的异常类型不能出现相同的,否则运行时抛异常。

  • 需要显式的声明处理的异常类型。

  • 作用域仅仅是该 Controller 并不是真正意义上的全局异常。如果要想作用于全局需要将其放入所有控制器的父类中。

3. @ControllerAdvice 结合 @ExceptionHandler

这是 2. 的改进型,通过定义 @ControllerAdvice 类并在方法上标记 @ExceptionHandler ,达到了全局异常处理的目的:

 @ControllerAdvice
 public class TestController {
 
  
     @ExceptionHandler({RuntimeException.class})
     public ModelAndView fix(Exception ex){
         System.out.println(ex.getMessage());
         return new ModelAndView("error",new ModelMap("ex",ex.getMessage()));
     }
 }

优点:

  • 全局的异常处理。

  • 完全控制响应的主体以及状态码

  • 将多个异常映射到同一方法,以一起处理,并且它充分利用了更新的 Restful ResponseEntity 响应

缺点:

  • 一个 Controller 中的 @ExceptionHandler 注解上的异常类型不能出现相同的,否则运行时抛异常。

  • 需要显式的声明处理的异常类型。

一般情况下也建议使用该方式进行异常处理。大多数情况下都是兼容的。

4. HandlerExceptionResolver 接口

实现 HandlerExceptionResolver 接口,这里我们继承其抽象实现 AbstractHandlerExceptionResolver :

 @Component
 public class RestResponseStatusExceptionResolver extends AbstractHandlerExceptionResolver {
  
     @Override
     protected ModelAndView doResolveException(
       HttpServletRequest request, 
       HttpServletResponse response, 
       Object handler, 
       Exception ex) {
         try {
             if (ex instanceof IllegalArgumentException) {
                 return handleIllegalArgument((IllegalArgumentException) ex, response, handler);
             }
            //todo more exception
         } catch (Exception handlerException) {
               //todo 
         }
         return null;
     }
  
     private ModelAndView 
       handleIllegalArgument(IllegalArgumentException ex, HttpServletResponse response) 
       throws IOException {
         response.sendError(HttpServletResponse.SC_CONFLICT);
         String accept = request.getHeader(HttpHeaders.ACCEPT);
           //todo  more  response
         return new ModelAndView();
     }
 }

优点:

  • 这是一个全局的异常处理器。

  • 这种方式全局异常处理返回JSPvelocity 等模板视图比较方便。

  • 支持多种格式的响应,虽然覆写的方法返回的是 ModelAndView 但是因为参数中有 HttpServletResponse, 我们可以利用它来进行定制响应结果。例如,如果二手手游买号客户端要求输入application / json,那么在出现错误情况时,我们要确保我们返回一个以application / json编码的响应。

缺点:

  • 我们需要与低级的 HttpServletResponse 交互才能实现各种形式的响应体。

  • 优先级比较低

5. Spring Boot 中的异常处理

如果你用的框架是 Spring Boot 。 我们还可以用它独特的处理方式。优点是屏蔽了低级的API,缺点也比较明显,无法捕捉到具体的异常。

5.1 实现 ErrorController

Spring Boot 在默认情况下,提供了 /error 映射来处理所有错误,在 Servlet 容器里注册了全局的错误页面(Whitelabel Error Page)并返回客户端。通过实现 ErrorController 接口并注册为 Bean。这里不再举例。可参考 BasicErrorController 。

5.2 添加 ErrorAttributes

我们也可以添加 ErrorAttributes 类型的 Bean 来替换替换默认的异常处理。

 @Component
 public class MyCustomErrorAttributes extends DefaultErrorAttributes {
  
     @Override
     public Map<String, Object> getErrorAttributes(
       WebRequest webRequest, boolean includeStackTrace) {
         Map<String, Object> errorAttributes = 
           super.getErrorAttributes(webRequest, includeStackTrace);
         errorAttributes.put("locale", webRequest.getLocale()
             .toString());
         errorAttributes.remove("error");
  
         //todo your business
  
         return errorAttributes;
     }
 }

5.3 继承基类 BasicErrorController

Spring Boot 自动配置还提供了实现 ErrorController 接口异常处理的基类 BasicErrorController,默认是处理 text/html类型请求的错误,可以继承该基类自定义处理更多的请求类型,添加公共方法并使用 @RequestMapping 注解的 produce属性指定处理类型。

 @Component
 public class MyErrorController extends BasicErrorController {
  
     public MyErrorController(ErrorAttributes errorAttributes) {
         super(errorAttributes, new ErrorProperties());
     }
  
     @RequestMapping(produces = MediaType.APPLICATION_XML_VALUE)
     public ResponseEntity<Map<String, Object>> xmlError(HttpServletRequest request) {
          
     //todo your business
  
     }
 }

6. Spring 5 的 ResponseStatusException

另外在最新的 Spring 5 中你还可以通过 抛出 ResponseStatusException 异常来进行处理。

好处:

  • 使用比较方便

  • 一种类型,多种状态代码:一种异常类型可以导致多种不同的响应。与@ExceptionHandler相比,这减少了紧密耦合

  • 我们将不必创建那么多的自定义异常类

  • 由于可以通过编程方式创建异常,因此可以更好地控制异常处理

缺点:

  • 没有统一的异常处理方式,强制执行某些应用程序范围的约定更加困难

  • 可能会有大量的重复代码。

7. 总结

我们对常用的、不常用的 Spring 处理异常的方式进行了总结和优劣上的分析。 相信你可以从中找到适合你的处理方式。如果对你有用请帮忙点一个赞,您的鼓励,我的动力!

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
Spring 框架异常处理是通过 AOP(面向切面编程)实现的。Spring 提供了一种统一的方式来捕获和处理异常,这样可以使代码更加清晰和易于维护。 Spring 框架异常处理通常包括以下步骤: 1. 定义异常处理器类:在 Spring 异常处理器类需要实现 ExceptionHandler 接口,并通过 @ControllerAdvice 注解来声明。 2. 定义异常处理方法:在异常处理器类,定义与异常对应的方法。该方法应该使用 @ExceptionHandler 注解来声明,以便 Spring 能够自动将其与正确的异常关联起来。 3. 注册异常处理器:在 Spring 配置文件,使用 <mvc:annotation-driven /> 标签来启用 Spring MVC 的注解支持,并使用 <bean> 标签来注册异常处理器。 4. 在控制器抛出异常:当在控制器发生异常时,Spring 将自动将其捕获,并调用相应的异常处理方法进行处理。 例如,以下是一个简单的异常处理器类的示例: ``` @ControllerAdvice public class MyExceptionHandler implements ExceptionHandler<Exception> { @ExceptionHandler(Exception.class) public ModelAndView handleException(Exception ex) { ModelAndView mav = new ModelAndView(); mav.addObject("message", ex.getMessage()); mav.setViewName("error"); return mav; } } ``` 在上面的代码,我们定义了一个异常处理器类 MyExceptionHandler,它实现了 ExceptionHandler 接口,并使用 @ControllerAdvice 注解来声明。该类的 handleException 方法使用 @ExceptionHandler 注解来声明,以便 Spring 能够将其与 Exception 类型的异常关联起来。当发生异常时,该方法将返回一个包含错误信息的 ModelAndView 对象,用于显示错误页面。 注意,我们还需要在 Spring 配置文件注册该异常处理器: ``` <bean class="com.example.MyExceptionHandler" /> <mvc:annotation-driven /> ``` 通过以上步骤,我们就可以在 Spring 框架实现统一的异常处理

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值