Spring MVC相关异常类

简介: Spring MVC相关异常类

使用@ResponseStatus修饰异常类

如果希望程序抛出自定义异常时也能被异常解析器解析成HTTP状态码,从而显示Web服务器提供的错误页面,就像前面DefaultHandlerExceptptionResolver的行为那样,则可使用Spring MVC提供的@ResponseStatus注解。

@ResponseStatus可用于修饰异常类,为该异常类指定对应的状态码和错误原因,这样当控制器的处理方法抛出该异常时,将由ResponseStatusExceptionResolver负责解析成对应的HTTP状态码。

此外,@ResponseStatus还可用于修饰方法,当使用该注解修饰方法时,通常会与@ExceptionHandler注解结合使用。

@ResponseStatus注解支持的属性如表

@ResponseStatus注解其实很简单,通常只需指定value或code属性,指定该异常类对应的HTTP状态码。

需要说明的是,当使用该注解修饰异常类,或者该注解指定了reason属性之后,Spring MVC底层会调用HttpServletResponse的sendError()方法来输出响应消息。

一旦调用了HttpServletResponse的sendError()方法,整个响应就完成了,后面不应该继续输出任何内容。因此,@ResponseStatus注解不适合在RESTful API中使用。注意

避免在RESTful API中使用@ResponseStatus注解。如果希望RESTful API也能生成带HTTP状态码的响应消息,只要让处理方法返回ResponseEntity对象即可,就如第6章所介绍的那样。

下面对上一个示例略做修改,先删除Spring MVC配置文件中关于SimpleMappingExceptionResolver异常解析器的配置,不再使用这种“老旧”的异常处理机制。

接下来定义一个自定义的异常类。

该异常类使用了@ResponseStatus注解修饰,并指定了code和reason属性,这意味着当控制器的处理方法抛出该异常时,该异常就会被解析成HttpStatus.FORBIDDEN状态码,并使用reason指定异常原因。

该示例对BookServiceImpl实现类略做修改,使之能抛出自定义的BookException异常。下面是BookServiceImpl实现类的代码。

从上面的粗体字代码可以看出,当Book的price属性值小于或等于50时,该方法会抛出BookException异常。

由于本示例不再需要argerror.jsp、sqlerror.jsp、error.jsp等错误页面,而是直接使用Web服务器提供的错误页面,因此可删除/WEB-INF/content目录下的argerror.jsp、sqlerror.jsp、error.jsp文件。


部署、运行该应用,请求/bookForm,应用会显示/WEB-INF/content/bookForm.jsp页面,在该页面的price表单域中输入小于50的数值后提交表单,将看到如图

使用@ExceptionHandler修饰异常处理方法

@ExceptionHandler注解修饰的方法被当成异常处理方法,当控制器的处理方法抛出异常时,该方法将会自动执行,对异常进行处理。


@ExceptionHandler注解只支持一个value属性,该属性可通过数组指定一系列的异常类名,表明只有当处理方法抛出对应的异常时,@ExceptionHandler注解修饰的异常处理方法才会自动执行。


@ExceptionHandler注解修饰的异常处理方法可声明如下类型形参。

➢ 任何异常类型:用于访问处理方法抛出的异常。

➢ ServletRequest、ServletResponse、HttpSession等:用于访问Servlet API。

➢ WebRequest或NativeWebRequest:其作用等同于在控制器的处理方法中声明这种类型的形参。

➢ Locale:用于访问客户端的语言区域。

➢ InputStream、Reader、OutputStream或Writer:用于直接访问请求或响应的IO流。

➢ Model:代表模型对象。

@ExceptionHandler注解修饰的异常处理方法可返回如下类型的返回值。

➢ ModelAndView:该返回值同时包含Model和View。

➢ Model或Map:该返回值只有模型数据,Spring MVC会使用RequestToViewNameTranslator隐式获取视图名。

➢ View:该返回值就是视图对象。

➢ String:该返回值代表逻辑视图名。

➢ HttpEntity<?>、ResponseEntity<?>或@ResponseBody修饰的方法:该方法的返回值将直接作为响应消息,通常用于RESTful API开发。

➢ void:当异常处理方法自行通过ServletResponse或HttpServletResponse生成响应消息时,可将该方法的返回值声明为void;否则,如果将异常处理方法的返回值声明为void,Spring MVC会使用RequestToViewNameTranslator隐式获取视图名。

下面示例还是对前面的SimpleMappingExceptionResolver示例略做修改,先删除Spring MVC配置文件中关于SimpleMappingExceptionResolver异常解析器的配置,不再使用这种“老旧”的异常处理机制。


