Android网络框架——OkHttp3框架的使用

简介

OKHttp是一个处理网络请求的开源项目，Android 当前最火热网络框架，由移动支付Square公司贡献，用于替代HttpUrlConnection和Apache HttpClient(android API23 6.0里已移除HttpClient）。
GitHub地址

OKHttp优点

• 支持HTTP2/SPDY（SPDY是Google开发的基于TCP的传输层协议，用以最小化网络延迟，提升网络速度，优化用户的网络使用体验。）
• socket自动选择最好路线，并支持自动重连，拥有自动维护的socket连接池，减少握手次数，减少了请求延迟，共享Socket,减少对服务器的请求次数。
• 基于Headers的缓存策略减少重复的网络请求。
• 拥有Interceptors轻松处理请求与响应（自动处理GZip压缩）。

OKHttp的功能

• PUT，DELETE，POST，GET等请求
• 文件的上传下载
• 加载图片(内部会图片大小自动压缩)
• 支持请求回调，直接返回对象、对象集合
• 支持session的保持

OkHttp3的基础使用

添加OkHttp3的依赖

implementation 'com.squareup.okhttp3:okhttp:4.4.0'

添加网络权限

<uses-permission android:name="android.permission.INTERNET"/>

1.异步GET请求

//1.创建OkHttpClient对象
OkHttpClient okHttpClient = new OkHttpClient();
//2.创建Request对象，设置一个url地址（百度地址）,设置请求方式。
Request request = new Request.Builder().url("http://www.baidu.com").method("GET", null).build();
//3.创建一个call对象,参数就是Request请求对象
Call call = okHttpClient.newCall(request);
//4.请求加入调度，重写回调方法
call.enqueue(new Callback() {
   
    //请求失败执行的方法
    @Override
    public void onFailure(Call call, IOException e) {
   
    }

    //请求成功执行的方法
    @Override
    public void onResponse(Call call, Response response) throws IOException {
   
    }
});

上面就是发送一个异步GET请求的4个步骤：

1. 创建OkHttpClient对象
2. 通过Builder模式创建Request对象，参数必须有个url参数，可以通过Request.Builder设置更多的参数比如：header、method等
3. 通过request的对象去构造得到一个Call对象，Call对象有execute()和cancel()等方法。
4. 以异步的方式去执行请求，调用的是call.enqueue，将call加入调度队列，任务执行完成会在Callback中得到结果。

注意事项：

• 异步调用的回调函数是在子线程,我们不能在子线程更新UI,需要借助于 runOnUiThread() 方法或者 Handler 来处理。
• onResponse回调有一个参数是response，如果我们想获得返回的是字符串，可以通过response.body().string()获取；如果希望获得返回的二进制字节数组，则调用response.body().bytes()；如果你想拿到返回的inputStream，则调response.body().byteStream()，有inputStream我们就可以通过IO的方式写文件（后面会有例子）

2.同步GET请求

//1.创建OkHttpClient对象
OkHttpClient okHttpClient = new OkHttpClient();
//2.创建Request对象，设置一个url地址（百度地址）,设置请求方式。
Request request = new Request.Builder().url("http://www.baidu.com").method("GET", null).build();
//3.创建一个call对象,参数就是Request请求对象
Call call = okHttpClient.newCall(request);
//4.同步调用会阻塞主线程,这边在子线程进行
new Thread(new Runnable() {
   
    @Override
    public void run() {
   
        try {
   
            //同步调用,返回Response,会抛出IO异常
            Response response = call.execute();
        } catch (IOException e) {
   
            e.printStackTrace();
        }
    }
}).start();

同步GET请求和异步GET请求基本一样，不同地方是同步请求调用Call的execute()方法，而异步请求调用call.enqueue()方法

3.POST请求提交键值对

//1.创建OkHttpClient对象
OkHttpClient  okHttpClient = new OkHttpClient();
//2.通过new FormBody()调用build方法,创建一个RequestBody,可以用add添加键值对 
RequestBody  requestBody = new FormBody.Builder().add("name","zhangqilu").add("age","25").build();
//3.创建Request对象，设置URL地址，将RequestBody作为post方法的参数传入
Req