Spring 异常处理的各种姿势总结

Spring 异常处理的各种姿势总结

本文实例总结了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();

}

}

优点：

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

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

支持多种格式的响应，虽然覆写的方法返回的是 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 getErrorAttributes(

WebRequest webRequest, boolean includeStackTrace) {

Map errorAttributes =

super.getErrorAttributes(webRequest, includeStackTrace);

errorAttributes.put("locale", webRequest.getLochttp://ale()

.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

//todo your business

}

}

6. Spring 5 的 ResponseStatusException

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

好处：

使用比较方便

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

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

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

缺点：

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

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

7. 总结

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

更多关于java相关内容感兴趣的读者可查看本站专题：《Spring框架入门与进阶教程》、《Java数据结构与算法教程》、《Java操作DOM节点技巧总结》、《Java文件与目录操作技巧汇总》和《Java缓存操作技巧汇总》

希望本文所述对大家java程序设计有所帮助。

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。