Cronet 请求生命周期

了解使用 Cronet 创建的请求的生命周期，以及如何使用该库提供的回调方法管理这些请求。

生命周期概览

使用 Cronet 库创建的网络请求由 UrlRequest 类表示。以下概念对于理解 UrlRequest 生命周期至关重要：

状态
状态是指请求在特定时间所处的特定条件。使用 Cronet 库创建的 UrlRequest 对象在其生命周期中会经历不同的状态。请求生命周期包括初始状态以及多个过渡状态和最终状态。
UrlRequest 方法
客户端可以根据 UrlRequest 对象的状态调用特定方法。这些方法会将请求从一种状态移至另一种状态。
Callback 方法
通过实现 UrlRequest.Callback 类的方法，您的应用可以接收有关请求进度的最新动态。您可以实现回调方法，以调用 UrlRequest 对象的方法，将生命周期从一种状态转换为另一种状态。

以下列表介绍了 UrlRequest 生命周期的流程：

  1. 应用调用 start() 方法后，生命周期处于已开始状态。
  2. 服务器可能会发送重定向响应，该响应会将流程转到 onRedirectReceived() 方法。在此方法中，您可以执行以下任一客户端操作：
    • 使用 followRedirect() 跟踪重定向。此方法会将请求恢复为已开始状态。
    • 使用 cancel() 取消请求。此方法会将请求传递给 onCanceled() 方法，在请求变为“已取消”最终状态之前，应用可以执行其他操作。
  3. 应用跟踪所有重定向后，服务器会发送响应标头并调用 onResponseStarted() 方法。请求处于 Waiting for read() 状态。应用应调用 read() 方法来尝试读取部分响应正文。调用 read() 后，请求处于读取状态，可能出现以下结果：
    • 读取操作已成功完成，但还存在更多可用数据。系统会调用 onReadCompleted()，并且请求再次处于正在等待 read() 状态。应用应再次调用 read() 方法，以继续读取响应正文。应用还可以使用 cancel() 方法停止读取请求。
    • 读取操作已成功，没有更多数据了。已调用 onSucceeded() 方法，请求现在处于成功最终状态。
    • 读取操作失败。系统会调用 onFailed 方法，请求的最终状态为失败。

下图显示了 UrlRequest 对象的生命周期：

Cronet 请求生命周期图
Cronet 请求生命周期

图例
Cronet 初始状态图例图标 初始状态 Cronet 最终状态图例图标 最终状态
Cronet 过渡状态图例图标 过渡状态 Cronet 回调方法图例图标 回调方法
Cronet 客户端操作图例图标 UrlRequest 方法