当前位置： 首页 > news >正文

【Spring Boot】异常处理

news 来源：原创 2024/7/3 1:29:20

异常处理

  • 1.认识异常处理
    • 1.1 异常处理的必要性
    • 1.2 异常的分类
    • 1.3 如何处理异常
      • 1.3.1 捕获异常
      • 1.3.2 抛出异常
      • 1.3.4 自定义异常
    • 1.4 Spring Boot 默认的异常处理
  • 2.使用控制器通知
  • 3.自定义错误处理控制器
    • 3.1 自定义一个错误的处理控制器
    • 3.2 自定义业务异常类
      • 3.2.1 自定义异常类
      • 3.2.2 自定义全局捕获异常
      • 3.2.3 测试自定义异常类

1.认识异常处理

异常处理 是编程语言的机制，用来处理软件系统中出现的异常情况，增强代码的可读性。

1.1 异常处理的必要性

异常处理用于解决一些程序无法掌控，但又必须面对的情况。例如，程序需要读取文件、连接网络、使用数据库等，但可能文件不存在、网络不畅通、数据库无效等情况。为了程序能继续运行此时就需要把这些情况进行异常处理。异常处理的方法通常有以下几种：

  • 将异常通知给开发人员、运维人员或用户。
  • 使因为异常中断的程序以适当的方式继续运行，或者退出。
  • 保存用户的当前操作，或者进行数据回滚。
  • 释放资源。

1.2 异常的分类

  • Error：代表编译和系统的错误，不允许捕获。
  • Exception：标准 Java 库的方法所激发的异常，包含运行异常 Runtime_Exception 和非运行异常 Non_RuntimeException 的子类。
  • Runtime Exception：运行时异常。
  • Non RuntimeException：非运行时可检测的异常，Java 编译器利用分析方法或构造方法中可能产生的结果来检测程序中是否含有检测异常的处理程序，每个可能的可检测异常、方法或构造方法的 throws 子句必须列出该异常对应的类。
  • Throw：用户自定义异常。

1.3 如何处理异常

1.3.1 捕获异常

捕获异常的格式，见以下代码：

try{//......
}
catch(//......
)
finally{//......
}
  • try：在 try 语句中编写可能发生异常的代码，即正常的业务功能代码。如果执行完 try 语句不发生异常，则执行 finally 语句（如果有的话）和 finally 后面的代码；如果发生异常，则尝试去匹配 catch 语句。
  • catch：捕捉错误并处理。
  • finally：finally 语句是可选的，无论异常是否发生、是否匹配、是否被处理，finally 都会执行。

一个 try 至少要有一个 catch 语句，或至少要有 1 1 1 个 finally 语句。finally 不是用来处理异常的，也不会捕获异常，是为了做一些清理工作，如流的关闭、数据库连接的关闭等。

1.3.2 抛出异常

除用 try 语句处理异常外，还可以用 throw、throws 抛出异常。

执行 throw 语句的地方是一个异常抛出点，后面必须是一个异常对象，且必须写在函数中。

throw、throws 的用法见以下代码。

  • throw 语法：
throw(异常对象);
  • throws 语法：
[(修饰符)](返回值类型)(方法名)([参数列表])[throws(异常类)]{...}

1.3.4 自定义异常

在应用程序的开发过程中，经常会自定义异常类，以避免使用 try 产生重复代码。自定义异常类一般是通过扩展 Exception 类来实现的。这样的自定义异常属于 检查异常（checked exception）。如果要自定义非检查异常，则需要继承 RuntimeException。

1.4 Spring Boot 默认的异常处理

Spring Boot 提供了一个默认处理异常的映射。在 Spring Boot 的 Web 项目中，尝试访问一个不存在的 URL（http://localhost:8080/pipi），会得到 Spring Boot 中内置的异常处理如下提示：

This application has no explicit mapping for /error, so you are seeing this as a fallback.
Sat May 18 22:49:20 CST 2019
There was an unexpected error (type=Not Found, status=404).
No message available.

同样的地址，如果发送的请求带有 Content-Type→application/json;charset=UTF-8 则返回的是 JSON 格式的错误结果，见以下输出结果：

{"timestamp":"2019-05-18T14:47:46.722+0000","status": 404,"error": "Not Found","message": "No message available","path": "/pipi"
}

从上面结果可以看出，Spring Boot 会根据消费者发送的 Content-Type 来返回相应的异常内容，如果 Content-Type 是 applicaton/json，则返回 JSON 文件；如果 Content-Type，是 text/html，则返回 HTML 文件。

2.使用控制器通知

