Android上的网络响应日志技巧

发表于 5年以前 | 总阅读数：1973 次

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();