UrlRequest

public abstract class UrlRequest

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

ملخّص

الأنواع المتداخلة
public abstract class UrlRequest.Builder

أداة إنشاء لـ UrlRequest
public abstract class UrlRequest.Callback

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

تعليق توضيحي لواجهات برمجة التطبيقات التي لم يتم اعتبارها ثابتة بعد.
public class UrlRequest.Status

قيم حالة الطلب التي تعرضها getStatus.
public abstract class UrlRequest.StatusListener

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

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

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

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

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

يستعلم عن حالة الطلب.
abstract boolean

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

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

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

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

UrlRequest

public UrlRequest()

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

إلغاء

public abstract void cancel()

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

followRedirect

public abstract void followRedirect()

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

getStatus

public abstract void getStatus(UrlRequest.StatusListener listener)

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

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

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

isDone

public abstract boolean isDone()

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

المرتجعات
boolean

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

قراءة

public abstract void read(ByteBuffer buffer)

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

المعلَمات
ByteBuffer buffer

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

البدء

public abstract void start()

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