在编写代码时，需要对异常进行处理。进行异常处理的普通的代码是 try...catch 结构。但在开发业务时，只想关注业务正常的代码，对于 catch 语句中的捕获异常，希望交给异常捕获来处理，不单独在每个方法中编写。这样不仅可以减少冗余代码，还可以减少因忘记写 catch 而出现错误的概率。

Spring 正好提供了一个非常方便的异常处理方案：控制器通知（@ControllerAdvice 或 @RestcontrollerAdvice），它将所有控制器作为一个切面，利用切面技术来实现。

通过基于 @ControllerAdvice 或 @RestControllerAdvice 的注解可以对异常进行全局统一处理，默认对所有的 Controller 有效。如果要限定生效范围，则可以使用 ControllerAdvice 支持的限定范围方式。

  • 按注解：@ControllerAdvice(annotations=RestController.class)。
  • 按包名：@ControllerAdvice("org.example.controller")。
  • 按类型：@ControllerAdvice(assignableTypes={Controllerlnterface.class, AbstractController.class})。

这是 ControllerAdvice 进行统一异常处理的优点，它能够细粒度地控制该异常处理器针对哪些 Controller、包或类型有效。

可以利用这一特性在一个系统实现多个异常处理器，然后 Controller 可以有选择地决定使用哪个，使得异常处理更加灵活、降低侵入性。

异常处理类会包含以下一个或多个方法：

  • @InitBinder：对表单数据进行绑定，用于定义控制器参数绑定规则。如转换规则、格式化等。可以通过这个注解的方法得到 WebDataBinder 对象，它在参数转换之前被执行。
  • @ModelAttribute：在控制器方法被执行前，对所有 Controller 的 Model 添加属性进行操作。
  • @ExceptionHandler：定义控制器发生异常后的操作，可以拦载所有控制器发生的异常。
  • @ControllerAdvice：统一异常处理，通过 @ExceptionHandler(value=Exception.class) 来指定捕获的异常。@ControllerAdvice + @ExceptionHandle 可以处理除 404 以外的运行异常。

3.自定义错误处理控制器

3.1 自定义一个错误的处理控制器

以下代码演示如何自定义一个错误的处理控制器。

package com.example.demo.Controller;import org.springframework.boot.web.servlet.error.ErrorController;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.bind.annotation.RestController;import java.util.HashMap;
import java.util.Map;@RestController
/*springboot提供了默认的错误映射地址error
@RequestMapping("${server.error.path:${error.path:/error}}")
@RequestMapping("/error")
上面2种写法都可以
*/
@RequestMapping("/error")
//继承springboot提供的ErrorController
public class TestErrorController implements ErrorController {//一定要重写方法,默认返回null就可以,不然报错,因为getErrorPath为空@Overridepublic String getErrorPath() {return null;}//一定要添加url映射,指向error@RequestMappingpublic Map<String, Object> handleError() {//用Map容器返回信息Map<String, Object> map = new HashMap<String, Object>();map.put("code", 404);map.put("msg", "不存在");return map;}/*这里加一个能正常访问的页面,作为比较因为写在一个控制器所以它的访问路径是http://localhost:8080/error/ok*/@RequestMapping("/ok")@ResponseBodypublic Map<String, Object> noError() {//用Map容器返回信息Map<String, Object> map = new HashMap<String, Object>();map.put("code ", 200);map.put("msg", "正常，这是测试页面");return map;}
}

启动项目，访问一个不存在的网址，则返回下方信息：

在这里插入图片描述
访问正确定义的映射，则返回下方正确信息：

在这里插入图片描述

3.2 自定义业务异常类

3.2.1 自定义异常类

自定义异常类需要继承 Exception（异常）类。这里继承 RuntimeException，代码如下：

package com.example.demo.exception;public class BusinessException extends RuntimeException{//自定义错误码private Integer code;//自定义构造器，必须输入错误码及内容public BusinessException(int code, String msg) {super(msg);this.code = code;}public Integer getCode() {return code;}public void setCode(Integer code) {this.code = code;}
}

RuntimeException 和 Error 是非检查异常，其他的都是检查异常。所有方法都可以在不声明 throws 方法的情况下抛出 RuntimeException 及其子类，不可以在不声明的情况下抛出非 RuntimeException，即：非 RuntimeException 要自己写 catch 语句处理，如果 RuntimeException 不使用 try...catch 进行捕捉，则会导致程序运行中断。

3.2.2 自定义全局捕获异常

