浅析@ResponseStatus的作用、属性、用法、底层原理及使用注意事项

  @ResponseStatus注解是spring-web包中提供的一个注解,其主要作用就是为了改变HTTP响应的状态码,具有value、code、reason 三个属性,如下:

浅析@ResponseStatus的作用、属性、用法、底层原理及使用注意事项

一、@ResponseStatus注解用法

  @ResponseStatus注解有两种用法,一种是加载自定义异常类上,一种是加在目标方法中,当修饰一个类的时候,通常修饰的是一个异常类。

  这里我们说一下加在目标方法上的这种情况,注解中有两个参数,value属性设置异常的状态码,reaseon是对于异常的描述,其实@ResponseStatus大部分情况下更适合于在自定义异常类或者目标方法上使用。

1、标注在@ControllerAdvice中

// controller
@GetMapping("/err")
public Response errorTest(){
    int i = 1 / 0;
    return new Response(401, "1/0", null);
}
// ExceptionController
@RestControllerAdvice
public class ExceptionController {
    // 捕捉其他所有异常
    @ExceptionHandler(Exception.class)
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    public Response globalException(HttpServletRequest request, Throwable ex) {
        return new Response(400,"1 / 0",null);
    }
}

  由于1 / 0 出现异常被我们捕获之后返回我们自定义的状态码400,和自定义的结果。ResponseStatus就是设置了状态码400。

2、标注在controller方法上

(1)修改状态码

@RequestMapping(path = "/401")
@ResponseStatus(value = HttpStatus.CREATED)
public Response unauthorized() {
    return new Response(401, "Unauthorized", null);
}

  HttpStatus.CREATED 状态码为201,将原来请求状态码200改为201。

浅析@ResponseStatus的作用、属性、用法、底层原理及使用注意事项

(2)使用reason

@RequestMapping(path = "/401")
@ResponseStatus(value = HttpStatus.UNAUTHORIZED,reason = "no no no")
public Response unauthorized() {
    return new Response(401, "Unauthorized", null);
}

  如果@ResponseStatus有reason属性,@RequestMapping方法返回值都不处理了,直接返回服务器自带的 ERROR 页面,交互体验比较差,建议不要使用。

浅析@ResponseStatus的作用、属性、用法、底层原理及使用注意事项

3、标注在自定义的异常类上

  使用时,先声明一个自定义异常类,在自定义异常类上面加上@ResponseStatus注释表示在系统运行期间,当抛出自定义异常的时候,使用@ResponseStatus注解中声明的属性和reason属性将异常信息返回给客户端,提高可读性。

// MyException
@ResponseStatus(code = HttpStatus.PAYMENT_REQUIRED,reason = "this is MyException")
public class MyException extends RuntimeException {
    public MyException() {
    }
}
// controller
@GetMapping("/err2")
public Response errorTest2(){
    throw new MyException();
}

浅析@ResponseStatus的作用、属性、用法、底层原理及使用注意事项

二、底层实现原理

  注解底层还是通过设置 response.setStatus 来实现的。在@RequestMapping方法执行完成,Spring解析返回值之前,进行了responseStatus设置。

  代码片段位于:org.springframework.web.servlet.mvc.method.annotation.ServletInvocableHandlerMethod#setResponseStatus

  this对象指当前的ServletInvocableHandlerMethod,看到 @ResponseStatus的reason不为空,就调用response.sendError ; reason为空,就调用setStatus方法仅仅设置响应状态码。

浅析@ResponseStatus的作用、属性、用法、底层原理及使用注意事项

  代码片段位于:org.springframework.web.servlet.mvc.method.annotation.ServletInvocableHandlerMethod#invokeAndHandle,发现如果ServletInvocableHandlerMethod的responseReason有值,也就是@ResponseStatus有reason属性,@RequestMapping方法返回值都不处理了,直接返回;

浅析@ResponseStatus的作用、属性、用法、底层原理及使用注意事项

  也就是说只要有 @ResponseStatus 的 reason 属性标注在 处理器 Controller 类或者方法上,比如响应状态码code设置为 404,reason设置为页面没找到 ,那 tomcat 展示界面是这样大概,展示信息就是我们写的reason属性。

  @ResponseStatus(code=A,reason=B)标注在 @RequestMapping方法上,作用效果与 response.sendError(A,B)是一样的,所以需要慎用 reason 属性。

浅析@ResponseStatus的作用、属性、用法、底层原理及使用注意事项

二、@ResponseStatus的注意事项

1、当@ResponseStatus用在方法上,如果添加了reason属性,且reason不为"",且code > 0(哪怕状态码是200),会对当前请求走错误处理。

@RequestMapping("/test")
@ResponseStatus(reason="ok",code=HttpStatus.OK)
public String test() {
    return "test";
}

  原因:org.springframework.web.servlet.mvc.method.annotation.ServletInvocableHandlerMethod 类中,设置返回状态。

浅析@ResponseStatus的作用、属性、用法、底层原理及使用注意事项

  io.undertow.servlet.handlers.ServletInitialHandler 类中,判断错误码。

浅析@ResponseStatus的作用、属性、用法、底层原理及使用注意事项

2、返回状态码的其他翻案:返回状态码也可通过modelAndView.setStatus()实现

@RequestMapping(value = { "/test" }, method = RequestMethod.GET)
public ModelAndView test() {
  ModelAndView modelAndView = new ModelAndView();
  modelAndView.setViewName("test");
  modelAndView.setStatus(HttpStatus.INTERNAL_SERVER_ERROR);
  return modelAndView;
}

以上来源于这三篇文章的学习笔记:

https://www.cnblogs.com/lvbinbin2yujie/p/10575101.html

https://blog.csdn.net/Thinkingcao/article/details/110875494

https://blog.csdn.net/jumpe_17/article/details/118196644

上一篇:ES6特性 -- Promise特性


下一篇:waf指纹识别工具WAFW00F的使用