UrlResponseInfo

public abstract class UrlResponseInfo

تمثّل هذه السمة معلومات أساسية عن ردّ معيّن. مضمّنة في عمليات معاودة الاتصال UrlRequest.Callback. يحصل كل onRedirectReceived() ردّ اتصال على نسخة مختلفة من UrlResponseInfo تصف ردّ إعادة توجيه معيّنًا.

ملخّص

الأنواع المتداخلة
public abstract class UrlResponseInfo.HeaderBlock

حاوية غير قابلة للتعديل لعناوين الردود أو البيانات اللاحقة.

طُرق وضع التصميم العامة

الإجراءات العامة
abstract Map<String, List<String>>

تعرض هذه الطريقة خريطة غير قابلة للتعديل لحقول عناوين الاستجابة وقيمها.
abstract List<Map.Entry<String, String>>

تعرض هذه الطريقة قائمة غير قابلة للتعديل من أزواج الحقول والقيم في عناوين الاستجابة.
abstract int

تعرِض هذه السمة رمز حالة HTTP.
abstract String

تعرِض هذه السمة نص حالة HTTP لسطر الحالة.
abstract String

تعرض هذه السمة البروتوكول (مثل quic/1+spdy/3) الذي تم التفاوض عليه مع الخادم.
abstract String

تعرض هذه السمة الخادم الوكيل الذي تم استخدامه في الطلب.
abstract long

تعرض هذه السمة الحد الأدنى لعدد وحدات البايت المستلَمة من الشبكة لمعالجة هذا الطلب.
abstract String

تعرض هذه السمة عنوان URL الذي تم إرسال الردّ إليه.
abstract List<String>

تعرض هذه السمة سلسلة عناوين URL.
abstract boolean

تعرِض القيمة true إذا كانت الاستجابة واردة من ذاكرة التخزين المؤقت، بما في ذلك الطلبات التي تمت إعادة التحقّق من صحتها عبر الشبكة قبل استرجاعها من ذاكرة التخزين المؤقت.

طُرق وضع التصميم العامة

UrlResponseInfo

public UrlResponseInfo()

الإجراءات العامة

getAllHeaders

public abstract Map<String, List<String>> getAllHeaders()

تعرض هذه الطريقة خريطة غير قابلة للتعديل لحقول عناوين الاستجابة وقيمها. تكون كل قائمة قيم لحقل عنوان واحد بالترتيب نفسه الذي تم استلامها به عبر الشبكة.

المرتجعات
Map<String, List<String>>

خريطة غير قابلة للتعديل لحقول وعناوين الاستجابة.

getAllHeadersAsList

public abstract List<Map.Entry<String, String>> getAllHeadersAsList()

تعرض هذه الطريقة قائمة غير قابلة للتعديل من أزواج الحقول والقيم في عناوين الاستجابة. تكون العناوين بالترتيب نفسه الذي تم استلامها به عبر الشبكة.

المرتجعات
List<Map.Entry<String, String>>

قائمة غير قابلة للتعديل تتضمّن أزواجًا من حقول عناوين الاستجابة وقيمها

getHttpStatusCode

public abstract int getHttpStatusCode()

تعرِض هذه السمة رمز حالة HTTP. عند استرداد مورد من ذاكرة التخزين المؤقت، سواء تمت إعادة التحقّق من صحته أم لا، يتم عرض رمز الحالة الأصلي.

المرتجعات
int

رمز حالة HTTP

getHttpStatusText

public abstract String getHttpStatusText()

تعرِض هذه السمة نص حالة HTTP لسطر الحالة. على سبيل المثال، إذا تلقّى الطلب استجابة "HTTP/1.1 200 OK"، سيعرض هذا الإجراء "OK".

المرتجعات
String

نص حالة HTTP لسطر الحالة

getNegotiatedProtocol

public abstract String getNegotiatedProtocol()

تعرض هذه السمة البروتوكول (مثل quic/1+spdy/3) الذي تم التفاوض عليه مع الخادم. تعرض هذه السمة سلسلة فارغة في حال عدم التفاوض على أي بروتوكول أو إذا كان البروتوكول غير معروف أو عند استخدام HTTP أو HTTPS العاديين.

المرتجعات
String

البروتوكول الذي تم التفاوض عليه مع الخادم

getProxyServer

public abstract String getProxyServer()

تعرض هذه السمة الخادم الوكيل الذي تم استخدامه في الطلب.

المرتجعات
String

خادم البروكسي الذي تم استخدامه في الطلب

getReceivedByteCount

public abstract long getReceivedByteCount()

تعرِض هذه السمة الحدّ الأدنى لعدد وحدات البايت المستلَمة من الشبكة لمعالجة هذا الطلب. قد يتجاهل هذا العدد بعض النفقات العامة (مثل إنشاء إطارات IP وTCP/UDP، والمصافحة وإنشاء الإطارات في طبقة المقابس الآمنة، ومعالجة الخادم الوكيل). يتم احتساب هذا العدد قبل فك الضغط (مثل GZIP) ويتضمّن العناوين والبيانات من جميع عمليات إعادة التوجيه. قد تتغيّر هذه القيمة (حتى بالنسبة إلى مثيل UrlResponseInfo واحد) أثناء تقدّم الطلب إلى أن يكتمل، وعندها يتم استدعاء onSucceeded() أو onFailed() أو onCanceled().

المرتجعات
long

الحدّ الأدنى لعدد وحدات البايت المستلَمة من الشبكة لمعالجة هذا الطلب

getUrl

public abstract String getUrl()

تعرض هذه السمة عنوان URL الذي تم إرسال الردّ إليه. هذا هو عنوان URL بعد اتّباع عمليات إعادة التوجيه، لذا قد لا يكون عنوان URL المطلوب في الأصل.

المرتجعات
String

عنوان URL الذي تم إرسال الرد إليه

getUrlChain

public abstract List<String> getUrlChain()

تعرض هذه السمة سلسلة عناوين URL. الإدخال الأول هو عنوان URL المطلوب في الأصل، أما الإدخالات التالية فهي عمليات إعادة التوجيه التي تمّت متابعتها.

المرتجعات
List<String>

سلسلة عناوين URL

wasCached

public abstract boolean wasCached()

تعرِض القيمة true إذا كانت الاستجابة واردة من ذاكرة التخزين المؤقت، بما في ذلك الطلبات التي تمت إعادة التحقّق من صحتها عبر الشبكة قبل استرجاعها من ذاكرة التخزين المؤقت.

المرتجعات
boolean

true إذا كانت الاستجابة من ذاكرة التخزين المؤقت، false في الحالات الأخرى