UrlResponseInfo
abstract class UrlResponseInfo
تمثّل هذه السمة معلومات أساسية عن ردّ معيّن. مضمّنة في عمليات معاودة الاتصال UrlRequest.Callback. يحصل كل onRedirectReceived() ردّ اتصال على نسخة مختلفة من UrlResponseInfo تصف ردّ إعادة توجيه معيّنًا.
ملخّص
الأنواع المتداخلة |
|---|
abstract class UrlResponseInfo.HeaderBlockحاوية غير قابلة للتعديل لعناوين الردود أو البيانات اللاحقة. |
طُرق وضع التصميم العامة |
|---|
الوظائف العامة |
|
|---|---|
abstract (Mutable)Map<String!, (Mutable)List<String!>!>! |
تعرض هذه الطريقة خريطة غير قابلة للتعديل لحقول عناوين الاستجابة وقيمها. |
abstract (Mutable)List<(Mutable)Map.Entry<String!, String!>!>! |
تعرض هذه الطريقة قائمة غير قابلة للتعديل من أزواج الحقول والقيم في عناوين الاستجابة. |
abstract Int |
تعرِض هذه السمة رمز حالة HTTP. |
abstract String! |
تعرِض هذه السمة نص حالة HTTP لسطر الحالة. |
abstract String! |
تعرض هذه السمة البروتوكول (مثل quic/1+spdy/3) الذي تم التفاوض عليه مع الخادم. |
abstract String! |
تعرض هذه السمة الخادم الوكيل الذي تم استخدامه في الطلب. |
abstract Long |
تعرِض هذه السمة الحدّ الأدنى لعدد وحدات البايت المستلَمة من الشبكة لمعالجة هذا الطلب. |
abstract String! |
getUrl()تعرض هذه السمة عنوان URL الذي تم إرسال الردّ إليه. |
abstract (Mutable)List<String!>! |
تعرض هذه السمة سلسلة عناوين URL. |
abstract Boolean |
تعرِض القيمة |
طُرق وضع التصميم العامة
الوظائف العامة
getAllHeaders
abstract fun getAllHeaders(): (Mutable)Map<String!, (Mutable)List<String!>!>!
تعرض هذه الطريقة خريطة غير قابلة للتعديل لحقول عناوين الاستجابة وقيمها. تكون كل قائمة قيم لحقل عنوان واحد بالترتيب نفسه الذي تم استلامها به عبر الشبكة.
getAllHeadersAsList
abstract fun getAllHeadersAsList(): (Mutable)List<(Mutable)Map.Entry<String!, String!>!>!
تعرض هذه الطريقة قائمة غير قابلة للتعديل من أزواج الحقول والقيم في عناوين الاستجابة. تكون العناوين بالترتيب نفسه الذي تم استلامها به عبر الشبكة.
getHttpStatusCode
abstract fun getHttpStatusCode(): Int
تعرِض هذه السمة رمز حالة HTTP. عند استرداد مورد من ذاكرة التخزين المؤقت، سواء تمت إعادة التحقّق من صحته أم لا، يتم عرض رمز الحالة الأصلي.
| المرتجعات | |
|---|---|
Int |
رمز حالة HTTP |
getHttpStatusText
abstract fun getHttpStatusText(): String!
تعرض هذه السمة نص حالة HTTP لسطر الحالة. على سبيل المثال، إذا تلقّى الطلب استجابة "HTTP/1.1 200 OK"، سيعرض هذا الإجراء "OK".
| المرتجعات | |
|---|---|
String! |
نص حالة HTTP لسطر الحالة |
getNegotiatedProtocol
abstract fun getNegotiatedProtocol(): String!
تعرض هذه السمة البروتوكول (مثل quic/1+spdy/3) الذي تم التفاوض عليه مع الخادم. تعرض هذه السمة سلسلة فارغة في حال عدم التفاوض على أي بروتوكول أو إذا كان البروتوكول غير معروف أو عند استخدام HTTP أو HTTPS العاديين.
| المرتجعات | |
|---|---|
String! |
البروتوكول الذي تم التفاوض عليه مع الخادم |
getProxyServer
abstract fun getProxyServer(): String!
تعرض هذه السمة الخادم الوكيل الذي تم استخدامه في الطلب.
| المرتجعات | |
|---|---|
String! |
خادم البروكسي الذي تم استخدامه في الطلب |
getReceivedByteCount
abstract fun getReceivedByteCount(): Long
تعرِض هذه السمة الحدّ الأدنى لعدد وحدات البايت المستلَمة من الشبكة لمعالجة هذا الطلب. قد يتجاهل هذا العدد بعض النفقات العامة (مثل إنشاء إطارات IP وTCP/UDP، والمصافحة وإنشاء الإطارات في طبقة المقابس الآمنة، ومعالجة الخادم الوكيل). يتم احتساب هذا العدد قبل فك الضغط (مثل GZIP) ويتضمّن العناوين والبيانات من جميع عمليات إعادة التوجيه. قد تتغيّر هذه القيمة (حتى بالنسبة إلى مثيل UrlResponseInfo واحد) أثناء تقدّم الطلب إلى أن يكتمل، وعندها يتم استدعاء onSucceeded() أو onFailed() أو onCanceled().
| المرتجعات | |
|---|---|
Long |
الحدّ الأدنى لعدد وحدات البايت المستلَمة من الشبكة لمعالجة هذا الطلب |
getUrl
abstract fun getUrl(): String!
تعرض هذه السمة عنوان URL الذي تم إرسال الردّ إليه. هذا هو عنوان URL بعد اتّباع عمليات إعادة التوجيه، لذا قد لا يكون عنوان URL المطلوب في الأصل.
| المرتجعات | |
|---|---|
String! |
عنوان URL الذي تم إرسال الرد إليه |
getUrlChain
abstract fun getUrlChain(): (Mutable)List<String!>!
تعرض هذه السمة سلسلة عناوين URL. الإدخال الأول هو عنوان URL المطلوب في الأصل، أما الإدخالات التالية فهي عمليات إعادة التوجيه التي تمّت متابعتها.
wasCached
abstract fun wasCached(): Boolean
تعرِض القيمة true إذا كانت الاستجابة واردة من ذاكرة التخزين المؤقت، بما في ذلك الطلبات التي تمت إعادة التحقّق من صحتها عبر الشبكة قبل استرجاعها من ذاكرة التخزين المؤقت.
| المرتجعات | |
|---|---|
Boolean |
|