Spring MVC 中的异常处理 (handling exceptions)

2024-02-11 18:08

本文主要是介绍Spring MVC 中的异常处理 (handling exceptions),希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

在任何应用开发中都需要对异常情况做处理,web应用也是如此。但是在Spring MVC中,所有的Request都是由Servlet处理的,返回的结果都是Response。也就是说,无论请求过程中出现什么异常,返回的都是一个Response,所有异常信息都要转换成Response。

当然,Spring提供了多种异常信息到Response信息的转换方式:

1. 一些特定的Spring异常已经被自动映射特定的http status code
2. 我们可以通过@ResponseStatus注解将一个异常,将其映射到特定的http status code
3. 我们可以通过@ExceptionHandler注解一个方法,由这个方法处理异常

一、将异常映射到http 状态码

上面讲过,Spring已经将一些特定异常映射成了http 状态码:
这里写图片描述

上面列表中的异常一般都是Spring的DispatchServlet在处理请求中经常遇到的异常,比如当DispatchServlet在处理请求过程中找不到controller对应的方法时,便会抛出NoSunchRequestHandlingMethodException,这个异常便会被自动映射成404 错误码。

自动映射的异常是有限的,无法覆盖应用中遇到的各种异常,幸好Spring提供了@ResponseStatus注解,可以将任何一个异常映射成http状态码,下面举个例子。

比如我们在写一个注册业务时,可能会遇到用户名已存在的问题,此时我们抛出一个用户已存在异常:

@RequestMapping(value = "/register", method = RequestMethod.POST)
public String processRegistration(User user) {if (registerService.isUserExist(user)) {throw new UserExistException();}registerService.register(user);return "profile";
}

此时我们希望在我们的业务抛出UserExistException异常时,DispatchServlet能将其映射成400状态码,这时我们可以通过@ResponseStatusUserExistException异常进行配置:

@ResponseStatus(value = HttpStatus.BAD_REQUEST,reason="user has exist!")
public class UserExistException extends RuntimeException{}

@ResponseStatus有两个属性,第一个属性是异常映射的http状态码,我们指定其值为400(bad-request),第二个属性是原因描述。

我们启动应用,当我们的业务方法抛出UserExistException时,client端会收到异常指定的错误码和原因描述:
这里写图片描述

二、写异常处理方法

将异常映射成http 状态码可以满足大部分情形,但是有时候我们不希望异常出现时仅仅返回一个状态码,我们还希望能对出现的异常做特殊的处理。还是上面那个例子,当出现UserExistException时我们不返回状态码,而是将其重定向到一个错误页面,我们可以这么处理:

@RequestMapping(value = "/register", method = RequestMethod.POST)
public String processRegistration(User user) {try{registerService.register(user);return "profile";}catch(UserExistException e){return "error";}
}

上面是一种很普通的处理方式,不过上面这种方式还是稍显复杂,每个业务方法除了关心正常的业务逻辑之外还得处理异常业务逻辑。我们很容易想到,可不可让一个方法去单独处理异常?答案当然是可以的,我们可以使用Spring提供的@ExceptionHandler注解,上面例子就可以改造成这样:

@RequestMapping(value = "/register", method = RequestMethod.POST)
public String processRegistration(User user) {registerService.register(user);return "profile";
}//异常处理方法
@ExceptionHandler(UserExistException.class)
public String handleUserExist() {return "error";
}

通过@ExceptionHandler注解的使用,业务逻辑只需要处理自己的正常逻辑,异常统统交给异常处理方法进行处理。另外,@ExceptionHandler注解可以捕获当前controller抛出的任何异常,所以同一个controller中的任何一个业务方法抛出异常,都可以交由一个异常处理方法统一处理。

既然@ExceptionHandler注解可以处理当前controller抛出的任何异常,那么还有没有一种方式可以让它捕获所有controller抛出的异常呢?答案也是可以的,这就需要用到@ControllerAdvice注解

三、捕获应用中所有controller异常

@ControllerAdvice注解可以是一个普通的controller变成一个controller advice,即切面controller。在切面controller里面可以定义三种类型的方法:

1. @ExceptionHandler注解的方法
2. @InitBinder注解的方法
3. @ModelAttribute注解的方法

切面controller里面的这些方法可以全局应用到所有controller的所有业务方法。有了这个特性,我们就可以利用一个切面controller集中处理应用中的所有异常了。还有,@ControllerAdvice本身已经被@controller注解,所以被@ControllerAdvice注解的类可以被自动扫描到,无需再注解@controller了。下面举例说明一下。

