前言
- 为什么这篇又不是Spring Boot初体验，因为在初体验过程中，我使用的方法返回值类型并不是基本数据类型，也不是String，而是用了ResponseEntity，为了避免有些人看不懂，在这篇做个ResponseEntity的源码浅析。
- 主要浅析ResponseEntity.ok方法的源码
- 本文是基于Spring5源码进行浅析
- 本文及以后文章中的 API 指的是API文档描述
ResponseEntity.class
让我们打开ResponseEntity.class
嗯。可以说是非常的清爽了；一个注释文档都没看到┑(￣Д ￣)┍
无奈；只好上官网找API：ResponseEntity API
ResponseEntity概念
Extension of
HttpEntitythat adds aHttpStatusstatus code. Used inRestTemplateas well@Controllermethods.
以上引用自ResponseEntity API
直译：
可以添加HttpStatus状态码的HttpEntity的扩展类。被用于RestTemplate和Controller层方法
简单粗暴理解：
ResponseEntity继承了HttpEntity，是HttpEntity的子类且可以添加HttpStatus状态码（推测HttpEntity不能添加HttpStatus状态码）。被用于RestTemplate和Controller层方法
ResponseEntity.ok API
在ResponseEntity中有两个ok方法；一个无参，一个有参
- public static ResponseEntity.BodyBuilder ok()
Create a builder with the status set to OK.
以上引用自ResponseEntity API
直译：
创建一个设置了OK状态的builder
简单粗暴理解：
这个方法若被调用的话，返回OK状态
- public static <T> ResponseEntity<T> ok(T body)
A shortcut for creating a
ResponseEntitywith the given body and the status set to OK.
以上引用自ResponseEntity API
直译：
一种捷径去创建ResponseEntity，通过被给予的body和设置了OK的状态
简单粗暴理解：
这个方法若被调用的话，返回body内容和OK状态
至于OK状态是什么，后面再解释
ResponseEntity.ok源码
//无参ok
public static ResponseEntity.BodyBuilder ok() {
return status(HttpStatus.OK);
}
//有参ok
public static <T> ResponseEntity<T> ok(T body) {
ResponseEntity.BodyBuilder builder = ok();
return builder.body(body);
}
通过源码，我们不难发现
- 与API中的描述一致，无参ok方法返回OK状态，有参ok方法返回body内容和OK状态
- body类型 是 泛型T，也就是我们不确定body是什么类型，可以向ok方法传递任意类型的值
- 有参ok方法其实有调用无参ok方法
那么源码中的BodyBuilder又是什么鬼呢，后面再解释
解释一下
OK状态是什么鬼
现在我们都知道ResponseEntity概念是可以添加HttpStatus状态码的HttpEntity的扩展类；那么不难推测出这个OK状态其实就是HttpStatus状态码（其实在上面的源码中也能看到了）
//无参ok
public static ResponseEntity.BodyBuilder ok() {
return status(HttpStatus.OK);
}
那么有计算机网络基础的看官都知道，在HttpStatus状态码中代表OK的是200；不信？？看源码（应该没人不信吧┑(￣Д ￣)┍）
BodyBuilder又是什么鬼
ResponseEntity结构
通过ResponseEntity的结构，我们知道BodyBuilder是ResponseEntity中的接口
BodyBuilder API
Defines a builder that adds a body to the response entity.
以上引用自BodyBuilder API
直译：
定义一个可以添加body到response entity的builder
简单粗暴理解：
ResponseEntity可以通过这个builder返回任意类型的body内容
BodyBuilder源码
public interface BodyBuilder extends ResponseEntity.HeadersBuilder<ResponseEntity.BodyBuilder> {
ResponseEntity.BodyBuilder contentLength(long var1);
ResponseEntity.BodyBuilder contentType(MediaType var1);
<T> ResponseEntity<T> body(@Nullable T var1);
}
通过BodyBuilder源码，不难发现
- BodyBuilder接口中的body方法的参数可以为空值（有@Nullable标签名字推测其允许空值）
后记
- 感觉写技术文章好艰难，要写好久，而且还要捋顺思路，这难度堪比编程，可能是我写的少的缘故吧
（脑阔疼） - 这两天被ThreadLocal给吸引住了，在研究ThreadLocal的源码，怎么说，感觉ThreadLocal源码的思维逻辑对现在的我来说，好难理解，过几天
（也许是十几天）也会出个ThreadLocal的源码浅析，当然是在写完Spring Boot初体验之后 - 关于读源码，这是每个程序员的必经之路，而我现在正在经过；嗯。。虽然源码读得有点艰难，但还算有趣吧
（真素脑阔疼）。
参考文章
ResponseEntity API
BodyBuilder API
下篇预告
Spring Boot初体验
补充 于2018年08月25日
我才发现原来class文件是不会有注释文档的；
在idea中打开class文件，发现idea代码编辑区的右上角有个Download Sources，很明显就是下载源码的意思，我点了，然后源码就下载下来了，根本不用去官网查API的。。
