IndeterminateProgressbar解析 – Part 1

* 原文作者 : [Mark Allison](https://blog.stylingandroid.com/)

* 译文出自 : [开发技术前线 www.devtf.cn](http://www.devtf.cn)

* 转载声明: 本译文已授权[开发者头条](http://toutiao.io/download)享有独家转载权，未经允许，不得转载!

* 译者 : [chaossss](https://github.com/chaossss)

* 校对者: [desmond1121](https://github.com/desmond1121)

* 状态 : 完成

IndeterminateProgressBar 能在用户进行某项不定时长的耗时操作时提供绝佳的用户体验，之前我有教过大家怎么创建[水平的 IndeterminateProgressBar](http://blog.csdn.net/u012403246/article/details/49582789)，今天我就来教大家实现圆形的 IndeterminateProgressBar，这个控件将支持 API 11（Honeycomb）以上的设备。

这系列博文将有别于传统的自定义控件方法，而是从 Lollipop+ 提供的 API 实现去理解其运作机制，最后我会将从中学习到的知识应用到开发中，创造一个在低版本设备中效果类似的控件。

在开始研究之前可以看看我们期望实现的效果：

[Youtube视频](https://youtu.be/g6Zo6WDS2Gg)

所以我们要做的就是：进度条在旋转，然后由长变短最后消失，再出现，由短变长。不妨看看[ Google 的实现](https://android.googlesource.com/platform/frameworks/base/+/refs/heads/master/core/res/res/drawable/progress_medium_material.xml)：

<?xml version="1.0" encoding="utf-8"?>

<animated-vector xmlns:android="http://schemas.android.com/apk/res/android"

android:drawable="@drawable/vector_drawable_progress_bar_medium" >

<target

android:name="progressBar"

android:animation="@anim/progress_indeterminate_material" />

<target

android:name="root"

android:animation="@anim/progress_indeterminate_rotation_material" />

</animated-vector>

在这里他们使用了 AnimatedVectorDrawable - Lollipop+ 才有的特性，在低版本设备中将使用 Holo 风格的 drawable 资源。因此这个效果应用了两个动画 - 一个完成进度条长度变化，另一个完成旋转，[具体实现](https://android.googlesource.com/platform/frameworks/base/+/refs/heads/master/core/res/res/drawable/vector_drawable_progress_bar_medium.xml)可以参考：

<vector xmlns:android="http://schemas.android.com/apk/res/android"

android:height="48dp"

android:width="48dp"

android:viewportHeight="48"

android:viewportWidth="48"

android:tint="?attr/colorControlActivated">

<group

android:name="root"

android:translateX="24.0"

android:translateY="24.0" >

<path

android:name="progressBar"

android:fillColor="#00000000"

android:pathData="M0, 0 m 0, -19 a 19,19 0 1,1 0,38 a 19,19 0 1,1 0,-38"

android:strokeColor="@color/white"

android:strokeLineCap="square"

android:strokeLineJoin="miter"

android:strokeWidth="4"

android:trimPathEnd="0"

android:trimPathOffset="0"

android:trimPathStart="0" />

</group>

</vector>

我不想在这里解释 pathData，但它确实绘制了一个圆。但控件不会被渲染成一个圆，因为 trimPath 相关的值都为 0（其实是因为 trimPathEnd="0"，使得 Path 起点处的绘制被停止）。

值得一提的是 path 的命名及其成员元素都与 Animator 关联并应用于 AnimatedVectorDrawable。旋转 Animator 也被应用到其中（在这里都是很常见的方法，所以我不打算过多地解释，有兴趣的话可以[看这里](https://android.googlesource.com/platform/frameworks/base/+/refs/heads/master/core/res/res/anim/progress_indeterminate_rotation_material.xml)）。但用于进度条长度变化的 Aniamtor 值得学习：

<?xml version="1.0" encoding="utf-8"?>

<set xmlns:android="http://schemas.android.com/apk/res/android" >

<objectAnimator

android:duration="1333"

android:interpolator="@interpolator/trim_start_interpolator"

android:propertyName="trimPathStart"

android:repeatCount="-1"

android:valueFrom="0"

android:valueTo="0.75"

android:valueType="floatType" />

<objectAnimator

android:duration="1333"

android:interpolator="@interpolator/trim_end_interpolator"

android:propertyName="trimPathEnd"

android:repeatCount="-1"

android:valueFrom="0"

android:valueTo="0.75"

android:valueType="floatType" />

<objectAnimator

android:duration="1333"

android:interpolator="@android:anim/linear_interpolator"

android:propertyName="trimPathOffset"

android:repeatCount="-1"

android:valueFrom="0"

android:valueTo="0.25"

android:valueType="floatType" />

</set>

在这里用了三个 Animator，三者并行运行动画效果，且每一个修改 path 元素中 trimPath 前缀的值，最终就实现了我们想要的效果。

其中第一和第二个 ObjectAnimator 控制圆的起点和终点，绘制出两点间的圆弧。所以当我们以不同的速率改变这两个 Animator 的值时，就会得到我们所说的变长变短的效果。除了应用的插值器，它们对应的参数都是相同的不同。

第三个 Animator 用于显示间距，以显示长度变化时，长度渐变消失的效果。

关注我的读者都知道我很喜欢用插值器，因为它们实在是太好用了！在下一篇博文中我会解释其中的细节。

因为这篇博文都是基于[ Google 源码](https://android.googlesource.com/platform/frameworks/base/+/refs/heads/master/core/res/res/anim/progress_indeterminate_rotation_material.xml)进行的，所以我就不提供源码了，但后面的文章我保证都会有源码！

剖析OkHttp缓存机制

* 原文作者 : [Damian Petla](http://www.schibsted.pl/author/petla/)

* 译文出自 : [开发技术前线 www.devtf.cn](http://www.devtf.cn)

* 转载声明: 本译文已授权[开发者头条](http://toutiao.io/download)享有独家转载权，未经允许，不得转载!

* 译者 : [chaossss](https://github.com/chaossss)

* 校对者: [desmond1121](https://github.com/desmond1121)

* 状态 : 完成

现在应用市场上的 App 无一不需要网络操作，这些应用的开发者大多数都选择结合使用 [OkHttp](http://square.github.io/okhttp/) 和 [Retrofit](http://square.github.io/retrofit/) 来完成网络操作。okHttp 最为人称道的一个特性就是它的缓存机制，而我将在本篇博文对其进行剖析。

每次我用 OkHttp 时我都需要一些时间想想我将怎么使用它，我该用哪一个 HTTP 报头，作为一个客户端 App 我有哪些职责，我期望从服务器上获得什么，等等……所以对我来说，这篇博文将是 OkHttp 缓存特性的引用文档，我写这篇文档不是因为我在之后的开发中可能会接触 OkHttp 的缓存机制，而是因为我很有可能在下次需要使用它的时候却把这些知识忘了。

这篇博文用于帮助熟悉 OkHttp 的高级工程师，我希望这篇博文的读者最起码应该知道怎么使用 OkHttp 以及怎么开启缓存。如果你不知道的话，就去 OkHttp 的维基页面学习吧。当然了，这里面的解释可能有一部分是错的，我只是尝试去解释一些我所理解的内容，所以如果你发现我某些部分的解释是有问题的，请通过邮件或其他方式告诉我。

##分析的起点

我将会从以下类开始我的分析工作：CacheStrategy 和 HttpEngine，其中 CacheStrategy 包含缓存机制的所有逻辑，HttpEngine 是 CacheStrategy 被调用的地方。

- **CacheStrategy.Factory** 理解缓存候选响应的报头并将其转换为类成员的构造器

- **CacheStrategy.getCandidate()** - 检查缓存候选响应，如果需要的话讲修改原始请求的报头

这两部分内容是 OkHttp 整个缓存机制最关键的部分，而且几乎包含了所有我们想要了解的信息。虽说其他方法也很重要，但如果你去分析的话会发现最终还是会回到这里。

##什么是缓存候选响应？

第一次进行 HTTP 请求时不会存在任何已缓存内容，相关 API 只在有缓存内容的时候才会被调用，这点相信不需要我再多解释了。

一旦响应被存储我们就能尝试将它用到后续的调用中，当然了，我们不可能将所有响应码对应的响应都存储下来。我们只存储以下响应码对应的响应：200, 203, 204, 300, 301, 404, 405, 410, 414, 501, 308。除此以外还有 302, 307，但存储它们对应的响应时必须满足以下条件之一：

- contains **Expires** header OR

- **CacheControl** contains **max-age** OR

- **CacheControl** contains **public** OR

- **CacheControl** contains **private**

- 包含 **Expires** 报头

- **CacheControl** 包含 **max-age**

- **CacheControl** 包含 **public**

- **CacheControl** 包含 **private**

需要注意：OkHttp 的缓存机制不支持缓存部分报文内容。

当我们重复某个请求，OkHttp 会判断是否已经有已缓存的响应，后文中我将称其为缓存候选响应。

##CacheStrategy 是什么？

CacheStrategy 需要一个新的报文和一个缓存候选响应，评估这两个 HTTP 报头是否有效并比较它们。

首先，存放在缓存候选响应报头中的部分成员是：

- Date

- Expires

- Last-Modified

- ETag

- Age

下面是需要检查的条件的汇总列表：

1. 判断缓存候选响应是否存在。

2. 如果接收的是 HTTPS 请求，如果需要的话，判断缓存候选响应是否已进行握手。

3. 判断缓存候选响应是否已缓存；这和 OkHttp 存储响应时完成的工作是相同的。

4. 如果没有缓存，在请求报头的 Cache-Control 中检查对应内容，如果该标记为 true，缓存候选响应将不会被使用，后面的检查也会跳过。

5. 在请求报头中查找 If-Modified-Since 或 If-None-Match，如果找到其中之一，缓存候选响应将不会被使用，后面的检查也会跳过。

6. 进行一些计算以得到诸如缓存响应缓存响应存活时间，缓存存活时间，缓存最大失活时间。我不希望在此解释所有对应实现的细节，因为这会让博文变得冗长，你只需要知道以上提到的报文内容（例如：Date, Expires 等等…）还有请求 Cache-Control 中的 max-age, min-fresh, max-stale 这部分相关的计算耗时是毫秒级的。完成检查最简单的办法是写这样的伪代码：if ("cache candidate's no-cache" && "cache candidate's age" + "request's min-fresh" < "cache candidate's fresh lifetime" + "request's max-stale")

如果上述条件被满足，那么已缓存的响应报文将会被使用，后面的检查将跳过。

7. 在需要进行网络操作时，下一次检查会判断它是否为“条件请求”。条件请求指的是：发送报文请求服务器响应，而服务器可能会也可能不会返回新的内容，或让我们使用已缓存的报文。

#WE LOOK FOR ANDROID DEVELOPERS!

##条件请求

下一节看起来是新的内容，但在代码结构中和上一节所解释内容是在相同的方法里的。

1. 如果缓存候选响应包含 ETag 报头，那么新的 If-None-Match 请求报文会使用相同的 ETag 值。

2. 如果上一点没有被满足，且缓存候选响应包含 Last-Modified，那么新的 If-Modified-Since 请求报文会使用该值。

3. 如果以上两点都没有被满足，且缓存候选响应包含 Date，那么新的 If-Modified-Since 请求报文会使用该值。

##还有更多！

上述描述过程的最后，也就是 **CacheStrategy.getCandidate()** 方法返回后，还会有一个检查。OkHttp 会在此时判断报头的 **Cache-Strategy** 是否包含 “**only-if-cached**“ 参数。如果有的话，不会请求新的数据。OkHttp 会强制使用缓存候选响应（如果有且可用），不然的话会抛出 HTTP **504 Unsatisfiable Request** 错误。

##怎么运作？

你可能自己已经知道，进行 HTTP 操作时就是设置正确的报头。但不添加额外的报头内容，使用默认的 HTTP 调用也能完成网络操作，我会在后面提及这部分内容。

##无网络环境

刚开始我遇到的问题就包含这个，那时我天真地以为只要允许进行缓存就会解决这个问题，然而并不行，我知道的两种解决方法是：

- 使用 **Cache-Control : only-if-cached header**，报文将永远也不会到达服务器。只有存在可用缓存响应时才会检查并返回它。不然的话，会抛出 504 错误，所以开发的时候别忘了处理这个异常。

- 使用 **Cache-Control : max-stale=[seconds]** 报头，这种办法更灵活一些，它向客户端表明可以接收缓存响应，只要该缓存响应没有超出其生命周期。而该缓存响应是否可用由 OkHttp 检查，所以不需要与服务器建立连接来判断。但即使如此，当缓存响应超出其生命周期，网络操作还是会进行，然后得到服务器返回的新内容。

##关心用户的开销和运行效率

上面提到的解决方法依赖 OkHttp 的验证机制能在离线时完成一些操作。通常 App 都是在线状态，而我们更希望得到新的数据，这样会一次又一次地从服务器上获取相同的内容，给用户产生冗余的开销并降低 App 的运行效率。

理想状态下，我们发送一个请求，得到真正的新数据。当服务器的数据没有发生改变，将得到 304 响应码，而 OkHttp 返回缓存响应。如果服务器支持缓存的话，这种情况是可以实现的。所以你需要做的大体就是和你的同事研究 **ETag** 或 **Last-Modified-Since** 是否被支持，如果支持的话，OkHttp 会帮你解决剩下的麻烦！

**NOTE**: 请不要自己设置 **If-Modified-Since** 或 **If-None-Match**。前文已经提到，设置这两个报头会跳过后续的许多检查，进行网络操作。

##强制网络操作

你也可以强制进行网络操作，但就我个人而言，我还没有这样用过 OkHttp，不过我发现了一些可能的应用场景。例如你在报头中使用了 max-stale，过了很久服务器接收到了该报文。当你想允许用户在某些特殊情况下强行进行刷新时，很简单，在请求中使用 Cache-Control : no-cache，你就能从服务器得到新的数据了。

##结论

在我看来，OkHttp 非常易用，极大简化了网络操作。而且有助于理解数据流，哪些报头能被设置以及它们的用处。我希望这篇博文能给你提供一些帮助。

祝你好运！