Android上的网络响应日志技巧

在开发Android应用程序的过程中，你或许需要从远处服务器中加载数据。而在开发过程中，你可能要经常查看应用从网络中获取到的数据的内容。

如果你最近几年在开发Android应用，或许你使用过（或者听说过）Retrofit来处理网络请求。如果没有，我建议你了解一下，因为他实在太棒了。

所以，使用Retrofit时，在监听网络请求方面，你有哪些选择呢？

Retrofit / OkHttp的logging

Retrofit 和 OkHttp 有一些内置的记录HTTP响应的方法。使用这些功能的方法取决于你使用的Retrofit的具体版本。

Retrofit 1.x

如果你使用的是比较老的Retrofit 1.x版本。在创建RestAdapter时，你可以通过在RestAdapter.Buidler中设置LogLevel的属性直接开启响应日志这一功能。

LogLevel logLevel = LogLevel.FULL;
new RestAdapter.Builder()
        .setClient(client)
        .setEndpoint(endpoint)
        .setConverter(converter)
        .setErrorHandler(errorHandler)
        .setLogLevel(logLevel)
        .build();

LegLevel是一个表示日志细节的枚举类型，值有NONE, BASIC, HEADERS, HEADERS_AND_ARGS 和 FULL。你可以根据需要打印的每一个网络请求的内容设置对应的值。

Retrofit 2.x

Retrofit 2.0的稳定版在16年三月上旬已经发布，变化很大。如果你还没有升级它,我建议你​​升级吧：

Retrofit 2.0与RxJava混合使用的快速入门 您可能已经注意到Retrofit 2.0最终版本已经出来了，所以，还等什么，现在去升级吧！

你升级以后，会发现Retrofit发生了很多变化。比如，你无法直接通过类Retrofit.Builder设置Log Level.

Retrofit 2.x直接依赖于Square的另一个库（OkHttp3）进行HTTP的实际网络调用。与此不同的是，Retrofit 以前的版本(1.x)并没有直接依赖于OkHttp，因而你可以使用不同的HTTP客户端，只要它们实施了Retrofit的客户端接口。

因此，日志功能已经从Retrofit更改到OkHttp中去了。

现在，您可以调用OkHttp的拦截器 [HttpLoggingInterceptor]（https://github.com/square/okhttp/tree/master/okhttp-logging-interceptor）实现和Retrofit 1.x一样的日志功能。

如果要使用它，您必须先在Gradle中声明，因为它以独立的形式进行分发：

compile 'com.squareup.okhttp3:logging-interceptor:<latest>'

然后将日志记录拦截器添加到OkHttp中：

Level logLevel = Level.BODY;
HttpLoggingInterceptor interceptor = new HttpLoggingInterceptor();
interceptor.setLevel(logLevel);
new OkHttpClient.Builder()
        .addInterceptor(interceptor)
        .build();

'日志的输出效果是什么样子？`

网络响应的body以纯文本的形式出现在Logcat中。日志通常被分隔成了若干行，往往难以阅读： Retrofit 1.x / HttpLoggingInterceptor logcat output

通常,你需要拷贝整行的响应，然后再取出开头的时间戳，包名称以及标记。如果你遇到的JSON响应，您可以使用像[JsonFormatter]（https://jsonformatter.curiousconcept.com/）或[在线JSON查看器（http://jsonviewer.stack.hu/），提高复制的文本可读性。

对于我来说，每次检查网络请求的过程都十分繁琐、耗时。这就是我决定创建自己的拦截器的原因——这可以简化流程。

OkLog - 检查响应的快捷之道

[OkLog]（https://github.com/simonpercic/OkLog）是针对OkHttp 网络响应的日志记录拦截器，可以在开发过程中简化了网络响应的调试。

OKLog有两个独立的库，取决于OkHttp的版本：OkLog对应于OkHttp，OkLog3对应于OkHttp3。

OkLog写了一个可访问的URL，可将网络响应作为URL路径的一部分进行日志记录。

这样一来，您就可以点击Android Studio中的日志显示一个链接，你在浏览器中查看这个响应对应文本：

OkLog 使用示例

另一个好处是能够与其他开发者（通常是REST API的开发人员）分享这些URL。

它是如何运作的？

OkLog通过实现自己的[“应用程序”interceptor]（https://github.com/square/okhttp/wiki/Interceptors）截获OkHttp的纯网络响应。

