‫RequestFinishedInfo

public abstract class RequestFinishedInfo

معلومات عن طلب تم الانتهاء منه. يتم تمريرها إلى RequestFinishedInfo.Listener.

لربط البيانات بالطلب الأصلي، استخدِم addRequestAnnotation لإضافة معرّف فريد عند إنشاء الطلب، واستدعِ getAnnotations عند تلقّي RequestFinishedInfo لاسترداد المعرّف.

ملخّص

الأنواع المضمّنة
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

إذا تعذّر إجراء الطلب، يعرِض CronetException نفسه الذي تم تقديمه إلى onFailed.
abstract int

تعرِض السبب وراء الانتهاء من الطلب.
abstract RequestFinishedInfo.Metrics

تعرِض المقاييس التي تم جمعها لهذا الطلب.
abstract @Nullable UrlResponseInfo

تعرِض UrlResponseInfo للطلب، إذا بدأت استجابته.
abstract String

تعرِض عنوان URL الأصلي للطلب.

الثوابت

تم إلغاؤها

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<Object> getAnnotations()

تعرِض الكائنات التي قدّمها المتصل عند بدء الطلب باستخدام addRequestAnnotation. يمكن استخدام التعليقات التوضيحية لربط RequestFinishedInfo بالطلب الأصلي أو نوع الطلب.

النتائج
Collection<Object>

التعليقات التوضيحية التي تم تقديمها عند إنشاء الطلب

getException

public abstract @Nullable CronetException getException()

إذا تعذّر إجراء الطلب، يعرِض CronetException نفسه الذي تم تقديمه إلى onFailed.

النتائج
@Nullable CronetException

‫CronetException للطلب، إذا تعذّر إجراء الطلب

getFinishedReason

public abstract int getFinishedReason()

تعرِض السبب وراء الانتهاء من الطلب.

النتائج
int

أحد الخيارات SUCCEEDED أو FAILED أو CANCELED

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

تعرِض عنوان URL الأصلي للطلب.

النتائج
String

عنوان URL الأصلي للطلب