OkHttpClient
对外提供的公开类,实现了Call.Factory
接口
OkHttpClient.Builder
OkHttp
内部类,构建OkHttpClient
对象都是使用Builder
类来创建
HttpUrl
封装Http地址,提供了众多操作http地址的方法, http请求地址实际上就是一个URL
, 而URL
的标准构成是:
scheme://username:password@host:port/path/path?queryParameter#fragment;
其中我们最常用的是scheme://host:port/path?queryParameter
这种形式
Headers
封装Http请求的头部信息,通过Headers
类可以配置Http请求的头部信息
RequestBody
抽象类,封装Http请求体Body
FormBody
继承自RequestBody
,代表表单数据的请求体
MultipartBody
同样继承自RequestBody
,multipart/form-data
一般用于传输文件,在请求体中添加了分隔符
Request
封装Http请求,内部包含上述的HttpUrl
, Headers
, RequestBody
Response
表Http的响应消息
ResponseBody
Http响应正, 一般情况下是进行http请求都是通过异步的形式,需要传入一个回调接口Callback
,请求结束后会回调onResponse(Call call, Response response)
方法,然后通过response.body()
获取ResponseBody
对象, 通过ResponseBody
可以获取对应的输入
Call
可以理解为任务,每次要进行Okhttp的网络请求时,都需要通过创建Call
对象,来完成实际的请求工作,Call
是一个接口,主要提供了两个方法:
-
Response execute()
- 同步调用 -
void enqueue(Callback responseCallback)
- 异步调用
RealCall
Call
接口的唯一实现类,当调用OkHttpClient.newCall
时实际生成的就是RealCall
Dispatcher
顾名思义,调度器,内部包含一个ExecutorService
线程池,以及三个双端队列:
-
readyAsynCalls
- 保存待运行的请求(当正在运行的请求队列已满时,新放入的请求会放入待运行队列) -
runningAsyncCalls
- 保存正在运行的异步请求 -
runningSynCalls
- 保存正在运行的同步请求
Interceptor
拦截器,可以通过拦截器重写,监听请求,OkHttp内部就是通过一层层的拦截器逐步完成, Interceptor使用的是责任链模式:"它包含了一些命令对象和一系列的处理对象,每一个处理对象决定它能处理哪些命令对象,它也知道如何将它不能处理的命令对象传递给该链中的下一个处理对象。该模式还描述了往该处理链的末尾添加新的处理对象的方法"(参考来自: 拆轮子系列: 拆OkHttp)
Okhttp内部的Interceptor有以下几种:
RetryAndFollowUpInterceptor
BridgeInterceptor
CacheInterceptor
ConnectInterceptor
CallServerInterceptor
个人觉得, Interceptor是OkHttp中最牛掰的一个设计
RetryAndFollowUpInterceptor
主要创建StreamAllocation
对象,处理重定向响应以及进行错误恢复
BridgeInterceptor
主要添加一些必要的Http请求头部信息,获取响应后,会保存Cookie,如果响应的内容是以gzip压缩的,还会进行解压缩
CacheInterceptor
主要从缓存中获取相应,如果有对应的响应,且响应未过期的话,直接返回缓存中的响应,如果没有缓存则调用下一步的Interceptor进行请求,得到响应后,检查响应是否需要缓存,若需要缓存,则直接缓存起来
ConnectInterceptor
主要是建立同服务器之间的连接
CallServerInterceptor
主要是处理相对应的IO,发送请求,获取响应(OkHttp的I/O使用的Okio)
Protocol
协议类,定义了Okhttp所使用的网络协议,目前okhttp支持以下几种协议:
- http/1.0
- http/1.1
- SPDY/3.1
- http/2.0 - 即https协议
Dns
接口, 提供根据主机名查找ip地址的方法,默认实现是内部的SYSTEM
变量,通过java.net.InextAddress.getAllByName
查找ip
Cookie
用于表示Cookie
信息
CookieJar
用来管理Cookie
,可以从请求中提取Cookie,也可以从响应中获取Cookie, 内部提供了一个的NO_COKKIE
变量作为默认的cookie管理类
MediaType
用于指定请求体的Content-Type的MIME类型,此外还能指定字符集,默认为utf-8
RouteSelector
代理选择器, 通过这个类来选择使用哪个代理Proxy
(Proxy
是java.net包里面的代理,代理分为三种:
DIRECT直连,即直接跟目标服务器连接,
HTTPhttp代理,
SOCKS`socks代理)
Connection
接口,提供Socket连接的方法
RealConnection
实现了Connection
接口,Socket的连接实际是通过这个类来完成,重要的方法有:
- void connect() 进行网络连接,创建Socket连接,如果是https协议,还要进行TLS的握手,证书校验等操作
ConnectionPool
连接池,用来管理HTTP和SPDY连接的复用, HTTP请求相同的Address可以共享同一个连接
ConnectionSpec
连接规范,用于配Socket连接层,还可配置HTTPS相关的配置
HttpCodec
接口,提供了创建http request和解析http response的方法, 重要方法有:
-
Sink createRequestBody
创建一个Request body的输出 -
Response.Builder readResponseHeaders
从流中解析出Response -
ResponseBody openResponseBody
从Response中解析出REsponseBody
StreamAllocation
用于协调连接,流和请求. 比较重要的方法有:
-
HttpCodec newStream()
- 找到一个可以使用的Connection, 之后生成一个新的HttpCodec
CipherSuite
密码套件,提供了众多算法供TLS连接使用
CertificatePinner
证书锁,HTTPS相关,用于约束那些证书可以被信任