OkHttp概览与Calls

一、Overview(概览)

1、什么是OkHttp

OkHttp是一个开源网络请求框架,由square团队开发

2、OkHttp有哪些优势
  • 1) 支持Http或者http2.0请求,支持同一个host共享socket连接
  • 2) 如果http/http2.0不可用时,使用连接池减少请求延迟
  • 3) GZIP压缩与下载大小透明
  • 4) 使用响应缓存避免重复请求
  • okHttp会在网络错误时进行重连,会在后台恢复链接问题。
  • 如果service提供了多个ip地址,okHttp会在第一次连接失败后自动尝试连接其他ip地址
  • okHttp支持TLS的,配置后可以实现广泛的连接。
3、适用的Android版本
  • Android 5.0+ 和 Java 8+
4、添加依赖
  • build.gradle中
    dependencies {
       // define a BOM and its version
       implementation(platform("com.squareup.okhttp3:okhttp-bom:4.9.0"))

       // define any required OkHttp artifacts without version
       implementation("com.squareup.okhttp3:okhttp")
       implementation("com.squareup.okhttp3:logging-interceptor")
    }
5、Get请求
OkHttpClient client = new OkHttpClient();

String run(String url) throws IOException {
  Request request = new Request.Builder()
      .url(url)
      .build();

  try (Response response = client.newCall(request).execute()) {
    return response.body().string();
  }
}
6、Post请求
public static final MediaType JSON
    = MediaType.get("application/json; charset=utf-8");

OkHttpClient client = new OkHttpClient();

String post(String url, String json) throws IOException {
  RequestBody body = RequestBody.create(JSON, json);
  Request request = new Request.Builder()
      .url(url)
      .post(body)
      .build();
  try (Response response = client.newCall(request).execute()) {
    return response.body().string();
  }
}

二、Calls(call请求)

  • Http客户端的工作就是接收请求并根据请求产生响应。理论上很简单,但是实际操作过程却比较麻烦
1、Requests 请求组成
  • 每个Http请求包含Url、请求方式(GET、POST)、Headers,特殊的请求也可能包含数据流RequestBody
2、Responses 响应组成
  • Response中包含响应状态码、响应头、响应体
3、Rewriting Requests 重写请求

当通过OkHttp发起一个http请求时,为了保证请求的正确和高效,OkHttp会在发送请求前将请求重写。

OkHttp会将原始请求中缺失的headers进行补充,包含:Content-Length, Transfer-Encoding, User-Agent, Host, Connection, and Content-Type,Accept-Encoding,当请求中包含cookie时,OkHttp会自动添加cookie头

一些请求中会包含缓存的响应,当缓存的响应不是最新时,OKHttp会自动更新缓存,这时OkHttp会自动在请求头中添加If-Modified-Since 和 If-None-Match

4、Rewriting Responses 重写响应

如果设置了不压缩,OkHttp 将丢弃相应的响应头Content-Encoding,Content-Length

5、Follow-up Requests 请求重定向

当请求的URL被移动后,webServer会返回一个响应码302来将URL指向新的URL,OKHttp会跟随并重定向获取最终的响应。

如果返回需要验签认证,OkHttp会查询验签认证来满足验签。如果认证中心包含证书,OKHttp会将请求携带证书进行验证。

6、Retrying Requests 请求重试

有时连接会失败:要么是连接池失效并断开,要么是无法访问web服务器本身。OkHttp会用另一条可用的路由重试请求

7、Calls

通过重写、重定向、跟踪和重试,简单的请求可能会产生许多请求和响应。无论需要多少中间请求和响应,OkHttp都会使用Call对满足请求的任务建模。
但令人欣慰的是,如果您的url被重定向,或者故障转移到另一个IP地址,代码将继续工作。

Calls两种请求方式

  • 同步:线程阻塞,直到响应可读。
  • 异步:在任何线程上排队请求,当响应是可读的时,在另一个线程上被回调。

请求可以从任何线程取消,如果请求还没有完成,会调用失败。当请求调用被取消时,正在写请求体或读取响应体的代码将发生IOException

8、Dispatch 请求分发

对于同步调用,可以使用自己的线程,并负责管理并发请求的数量。
对于异步调用,Dispatcher实现了最大并发请求的策略。可以设置每个web服务器的最大值(默认是5)和总的最大值(默认是64)

参考: OKHttp:https://square.github.io/okhttp/
上一篇:转 Android网络编程之使用HttpClient批量上传文件 MultipartEntityBuilder


下一篇:Dynamics 365Online 查询Web Api的请求WebUri