OkHttp 在 Android 网络框架这一块的地位已经不言而喻了,尤为从 Android 4.4 以后,系统已经抛弃了原生的 HttpUrlConnection 的内部实现,转而是封装了 OkHttp 的实现,HttpUrlConnection 对外只是一层接口供开发者来调用。因此如今无论你是使用 HttpUrlConnection 仍是 Volley,其实都是在间接使用 OkHttp,说它的出现基本上统一了 Android 的 Http 网络框架真的一点也不为过。git
用官网的话来讲,OkHttp 是一个用于进行 Http / Http2 通讯的客户端,而且同时适用于 Android 和 Java。github
固然,其仍是一个很是强大而高效的网络框架,其主要特色在于:web
OkHttp的使用是很简单的,它在 request/reponse API 上采用了链式 Builder 的设计模式,使得它具有一旦构建便不可修改性。算法
最后,还提到它支持同步和异步请求。其实网络请求的实现原理上也是一次 I/O 通讯,而且大多仍是同步的 I/O。早前咱们直接用 HttpUrlConnection 进行通讯时根本不区分什么同步和异步,只是迫于 Android 的强制管理机制,要求网络通讯不能放在 "main thread" 中进行,不然就报 crash,咱们不得已才把网络请求这一段代码放到了子线程运行,最后再经过 Handler 把结果返回到主线程。因此这里说的同步和异步主要也是说实现了同步和异步的封装。固然,咱们进行同步调用时,也仍是不能在 "main thread" 中进行。apache
Get 请求json
// 构建 OkHttpClient 实例
OkHttpClient client = new OkHttpClient();
String run(String url) throws IOException {
// 经过链式 Builder 设计提供的 Builder 构建 Request
Request request = new Request.Builder()
.url(url)
.build();
// 如下是发起一个同步请求,Response 为接收的响应结果
Response response = client.newCall(request).execute();
return response.body().string();
}
复制代码
Post 请求设计模式
// 指定 Body 的 cotent-type 为 application/json,通常状况下都是这个
public static final MediaType JSON
= MediaType.parse("application/json; charset=utf-8");
// 构建 OkHttpClient 实例
OkHttpClient client = new OkHttpClient();
String post(String url, String json) throws IOException {
// 构建 Body
RequestBody body = RequestBody.create(JSON, json);
// 构建 Request,对于 post 请求,除了设置 url 还须要设置 body
Request request = new Request.Builder()
.url(url)
.post(body)
.build();
// 执行一个同步的请求,响应结果在 Response 中
Response response = client.newCall(request).execute();
return response.body().string();
}
复制代码
sample 中的请求都是同步的,其对应的异步请求为 client.newCall(request).enqueue(callback)。缓存
这个就 so easy 了安全
compile 'com.squareup.okhttp3:okhttp:3.12.0'
复制代码
当咱们 clone 下 OkHttp 的 github 仓库下来,会发现其里面含有很是多的小工程,这实际上是一个大的 maven 工程。若是要工程化的管理以及调试,建议用 IntelliJ IDEA 或者 Eclipse 打开工程,而不要用 Android Studio 打开,最后获得的效果以下图。若是打开的下图这个样子,你就能够进行愉快的代码调式了。固然手头最好仍是准备一个衬手的抓包工具,如 charles,fiddler 或者 更牛逼的 Wireshark。bash
从上图看 OKHttp 的核心实现库就是 okhttp 工程。做为一个优秀的框架,必定不是孤立地存在的,还有它身边的辅助工程,demo 工程等等。以下是整个工程模块的分类及简要说明。
模块名 | 说明 | |
---|---|---|
1 | benchmark | 主要用于性能测试。 |
2 | mockwebserver | mock 一个 web 服务器,方便测试。包括了 HTTP 和 HTTPS 全栈测试。 |
3 | okhttp-dnsoverhttps | 使用OkHttp在HTTPS上进行DNS实验 |
4 | okhttp-hpacktests | hpack 测试,hapck 即头部压缩算法,主要应用在 http2 上 |
5 | okhttp-testing-support | 测试支持模块 |
6 | sampls | 例程 |
7 | okcurl | okhttp 版本的 curl,能够测试整个 okhttp 库,包括了 http2 协议 |
8 | okhttp-andorid-support | 加强 Android 的支持 |
9 | okhttp-apache | 封装了 OkHttp 版本的 apache HttpClient 实现,将来版本中会被移除 |
10 | okhttp-tests | 单元测试 |
11 | okhttp-urlconnection | 封装了 OkHttp 版本的 HttpUrlConnection,将来版本中会被移除 |
12 | okhttp-tls | 简化 tls 使用的 API,尤为自签名证书 |
13 | okhttp-see | 实验性的用于支持服务器发送的事件。API不稳定,可能随时更改。 |
14 | okhttp-logging-interceptor | 典型的 interceptor 用例 |
15 | bom | 目前还只是一个空模块 |
16 | websites | okhttp 站点页面 |
17 | okhttp | okhttp 核心库的实现 |
基础认知部分主要是熟悉了 OkHttp 的官网以及 OkHttp 源码的整个工程。经过对整个工程的了解,其主要目的是创建一块儿一个全局观。所谓站的高看的远,有了全局观以后使得咱们深刻到某个细节以后不致于感到迷惘。
最后,感谢你能读到并读完此文章。受限于做者水平有限,若是分析的过程当中存在错误或者疑问都欢迎留言讨论。若是个人分享可以帮助到你,还请记得帮忙点个赞吧,谢谢。