转载

高效地配置OkHttp

当我为可汗学院开发 Android app 的时候， OkHttp 是一个十分有用的第三方库。虽然它的默认设置已经提供了很大的便利，但我们还是采取了以下的步骤使OkHttp更加高效与智能:

1. 开启响应数据缓存到文件系统功能

允许缓存响应数据时需要往请求头里加入 Cache-Control ，默认情况下OkHttp不会缓存响应数据。所以，客户端就会浪费时间和流量去多次请求同样的数据。相反的，如果缓存了响应数据，只需要在第一次请求的时候从网络获取，以后就可以直接从缓存文件中获取数据。

为了开启缓存响应数据功能，你需要创建一个 com.squareup.okhttp.Cache 对象并将其作为参数传给 OkHttpClient 的 setCache 方法。在创建 Cache 对象的时候，你必须为其指定一个 File 参数和以byte为单位的最大容量参数，这个File代表了缓存的路径。缓存的数据会被存储在这个路径中。当缓存的大小超过指定的最大容量时，OkHttp会根据 LRU算法对缓存数据进行清理操作。

根据 Jesse Wilson 的推荐，我们把缓存的数据存放在 context.getCacheDir() 的子目录中:

// Base directory recommended by http://stackoverflow.com/a/32752861/400717. // Guard against null, which is possible according to // https://groups.google.com/d/msg/android-developers/-694j87eXVU/YYs4b6kextwJ and // http://stackoverflow.com/q/4441849/400717. final @Nullable File baseDir = context.getCacheDir(); if (baseDir != null) {   final File cacheDir = new File(baseDir, "HttpResponseCache");   okHttpClient.setCache(new Cache(cacheDir, HTTP_RESPONSE_DISK_CACHE_MAX_SIZE)); }

// Base directory recommended by http://stackoverflow.com/a/32752861/400717. // Guard against null, which is possible according to // https://groups.google.com/d/msg/android-developers/-694j87eXVU/YYs4b6kextwJ and // http://stackoverflow.com/q/4441849/400717. final @NullableFilebaseDir = context.getCacheDir(); if (baseDir != null) {   final FilecacheDir = new File(baseDir, "HttpResponseCache");   okHttpClient.setCache(new Cache(cacheDir, HTTP_RESPONSE_DISK_CACHE_MAX_SIZE)); }

在可汗学院App中，我们指定 HTTP_RESPONSE_DISK_CACHE_MAX_SIZE 的值为 10 * 1024 * 1024 ，即10MB。

2. 集成Stetho

Stetho 是由Facebook开发的一个实用的库，它可以让你使用Chrome提供的 Chrome Developer Tools 来审查你的Android应用的代码。

除了可以让你审查应用中的SQLite数据库和View的继承层次外，Stetho也可以审查OkHttp发起的每一个请求和收到的每一个响应:

高效地配置OkHttp

这个拦截器可以确保服务端返回的HTTP头允许缓存相关数据，而且也可以保证如果有缓存数据的话不会进行网络请求。

使用Stetho也很简单，往网络拦截器列表中添加一个 StethoInterceptor 对象就可以了:

okHttpClient.networkInterceptors().add(new StethoInterceptor());

okHttpClient.networkInterceptors().add(new StethoInterceptor());

然后运行你的应用并且打开Chrome，导航到 chrome://inspect 。

这时应该就会有一个设备和应用id的列表。点击’inspect’链接来打开Developer Tools，然后打开NetWork标签就可以观察OkHttp的请求了。

3. 在你的应用中使用Picasso and Retrofit

如果你也像我们一样使用 Picasso 加载网络图片，或者使用 Retrofit 简化网络请求和数据解析。在你没有明确指定一个 OkHttpClient 的情况下，这些库会自己创建一个默认的供内部使用。比如2.5.2的Picasso中 OkHttpDownloader 类是如下这样:

private static OkHttpClient defaultOkHttpClient() {   OkHttpClient client = new OkHttpClient();   client.setConnectTimeout(Utils.DEFAULT_CONNECT_TIMEOUT_MILLIS, TimeUnit.MILLISECONDS);   client.setReadTimeout(Utils.DEFAULT_READ_TIMEOUT_MILLIS, TimeUnit.MILLISECONDS);   client.setWriteTimeout(Utils.DEFAULT_WRITE_TIMEOUT_MILLIS, TimeUnit.MILLISECONDS);   return client; }

private static OkHttpClientdefaultOkHttpClient() {   OkHttpClientclient = new OkHttpClient();   client.setConnectTimeout(Utils.DEFAULT_CONNECT_TIMEOUT_MILLIS, TimeUnit.MILLISECONDS);   client.setReadTimeout(Utils.DEFAULT_READ_TIMEOUT_MILLIS, TimeUnit.MILLISECONDS);   client.setWriteTimeout(Utils.DEFAULT_WRITE_TIMEOUT_MILLIS, TimeUnit.MILLISECONDS);   return client; }

Retrofit有一个类似的工厂方法来创建自己的 OkHttpClient 。

图片是一个应用中比较大的资源。Picasso使用LRU算法对图片进行了缓存，严格来说是内存缓存。如果客户端试图使用Picasso加载一张图片，但是Picasso没有在内存缓存中找到这张图片。那么它就会委托内部的 OkHttpClient 来加载这张图片。默认情况下它总是会从网络加载图片，因为上文提到的 defaultOkHttpClient 并没有配置缓存响应数据到文件系统。

指定你自己的 OkHttpClient 可以让你从文件系统中获得缓存的响应数据，而不用每次都从服务端去获取数据。在App完成第一次启动后，这个特性特别重要。这个时候Picasso还没有内存缓存，所以它会频繁的让 OkHttpClient 去加载图片。