在得到响应的纯文本之后，将它转换对url友好的字符串，生成包含响应的URL。

然后，该URL作为日志打印出来。OkLog可以选择依赖于Timber，只有你的项目依赖于它时，它才发挥作用。否则，它将调用Android内置的Log方法进行日志记录（当然，你也可以强制它使用内置Log方法）。如果你愿意的话，甚至可以定制LogInterceptor自定义日志记录。

那么，究竟响应需要如何转化呢？

纯文本响应首先要经过[gzip压缩]（https://en.wikipedia.org/wiki/Gzip），以使该字符串尽可能短。然后，将所得的字符串进行[Base64]（https://en.wikipedia.org/wiki/Base64）编码，从而可以 以使其网址友好。

点击URL时会发生什么？

默认情况下，生成的URL指向一个Spring Web应用程序的托管实例，称为[ResponseEcho]（https://github.com/simonpercic/ResponseEcho）。该应用程序的工作，刚好和OKLog相反，对URL路径字符串参数进行Base64解码和对参数进行gzip解压，并将其作为一个普通的响应返回。

如果普通的响应恰好是一个JSON，Web应用程序应该返回格式规整的JSON，这样更容易阅读。

如果你愿意，你也可以自己搭建web应用程序，并设置OkLog匹配主机名网站的前缀。

如何使用它？

关于使用的具体流程请查看Github上的Readme，基本步骤如下：

• 首先添加当前的OKLog的版本.

  // pre-OkHttp3
  compile 'com.github.simonpercic:oklog:<latest>'
  // OkHttp3
  compile 'com.github.simonpercic:oklog3:<latest>'

• 使用 OkLogInterceptor的builder()方法构造一个实例

  OkLogInterceptor interceptor = OkLogInterceptor.builder()
        // set desired custom options
        .build();

• 在OKHttp的 interceptors中添加一个 okLogInterceptor实例

  // for pre-OkHttp3
  List<Interceptor> clientInterceptors = okHttpClient.interceptors();
  Collections.addAll(clientInterceptors, okLogInterceptor);
  // for OkHttp3
  new OkHttpClient.Builder().addInterceptor(okLogInterceptor).build();

• 通常，你可以通过 okHttpClient 实例来构造 Retrofit/2 实例。

已知的限制

OKLog是通过Android的Logging系统实现日志功能的，但Logging有约4000字符的长度限制。

即使生成的url通过gzip压缩和Base64编码，最后在一些网络响应中，他们仍可能 超出日志的行限制。

不幸的是，目前还没有针对性的解决方案。不过，大多数情况下，一切都是正常的。

在升级的实际记录过程中，OkLog可以选择[Timber]（https://github.com/JakeWharton/timber），Timber可以对一些过长的日志进行切片分割，所以你还可以看到那些超过长度限制的响应。如果，它被分割成若干行，你可以把它们链接起来从而得到完整的url。

这样会将太长线，所以你可以看到，如果一个反应是超过长度限制。如果它被分成多行，可以手动串接所有行，以获得有效的URL。

另一种实现方式 - Facebook的Stetho

和上述方案不同的是，Facebook’s Stetho 使用的是另一种方案来记录网络请求。

不同于直接在logcat中直接打印请求，Stetho 的运行依赖于OkHttp/3的网络连接器 interceptor。

在这种方式下，Stetho通过Chrome Developer Tools调试网络请求。

Chrome Developer Tools是一个十分棒的工具，他可以让你看见和网络活动相关的诸多信息。

但是，如果你只是希望可以快速的查看网络请求，他可能不适合你。除此以外,你无法快捷地和别人共享这些信息，除非你复制这些信息，

你应该选择哪一个呢？

我觉得并没有一个放之四海而皆准的标准，相反，我相信，不同的场景有着不同的解决方案，上述的每一种方案都有对应的最佳应用场景。

在我的项目中，我使用OKHttp的 HttpLoggingInterceptor，它可以在logcat中直接输出和请求相关的基本信息。同时，我也使用OKLog，他可以让我在浏览器中快速查看对应的网络请求，也可以和我的同事共享这些信息。

注意,你只能在你的debug版本中，不要在release版本中，打印网络响应。在release版本中，你不应该输出任何日志。

这篇文章有趣不？记得在Medium, Twitter 或 GitHub关注我哦。