Spring中的@ResponseStatus使用

lvbinbin2yujie 2022-11-19 我要评论

@ResponseStatus这个注解确实是个令我头疼的注解.

先记录下@ResponseStatus注解的定义. 记录几个得到的信息:@ResponseStatus声明在方法、类上, Spring3.0开始才有的, 三个属性其中 HttpStatus类型的 value 和 code是一个含义, 默认值就是服务器 500错误的 HttpStatus.

1. 用法一：标注在@RequestMapping方法上

@Controller
@RequestMapping("/simple")
public class SimpleController {
 
    @RequestMapping("/demo2")
    @ResponseBody
    @ResponseStatus(code = HttpStatus.OK)
    public String demo2(){
        return "hello world";
    }
}

上面说了 code 和 value一个意思，这里我就用code了，相对而言比较喜欢code单词. 这里作用就是改变服务器响应的状态码 ,比如一个本是200的请求可以通过@ResponseStatus 改成404/500等等.

常见的几个状态码 HttpStatus.OK 就是 200 , HttpStatus.INTERNAL_SERVER_ERROR 就是 500 等等，具体的查看 HttpStatus枚举有详细说明.

实现原理呢，注解底层还是通过设置 response.setStatus来实现.

1.1 在@RequestMapping方法执行完成

Spring解析返回值之前，进行了responseStatus设置

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

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

1.2 记录下在哪里调用了这个responseStatus方法 ?

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

发现如果ServletInvocableHandlerMethod的responseReason有值，也就是@ResponseStatus有reason属性,@RequestMapping方法返回值都不处理了,直接返回;

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

@ResponseStatus(code=A,reason=B)标注在 @RequestMapping方法上，作用效果与 response.sendError(A,B)是一样的.

所以，@ResponseStatus我建议啊, 这种方式下使用千万不要加 reason, 就把@ResponseStatus 当做一个用来改变响应状态码的方式!

2. 用法二：标注在@ControllerAdvice中

@ControllerAdvice
@ResponseStatus
public class MyControllerAdvice {
 
    @ExceptionHandler({ArithmeticException.class})
    public ModelAndView fix(Exception e){
        Map map=new HashMap();
        map.put("ex",e.getMessage());
        return new ModelAndView("error",map);
    }
 
}

@ControllerAdvice标注初衷我想就是程序运行过程中发生异常，对异常如何处理？而@ResponseStatus标注在@ControllerAdvice类或者该类下的@ExceptionHandler上，区别大概就是，

原来比如请求程序抛出异常，异常被捕获，走@ExceptionHandler，正常走完状态码是200.

@ControllerAdvice或者 @ExceptionHandler标注了@ReponseStatus，那走完状态码就是500.

如果你再给@ResponseStatus添加了reason属性，不管捕获异常方法咋返回，都是服务器的错误码捕获界面，比如上面我的例子，给@ResponseStatus添加reason=”your defined message”.

不管怎么说，下面界面比一大堆异常堆栈信息看起来更简洁，但我还是不推荐使用诶,原因啊，界面不友好.

3. 用法三：自定义类型的异常添加注解@ResponseStatus

@ResponseStatus(code = HttpStatus.INTERNAL_SERVER_ERROR,reason = "not  an error , just info")
public class MyException extends RuntimeException {
    public MyException() {
    }
 
    public MyException(String message) {
        super(message);
    }
}

这样子，在SpringMvc中如果有某个 @RequestMapping方法抛出该异常, 只要开启<mvc:annotation-driven/>,异常自动展示的界面都是如下的:

4. SpringMvc异常捕获方法如下

代码片段位于:org.springframework.web.servlet.DispatcherServlet#processHandlerException

<mvc:annotation-driven/>注册了三个HandlerExceptionResolver：ExceptionHandlerExceptionResolver用来处理@ExceptionHandler，而ResponseStatusExceptionResolver是用来处理抛出的异常上标注了@ResponseStatus的解析器.

4.1 ResponseStatusExceptionResolver解析异常方式

代码片段位于:org.springframework.web.servlet.mvc.annotation.ResponseStatusExceptionResolver#doResolveException

ex就是@RequestMapping方法抛出自定义的异常，使用工具类解析自定义异常上的@ResponseStatus注解，找到注解就调用resolveResponseStatus进行响应的处理。

protected ModelAndView doResolveException(HttpServletRequest request, HttpServletResponse response,
            Object handler, Exception ex) {
 
        ResponseStatus responseStatus = AnnotatedElementUtils.findMergedAnnotation(ex.getClass(), ResponseStatus.class);
        if (responseStatus != null) {
            try {
                return resolveResponseStatus(responseStatus, request, response, handler, ex);
            }
            catch (Exception resolveEx) {
                logger.warn("Handling of @ResponseStatus resulted in Exception", resolveEx);
            }
        }
        else if (ex.getCause() instanceof Exception) {
            ex = (Exception) ex.getCause();
            return doResolveException(request, response, handler, ex);
        }
        return null;
    }

4.2 ResponseStatusExceptionResolver如何根据异常上的@ResponseStatus处理响应？

代码片段位于:org.springframework.web.servlet.mvc.annotation.ResponseStatusExceptionResolver#resolveResponseStatus

获取了@ReponseStatus的 code reason属性，reason不为空就 response.sendError(statusCode, reason) ,并且返回一个空的ModelAndView，这里的ModelAndView已经没有意义了，SendError方法简单来说就是会跳转到web.xml中配置的错误状态码对应的页面，没有配置就是默认的服务器的那种错误界面，且只展示前面的reason信息，即响应类型为text/html .

5. 总结

不管哪种方式，@ReponseStatus最后都是通过response.setStatus或response.sendError来处理.

如果只是为了返回状态码，建议只使用 @ResponseStatus(code=xxxx)这样来设置响应状态码；

如果抛出异常呢，不建议@ControllerAdvice里面的 @ResponseStatus和自定义异常上的 @ResponseStatus一起使用，按照我的阅读理解，两个一起使用肯定是一个生效，而且是 @ControllerAdvice中的@ResponseStatus生效.

场景分析：假设抛出异常不是我们自定义的异常，我们想改变响应的状态码，通过@ExceptionHandler来处理异常，并在@ExceptionHandler方法上也可以设置@ResponseStatus来达到效果;

假如抛出自定义的异常，自己没有定义异常处理界面，那在异常上标注@ResponseStatus就可以走服务器默认的界面展示,或者通过web.xml 配置error-code \ error-page来自定义界面处理异常;

以上为个人经验，希望能给大家一个参考，也希望大家多多支持。