درخواست آدرس

public abstract class UrlRequest


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

خلاصه

انواع تو در تو

public abstract class UrlRequest.Builder

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

public abstract class UrlRequest.Callback

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

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

public class UrlRequest.Status

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

public abstract class UrlRequest.StatusListener

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

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

روش‌های عمومی

abstract void
cancel ()

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

abstract void

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

abstract void

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

abstract boolean
isDone ()

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

abstract void
read ( ByteBuffer buffer)

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

abstract void
start ()

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

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

درخواست آدرس

public UrlRequest()

روش‌های عمومی

لغو

public abstract void cancel()

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

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

public abstract void followRedirect()

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

دریافت وضعیت

public abstract void getStatus(UrlRequest.StatusListener listener)

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

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

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

انجام شد

public abstract boolean isDone()

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

بازگشت‌ها
boolean

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

خواندن

public abstract void read(ByteBuffer buffer)

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

پارامترها
ByteBuffer buffer

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

شروع

public abstract void start()

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