spring boot 教程(四) 统一异常处理
我们在做Web应用的时候,请求处理过程中发生错误是非常常见的情况。Spring Boot提供了一个默认的映射:/error
,
当处理中抛出异常之后,会转到该请求中处理,并且该请求有一个全局的错误页面用来展示异常内容。下图列出了Spring Boot中跟
MVC异常处理相关的类。
在spring Boot中,我们如果访问一个不存在的URL,就会得到spring boot中内置的页面。
我们在这里修改一下,以前的内容,直接抛出一个异常看看有什么效果
- "/")(
- public String index() throws Exception{
- throw new Exception("error");
- }
它会把我们抛出的异常信息,打印在下面。那么为什么Spring Boot会打印这些东西啦,是因为Spring Boot在启动过程中会根据当前环境进行AutoConfiguration,其中跟MVC错误处理相关的配置内容,在ErrorMvcAutoConfiguration这个类中。在Servlet容器中添加了一个默认的错误页面
在ErrorMvcAutoConfiguration类实现了EmbeddedServletContainerCustomizer接口,所以可以
通过override customize方法来定制Servlet容器
- "${error.path:/error}")(
- private String errorPath = "/error";
- public void customize(ConfigurableEmbeddedServletContainer container) {
- container.addErrorPages(new ErrorPage(this.properties.getServletPrefix()
- + this.errorPath));
- }
可以看到ErrorMvcAutoConfiguration在容器中,添加了一个错误页面/error。因为这项配置的存在,如果Spring MVC在处理过程抛出异常到Servlet容器,
容器会定向到这个错误页面/error。
虽然,Spring Boot中实现了默认的error映射,但是在实际应用中,上面你的错误页面对用户来说并不够友好,我们通常需要去实现我们自己的异常提示。
- 创建全局异常处理类:通过使用
@ControllerAdvice
定义统一的异常处理类,而不是在每个Controller中逐个定义。@ExceptionHandler
用来定义函数针对的异常类型, - 最后将Exception对象和请求URL映射到
error.html
中
- 实现
error.html
页面展示:在templates
目录下创建error.html
,将请求的URL和Exception对象的message输出。
- public class GlobalExceptionHandler {
- public static final String DEFAULT_ERROR_VIEW = "error";
- public ModelAndView defaultErrorHandler(HttpServletRequest req, Exception e) throws Exception {
- ModelAndView mav = new ModelAndView();
- mav.addObject("exception", e);
- mav.addObject("url", req.getRequestURL());
- mav.setViewName(DEFAULT_ERROR_VIEW);
- System.out.println("进来了--------------------");
- return mav;
- }
- }
- 实现
error.html
页面展示:在templates
目录下创建error.html
,将请求的URL和Exception对象的message输出。
- <html>
- <head lang="en">
- <meta charset="UTF-8" />
- <title>统一异常处理</title>
- </head>
- <body>
- <h1>Error Handler1</h1>
- <div th:text="${url}"></div>
- <div th:text="${exception.message}"></div>
- </body>
- </html>
最后访问异常方法可以看到
通过实现上述内容之后,我们只需要在Controller
中抛出Exception
,当然我们可能会有多种不同的Exception
。
然后在@ControllerAdvice
类中,根据抛出的具体Exception
类型匹配@ExceptionHandler
中配置的异常类型来匹配错误映射和处理。
返回JSON格式
在上述例子中,通过@ControllerAdvice
统一定义不同Exception映射到不同错误处理页面。而当我们要实现RESTful API时,返回的错误是JSON格式的数据,而不是HTML页面,这时候我们也能轻松支持。
本质上,只需在@ExceptionHandler
之后加入@ResponseBody
,就能让处理函数return的内容转换为JSON格式。
下面以一个具体示例来实现返回JSON格式的异常处理。
- 创建统一的JSON返回对象,code:消息类型,message:消息内容,url:请求的url,data:请求返回的数据
- public class ErrorInfo<T> {
- public static final Integer OK = 0;
- public static final Integer ERROR = 100;
- private Integer code;
- private String message;
- private String url;
- private T data;
- // 省略getter和setter
- 创建一个自定义异常,用来实验捕获该异常,并返回json
- public class MyException extends Exception {
- public MyException(String message) {
- super(message);
- }
- }
Controller
中增加json映射,抛出MyException
异常
- "/json")(
- public String json() throws MyException {
- throw new MyException("发生错误2");
- }
- 为
MyException
异常创建对应的处理
- public ErrorInfo<String> jsonErrorHandler(HttpServletRequest req, MyException e) throws Exception {
- ErrorInfo<String> r = new ErrorInfo<>();
- r.setMessage(e.getMessage());
- r.setCode(ErrorInfo.ERROR);
- r.setData("Some Data");
- r.setUrl(req.getRequestURL().toString());
- return r;
- }
我们访问页面就可以得到下面的结果
至此,已完成在Spring Boot中创建统一的异常处理,实际实现还是依靠Spring MVC的注解。
补充:如果全部异常处理返回json,那么可以使用 @RestControllerAdvice 代替 @ControllerAdvice ,
这样在方法上就可以不需要添加 @ResponseBody。
spring boot 教程(四) 统一异常处理相关推荐
- Spring Boot教程(十六):Spring Boot集成shiro
Apache Shiro™是一个功能强大且易于使用的Java安全框架,可执行身份验证,授权,加密和会话管理.借助Shiro易于理解的API,您可以快速轻松地保护任何应用程序 - 从最小的移动应用程序到 ...
- 超详细的Spring Boot教程,搞定面试官!
前言 Spring Boot是由Pivotal团队提供的全新框架,其设计目的是用来简化新Spring应用的初始搭建以及开发过程.该框架使用了特定的方式来进行配置,从而使开发人员不再需要定义样板化的配置 ...
- Spring Boot教程(二十五)返回JSON格式
在上述例子中,通过@ControllerAdvice统一定义不同Exception映射到不同错误处理页面.而当我们要实现RESTful API时,返回的错误是JSON格式的数据,而不是HTML页面,这 ...
- Spring Boot教程(二十):Spring Boot使用String Task定时任务
一.JAVA常见的几种定时任务比较 Timer:jdk自带的java.util.Timer类,这个类允许你调度一个java.util.TimerTask任务.使用这种方式可以让程序按照某一个频度执行, ...
- Spring Boot教程系列(ImportNew )
ImportNew Spring Boot教程系列 SpringBoot (一) :入门篇--http://mp.weixin.qq.com/s/hAJmvrYfS6OehMYVgqpqkw Spri ...
- Spring Boot教程系列 ImportNew
分享一下我老师大神的人工智能教程!零基础,通俗易懂!http://blog.csdn.net/jiangjunshow 也欢迎大家转载本篇文章.分享知识,造福人民,实现我们中华民族伟大复兴! Impo ...
- ImportNew Spring Boot教程系列
ImportNew Spring Boot教程系列 SpringBoot (一) :入门篇--http://mp.weixin.qq.com/s/hAJmvrYfS6OehMYVgqpqkw Spri ...
- Spring Boot教程(来源于微信公众号ImportNew)
ImportNew Spring Boot教程系列 非常适合刚接触的初学者,我也是通过这些文章在慢慢学习 分享一下Spring Boot的中文文档(插入的超链接用不了就很蓝瘦):https://qbg ...
- Spring Boot 教程(三): Spring Boot 整合Mybatis
教程简介 本项目内容为Spring Boot教程样例.目的是通过学习本系列教程,读者可以从0到1掌握spring boot的知识,并且可以运用到项目中.如您觉得该项目对您有用,欢迎点击收藏和点赞按钮, ...
最新文章
- Java3大框架的学习都是什么
- html 可以折叠的表格,javascript – html5 – 如何折叠和扩展复杂的表格元素
- 为什么维护工作让数据中心工作人员夜不能寐?
- python matplotlib pyplot plt.axhline()函数(绘制平行于x轴的水平参考线)
- bash--shell高级编程-特殊字符
- Java基础 — 异常
- webpack vue-cli 一有空格和分号就报错
- js模块化之模块依赖处理
- 分布式是写出来的(三)
- python找到文件夹下指定文件_python实现在目录中查找指定文件的方法
- SSAS的MDX语句整理
- mysql in 索引_关于MySQL种的in函数到底走不走索引、我和同事差点大打出手!
- post方式加载iframe
- servlet mysql 小程序_Servlet页面注册用户的小程序(一)
- G1的基本概念(G1源码分析和调优读书笔记)
- 如何理解新技术带来的新资产类别?
- 元气骑士卡无限服务器,元气骑士养剑葫怎么卡无限飞剑bug方法介绍
- 新氧放弃私有化:曾由CEO金星发起 公司市值已不足1亿美元
- CHK文件丢失怎么办?chk文件恢复技巧就看这一个!
- 华为HCIE RS笔记-16以太网技术端口隔离,Smart Link,Monitor Link,端口镜像
热门文章
- 好记心不如烂笔头之JQuery学习,第四章
- document.body和document.documentElement的区别
- Java编程思想第四版——第十五天
- C#文件过滤器filter
- C#实现小写金额转大写金额
- 【信息系统项目管理师】第12章-项目采购管理 知识点详细整理
- Linux Socket之send()异步通信时:Broken pipe报错
- WSL2支持GPU使用docker
- 浏览器获取CA认证流程
- Android报错:No resource found that matches the given name 'Theme.AppCompat.Light.NoActionBar'