Android Networking I: OkHttp, Volley and Gson

写这篇文章的动机

在安卓项目中有一个问题可能无法避免：网络。不管你是加载图片，请求API数据还是从因特网上获得一个字节，你都是在使用网络。

鉴于网络在安卓中的重要性与基础性，当今安卓开发者面临的问题之一就是使用何种解决方案。有许多优秀的库，你可以用各种方式把一个用在另一个之上。

之所以这么多的人致力于开发网络库是因为 Android framework所提供的办法 不够好，在旧版本中一团糟（Eclair, Froyo 和 Gingerbread），每次进行网络操作的时候，你都需要重复的写乱七八糟的代码。考虑到安卓所获取的强势地位，试图一次性解决所有问题的方案与库就开始出现了。

这篇文章的目的只是分享我的发现与经验，以及我所学之所得。也许能帮助到一些人。

这篇文章中我们将讨论其中的一个解决方案：OkHttp, Volley 和 Gson的组合。今后的文章中我们将讨论其他方案。

假设

和服务器的API交互是通过JSON的

你在使用Android Studio 和 Gradle

OkHttp

OkHttp是一个现代，快速，高效的Http client，支持HTTP/2以及SPDY，它为你做了很多的事情。纵观一眼OkHttp为你实现的诸多技术如连接池，gziping，缓存等就知道网络相关的操作是多么复杂了。OkHttp扮演着传输层的角色。

OkHttp使用Okio来大大简化数据的访问与存储，Okio是一个增强 java.io 和 java.nio的库 。

OkHttp和Okio都是Square团队开发的。

OkHttp是一个现代，快速，高效的Http client，支持HTTP/2以及SPDY，扮演着传输层的角色。

Volley

Volley是一个简化网络任务的库。他负责处理请求，加载，缓存，线程，同步等问题。它可以处理JSON，图片，缓存，文本源，支持一定程度的自定义。

Volley是为RPC网络操作而设计的，适用于短时操作。

Volley默认在Froyo上使用Apache Http stack作为其传输层，在Gingerbread及之后的版本上使用HttpURLConnection stack作为传输层。原因是在不同的安卓版本中这两种http
stack各自存在一些问题。

Volley可以轻松设置OkHttp作为其传输层。

Volley是谷歌开发的。



这就是Ficus Kirkpatrick（Volley背后的开发者）所描述的安卓网络操作：许许多多异步调用。

Gson

Gson 是一个JSON序列化与反序列化库，使用反射来把JSON对象转换成Java数据模型对象。你可以添加自己的序列化与反序列化来更好的控制与自定义。

Gson是谷歌开发的。

设置

Android Studio的gradle依赖

你需要在app模块的build.gradle文件中添加如下几行代码：

compile 'com.squareup.okio:okio:1.5.0'

compile 'com.squareup.okhttp:okhttp:2.4.0'

compile 'com.mcxiaoke.volley:library:1.0.16'

compile 'com.google.code.gson:gson:2.3.1'

其中的版本号可能随着它们的更新而发生改变。

除了Volley外，以上几个依赖都是官方的，虽然Volley不是官方提供的，但是也值得信赖。据我所知，Volley是没有官方的gradle依赖的，只有源码包。

Volley

Volley的工作方式是创建不同的request，然后把它们添加到队列中（queue）。一个项目只需要一个queue就足够了，每次你想创建一个request的时候你都只需要获得这个唯一的queue来添加。

我现在使用的是如下方法获得的全局的queue单例：

这里创建一个新请求队列的方法中我们使用了一个HttpStack参数。如果你不提供HttpStack参数Volley会根据API等级创建一个stack。( API level 9上是AndroidHttpClient ， API level 10 及以上是HttpURLConnection )。

就如刚刚我提到的，我想使用OkHttp作为我们的传输层，所以我们使用OkHttpStack作为我们的参数之一。OkHttpClient的实现我们使用的是这个。

接下来是添加请求（request）到Volley请求队列的一些方法：

下面这个方法则是取消请求的方法，通常用在生命周期的onStop方法中。

