UrlRequest

abstract class UrlRequest

يتحكّم في طلب HTTP (مثل GET وPUT وPOST وما إلى ذلك). تم إنشاؤه بواسطة UrlRequest.Builder، الذي يمكن الحصول عليه من خلال استدعاء newUrlRequestBuilder. ملاحظة: يجب استدعاء جميع الطرق على Executor الذي تم تمريره إلى newUrlRequestBuilder.

ملخّص

الأنواع المضمّنة
abstract class UrlRequest.Builder

أداة إنشاء لطلبات UrlRequest
abstract class UrlRequest.Callback

يوسّع مستخدِمو Cronet هذه الفئة لتلقّي عمليات معاودة الاتصال التي تشير إلى تقدّم معالجة UrlRequest.

شرح توضيحي لواجهات برمجة التطبيقات التي لا تُعتبر مستقرّة بعد

قيم حالة الطلب التي تعرضها الدالة getStatus

فئة المستمع المستخدَمة مع getStatus لتلقّي حالة UrlRequest

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

الوظائف العامة
abstract Unit

إلغاء الطلب
abstract Unit

تتبُّع عملية إعادة توجيه معلّقة
abstract Unit

الاستعلام عن حالة الطلب
abstract Boolean

عرض true إذا تم بدء الطلب بنجاح واكتمل الآن (تم أو تم إلغاؤه أو تعذّر تنفيذه)
abstract Unit
read(buffer: ByteBuffer!)

محاولة قراءة جزء من نص الردّ في المخزن المؤقت المقدَّم
abstract Unit

بدء الطلب، وتنتقل جميع عمليات معاودة الاتصال إلى Callback

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

UrlRequest

UrlRequest()

الوظائف العامة

cancel

abstract fun cancel(): Unit

إلغاء الطلب يمكن استدعاء هذه الطريقة في أي وقت. سيتم استدعاء onCanceled() عند اكتمال عملية الإلغاء ولن يتم استدعاء أي طرق معاودة اتصال أخرى. إذا اكتمل الطلب أو لم يبدأ، لن يكون لاستدعاء cancel() أي تأثير ولن يتم استدعاء onCanceled(). إذا كان Executor الذي تم تمريره أثناء إنشاء UrlRequest يُشغّل المهام على سلسلة محادثات واحدة، وتم استدعاء cancel() على سلسلة المحادثات هذه، لن يتم استدعاء أي طرق معاودة اتصال (باستثناء onCanceled()) بعد استدعاء cancel(). بخلاف ذلك، يمكن استدعاء طريقة رد الاتصال واحدة على الأكثر بعد اكتمال cancel().

followRedirect

abstract fun followRedirect(): Unit

تتبُّع عملية إعادة توجيه معلّقة يجب عدم استدعاء هذه الطريقة إلا مرة واحدة على الأكثر لكل استدعاء من onRedirectReceived().

getStatus

abstract fun getStatus(listener: UrlRequest.StatusListener!): Unit

الاستعلام عن حالة الطلب

المعلَمات
listener: UrlRequest.StatusListener!

StatusListener سيتم استدعاؤه باستخدام الحالة الحالية للطلب سيتم استدعاء listener مرة أخرى على Executor الذي تم تمريره عند إنشاء الطلب.

isDone

abstract fun isDone(): Boolean

عرض true إذا تم بدء الطلب بنجاح واكتمل الآن (تم أو تم إلغاؤه أو تعذّر تنفيذه)

المرتجعات
Boolean

true إذا تم بدء الطلب بنجاح واكتمل الآن (تم أو تم إلغاؤه أو تعذّر تنفيذه)

read

abstract fun read(buffer: ByteBuffer!): Unit

محاولة قراءة جزء من نص الردّ في المخزن المؤقت المقدَّم يجب عدم استدعاء هذه الطريقة إلا مرة واحدة على الأكثر ردًا على كل استدعاء من طريقتَي onResponseStarted() وonReadCompleted() في Callback. سيؤدي كل استدعاء إلى استدعاء غير متزامن إما لطريقة Callback'sonReadCompleted() إذا تم قراءة البيانات، أو طريقة onSucceeded() إذا لم يعُد هناك بيانات للقراءة، أو طريقة onFailed() إذا حدث خطأ.

المعلَمات
buffer: ByteBuffer!

ByteBuffer لكتابة نص الردّ فيه يجب أن يكون ByteBuffer مباشرًا. يجب ألا يقرأ التطبيق المضمِّن أو يعدّل موضع المخزن المؤقت أو حدّه أو بياناته بين موضعه وحدّه إلى أن يعاود الطلب الاتصال بـ Callback.

start

abstract fun start(): Unit

بدء الطلب، وتنتقل جميع عمليات معاودة الاتصال إلى Callback لا يمكن استدعاء هذه الطريقة إلا مرة واحدة. لا يمكن استدعاؤها إذا تم استدعاء cancel.