Spring MVC 注解 @ResponseStatus 的使用

博客介绍了在应用中通过注解设置响应状态的方法,具体有两种使用方式,一是用在控制器方法上,包括带 status 和 reason 以及只有 status 两种情况;二是用在异常类上,还给出了相关参考文章。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

Spring MVC应用中,通过使用注解@ResponseStatus,我们可以设置HTTP响应的状态。

具体的使用方式这里我们介绍两种 :

  1. 用在控制器方法上
  2. 用在异常类上

1. 用在控制器方法上(status+reason)

@RestController
@RequestMapping(value = "/test")
public class TestServiceController {
    @ResponseStatus(reason = "@ResponseStatus demo", value = HttpStatus.NOT_FOUND)
    @RequestMapping("/response-status-404")
    public void testResponseStatus404() {
        // 省略具体逻辑
    }
}	

定义了上面的控制器方法testResponseStatus404之后,启动应用,访问页面http://localhost:8080/test/response-status-404,你会看到如下页面展示 :
在这里插入图片描述

2. 用在控制器方法上(只有status,没有reason)

现在把上面例子中的reason属性设置去掉,也就是换成@ResponseStatus(value = HttpStatus.NOT_FOUND),再次访问页面,你会看到输出 :
在这里插入图片描述
关于背后的原理,可以参考Spring MVC的如下实现:

	// 类 ServletInvocableHandlerMethod 代码片段    
    /**
	 * Set the response status according to the ResponseStatus annotation.
	 */
	private void setResponseStatus(ServletWebRequest webRequest) throws IOException {
		HttpStatus status = getResponseStatus();
		if (status == null) {
			return;
		}

		HttpServletResponse response = webRequest.getResponse();
		if (response != null) {
			String reason = getResponseStatusReason();
			if (StringUtils.hasText(reason)) {
				response.sendError(status.value(), reason);
			}
			else {
				response.setStatus(status.value());
			}
		}

		// To be picked up by RedirectView
		webRequest.getRequest().setAttribute(View.RESPONSE_STATUS_ATTRIBUTE, status);
	}

3. 用在异常类上

@RestController
@RequestMapping(value = "/test")
public class TestServiceController {
    @ResponseStatus(code = HttpStatus.BAD_REQUEST)
    class DemoException extends RuntimeException {}

    @RequestMapping("/response-status-400")
    public void triggerDemoException() {
        // 模仿一个会抛出异常 DemoException 的业务逻辑
        throw new DemoException();
    }
}    

定义了上面的控制器方法triggerDemoException之后,启动应用,访问页面http://localhost:8080/test/response-status-400,你会看到如下页面展示 :
在这里插入图片描述

注意 : 这种情况下,只要@ResponseStatus使用在异常上,不管是否设置reason属性,最终都会显示Whitelabel Error Page

参考文章

Using Spring @ResponseStatus to Set HTTP Status Code
Error Handling for REST with Spring
response.sendError() vs response.setStatus()

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值