目录
相关文章
|
2月前
|
前端开发 Java 微服务
《深入理解Spring》:Spring、Spring MVC与Spring Boot的深度解析
Spring Framework是Java生态的基石,提供IoC、AOP等核心功能;Spring MVC基于其构建,实现Web层MVC架构;Spring Boot则通过自动配置和内嵌服务器,极大简化了开发与部署。三者层层演进,Spring Boot并非替代,而是对前者的高效封装与增强,适用于微服务与快速开发,而深入理解Spring Framework有助于更好驾驭整体技术栈。
|
9月前
|
前端开发 Java 测试技术
微服务——SpringBoot使用归纳——Spring Boot中的MVC支持——@RequestParam
本文介绍了 `@RequestParam` 注解的使用方法及其与 `@PathVariable` 的区别。`@RequestParam` 用于从请求中获取参数值(如 GET 请求的 URL 参数或 POST 请求的表单数据),而 `@PathVariable` 用于从 URL 模板中提取参数。文章通过示例代码详细说明了 `@RequestParam` 的常用属性,如 `required` 和 `defaultValue`,并展示了如何用实体类封装大量表单参数以简化处理流程。最后,结合 Postman 测试工具验证了接口的功能。
499 0
微服务——SpringBoot使用归纳——Spring Boot中的MVC支持——@RequestParam
|
9月前
|
JSON 前端开发 Java
微服务——SpringBoot使用归纳——Spring Boot中的MVC支持——@RequestBody
`@RequestBody` 是 Spring 框架中的注解,用于将 HTTP 请求体中的 JSON 数据自动映射为 Java 对象。例如,前端通过 POST 请求发送包含 `username` 和 `password` 的 JSON 数据,后端可通过带有 `@RequestBody` 注解的方法参数接收并处理。此注解适用于传递复杂对象的场景,简化了数据解析过程。与表单提交不同,它主要用于接收 JSON 格式的实体数据。
746 0
|
9月前
|
前端开发 Java 微服务
微服务——SpringBoot使用归纳——Spring Boot中的MVC支持——@PathVariable
`@PathVariable` 是 Spring Boot 中用于从 URL 中提取参数的注解,支持 RESTful 风格接口开发。例如,通过 `@GetMapping(&quot;/user/{id}&quot;)` 可以将 URL 中的 `{id}` 参数自动映射到方法参数中。若参数名不一致,可通过 `@PathVariable(&quot;自定义名&quot;)` 指定绑定关系。此外,还支持多参数占位符,如 `/user/{id}/{name}`,分别映射到方法中的多个参数。运行项目后,访问指定 URL 即可验证参数是否正确接收。
488 0
|
9月前
|
JSON 前端开发 Java
微服务——SpringBoot使用归纳——Spring Boot中的MVC支持——@RequestMapping
@RequestMapping 是 Spring MVC 中用于请求地址映射的注解,可作用于类或方法上。类级别定义控制器父路径,方法级别进一步指定处理逻辑。常用属性包括 value(请求地址)、method(请求类型,如 GET/POST 等,默认 GET)和 produces(返回内容类型)。例如:`@RequestMapping(value = &quot;/test&quot;, produces = &quot;application/json; charset=UTF-8&quot;)`。此外,针对不同请求方式还有简化注解,如 @GetMapping、@PostMapping 等。
429 0
|
9月前
|
JSON 前端开发 Java
微服务——SpringBoot使用归纳——Spring Boot中的MVC支持——@RestController
本文主要介绍 Spring Boot 中 MVC 开发常用的几个注解及其使用方式,包括 `@RestController`、`@RequestMapping`、`@PathVariable`、`@RequestParam` 和 `@RequestBody`。其中重点讲解了 `@RestController` 注解的构成与特点:它是 `@Controller` 和 `@ResponseBody` 的结合体,适用于返回 JSON 数据的场景。文章还指出,在需要模板渲染(如 Thymeleaf)而非前后端分离的情况下,应使用 `@Controller` 而非 `@RestController`
348 0
|
5月前
|
前端开发 Java API
Spring Cloud Gateway Server Web MVC报错“Unsupported transfer encoding: chunked”解决
本文解析了Spring Cloud Gateway中出现“Unsupported transfer encoding: chunked”错误的原因,指出该问题源于Feign依赖的HTTP客户端与服务端的`chunked`传输编码不兼容,并提供了具体的解决方案。通过规范Feign客户端接口的返回类型,可有效避免该异常,提升系统兼容性与稳定性。
339 0
|
5月前
|
SQL Java 数据库连接
Spring、SpringMVC 与 MyBatis 核心知识点解析
我梳理的这些内容,涵盖了 Spring、SpringMVC 和 MyBatis 的核心知识点。 在 Spring 中,我了解到 IOC 是控制反转,把对象控制权交容器;DI 是依赖注入,有三种实现方式。Bean 有五种作用域,单例 bean 的线程安全问题及自动装配方式也清晰了。事务基于数据库和 AOP,有失效场景和七种传播行为。AOP 是面向切面编程,动态代理有 JDK 和 CGLIB 两种。 SpringMVC 的 11 步执行流程我烂熟于心,还有那些常用注解的用法。 MyBatis 里,#{} 和 ${} 的区别很关键,获取主键、处理字段与属性名不匹配的方法也掌握了。多表查询、动态
157 0
|
5月前
|
JSON 前端开发 Java
第05课:Spring Boot中的MVC支持
第05课:Spring Boot中的MVC支持
269 0
|
12月前
|
Java Spring
【Spring】方法注解@Bean,配置类扫描路径
@Bean方法注解,如何在同一个类下面定义多个Bean对象,配置扫描路径
519 73