OkHttp学习系列一:入门和简单使用

参考并有选择地翻译了:http://square.github.io/okhttp/

综述

HTTP是是现代应用访问网络的方式。它是现在我们交换数据和媒体的方式。高效地使用HTTP可以让数据加载更快和节省带宽(bandwidth)。

OkHttp是一个适用于Android和Java的HTTP 和 HTTP/2的客户端。它很高效,默认支持:

  • HTTP/2支持允许到同一个主机(host)的所有的请求共享一个socket
  • 连接池技术减少了请求延迟(如果HTTP/2不可用)
  • 悄无声息的GZIP支持减少了下载的体积
  • 响应缓存完全避免了网络服务于重复的请求

当网络出错时,OkHttp坚持:默默地从普通的连接问题中恢复网络。如果你的服务中有多个IP地址,OkHttp会在第一次连接失败后尝试可选的地址。这对于IPv4+IPv6和拥有冗余数据中心的服务来说是很必须的。OkHttp采用现代的TLS(Transport Layer Security,传输层安全)(SNI和ALPN)初始化新的连接,当握手失败时会退回TLS1.0。

使用OkHttp相当easy。它的请求/响应的API是用流畅的建造者模式构建并且具有不变性(?)。它同时支持同步阻塞调用和使用回调异步调用。

OkHttp支持Android 2.3和以上版本。对应Java,最小的要求是1.7版本。

小知识:OkHttp是Square这家移动支付公司开发并贡献到开源社区的开发库。Square Open Source主页展示了该公司开源的一些产品,诸如dagger、picasso、retrofit等都是出自该公司,该公司的开源团队由25人组成,其中最出名的是Jake Wharton,他是ActionBarSherlock、butterknife、ViewPagerIndicator、NineOldAndroids等开源库的作者

示例

GET请求

下面的代码展示了如何从一个URL中获取内容数据并以字符串形式打印出来。

public class GetExample {
  OkHttpClient client = new OkHttpClient();
  String run(String url) throws IOException {
    Request request = new Request.Builder()
        .url(url)
        .build();
    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请求

下面的例子演示了如何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();
    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);
  }
}

下载

Okio用于给OkHttp提供快速的I/O和可调整大小的缓存池。
OkHttp的源代码,示例可以在GitHub中取得。

Meven配置

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

Gradle配置

compile 'com.squareup.okhttp3:okhttp:3.2.0'
    原文作者:Lshare_Blog
    原文地址: https://www.jianshu.com/p/4160dc21ccad
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