到此我们已经准备好了Volley和OkHttp。因此可以开始制做String，JsonObject或者JsonArray请求了。

一个JsonObject请求差不多是这样子的：

我们还需要解析JSON对象成Java模型（model）。从Volley请求直接获得的响应（不管是String, JsonObject 还是 JsonArray）其实并没有什么卵用。



在安卓的网络世界里，你并不孤独。

Gson

我们可以通过自定义request来获得符合我们数据模型的java对象的响应。我们只需要一个继承自Request的GsonRequest类， 比如这个例子里面的这个。

译者注：实际上下面代码中要用到的GsonRequest和上面那个例子中的GsonRequest并不完全一致。

下面是一个GET调用如何获得与解析Json object的例子：

下面是一个GET调用如何取得与解析Json数组的例子:

Gson会在后台线程解析一个GsonRequest，而不是主线程中。

上面的例子中，我提供了一个deserializer（反序列化，即解析工具，这里就是指的DummyObjectDeserializer），但是这并不强制必须要提供erializers活着deserializers，只要类的域名和JSON文件相匹配，Gson可以自动处理好一切。我比较喜欢自己提供自定义的serializer/deserializer 。

上面的两个例子都是用的GET调用。为了以防调用是POST的，我在项目中包含了一个GsonPostRequest 以及用法示例 。

OkHttp works as the transport layer for Volley, which on top of OkHttp is a handy way of making network requests that are parsed to Java objects by Gson just before delivering the response to the main

加载图片

ImageLoader 与 NetworkImageView

Volley中有一个叫做NetworkImageView（ImageView的子类）的自定义View，用它加载图片非常方便。你可以设置一个URL，一张默认的空白占位图，以及提示加载错误的图片。

代码中比较重要的部分是setImageUrl 方法，它接收两个参数：图片的地址以及一个ImageLoader（从远程地址加载和缓存图片的Volley帮助类），让我们看看我们定义的getVolleyImageLoader方法是如何获得一个ImageLoader的：

这里唯一没有讲到的就是这个LruBitmapCache。Volley并没有实现提供这个类的实现，但是我们可以从这里找到，它可以针对不同的屏幕设置不同的缓存大小，这点很酷。

译者注：为了方便对英语不熟悉的同学，我把提到的这篇文章中的代码拷贝在下面，不过仍然建议读一读原文：

ImageRequest

某些情况下，我们可能不像使用NetworkImageView。比如我们想要一个圆形的图片，同时我们使用的是CircleImageView。这种情况下，我们必须使用ImageRequest，使用方法如下：

Curiosities

本文所讨论的所有组建（Okio, OkHttp, Volley 和 Gson）都是可以单独使用的，它们并非一定要在一起使用。

在引言部分我提到的第一篇文章（这篇）的作者是Jesse
Wilson。Jesse Wilson是 HTTP, Gson, OkHttp 和 Okio项目的参与者之一。我觉得应该提一下它。

OkHttp引擎在Android 4.4上是基于HttpURLConnection的。 Twitter, Facebook 和 Snapch都采用了它。

这个解决方案在2015年还重要吗？

Volley/Gson的解决方案比较成熟，因为这是谷歌的解决方案，同时也因为出现在安卓开发者网站上，因此在2013到2014年都非常流行。到目前为止，这仍然是一个很好的选择，它是简单有效的。不过需要考虑一下的是Volley和Gson现在不怎么更新了。

我们可以从速度，简便性，以及可自定义程度等因素上去分析比较不同解决方案，以帮助我们决定使用哪一种。

你可能想尝试下一些其他的选择：

Android 网络操作II: OkHttp, Retrofit, Moshi 以及Picasso. (即将发表)

Android 网络操作III: ION (即将发表)

Github样例项目

源码

一些资源

Okio in Github

OkHttp webpage

Volley introduction at Google IO 2013

Android Developers Volley training

OkHttp as the transport layer for Volley

A Few Ok Libraries (Jake Wharton at Droidcon Montreal)

HttpStack implementation which uses OkHttp’s native request/response API instead of relying on the HttpURLConnection
wrapper