转载请注明出处 http://www.jianshu.com/p/7919cd2685d3 (作者：韩栋)
本文为译文，由于译者水平有限，欢迎拍砖，读者也可以阅读原文
【OkHttp3-基本用法，OkHttp3-使用进阶（Recipes），OkHttp3-请求器（Calls），OkHttp3-连接（Connections），OkHttp3-拦截器（Interceptor）】

OkHttp

一个支持Http和Http/2，可适用于Android以及Java应用的网络请求客户端。

概述

Http是现代网络应用的所常用的协议，它是一种数据传输的媒介。执行高效的Http代码可以让应用程序以更快的加载速度以及更少的带宽去请求数据。
OkHttp是一种高效的Http请求客户端，通常情况下它拥有以下特点：

当同时向同一个主机发送大量请求时，Http/2允许并支持共用一个Socket。
连接池的存在可以有效减少请求的所需的准备工作
可自动压缩下载数据，降低下载数据的大小
自动缓存响应数据，可以避免每次都通过网络去请求网络数据

OkHttp可以在请求出现问题时坚守灵活处理：针对于常见的连接问题，OkHttp会默认自动帮应用做修复处理。如果你的服务器有多个IP地址，OkHttp将会在请求失败时，不断尝试连接另外的IP地址。当服务器同时支持IPv4+IPv6，或者主机服务器出现数据故障时，这是非常有用的。如果握手失败，OkHttp会自动初始化一个带有TLS（SNI, ALPN）协议的新连接向支持TLS 1.0的服务器再次发起请求。

OkHttp的用法是非常简单的。OkHttp的请求/响应的Api被设计成建造者模式，并且它拥有不变性。它既可以在主线程中调用相应的闭包，也可以在子线程中去回调相应方法。

OkHttp支持Android 2.3以上的版本。对于Java 应用，最小版本需要JDK 1.7以上。

下载

okhttp-3.8.0.jar包下载链接
如果你通过向应用导入Jar包的方式集成，你必须同时集成Okio，Okio为OkHttp提供了快速的I/O操作以及可调整大小的缓存区。

MAVEN

<dependency>
  <groupId>com.squareup.okhttp3</groupId>
  <artifactId>okhttp</artifactId>
  <version>3.8.0</version>
</dependency>

GRADLE

compile 'com.squareup.okhttp3:okhttp:3.8.0'

范例

通过Get方法去请求一个URL

下面的代码通过一个URL去下载一个文本，并且打印出文本内容。

public class GetExample {
  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();
    }
  }

  public static void main(String[] args) throws IOException {
    GetExample example = new GetExample();
    String response = example.run("https://raw.github.com/square/okhttp/master/README.md");
    System.out.println(response);
  }
}

通过Post方法向服务器传递数据

下面代码展示了向服务器上传数据的操作。

public class PostExample {
  public static final MediaType JSON
      = MediaType.parse("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();
    }
  }

  String bowlingJson(String player1, String player2) {
    return "{'winCondition':'HIGH_SCORE',"
        + "'name':'Bowling',"
        + "'round':4,"
        + "'lastSaved':1367702411696,"
        + "'dateStarted':1367702378785,"
        + "'players':["
        + "{'name':'" + player1 + "','history':[10,8,6,7,8],'color':-13388315,'total':39},"
        + "{'name':'" + player2 + "','history':[6,10,5,10,10],'color':-48060,'total':41}"
        + "]}";
  }

  public static void main(String[] args) throws IOException {
    PostExample example = new PostExample();
    String json = example.bowlingJson("Jesse", "Jake");
    String response = example.post("http://www.roundsapp.com/post", json);
    System.out.println(response);
  }
}

OkHttp3-基本用法