OKHttp库入门到精通 - 1（全程实战演示，完整Android代码示例，持续更新）

简介

OKHTTP是Square公司开发的一套开源HTTP框架。
项目主页：https://square.github.io/okhttp/。
源码：https://github.com/square/okhttp

高效：

• 支持HTTP/2，允许访问一个主机的所有请求共享同一个socket
• 通过连接池减少请求延迟（当HTTP/2不可用）
• 通过透明的GZIP压缩下载大小
• 缓存相应，避免进行重复请求。

稳定

• 当网络出现问题时，OkHttp会保持重试，一般问题都能够自动恢复。
• 如果服务有多个IP地址，当一个地址不能访问时，OkHttp将尝试其他地址。这各功能对于IPv4+IPv6和冗余链路数据中心托管的服务是必要的。
• OkHttp支持现代TLS特性(TLS 1.3, ALPN等)。当不能正常工作时，也可以将其配置为自动回退为普通连接。

易用

• 它的请求/响应API设计支持流式编程的创建方式。
• 支持同步阻塞调用，也支持带回调的异步调用。

系统要求

• OkHttp适用于Android 5.0+ (API级别21+)和Java 8+。
• OkHttp依赖于Okio高性能I/O库和Kotlin标准库。
• 建议保持OkHttp的更新。有助于防范潜在的安全风险问题。
• OkHttp使用您平台的内置TLS实现。在Java平台上，OkHttp还支持Conscrypt，它集成了BoringSSL和Java。

简单的Get请求示例

1. 在AS中创建一个Empty project。
2. app/build.gradle文件中增加OkHttp依赖，添加后执行Syn project with gradle files：

dependencies {
    implementation("com.squareup.okhttp3:okhttp:4.10.0")
}

3. 在AndroidManifest.xml文件中增加网络访问权限：

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

4. layout文件：main_activity.xml
   默认的布局文件，给TextView增加了id，把返回结果输出到界面。

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <TextView
        android:id="@+id/tv_response"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

5. Java代码：

package com.kaola.okhttp;

import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;
import android.widget.TextView;

import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        TextView textView = findViewById(R.id.tv_response);

        new Thread(new Runnable() {
            @Override
            public void run() {
                String response = getUrl("https://www.taobao.com/robots.txt");

                runOnUiThread(new Runnable() {
                    @Override
                    public void run() {
                        textView.setText(response);
                    }
                });
            }
        }).start();
    }

    private String getUrl(String url) {
        try {
            OkHttpClient client = new OkHttpClient();
            Request request = new Request.Builder()
                    .url(url)
                    .build();
            Response response = client.newCall(request).execute();
            return response.body().string();
        } catch (Exception e) {
            return "Failed to get response: " + e;
        }
    }
}

说明：
（1）网络访问不能在主线程中操作，创建一个新的线程执行网络操作。网络请求的返回结果通过runOnUiThread()方法或者handler等机制刷新UI显示。
（2）OkHttp的使用流程：构建OkHttpClient、Request（Get/Post）、Call对象，然后执行请求。同步：Call.execute()，异步：Call.enqueue(callback)。
（3）上面请求的示例url（https://www.taobao.com/robots.txt）可以在浏览器地址栏中打开查看。也可以替换为其他的可访问的url。

6. 访问结果：
   
   以上就完成了一个最基本的OkHttp的代码示例。后续文章中会陆续介绍各种请求的调用方式、原理以及一些高级用法。