package com.example.demo.exception;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;
import java.util.HashMap;
import java.util.Map;@ControllerAdvice
public class CustomerBusinessExceptionHandler {@ResponseBody@ExceptionHandler(BusinessException.class)public Map<String, Object> businessExceptionHandler(BusinessException e) {Map<String, Object> map = new HashMap<String, Object>();map.put("code", e.getCode());map.put("message", e.getMessage());//发生异常进行日志记录，此处省略return map;}
}

3.2.3 测试自定义异常类

创建控制器。以抛出 BusinessException 的自定义异常。

package com.example.demo.controller;import com.example.demo.exception.BusinessException;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;@RestController
public class TestController {@RequestMapping("/BusinessException")public String testResponseStatusExceptionResolver(@RequestParam("i") int i) {if (i == 0) {throw new BusinessException(600, "自定义业务错误");}return "success";}}

启动项目，访问 http://localhost:8080/BusinessException?i=0 测试异常处理情况，则抛出下方错误信息：

在这里插入图片描述
在这里插入图片描述

相关文章：

  • cad导入su线条不在一个平面怎么办？
  • Java | Leetcode Java题解之第132题分割回文串II
  • 分享一个用python写的本地WIFI密码查看器
  • 【risc-v】arm和riscv有什么关系或者联系？
  • Elasticsearch 管道查询语言 ES|QL 现已正式发布
  • 归一化在神经网络训练中的作用
  • 如何在React中创建自定义Hooks
  • python数据分析-ZET财务数据分析
  • Java数据结构与算法(盛水的容器)
  • 搜索与图论：八皇后问题
  • 【MySQL】服务器配置和管理
  • 28 - 只出现一次的最大数字（高频 SQL 50 题基础版)
  • Functional ALV系列 (10) - 将填充FieldCatalog封装成函数
  • 端午节赛龙舟，我们的新队员---AI大模型
  • 百度高级项目经理洪刘生受邀为第十三届中国PMO大会演讲嘉宾
  • 9月CHINA-PUB-OPENDAY技术沙龙——IPHONE
  • 0基础学习移动端适配
  • 2018天猫双11|这就是阿里云！不止有新技术，更有温暖的社会力量
  • ES6, React, Redux, Webpack写的一个爬 GitHub 的网页
  • JSDuck 与 AngularJS 融合技巧
  • JSONP原理
  • Leetcode 27 Remove Element
  • MobX
  • scrapy学习之路4(itemloder的使用)
  • Selenium实战教程系列（二）---元素定位
  • SpiderData 2019年2月25日 DApp数据排行榜
  • Work@Alibaba 阿里巴巴的企业应用构建之路
  • 买一台 iPhone X，还是创建一家未来的独角兽？
  • 无服务器化是企业 IT 架构的未来吗？
  • 小而合理的前端理论：rscss和rsjs
  • 一个普通的 5 年iOS开发者的自我总结，以及5年开发经历和感想！
  • 3月7日云栖精选夜读 | RSA 2019安全大会：企业资产管理成行业新风向标，云上安全占绝对优势 ...
  • 翻译 | The Principles of OOD 面向对象设计原则
  • 微龛半导体获数千万Pre-A轮融资，投资方为国中创投 ...
  • ​TypeScript都不会用，也敢说会前端？
  • #传输# #传输数据判断#
  • （Redis使用系列） Springboot 使用redis的List数据结构实现简单的排队功能场景 九
  • （ZT）出版业改革：该死的死，该生的生
  • （二）学习JVM —— 垃圾回收机制
  • （二开）Flink 修改源码拓展 SQL 语法
  • （十五）devops持续集成开发——jenkins流水线构建策略配置及触发器的使用
  • （十一）c52学习之旅-动态数码管
  • （原）Matlab的svmtrain和svmclassify
  • （转）负载均衡，回话保持，cookie
  • (轉貼) 2008 Altera 亞洲創新大賽 台灣學生成果傲視全球 [照片花絮] (SOC) (News)
  • .NET DataGridView数据绑定说明
  • .NET 除了用 Task 之外，如何自己写一个可以 await 的对象？
  • .NET 直连SAP HANA数据库
  • .NET/C# 使窗口永不激活（No Activate 永不获得焦点）
  • .NET/MSBuild 中的发布路径在哪里呢？如何在扩展编译的时候修改发布路径中的文件呢？
  • .net反编译工具
  • .Net高阶异常处理第二篇~~ dump进阶之MiniDumpWriter
  • .Net各种迷惑命名解释
  • .net企业级架构实战之7——Spring.net整合Asp.net mvc
  • .NET中统一的存储过程调用方法(收藏)