OkHttp学习(一)-重要类解读

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有以下几种:

  1. RetryAndFollowUpInterceptor
  2. BridgeInterceptor
  3. CacheInterceptor
  4. ConnectInterceptor
  5. 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(Proxyjava.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相关,用于约束那些证书可以被信任

推荐阅读更多精彩内容