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

简介: 在任何应用开发中都需要对异常情况做处理,web应用也是如此。但是在Spring MVC中,所有的Request都是由Servlet处理的,返回的结果都是Response。也就是说,无论请求过程中出现什么异常,返回的都是一个Response,所有异常信息都要转换成Response。当然,Spring提供了多种异常信息到Response信息的转换方式:1. 一些特定的Sp

在任何应用开发中都需要对异常情况做处理,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()方法捕获处理,这就是我们最期待的。

目录
相关文章
|
1月前
|
JSON 前端开发 Java
SSM:SpringMVC
本文介绍了SpringMVC的依赖配置、请求参数处理、注解开发、JSON处理、拦截器、文件上传下载以及相关注意事项。首先,需要在`pom.xml`中添加必要的依赖,包括Servlet、JSTL、Spring Web MVC等。接着,在`web.xml`中配置DispatcherServlet,并设置Spring MVC的相关配置,如组件扫描、默认Servlet处理器等。然后,通过`@RequestMapping`等注解处理请求参数,使用`@ResponseBody`返回JSON数据。此外,还介绍了如何创建和配置拦截器、文件上传下载的功能,并强调了JSP文件的放置位置,避免404错误。
|
1月前
|
前端开发 Java 应用服务中间件
【Spring】Spring MVC的项目准备和连接建立
【Spring】Spring MVC的项目准备和连接建立
54 2
|
2月前
|
缓存 前端开发 Java
【Java面试题汇总】Spring,SpringBoot,SpringMVC,Mybatis,JavaWeb篇(2023版)
Soring Boot的起步依赖、启动流程、自动装配、常用的注解、Spring MVC的执行流程、对MVC的理解、RestFull风格、为什么service层要写接口、MyBatis的缓存机制、$和#有什么区别、resultType和resultMap区别、cookie和session的区别是什么?session的工作原理
【Java面试题汇总】Spring,SpringBoot,SpringMVC,Mybatis,JavaWeb篇(2023版)
|
1月前
|
XML 前端开发 Java
Spring,SpringBoot和SpringMVC的关系以及区别 —— 超准确,可当面试题!!!也可供零基础学习
本文阐述了Spring、Spring Boot和Spring MVC的关系与区别,指出Spring是一个轻量级、一站式、模块化的应用程序开发框架,Spring MVC是Spring的一个子框架,专注于Web应用和网络接口开发,而Spring Boot则是对Spring的封装,用于简化Spring应用的开发。
112 0
Spring,SpringBoot和SpringMVC的关系以及区别 —— 超准确,可当面试题!!!也可供零基础学习
|
2月前
|
XML 缓存 前端开发
springMVC02,restful风格,请求转发和重定向
文章介绍了RESTful风格的基本概念和特点,并展示了如何使用SpringMVC实现RESTful风格的请求处理。同时,文章还讨论了SpringMVC中的请求转发和重定向的实现方式,并通过具体代码示例进行了说明。
springMVC02,restful风格,请求转发和重定向
|
3月前
|
Java 数据库连接 Spring
后端框架入门超详细 三部曲 Spring 、SpringMVC、Mybatis、SSM框架整合案例 【爆肝整理五万字】
文章是关于Spring、SpringMVC、Mybatis三个后端框架的超详细入门教程,包括基础知识讲解、代码案例及SSM框架整合的实战应用,旨在帮助读者全面理解并掌握这些框架的使用。
后端框架入门超详细 三部曲 Spring 、SpringMVC、Mybatis、SSM框架整合案例 【爆肝整理五万字】
|
3月前
|
XML JSON 数据库
SpringMVC入门到实战------七、RESTful的详细介绍和使用 具体代码案例分析(一)
这篇文章详细介绍了RESTful的概念、实现方式,以及如何在SpringMVC中使用HiddenHttpMethodFilter来处理PUT和DELETE请求,并通过具体代码案例分析了RESTful的使用。
SpringMVC入门到实战------七、RESTful的详细介绍和使用 具体代码案例分析(一)
|
3月前
|
前端开发 应用服务中间件 数据库
SpringMVC入门到实战------八、RESTful案例。SpringMVC+thymeleaf+BootStrap+RestFul实现员工信息的增删改查
这篇文章通过一个具体的项目案例,详细讲解了如何使用SpringMVC、Thymeleaf、Bootstrap以及RESTful风格接口来实现员工信息的增删改查功能。文章提供了项目结构、配置文件、控制器、数据访问对象、实体类和前端页面的完整源码,并展示了实现效果的截图。项目的目的是锻炼使用RESTful风格的接口开发,虽然数据是假数据并未连接数据库,但提供了一个很好的实践机会。文章最后强调了这一章节主要是为了练习RESTful,其他方面暂不考虑。
SpringMVC入门到实战------八、RESTful案例。SpringMVC+thymeleaf+BootStrap+RestFul实现员工信息的增删改查
|
3月前
|
Java Spring UED
Spring框架的异常处理秘籍:打造不败之身的应用!
【8月更文挑战第31天】在软件开发中,异常处理对应用的稳定性和健壮性至关重要。Spring框架提供了一套完善的异常处理机制,包括使用`@ExceptionHandler`注解和配置`@ControllerAdvice`。本文将详细介绍这两种方式,并通过示例代码展示其具体应用。`@ExceptionHandler`可用于控制器类中的方法,处理特定异常;而`@ControllerAdvice`则允许定义全局异常处理器,捕获多个控制器中的异常。
51 0
|
3月前
|
Java API 开发者
【开发者福音】Spring Boot 异常处理:优雅应对错误,提升应用健壮性,让调试不再是噩梦!
【8月更文挑战第29天】本文通过对比传统错误处理方式与Spring Boot推荐的最佳实践,展示了如何在Spring Boot应用中实现统一且优雅的异常处理。传统方法需在每个可能出错的地方显式处理异常,导致代码冗余且不一致。而Spring Boot的全局异常处理机制则能集中处理所有异常,简化代码并确保错误响应格式统一,提高应用程序的健壮性和可维护性。文中提供了具体的示例代码以帮助读者更好地理解和应用这一机制。
107 0