【统一异常处理】@ControllerAdvice + @ExceptionHandler 全局处理 Controller 层异常
1.利用springmvc注解对Controller层异常全局处理
对于与数据库相关的 Spring MVC 项目,我们通常会把 事务 配置在 Service层,当数据库操作失败时让 Service 层抛出运行时异常,Spring 事物管理器就会进行回滚。
如此一来,我们的 Controller 层就不得不进行 try-catch Service 层的异常,否则会返回一些不友好的错误信息到客户端。但是,Controller 层每个方法体都写一些模板化的 try-catch 的代码,很难看也难维护,特别是还需要对 Service 层的不同异常进行不同处理的时候。
1.1优缺点
- 优点:将Controller层的异常和数据校验的异常进行统一异常处理,减少模板代码,减少代码量,提升扩展性和可维护性、
- 缺点:只能处理Controller层未捕获(从Servcie层抛过来)的异常,对于Interceptor(拦截器)层的异常,Spring框架层的异常,就无能为力了。
1.2基本使用
1.2.1@ControllerAdvice 注解定义全局异常处理类
首先,确保此类GlobalExceptionHandler 能被扫描到并装载进Spring容器中。
@ControllerAdvice public class GlobalExceptionHandler { }
1.2.2@ExceptionHandler 注解声明异常处理方法
@ControllerAdvice public class GlobalExceptionHandler {@ExceptionHandler(Exception.class)@ResponseBodyString handleException(){return "Exception Deal!";} }
方法 handleException() 就会处理所有 Controller 层抛出的 Exception 及其子类的异常,这是最基本的用法了。
被 @ExceptionHandler 注解的方法的参数列表里,还可以声明很多种类型的参数,详见文档。其原型如下:
@Target(ElementType.METHOD) @Retention(RetentionPolicy.RUNTIME) @Documented public @interface ExceptionHandler {/*** Exceptions handled by the annotated method. If empty, will default to any* exceptions listed in the method argument list.*/Class<? extends Throwable>[] value() default {};}
如果 @ExceptionHandler 注解中未声明要处理的异常类型,则默认为参数列表中的异常类型。所以上面的写法,还可以写成这样:
@ControllerAdvice public class GlobalExceptionHandler {@ExceptionHandler()@ResponseBodyString handleException(Exception e){return "Exception Deal! " + e.getMessage();} }
参数对象就是 Controller 层抛出的异常对象!
1.3处理Service层上抛的业务异常
1.3.1代码示例
@ControllerAdvice public class GlobalExceptionHandler {private static final Logger LOGGER = LoggerFactory.getLogger(GlobalExceptionHandler.class);/*** 处理所有不可知的异常* @param e* @return*/@ExceptionHandler(Exception.class)@ResponseBodyAppResponse handleException(Exception e){LOGGER.error(e.getMessage(), e);AppResponse response = new AppResponse();response.setFail("操作失败!");return response;}/*** 处理所有业务异常* @param e* @return*/@ExceptionHandler(BusinessException.class)@ResponseBodyAppResponse handleBusinessException(BusinessException e){LOGGER.error(e.getMessage(), e);AppResponse response = new AppResponse();response.setFail(e.getMessage());return response;} }
BusinessException属于业务自定义异常类
@RestController @RequestMapping(value = "/dogs", consumes = {MediaType.APPLICATION_JSON_UTF8_VALUE}) public class DogController {@Autowiredprivate DogService dogService;@PatchMapping(value = "")Dog update(@Validated(Update.class) @RequestBody Dog dog){return dogService.update(dog);} }
这样Controller层就不需要进行异常处理了;
有时我们会在复杂带有数据库事务的业务中,当出现不和预期的数据时,直接抛出封装后的业务级运行时异常,进行数据库事务回滚,并希望该异常信息能被返回显示给用户。
我们可以使用自定义异常类可以针对具体业务处理异常;
Logger 进行所有的异常日志记录。
@ExceptionHandler(BusinessException.class) 声明了对 BusinessException 业务异常的处理,并获取该业务异常中的错误提示,构造后返回给客户端。
@ExceptionHandler(Exception.class) 声明了对 Exception 异常的处理,起到兜底作用,不管 Controller 层执行的代码出现了什么未能考虑到的异常,都返回统一的错误提示给客户端。
备注:以上 GlobalExceptionHandler 只是返回 Json 给客户端,更大的发挥空间需要按需求情况来做。
但是实际开发中并不这么做,因为返回的Response对象可能封装不同的数据,放在同一异常处理固然是方便,但是可能不实用;
1.4处理Controller数据绑定、数据校验的异常
在Dog类中的字段上的注解数据校验规则:
@Data public class Dog {@NotNull(message = "{Dog.id.non}", groups = {Update.class})@Min(value = 1, message = "{Dog.age.lt1}", groups = {Update.class})private Long id;@NotBlank(message = "{Dog.name.non}", groups = {Add.class, Update.class})private String name;@Min(value = 1, message = "{Dog.age.lt1}", groups = {Add.class, Update.class})private Integer age; }
说明:
说明:@NotNull、@Min、@NotBlank 这些注解的使用方法,不在本文范围内。如果不熟悉,请查找资料学习即可。
其他说明:
@Data 注解是 **Lombok** 项目的注解,可以使我们不用再在代码里手动加 getter & setter。
在 Eclipse 和 IntelliJ IDEA 中使用时,还需要安装相关插件,这个步骤自行Google/Baidu 吧!
Lombok 使用方法见:Java奇淫巧技之Lombok
基本使用:
SpringMVC 中对于 RESTFUL 的 Json 接口来说,数据绑定和校验,是这样的:
/*** 使用 GlobalExceptionHandler 全局处理 Controller 层异常的示例* @param dog* @return*/ @PatchMapping(value = "") AppResponse update(@Validated(Update.class) @RequestBody Dog dog){AppResponse resp = new AppResponse();// 执行业务Dog newDog = dogService.update(dog);// 返回数据 resp.setData(newDog);return resp; }
使用 @Validated + @RequestBody
注解实现。
当使用了 @Validated + @RequestBody 注解但是没有在绑定的数据对象后面跟上 Errors 类型的参数声明的话,Spring MVC 框架会抛出 MethodArgumentNotValidException 异常。
所以,在 GlobalExceptionHandler 中加上对 MethodArgumentNotValidException 异常的声明和处理,就可以全局处理数据校验的异常了!加完后的代码如下:
/*** Created by kinginblue on 2017/4/10.* @ControllerAdvice + @ExceptionHandler 实现全局的 Controller 层的异常处理*/ @ControllerAdvice public class GlobalExceptionHandler {private static final Logger LOGGER = LoggerFactory.getLogger(GlobalExceptionHandler.class);/*** 处理所有不可知的异常* @param e* @return*/@ExceptionHandler(Exception.class)@ResponseBodyAppResponse handleException(Exception e){LOGGER.error(e.getMessage(), e);AppResponse response = new AppResponse();response.setFail("操作失败!");return response;}/*** 处理所有业务异常* @param e* @return*/@ExceptionHandler(BusinessException.class)@ResponseBodyAppResponse handleBusinessException(BusinessException e){LOGGER.error(e.getMessage(), e);AppResponse response = new AppResponse();response.setFail(e.getMessage());return response;}/*** 处理所有接口数据验证异常* @param e* @return*/@ExceptionHandler(MethodArgumentNotValidException.class)@ResponseBodyAppResponse handleMethodArgumentNotValidException(MethodArgumentNotValidException e){LOGGER.error(e.getMessage(), e);AppResponse response = new AppResponse();response.setFail(e.getBindingResult().getAllErrors().get(0).getDefaultMessage());return response;} }
注意到了吗,所有的 Controller 层的异常的日志记录,都是在这个 GlobalExceptionHandler 中进行记录。也就是说,Controller 层也不需要在手动记录错误日志了。
其实,可以利用springaop进行拦截,然后记录日志,详情请看springaop【统一日志处理】相关文章。
1.5总结
其实,被 @ExceptionHandler 注解的方法还可以声明很多参数,详见文档。
@ControllerAdvice 也还可以结合 @InitBinder、@ModelAttribute 等注解一起使用,应用在所有被 @RequestMapping 注解的方法上,详见搜索引擎。
参考文章链接:
https://blog.csdn.net/kinginblue/article/details/70186586
转载于:https://www.cnblogs.com/AlanWilliamWalker/p/9993845.html
【统一异常处理】@ControllerAdvice + @ExceptionHandler 全局处理 Controller 层异常相关推荐
- Spring - @ControllerAdvice + @ExceptionHandler全局处理Controller层异常(转)
Spring - @ControllerAdvice + @ExceptionHandler全局处理Controller层异常(转) 参考文章: (1)Spring - @ControllerAdvi ...
- @ControllerAdvice + @ExceptionHandler 全局处理 Controller 层异常
@ControllerAdvice 和 @ExceptionHandler 的区别 ExceptionHandler, 方法注解, 作用于 Controller 级别. ExceptionHandle ...
- @ControllerAdvice + @ExceptionHandler 处理 全部Controller层异常
对于与数据库相关的 Spring MVC 项目,我们通常会把 事务 配置在 Service层,当数据库操作失败时让 Service 层抛出运行时异常,Spring 事物管理器就会进行回滚. 如此一来, ...
- 统一异常处理ControllerAdvice
用这个@ControllerAdvice 注解处理不同异常,下面是一个鉴权异常统一处理,可以跳转到异常页面,或提示未授权; package cn.itcast.shiro;import org.apa ...
- SpringBoot 统一异常处理 ControllerAdvice
转载请标明出处:http://blog.csdn.net/zhaoyanjun6/article/details/80678034 本文出自[赵彦军的博客] 在用spring Boot做web后台时, ...
- Springboot对web应用的统一异常处理
我们在做Web应用的时候,请求处理过程中发生错误是非常常见的情况.Spring Boot提供了一个默认的映射:/error,当处理中抛出异常之后,会转到该请求中处理,并且该请求有一个全局的错误页面用来 ...
- Springboot中如何优雅的写好Controller层代码
前言 优雅?看到这个词,我第一反应是什么是优雅?怎么写才算优雅?一千个读者有一千个哈姆雷特,每个人的经验.阅历不同,也许理解就不同.我对优雅的理解很简单,就是简洁有效.容易理解,别那么多套路.java ...
- Spring MVC统一异常处理
Spring MVC统一异常处理 一.为什么需要统一异常处理? 1.1 try catch带来的问题 平时项目中处理Controller层异常很多时候都会使用try catch去捕获异常(包括Cont ...
- Spring Boot @ControllerAdvice 处理全局异常,返回固定格式Json
需求 在构建RestFul的今天,我们一般会限定好返回数据的格式比如: { "code": 0, "data": {}, "msg" ...
最新文章
- linux平台的实验描述,基于LINUX的操作系统实验平台的设计与实现
- 【学术相关】高校教师提前离职需支付“天价违约金”,坑!
- 【❤️算法系列之二叉树的实现(包含前序、中序、后序遍历以及节点的查找和删除)❤️】
- 你可以通过这13种方法帮助Linux发展
- Windows新终端中玩转ASCII和Emoji游戏的正确姿势
- 利用Android 8.0 ShortcutManager创建桌面快捷图标
- Anaconda——如何“重命名”conda虚拟环境(通过复制和删除操作实现)
- python 菜鸟-Python3 模块
- Java常用集合笔记
- Python 基础数据类型
- 大学计算机作业互评评语简短,学生作业互评表的填写方法
- 骇基-黑客攻防实战入门⑴
- 思科路由器OSPF配置实例
- MATLAB 使用 loglog semilogy 不显示对数坐标
- 高级WEB前端游戏开发视频教程
- 拷机测试需要多久_网站建设要多久?
- 【构造+拓扑序】【JZOJ5405】Permutation
- 幼儿园手工之自制时钟_幼儿园手工时钟玩教具制作图片
- soapui 证书_配置https双向认证,以及用soapui调试
- “美亚杯”第二届中国电子数据取证大赛答案解析(团体赛)
热门文章
- python绘制散点图的函数_python绘制散点图
- AcWing 891. Nim游戏(nim博弈)
- AcWing 844. 走迷宫(BFS or DP)
- java locale string_Java Locale toString()用法及代码示例
- access month函数用法_掌握时间智能函数,同比环比各种比,轻松搞定!
- 来自一个用户的体验-Alpha项目测试
- 也来谈一谈js的浅复制和深复制
- 阿里巴巴战略投资苏宁体育!
- java基础三--IO流(1)
- cobertura试用