一、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)