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

相关文章

Spring boot整合dubbo+zookeeper的详细过程

《Springboot整合dubbo+zookeeper的详细过程》本文讲解SpringBoot整合Dubbo与Zookeeper实现API、Provider、Consumer模式,包含依赖配置、... 目录Spring boot整合dubbo+zookeeper1.创建父工程2.父工程引入依赖3.创建ap

SpringBoot结合Docker进行容器化处理指南

《SpringBoot结合Docker进行容器化处理指南》在当今快速发展的软件工程领域,SpringBoot和Docker已经成为现代Java开发者的必备工具,本文将深入讲解如何将一个SpringBo... 目录前言一、为什么选择 Spring Bootjavascript + docker1. 快速部署与

Spring Boot spring-boot-maven-plugin 参数配置详解(最新推荐)

《SpringBootspring-boot-maven-plugin参数配置详解(最新推荐)》文章介绍了SpringBootMaven插件的5个核心目标(repackage、run、start... 目录一 spring-boot-maven-plugin 插件的5个Goals二 应用场景1 重新打包应用

SpringBoot+EasyExcel实现自定义复杂样式导入导出

《SpringBoot+EasyExcel实现自定义复杂样式导入导出》这篇文章主要为大家详细介绍了SpringBoot如何结果EasyExcel实现自定义复杂样式导入导出功能,文中的示例代码讲解详细,... 目录安装处理自定义导出复杂场景1、列不固定,动态列2、动态下拉3、自定义锁定行/列,添加密码4、合并

Spring Boot集成Druid实现数据源管理与监控的详细步骤

《SpringBoot集成Druid实现数据源管理与监控的详细步骤》本文介绍如何在SpringBoot项目中集成Druid数据库连接池,包括环境搭建、Maven依赖配置、SpringBoot配置文件... 目录1. 引言1.1 环境准备1.2 Druid介绍2. 配置Druid连接池3. 查看Druid监控

Java中读取YAML文件配置信息常见问题及解决方法

《Java中读取YAML文件配置信息常见问题及解决方法》:本文主要介绍Java中读取YAML文件配置信息常见问题及解决方法,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要... 目录1 使用Spring Boot的@ConfigurationProperties2. 使用@Valu

创建Java keystore文件的完整指南及详细步骤

《创建Javakeystore文件的完整指南及详细步骤》本文详解Java中keystore的创建与配置,涵盖私钥管理、自签名与CA证书生成、SSL/TLS应用,强调安全存储及验证机制,确保通信加密和... 目录1. 秘密键(私钥)的理解与管理私钥的定义与重要性私钥的管理策略私钥的生成与存储2. 证书的创建与

浅析Spring如何控制Bean的加载顺序

《浅析Spring如何控制Bean的加载顺序》在大多数情况下,我们不需要手动控制Bean的加载顺序,因为Spring的IoC容器足够智能,但在某些特殊场景下,这种隐式的依赖关系可能不存在,下面我们就来... 目录核心原则:依赖驱动加载手动控制 Bean 加载顺序的方法方法 1:使用@DependsOn(最直

SpringBoot中如何使用Assert进行断言校验

《SpringBoot中如何使用Assert进行断言校验》Java提供了内置的assert机制,而Spring框架也提供了更强大的Assert工具类来帮助开发者进行参数校验和状态检查,下... 目录前言一、Java 原生assert简介1.1 使用方式1.2 示例代码1.3 优缺点分析二、Spring Fr

java使用protobuf-maven-plugin的插件编译proto文件详解

《java使用protobuf-maven-plugin的插件编译proto文件详解》:本文主要介绍java使用protobuf-maven-plugin的插件编译proto文件,具有很好的参考价... 目录protobuf文件作为数据传输和存储的协议主要介绍在Java使用maven编译proto文件的插件