okhttp 介绍
okhttp 是 square 公司开源的一款网络框架，封装了一个高性能的 http 请求库。
特点
- 支持 spdy、http2.0、websocket 等协议
- 支持同步、异步请求
- 封装了线程池，封装了数据转换，提高性能。
- 在 android 6.0 中自带的网络请求 api 的底层就是使用了
okhttp来进行的 - 使用
okhttp比较接近真正的 http 协议的框架
这个类主要是用来配置 okhttp 这个框架的，通俗一点讲就是这个类是管理这个框架的各种设置的。
call 类的工厂，通过 okhttpclient 才能得到 call 对象。
okhttp 中几个重要类的介绍
okhttpclient
这个类主要是用来配置 okhttp 这个框架的，通俗一点讲就是这个类是管理这个框架的各种设置的。
call 类的工厂，通过 okhttpclient 才能得到 call 对象。
okhttpclient使用注意
okhttpclient 应该被共享，使用 okhttp 这个框架的时候，最好要将 okhttpclient 设置成单例模式，所有的 http 在进行请求的时候都要使用这一个 client 。因为每个 okhttpclient 都对应了自己的连接池和线程池。减少使用连接池和线程池可以减少延迟和内存的使用。相反的如果每个请求都创建一个 okhttpclient 的话会很浪费内存资源。
okhttpclient的创建
okhttpclient 有三个创建方法
第一个方法：直接使用 new okhttpclient（） 来创建一个实例对象就可以了，这个实例对象有默认的配置。默认请求连接超时时间 10 s ，读写超时时间 10 s，连接不成功会自动再次连接。
第二个方法：就是通过 builder的方式来自己定义一个 okhttpclient 。当然如果你直接 build 没有自己配置参数的话，效果和第一个方法是一样的。
public final okhttpclient = new okhttpclient.builder() .addinterceptor(new httplogginginterceptor()) .cache(new cache(cachedir,cachesize)) .等等配置 .build();
第三个方法：就是通过已有的 okhttpclient 对象来复制一份共享线程池和其他资源的 okhttpclient 对象。
okhttpclient agerclient = client.newbuilder() .readtimeout(500,timeunit.millsecons) .build();
这种方法的好处就是，当我们有一个特殊的请求，有的配置有点不一样，比如要求连接超过 1 s 就算超时，这个时候我们就可以使用这个方法来生成一个新的实例对象，不过他们共用很多其他的资源，不会对资源造成浪费。
关于 okhttpclient 的配置改变都在 builder 中进行
不需要了可以关闭
其实持有的线程池和连接池将会被自定释放如果他们保持闲置的话。
你也可以自动释放，释放后将来再调用 call 的时候会被拒接。
client.dispatcher().excurorservice().shutdown()
清除连接池，注意清除后，连接池的守护线程可能会立刻退出。
client.connectionpool().evictall()
如果 client 有缓存，可以关闭。注意：再次调用一个被关闭的 cache 会发生错误。也会造成 crash。
client.cache().close();
okhttp 在 http/2 连接的时候也会使用守护线程。他们闲置的时候将自动退出。
知道有这么一回事就行，一般不会主动调用。
call 类
call 这个类就是用来发送 http 请求和读取 http 响应的一个类
这个类的方法很少，从上到下依次是：放弃请求、异步执行请求、同步执行请求。
request 类
这个类就是相当于 http 请求中的请求报文，是用来表达请求报文的，所以这里可以设置请求的 url、请求头、请求体等等和请求报文有关的内容。
主要方法罗列：
// 获取请求 url
public httpurl ;
// 获取请求方法类型
public string method();
// 获取请求头
public headers headers（）；
//获取请求体
public requestbody body();
// 获取 tag
public object tag();
// 返回缓存控制指令，永远不会是 null ，即使响应不包含 cache-control 响应头
public cachecontrol cachecontrol();
// 是否是 https 请求
public boolean ishttps();
// resquest{method=" ",url=" ",tag = " "}
public string tostring();
这是它的 builder 中提供的方法，只设置 . 的时候默认是 post 请求。
requestbody
介绍完请求报文就要介绍请求体了，这都是和 http协议紧密联系的。
requestbody 就是用来设置请求体的，它的主要方法就是下面这个几个静态方法，用来生成对应的请求体：
就是通过这几个方法来产生对应的不同的请求体。mediatype 是用来描述请求体或者响应体类型的。比如请求体类型是 json 串格式的，那对应的 mediatype 就是mediatype.parse("application/json; charset=utf-8"); ，如果上传的是文件那么对应的就是 application/octet-stream，还有几个常用的类型 text/plain imge/png text/x-markdown 等等。
它还有两个子类：
formbody 这个请求体是我们平时最常用的，就是我们平时使用 post 请求的时候，参数是键值对的形式。就是使用这个请求体最简单了。
说深一点，对应的请求报文是：
post /test http/1.1 请求行
host: 32.106.24.148:8080 下面都是请求头
content-type: application/x-www-form-urlencoded 用于指明请求体的类型。
user-agent: postmanruntime/7.15.0
accept: */*
cache-control: no-cache
postman-token: 954bda0d-dbc2-4193-addf-a7631cab2cfa,5ba2ebed-90b4-4f35-bcf5-80c4777de471
host: 39.106.24.148:8080
accept-encoding: gzip, deflate
content-length: 133
connection: keep-alive
cache-control: no-cachekey0=value0&key1=value1 请求体(也是我们的参数)
这是发送的原始的报文格式，用代码实现的话就是
// 创建客户端
okhttpclient client = new okhttpclient();
// 建立请求体
formbody formbody = new formbody.builder()
.add("key0", "value0")
.add("key1","value1")
.build();
// 建立请求报文
request request = new request.builder
.post(formbody)
.
.addheader("content-type", "application/x-www-form-urlencoded")
.addheader("user-agent", "postmanruntime/7.15.0")
.addheader("accept", "*/*")
.addheader("cache-control", "no-cache")
.addheader("postman-token", "954bda0d-dbc2-4193-addf-a7631cab2cfa,af7c027c-a7ba-4560-98ae-3a2a473ab88a")
.addheader("host", "39.106.24.148:8080")
.addheader("accept-encoding", "gzip, deflate")
.addheader("content-length", "133")
.addheader("connection", "keep-alive")
.addheader("cache-control", "no-cache")
.build();
// 发起请求
client.newcall(request).excute();
上面是使用了 formbody 的形式，如果使用 requestbody 的话就要更麻烦一些。
okhttpclient client = new okhttpclient();
mediatype mediatype = mediatype.parse("application/x-www-form-urlencoded");
requestbody body = requestbody.create(mediatype, "key0=value0&key1=value1");
request request = new request.builder()
.
.post(body)
.addheader("content-type", "application/x-www-form-urlencoded")
.addheader("user-agent", "postmanruntime/7.15.0")
.addheader("accept", "*/*")
.addheader("cache-control", "no-cache")
.addheader("postman-token", "954bda0d-dbc2-4193-addf-a7631cab2cfa,af7c027c-a7ba-4560-98ae-3a2a473ab88a")
.addheader("host", "39.106.24.148:8080")
.addheader("accept-encoding", "gzip, deflate")
.addheader("content-length", "133")
.addheader("connection", "keep-alive")
.addheader("cache-control", "no-cache")
.build();
response response = client.newcall(request).execute();
当然平时我们使用的时候，不用拼上这么多的请求头，我这样写的目的就是为了更加还原请求报文。
还有一个子类 multipartbody这个可以用来构建比较复杂的请求体。
1995 年 content-type 的类型扩充了 multipart/form-data 用来支持向服务器发送二进制数据。如果一次提交多种类型的数据，比如:一张图片和一个文字，这个时候引入了 boundary ，boundary使得 post 可以满足这种提交多种不同的数据类型。通过 boundary 可以实现多个不同类型的数据同时存在在一个 request 中。两个 boundary之间就是一个类型的数据，并且可以重新设置 content-type
与 html 文件上传形式兼容。每块请求体都是一个请求体，可以定义自己的请求头。这些请求头可以用来描述这块请求。例如，他们的 content-disposition。如果 content-length 和 content-type 可用的话，他们会被自动添加到请求头中。
来看一下这种类型的请求报文是什么样的：
post /web/uploadservlet http/1.1
content-type: multipart/form-data; boundary=e1b05ca4-fc4e-4944-837d-cc32c43c853a
content-length: 66089
host: localhost.tt.com:8080
connection: keep-alive
accept-encoding: gzip
user-agent: okhttp/3.5.0–e1b05ca4-fc4e-4944-837d-cc32c43c853a
content-disposition: form-data; name=”file”; filename=”**.png”
content-type: image/png
content-length: 65744fdpng
ihdr�0b7m�im�m�ccpim�cc profileh��……………………iend�b`�
–e1b05ca4-fc4e-4944-837d-cc32c43c853a
content-disposition: form-data; name=”comment”
content-length: 30上传一个图
–e1b05ca4-fc4e-4944-837d-cc32c43c853a–
第一个数据是一张 png 的图，重新设置了 content-type:image/png 中间的乱码就是图片的数据。这一堆数据前有一个空行，表示上下分别是请求头、请求体。
第二个数据，就是一个文本数据。
这样它们一起构成了请求体。
讲起来可能比较复杂，就记住，当既需要上传参数，又需要上传文件的时候用这种请求体。
mediatype mediatype = mediatype.parse("image/png");
requestbody requestbody = new multipartbody.builder()
// 需要设置成表单形式否则无法上传键值对参数
.settype(multipartbody.form)
.addpart(headers.of("content-disposition", "form-data;name=\"title\""),
requestbody.create(null, "square logo"))
.addpart(
headers.of("content-disposition", "form-data;name=\"imge\""),
requestbody.create(mediatype, new file("路径/logo.png"))
).
build();
request request = new request.builder()
.post(requestbody)
.
.build();
try {
mokhttpclient.newcall(request).execute();
} catch (ioexception e) {
e.printstacktrace();
}
简化写法：
mediatype mediatype = mediatype.parse("image/png");
requestbody requestbody = new multipartbody.builder()
.settype(multipartbody.form)
.addformdatapart("title","logo")
.addformdatapart("img","logo.png",requestbody.create(mediatype,new file("路径/logo.png")))
.build();
content-disposition 可以用在消息体的子部分中，用来给出其对应字段的相关信息。作为 multipart body 中的消息头，第一个参数总是固定不变的 form-data; 附加的参数不区分大小写，并且拥有参数值，参数名与参数值用等号连接，参数之间用分号分隔。参数值用双引号括起来
// 比如这样，就是这种固定的格式 "content-disposition","form-data;name=\"mfile\";filename=\"xxx.mp4\""
到这里关于请求的几个重要的类就讲完了。
总结一下
只要掌握 http 请求的原理，使用起 okhttp 来也就不是什么问题了。
首先 okhttpclient 是用来设置关于请求工具的一些参数的，比如超时时间、是否缓存等等。
call 对象是发起 http 请求的对象，通过 call 对象来发起请求。
发起请求的时候，需要有请求报文，request 对象就是对应的请求报文，可以添加对应的请求行、请求头、请求体。
说起请求体就是对应了 requestbody 了。然后这个网络请求过程就完成了！
okhttp架构图
okhttp发送主体流程
在使用okhttp发起一次请求时，对于使用者最少存在okhttpclient、request与call三个角色。其中okhttpclient和request的创建可以使用它为我们提供的builder（建造者模式）。而call则是把request交给okhttpclient之后返回的一个已准备好执行的请求。
同时okhttp在设计时采用的门面模式，将整个系统的复杂性给隐藏起来，将子系统接口通过一个客户端okhttpclient统一暴露出来。
okhttpclient中全是一些配置，比如代理的配置、ssl证书的配置等。而call本身是一个接口，我们获得的实现为:realcall
static realcall newrealcall(okhttpclient client, request originalrequest, boolean forwebsocket) {
// safely publish the call instance to the eventlistener.
realcall call = new realcall(client, originalrequest, forwebsocket);
call.eventlistener = client.eventlistenerfactory().create(call);
return call;
}
call的execute代表了同步请求，而enqueue则代表异步请求。两者唯一区别在于一个会直接发起网络请求，而另一个使用okhttp内置的线程池来进行。这就涉及到okhttp的任务分发器。
- call: 每一个请求的实例，比如登录login 对应一个call、获取用户信息 对应一个call。call本身就是一个接口，用户的每一个http请求就是一个call实例，而且每一个call都对应一个线程。
- call包含了 request()、execute()、enqueue() 方法。
- realcall： 具体的call接口实现类，代表每一个http请求。每一个realcall内部有一个asynccall final类。
- asynccall： realcall类的内部final类，实现了namedrunnable类的execute()。继承于namedrunnable类，namedrunnable类实现了runnable接口，并且有一个execute()抽象方法，这个抽象方法在runnable的run()里执行。
- dispatcher：
- okhttp的任务队列，其内部维护了一个线程池，进行线程分发，实现非阻塞，高可用，高并发。
- 当有接收到一个call时，dispatcher负责在线程池中找到空闲的线程并执行其execute方法。
- okhttp采用deque作为缓存队列，按照入队的顺序先进先出。
- okhttp最出彩的地方就是在try/finally中调用了finished函数，可以主动控制等待队列的移动，而不是采用 锁或者wait/notify，极大减少了编码复杂性。
分发器
dispatcher，分发器就是来调配请求任务的，内部会包含一个线程池。可以在创建okhttpclient时，传递我们自己定义的线程池来创建分发器。
这个dispatcher中的成员有:
//异步请求同时存在的最大请求 private int maxrequests = 64; //异步请求同一域名同时存在的最大请求 private int maxrequestsperhost = 5; //闲置任务(没有请求时可执行一些任务，由使用者设置) private @nullable runnable idlecallback; //异步请求使用的线程池 private @nullable executorservice executorservice; //异步请求等待执行队列 private final dequereadyasynccalls = new arraydeque<>(); //异步请求正在执行队列 private final deque runningasynccalls = new arraydeque<>(); //同步请求正在执行队列 private final deque runningsynccalls = new arraydeque<>();
同步请求
synchronized void executed(realcall call) {
runningsynccalls.add(call);
}
因为同步请求不需要线程池，也不存在任何限制。所以分发器仅做一下记录。
异步请求
synchronized void enqueue(asynccall call) {
if (runningasynccalls.size() < maxrequests && runningcallsforhost(call) < maxrequestsperhost) {
runningasynccalls.add(call);
executorservice().execute(call);
} else {
readyasynccalls.add(call);
}
}
当正在执行的任务未超过最大限制64，同时runningcallsforhost(call) < maxrequestsperhost同一host的请求不超过5个，则会添加到正在执行队列，同时提交给线程池。否则先加入等待队列。
加入线程池直接执行没啥好说的，但是如果加入等待队列后，就需要等待有空闲名额才开始执行。因此每次执行完一个请求后，都会调用分发器的finished方法
//异步请求调用
void finished(asynccall call) {
finished(runningasynccalls, call, true);
}
//同步请求调用
void finished(realcall call) {
finished(runningsynccalls, call, false);
}
private void finished(deque calls, t call, boolean promotecalls) {
int runningcallscount;
runnable idlecallback;
synchronized (this) {
//不管异步还是同步，执行完后都要从队列移除(runningsynccalls/runningasynccalls)
if (!calls.remove(call)) throw new assertionerror("call wasn't in-flight!");
if (promotecalls) promotecalls();
//异步任务和同步任务正在执行的和
runningcallscount = runningcallscount();
idlecallback = this.idlecallback;
}
// 没有任务执行执行闲置任务
if (runningcallscount == 0 && idlecallback != null) {
idlecallback.run();
}
}
需要注意的是 只有异步任务才会存在限制与等待，所以在执行完了移除正在执行队列中的元素后，异步任务结束会执行promotecalls()。很显然这个方法肯定会重新调配请求。
private void promotecalls() {
//如果任务满了直接返回
if (runningasynccalls.size() >= maxrequests) return;
//没有等待执行的任务，返回
if (readyasynccalls.isempty()) return;
//遍历等待执行队列
for (iterator i = readyasynccalls.iterator(); i.hasnext(); ) {
asynccall call = i.next();
//等待任务想要执行，还需要满足：这个等待任务请求的host不能已经存在5个了
if (runningcallsforhost(call) < maxrequestsperhost) {
i.remove();
runningasynccalls.add(call);
executorservice().execute(call);
}
if (runningasynccalls.size() >= maxrequests) return; // reached max capacity.
}
}
请求流程
用户是不需要直接操作任务分发器的，获得的realcall中就分别提供了execute与enqueue来开始同步请求或异步请求。
@override public response execute() throws ioexception {
synchronized (this) {
if (executed) throw new illegalstateexception("already executed");
executed = true;
}
capturecallstacktrace();
eventlistener.callstart(this);
try {
//调用分发器
client.dispatcher().executed(this);
//执行请求
response result = getresponsewithinterceptorchain();
if (result == null) throw new ioexception("canceled");
return result;
} catch (ioexception e) {
eventlistener.callfailed(this, e);
throw e;
} finally {
//请求完成
client.dispatcher().finished(this);
}
}
异步请求的后续同时是调用getresponsewithinterceptorchain()来执行请求
@override
public void enqueue(callback responsecallback) {
synchronized (this) {
if (executed) throw new illegalstateexception("already executed");
executed = true;
}
capturecallstacktrace();
eventlistener.callstart(this);
//调用分发器
client.dispatcher().enqueue(new asynccall(responsecallback));
}
如果该realcall已经执行过了，再次执行是不允许的。异步请求会把一个asynccall提交给分发器。
asynccall实际上是一个runnable的子类,使用线程启动一个runnable时会执行run方法，在asynccall中被重定向到execute方法:
final class asynccall extends namedrunnable {
private final callback responsecallback;
asynccall(callback responsecallback) {
super("okhttp %s", redacted);
this.responsecallback = responsecallback;
}
//线程池执行
@override
protected void execute() {
boolean signalledcallback = false;
try {
response response = getresponsewithinterceptorchain();
//.......
} catch (ioexception e) {
//......
} finally {
//请求完成
client.dispatcher().finished(this);
}
}
}
public abstract class namedrunnable implements runnable {
protected final string name;
public namedrunnable(string format, object... args) {
this.name = util.format(format, args);
}
@override
public final void run() {
string oldname = thread.currentthread().getname();
thread.currentthread().setname(name);
try {
execute();
} finally {
thread.currentthread().setname(oldname);
}
}
protected abstract void execute();
}
同时asynccall也是realcall的普通内部类，这意味着它是持有外部类realcall的引用，可以获得直接调用外部类的方法。
可以看到无论是同步还是异步请求实际上真正执行请求的工作都在getresponsewithinterceptorchain()中。这个方法就是整个okhttp的核心：拦截器责任链。但是在介绍责任链之前，我们再来回顾一下线程池的基础知识。
分发器线程池
前面我们提过，分发器就是来调配请求任务的，内部会包含一个线程池。当异步请求时，会将请求任务交给线程池来执行。那分发器中默认的线程池是如何定义的呢？为什么要这么定义？
public synchronized executorservice executorservice() {
if (executorservice == null) {
executorservice = new threadpoolexecutor(
0, //核心线程
integer.max_value, //最大线程
60, //空闲线程闲置时间
timeunit.seconds, //闲置时间单位
new synchronousqueue(), //线程等待队列
util.threadfactory("okhttp dispatcher", false) //线程创建工厂
);
}
return executorservice;
}
为什么选择使用okhttp
1.可扩展性高。类似于缓存，dns，请求/连接/响应超时时间等等都可以通过配置传入，甚至线程池都可以根据自己的需求来配置。
2.okhttp使用了连接池缓存，提高通信效率。
3.责任链五层拦截器模式，每层功能清晰明了，并且提供了两层可扩展的拦截器方便进行所需要的改造。
4.层次结构清晰，方便进行问题的排查。
5.观察者模式的充分使用，查看请求状态和监控请求状态变得十分简单。
6.使用了okio框架进行数据的处理，效率和安全性上更高。
