1、产生疑问
我们知道,如果在 Controller 的某个方法上加上 @ResponseBody 注解,那么你就能拿到 json 数据。
如果你只是知道这么用,那么你应该知道 ResponseBody 的具体作用:
其将方法的返回值通过适当的转换器转换为指定的格式之后,写入到 response 对象的 body 区,通常用来给客户端返回 JSON 数据或者是 XML 数据,当方法上面没有写 ResponseBody 时,底层会将方法的返回值封装为 ModelAndView 对象;需要注意的是,在使用此注解之后不会再走试图处理器,而是直接将数据写入到输入流中,他的效果等同于通过 response 对象输出指定格式的数据。
来看看 ResponseEntity:
首先我们清楚,@RestController = Controller + ResponseBody
但是,这个 ResponseEntity 是个什么鬼?
2、尝试理解
还记得 http 请求包含什么吗?
请求头、请求行、请求体;响应头、响应体、响应行(状态码)
而 @ResponseBody 只是作为一个响应体。
也就是在典型的 spring mvc 应用中,请求点通常返回 html 页面。
有时我们仅需要实际数据,如使用ajax请求。
这时我们能通过 @ResponseBody 注解标记请求处理方法,审批人能够处理方法结果值作为http响应体。
说到响应体,就得扯到状态码了,毕竟光有响应体不行呀,我们经常遇到的那个 404 就是个状态码;
放在注解中就是 @ResponseStatus。
那么这些跟 ResponseEntity 有什么关系?
ResponseEntity 太强大,ResponseBody 、 ResponseStatus 让使用更加便捷;
看一下 ResponseEntity.class
ResponseEntity 继承了 HttpEntity,是 HttpEntity 的子类且可以添加 HttpStatus 状态码,被用于 RestTemplate(后面文章单独讲解) 和 Controller 层方法。
通过代码继续分析:
@GetMapping("list")
public ResponseEntity<List<Category>> queryCategoryListByPid(@RequestParam("pid")Long pid){
return ResponseEntity.ok( mCategoryService.queryCategoryListByPid(pid) );
}
ResponseEntity <T> ,泛型T 表示要设置的返回的 响应体,而 ResponseEntity.ok() 表示设置的状态码 200,而 ResponseEntity.ok() 其实是一种快捷的写法,如果不这样写的话:
@GetMapping("list")
public ResponseEntity<List<Category>> queryCategoryListByPid(@RequestParam("pid")Long pid){
//return ResponseEntity.status(200).body(mCategoryService.queryCategoryListByPid(pid));
//或者
return ResponseEntity.status(HttpStatus.OK).body(mCategoryService.queryCategoryListByPid(pid));
}
3、总结
尽管 ResponseEntity 非常强大,但不应该过度使用。
在一些简单情况下,还有其他方法能满足我们的需求,使代码更整洁。
ResponseBody ResponseStatus