通过@ControllerAdvice注解定义一个可以处理所有controller异常的切面controller:

@ControllerAdvice
public class AppWideExceptionHandler {@ExceptionHandler(UserExistException.class)public String handleUserExist() {return "error";}
}

当应用中的任何一个controller抛出UserExistException异常时,都会被AppWideExceptionHandler中的handleUserExist()方法捕获处理,这就是我们最期待的。

这篇关于Spring MVC 中的异常处理 (handling exceptions)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/700476

相关文章

Java实现检查多个时间段是否有重合

《Java实现检查多个时间段是否有重合》这篇文章主要为大家详细介绍了如何使用Java实现检查多个时间段是否有重合,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录流程概述步骤详解China编程步骤1:定义时间段类步骤2:添加时间段步骤3:检查时间段是否有重合步骤4:输出结果示例代码结语作

Java中String字符串使用避坑指南

《Java中String字符串使用避坑指南》Java中的String字符串是我们日常编程中用得最多的类之一,看似简单的String使用,却隐藏着不少“坑”,如果不注意,可能会导致性能问题、意外的错误容... 目录8个避坑点如下:1. 字符串的不可变性:每次修改都创建新对象2. 使用 == 比较字符串,陷阱满

Java判断多个时间段是否重合的方法小结

《Java判断多个时间段是否重合的方法小结》这篇文章主要为大家详细介绍了Java中判断多个时间段是否重合的方法,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录判断多个时间段是否有间隔判断时间段集合是否与某时间段重合判断多个时间段是否有间隔实体类内容public class D

IDEA编译报错“java: 常量字符串过长”的原因及解决方法

《IDEA编译报错“java:常量字符串过长”的原因及解决方法》今天在开发过程中,由于尝试将一个文件的Base64字符串设置为常量,结果导致IDEA编译的时候出现了如下报错java:常量字符串过长,... 目录一、问题描述二、问题原因2.1 理论角度2.2 源码角度三、解决方案解决方案①:StringBui

Java覆盖第三方jar包中的某一个类的实现方法

《Java覆盖第三方jar包中的某一个类的实现方法》在我们日常的开发中,经常需要使用第三方的jar包,有时候我们会发现第三方的jar包中的某一个类有问题,或者我们需要定制化修改其中的逻辑,那么应该如何... 目录一、需求描述二、示例描述三、操作步骤四、验证结果五、实现原理一、需求描述需求描述如下:需要在

Java中ArrayList和LinkedList有什么区别举例详解

《Java中ArrayList和LinkedList有什么区别举例详解》:本文主要介绍Java中ArrayList和LinkedList区别的相关资料,包括数据结构特性、核心操作性能、内存与GC影... 目录一、底层数据结构二、核心操作性能对比三、内存与 GC 影响四、扩容机制五、线程安全与并发方案六、工程

JavaScript中的reduce方法执行过程、使用场景及进阶用法

《JavaScript中的reduce方法执行过程、使用场景及进阶用法》:本文主要介绍JavaScript中的reduce方法执行过程、使用场景及进阶用法的相关资料,reduce是JavaScri... 目录1. 什么是reduce2. reduce语法2.1 语法2.2 参数说明3. reduce执行过程

如何使用Java实现请求deepseek

《如何使用Java实现请求deepseek》这篇文章主要为大家详细介绍了如何使用Java实现请求deepseek功能,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1.deepseek的api创建2.Java实现请求deepseek2.1 pom文件2.2 json转化文件2.2

Java调用DeepSeek API的最佳实践及详细代码示例

《Java调用DeepSeekAPI的最佳实践及详细代码示例》:本文主要介绍如何使用Java调用DeepSeekAPI,包括获取API密钥、添加HTTP客户端依赖、创建HTTP请求、处理响应、... 目录1. 获取API密钥2. 添加HTTP客户端依赖3. 创建HTTP请求4. 处理响应5. 错误处理6.

Spring AI集成DeepSeek的详细步骤

《SpringAI集成DeepSeek的详细步骤》DeepSeek作为一款卓越的国产AI模型,越来越多的公司考虑在自己的应用中集成,对于Java应用来说,我们可以借助SpringAI集成DeepSe... 目录DeepSeek 介绍Spring AI 是什么?1、环境准备2、构建项目2.1、pom依赖2.2