Spring 6/Spring Boot 3新特性:优雅的业务异常处理
当你使用Spring Boot(Spring MVC)进行RESTful API开发的时候,你会发现HTTP的状态码很多时候不能足够有效的传递错误的信息。
HTTP里有一个RFC 7807规范:https://www.rfc-editor.org/rfc/rfc7807。这个规范里定义了HTTP API的“问题细节”(Problem Details)内容。
该规范定义了一个“问题细节”(Problem Details),用它来携带HTTP错误返回信息,避免自定义新的错误返回格式。我们通常情况下是自己定义错误返回格式的。
Spring 6.0为我们提供了一个org.springframework.http.ProblemDetail 来实现该规范。
RFC 7807是一个很简单的规范。它定义了一个JSON格式,并关联了一个媒体类型(media type),这个JSON格式包含了五个可选成员来描述问题细节:
type:一个URI引用,用来识别问题的类型。这个URI的路径内容应该用来显示人类可读的信息来描述类型;
title:人类可读的问题类型描述;相同类型的问题,应该总是相同的描述;
status:HTTP状态码,将它包含在问题细节里是一种方便的方式;
detail:人类可读的问题实例描述,解释为什么当前的问题发生在这个特定的场景下;
instance:一个URI引用,用来识别问题实例。这个URI的内容应该用来描述问题实例,但不是必须的。
我们首先建立一个演示项目:
1、通常的业务异常处理方法
定义一个业务异常类。异常含义为:当Person找不到的时候抛出的业务异常。
注册这个业务异常到全局异常处理。
通过在@RestControllerAdvice 中定义全局的切面处理。
通过@ExceptionHandler 来处理指定异常的处理方式。
这里返回的格式就是我们自定义的ErrorMsg格式。我们通过自定义这个ErroMsg完成和接口使用者协议,完成对业务异常的处理。
需自定义的错误返回
测试控制器
启动程序,访问:http://localhost:8080/getPerson
2、基于“问题细节”的业务异常处理
基于我们常规的异常处理,其实已经能满足我们的业务需求,使用RFC 7807规范,我们可以免去自定义的异常错误格式(ErrorMsg ),使用Spring 6.0给我们提供的ProblemDetail ,这样我们以后再无需自己自定义异常返回格式,且在不同的项目之间有了标准,从而客户端在使用的时候有了可预测性。
Spring 6.0的做法也很简单,我们只需要将我们自定返回的ErrorMsg 修改成ProblemDetail 即可。我们看一下示例代码:
值得说的是ProblemDetail 还支持设置一个Map的properties:
这样也为我们的定制扩展提供了更大的空间。
启动,访问:http://localhost:8080/getPerson,其实的错误返回符合RFC 7807规范。
注意查看返回的头信息,我们看到了,返回数据的媒体类型为:application/problem+json:
感谢支持我的书:《从企业级开发到云原生微服务:Spring Boot实战》
参考资料:https://docs.spring.io/spring-framework/docs/6.0.0-RC2/javadoc-api/org/springframework/http/ProblemDetail.html
文章出自:爱科学的卫斯理,如有转载本文请联系爱科学的卫斯理今日头条号。
相关文章
- 阿里面试官:如果要抗住双11高并发压力,你的Java系统该怎么设计
- 使用BufferedReader和BufferedWriter类来实现文件拷贝
- 使用 StopWatch 优雅打印执行耗时
- 夯实Java基础,一篇文章全解析线程问题
- 学会这几招让 Go 程序自己监控自己
- 前端程序员应知应会之JavaScript基准测试套件
- 妙用Java 8中的 Function接口 消灭if...else(非常新颖的写法)
- 我接手前同事写的烂Java代码,不小心搞出了一个内存泄露事故
- 纯Javascript实现平滑曲线生成
- JavaScript刷LeetCode拿offer-js版字典
- 用javascript分类刷leetcode18.队列(图文视频讲解)4
- JavaScript刷LeetCode-字符串类解题技巧4
- 用javascript分类刷leetcode17.栈(图文视频讲解)4
- JAVA中使用最广泛的本地缓存?Ehcache的自信从何而来3 —— 本地缓存变身分布式集群缓存,打破本地缓存天花板
- Java实现代理模式的三种方式
- Java开发人员的十大测试框架和库
- Java基础分享,一篇文章说透Java访问修饰符
- Java编程中忽略这些细节,Bug肯定找上你
- C语言如何实现动态扩容的string
- C/C++ 为什么要专门设计个Do…While?