为了实现上面说的，你只需要用 OkHttpDownloader 对 OkHttpClient 进行包裹，并把它作为参数传给 Picasso.Builder 的 downloader 方法：

final Picasso picasso = new Picasso.Builder(context)     .downloader(new OkHttpDownloader(okHttpClient))     .build();  // The client should inject this instance whenever it is needed, but replace the singleton // instance just in case. Picasso.setSingletonInstance(picasso);

final Picassopicasso = new Picasso.Builder(context)     .downloader(new OkHttpDownloader(okHttpClient))     .build();   // The client should inject this instance whenever it is needed, but replace the singleton // instance just in case. Picasso.setSingletonInstance(picasso);

为了在Retrofit 1.9.x中结合 RestAdapter 使用 OkHttpClient ，把 OkHttpClient 包裹在 OkClient 中，再把它作为 RestAdapter.Builder 的 setClient 方法的参数传进去尽可以了：

restAdapterBuilder.setClient(new OkClient(httpClient));

restAdapterBuilder.setClient(new OkClient(httpClient));

在Retrofit 2.0中就更简单了，直接把 OkHttpClient 作为 Retrofit.Builder 的 client 方法的参数传递进去就行了。

在可汗学院App中，我们借助 Dagger 来确保只有一个 OkHttpClient 的实例。这个实例被Picasso和Retrofit共同使用。我们使用 @Singleton 注解为 OkHttpClient 实例创建了一个提供者：

@Provides @Singleton public OkHttpClient okHttpClient(final Context context, ...) {   final OkHttpClient okHttpClient = new OkHttpClient();   configureClient(okHttpClient, ...);   return okHttpClient; }

@Provides @Singleton public OkHttpClientokHttpClient(final Contextcontext, ...) {   final OkHttpClientokHttpClient = new OkHttpClient();   configureClient(okHttpClient, ...);   return okHttpClient; }

然后使用Dagger将 OkHttpClient 注入到其他的提供者当中。这些提供者又创建了 RestAdapter 和 Picasso 实例。

4. 指定用户代理拦截器

当用户在每个请求里指定一个详细的 User-Agent 请求头的值的时候，日志文件和日志分析就变得更加有用了。默认情况下，OkHttp包含了一个 User-Agent 的请求头，但这个头仅仅标识出了OkHttp的版本信息。你可以创建一个自定义个拦截器来取代这个默认值，以下是 StackOverflow 上的一段可供参考的代码:

public final class UserAgentInterceptor implements Interceptor {   private static final String USER_AGENT_HEADER_NAME = "User-Agent";   private final String userAgentHeaderValue;    public UserAgentInterceptor(String userAgentHeaderValue) {     this.userAgentHeaderValue = Preconditions.checkNotNull(userAgentHeaderValue);   }    @Override   public Response intercept(Chain chain) throws IOException {     final Request originalRequest = chain.request();     final Request requestWithUserAgent = originalRequest.newBuilder()         .removeHeader(USER_AGENT_HEADER_NAME)         .addHeader(USER_AGENT_HEADER_NAME, userAgentHeaderValue)         .build();     return chain.proceed(requestWithUserAgent);   } }

public final class UserAgentInterceptor implements Interceptor {   private static final String USER_AGENT_HEADER_NAME = "User-Agent";   private final String userAgentHeaderValue;     public UserAgentInterceptor(String userAgentHeaderValue) {     this.userAgentHeaderValue = Preconditions.checkNotNull(userAgentHeaderValue);   }     @Override   public Responseintercept(Chainchain) throws IOException {     final RequestoriginalRequest = chain.request();     final RequestrequestWithUserAgent = originalRequest.newBuilder()         .removeHeader(USER_AGENT_HEADER_NAME)         .addHeader(USER_AGENT_HEADER_NAME, userAgentHeaderValue)         .build();     return chain.proceed(requestWithUserAgent);   } }

你可以使用任何你觉得有用的信息作为参数传递到 UserAgentInterceptor 的构造方法中来构造 User-Agent 头的值。我们使用了一下的信息：

Android 系统的 os 值，用它来明确额标识出这是来自Android设备的请求
Build.MODEL , 或“终端用户可见的产品名称”
Build.BRAND , 或“消费者可见的产品或者硬件品牌名”
Build.VERSION.SDK_INT , 或“用户可见的AndroidSDK版本号”
BuildConfig.APPLICATION_ID
BuildConfig.VERSION_NAME
BuildConfig.VERSION_CODE

最后三个参数我们通过Gradle构建脚本里的 applicationId , versionCode 和 versionName 来指定。你可以查看这里和这里的文档来获取更多的信息。

需要注意的是，如果你的App中用到了 WebView ,你可以配置你的WebView使用与 UserAgentInterceptor 的构造参数相同的 User-Agent 的值：

WebSettings settings = webView.getSettings(); settings.setUserAgentString(userAgentHeaderValue);

WebSettingssettings = webView.getSettings(); settings.setUserAgentString(userAgentHeaderValue);

5. 配置合理的超时时间

在2.5.0之前，OkHttp的请求默认不会超时。从2.5.0开始，如果一个请求建立连接后从这个连接中读取数据或者向这个连接写入数据超过10秒钟就认为超时。更新到2.5.0之后，我们的代码中出现了一些bug，因为一开始想要确定出错的具体位置。要覆盖这些默认行为，只需要对应的去调用 setConnectTimeout 、 setReadTimeout 或者 setWriteTimeout 方法即可。

需要注意的是Picasso和Retrofit的默认 OkHttpClient 的超时时间是不同的。Picasso的默认值分别是：