RequestFinishedInfo

public abstract class RequestFinishedInfo


有关已完成请求的信息。已传递给 RequestFinishedInfo.Listener

如需将数据与原始请求相关联,请在创建请求时使用 addRequestAnnotation 添加唯一标识符,并在收到 RequestFinishedInfo 时调用 getAnnotations 以检索该标识符。

摘要

嵌套类型

public abstract class RequestFinishedInfo.Listener

监听已完成的请求,以便收集指标。

public abstract class RequestFinishedInfo.Metrics

为单个请求收集的指标。

常量

static final int

表示请求已取消的原因值。

static final int
FAILED = 1

表示请求失败或返回错误的原因值。

static final int

表示请求成功的理由值。

公共构造函数

公共方法

abstract Collection<Object>

返回调用方在通过 addRequestAnnotation 发起请求时提供的对象。

abstract @Nullable CronetException

如果请求失败,则返回提供给 onFailed 的相同 CronetException

abstract int

返回请求完成的原因。

abstract RequestFinishedInfo.Metrics

返回为此请求收集的指标。

abstract @Nullable UrlResponseInfo

如果请求的响应已开始,则返回该请求的 UrlResponseInfo

abstract String

返回请求的原始网址。

常量

CANCELED

public static final int CANCELED = 2

表示请求已取消的原因值。从 getFinishedReason 返回。

失败

public static final int FAILED = 1

表示请求失败或返回错误的原因值。从 getFinishedReason 返回。

成功

public static final int SUCCEEDED = 0

表示请求成功的理由值。从 getFinishedReason 返回。

公共构造函数

RequestFinishedInfo

public RequestFinishedInfo()

公共方法

getAnnotations

public abstract Collection<ObjectgetAnnotations()

返回调用方在通过 addRequestAnnotation 发起请求时提供的对象。注释可用于将 RequestFinishedInfo 与原始请求或请求类型相关联。

返回
Collection<Object>

创建请求时提供的注释

getException

public abstract @Nullable CronetException getException()

如果请求失败,则返回提供给 onFailed 的相同 CronetException

返回
@Nullable CronetException

请求的 CronetException(如果请求失败)

getFinishedReason

public abstract int getFinishedReason()

返回请求完成的原因。

返回
int

SUCCEEDEDFAILEDCANCELED 中的一项

getMetrics

public abstract RequestFinishedInfo.Metrics getMetrics()

返回为此请求收集的指标。

报告的时间和字节数包含所有重定向,即 TTFB 是从原始请求开始到最终响应标头的时间,TTLB 是从原始请求开始到最终响应结束的时间,收到的字节数是所有重定向和最终响应的总和。这些累计指标定义存在争议,但之所以选择它们,是为了让面向用户的延迟时间分析有意义。

返回
RequestFinishedInfo.Metrics

针对相应请求收集的指标。

getResponseInfo

public abstract @Nullable UrlResponseInfo getResponseInfo()

如果请求的响应已开始,则返回该请求的 UrlResponseInfo

返回
@Nullable UrlResponseInfo

UrlResponseInfo(如果请求的响应已开始)。

getUrl

public abstract String getUrl()

返回请求的原始网址。

返回
String

请求的原始网址