درخواست آدرس

abstract class UrlRequest


یک درخواست HTTP (GET، PUT، POST و غیره) را کنترل می‌کند. توسط UrlRequest.Builder ایجاد شده است که می‌توان آن را با فراخوانی newUrlRequestBuilder به دست آورد. توجه: همه متدها باید در Executor ارسال شده به newUrlRequestBuilder فراخوانی شوند.

خلاصه

انواع تو در تو

abstract class UrlRequest.Builder

سازنده برای UrlRequest s.

abstract class UrlRequest.Callback

کاربران Cronet این کلاس را برای دریافت callbackهایی که نشان‌دهنده‌ی پیشرفت پردازش یک UrlRequest هستند، توسعه می‌دهند.

حاشیه‌نویسی برای APIهایی که هنوز پایدار در نظر گرفته نشده‌اند.

درخواست مقادیر وضعیت برگردانده شده توسط getStatus .

کلاس شنونده (listener) که به همراه getStatus برای دریافت وضعیت یک UrlRequest استفاده می‌شود.

سازندگان عمومی

کارکردهای عمومی

abstract Unit
cancel ()

درخواست را لغو می‌کند.

abstract Unit

یک تغییر مسیر در حال انتظار را دنبال می‌کند.

abstract Unit

وضعیت درخواست را استعلام می‌کند.

abstract Boolean
isDone ()

اگر درخواست با موفقیت شروع شده باشد و اکنون به پایان رسیده باشد (تکمیل شده، لغو شده یا ناموفق باشد)، مقدار true را برمی‌گرداند.

abstract Unit
read (buffer: ByteBuffer !)

تلاش می‌کند بخشی از بدنه پاسخ را در بافر ارائه شده بخواند.

abstract Unit
start ()

درخواست را شروع می‌کند، همه فراخوانی‌های برگشتی به Callback می‌روند.

سازندگان عمومی

درخواست آدرس

UrlRequest()

کارکردهای عمومی

لغو

abstract fun cancel(): Unit

درخواست را لغو می‌کند. می‌تواند در هر زمانی فراخوانی شود. onCanceled() زمانی فراخوانی می‌شود که لغو کامل شده باشد و هیچ متد فراخوانی مجدد دیگری فراخوانی نشود. اگر درخواست تکمیل شده باشد یا شروع نشده باشد، فراخوانی cancel() هیچ تاثیری ندارد و onCanceled() فراخوانی نخواهد شد. اگر Executor که در طول ساخت UrlRequest ارسال شده است، وظایف را روی یک نخ واحد اجرا کند و cancel() روی آن نخ فراخوانی شود، هیچ متد فراخوانی (به جز onCanceled() ) پس از فراخوانی cancel() فراخوانی نخواهد شد. در غیر این صورت، حداکثر یک متد فراخوانی مجدد می‌تواند پس از تکمیل cancel() فراخوانی شود.

دنبال کردنتغییر مسیر

abstract fun followRedirect(): Unit

یک تغییر مسیر در حال انتظار را دنبال می‌کند. باید حداکثر یک بار برای هر بار فراخوانی onRedirectReceived() فراخوانی شود.

دریافت وضعیت

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

وضعیت درخواست را استعلام می‌کند.

پارامترها
listener: UrlRequest.StatusListener !

یک StatusListener که با وضعیت فعلی درخواست فراخوانی می‌شود. listener دوباره بر روی Executor که هنگام ایجاد درخواست ارسال شده است، فراخوانی خواهد شد.

انجام شد

abstract fun isDone(): Boolean

اگر درخواست با موفقیت شروع شده باشد و اکنون به پایان رسیده باشد (تکمیل شده، لغو شده یا ناموفق باشد)، مقدار true را برمی‌گرداند.

بازگشت‌ها
Boolean

اگر درخواست با موفقیت شروع شده و اکنون به پایان رسیده است (تکمیل شده، لغو شده یا شکست خورده)، true .

خواندن

abstract fun read(buffer: ByteBuffer!): Unit

تلاش برای خواندن بخشی از بدنه پاسخ در بافر ارائه شده. حداکثر باید یک بار در پاسخ به هر فراخوانی متدهای onResponseStarted() و onReadCompleted() از Callback فراخوانی شود. هر فراخوانی منجر به فراخوانی غیرهمزمان متد onReadCompleted() Callback's در صورت خوانده شدن داده، متد onSucceeded() در صورت عدم وجود داده بیشتر برای خواندن، یا متد onFailed() در صورت وجود خطا خواهد شد.

پارامترها
buffer: ByteBuffer !

ByteBuffer برای نوشتن بدنه پاسخ. باید یک ByteBuffer مستقیم باشد. جاسازی‌کننده نباید موقعیت، محدودیت یا داده‌های بین موقعیت و محدودیت بافر را بخواند یا تغییر دهد تا زمانی که درخواست به Callback فراخوانی شود.

شروع

abstract fun start(): Unit

درخواست را شروع می‌کند، همه فراخوانی‌های برگشتی به Callback می‌روند. ممکن است فقط یک بار فراخوانی شود. اگر cancel فراخوانی شده باشد، ممکن است فراخوانی نشود.