این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

استثنای شبکه

abstract class NetworkException : CronetException

کاتلین.هری
↳	kotlin.Throwable
	↳	استثنای جاوا
		↳	استثنای java.io.IO
			↳	org.chromium.net.CronetException
				↳	org.chromium.net.NetworkException

زیرکلاس‌های مستقیم شناخته‌شده QuicException

QuicException

زیرکلاس NetworkException که شامل یک کد خطای QUIC با جزئیات از QuicErrorCode است.

زمانی که Cronet در پردازش یک درخواست شبکه با شکست مواجه می‌شود، استثنا به UrlRequest.Callback.onFailed() ارسال می‌شود. در این حالت getErrorCode و getCronetInternalErrorCode می‌توانند برای دریافت اطلاعات بیشتر در مورد نوع خاص خرابی استفاده شوند. اگر getErrorCode ERROR_QUIC_PROTOCOL_FAILED را برگرداند، این استثنا می‌تواند به QuicException تبدیل شود که می‌تواند جزئیات بیشتری را ارائه دهد.

خلاصه

ثابت‌ها
`const Int`	`ERROR_ADDRESS_UNREACHABLE = 9` کد خطایی که نشان می‌دهد آدرس IP مورد نظر غیرقابل دسترس است، به این معنی که هیچ مسیری به میزبان یا شبکه مشخص شده وجود ندارد.
`const Int`	`ERROR_CONNECTION_CLOSED = 5` کد خطایی که نشان می‌دهد اتصال به‌طور غیرمنتظره‌ای بسته شده است.
`const Int`	`ERROR_CONNECTION_REFUSED = 7` کد خطایی که نشان می‌دهد تلاش برای اتصال رد شده است.
`const Int`	`ERROR_CONNECTION_RESET = 8` کد خطایی که نشان می‌دهد اتصال به‌طور غیرمنتظره‌ای ریست شده است.
`const Int`	`ERROR_CONNECTION_TIMED_OUT = 6` کد خطایی که نشان می‌دهد زمان تلاش برای اتصال به پایان رسیده است.
`const Int`	`ERROR_HOSTNAME_NOT_RESOLVED = 1` کد خطایی که نشان می‌دهد درخواست به میزبان ارسال شده است، به آدرس IP قابل ترجمه نیست.
`const Int`	`ERROR_INTERNET_DISCONNECTED = 2` کد خطایی که نشان می‌دهد دستگاه به هیچ شبکه‌ای متصل نیست.
`const Int`	`ERROR_NETWORK_CHANGED = 3` کد خطایی که نشان می‌دهد هنگام پردازش درخواست، پیکربندی شبکه تغییر کرده است.
`const Int`	`ERROR_OTHER = 11` کد خطایی که نشان می‌دهد نوع دیگری از خطا رخ داده است.
`const Int`	`ERROR_QUIC_PROTOCOL_FAILED = 10` کد خطایی که نشان‌دهنده‌ی خطایی مربوط به پروتکل QUIC است.
`const Int`	`ERROR_TIMED_OUT = 4` کد خطایی که نشان می‌دهد مهلت استفاده از برنامه به پایان رسیده است.

سازنده‌های محافظت‌شده
`NetworkException (message: String !, cause: Throwable !)` یک استثنا ایجاد می‌کند که ناشی از خطای شبکه است.

کارکردهای عمومی
`abstract Int`	`getCronetInternalErrorCode ()` کد خطای داخلی Cronet را برمی‌گرداند.
`abstract Int`	`getErrorCode ()` کد خطا، یکی از `ERROR_*` را برمی‌گرداند.
`abstract Boolean`	`immediatelyRetryable ()` اگر تلاش مجدد برای این درخواست در همان لحظه ممکن است موفقیت‌آمیز باشد، `true` و در غیر این صورت `false` را برمی‌گرداند.

توابع ارثی

از java.lang.Throwable

`synchronized Unit`	`addSuppressed (p: Throwable !)`
`synchronized Throwable !`	`fillInStackTrace ()`
`synchronized Throwable !`	`getCause ()`
`String !`	`getLocalizedMessage ()`
`String !`	`getMessage ()`
`Array < StackTraceElement !>!`	`getStackTrace ()`
`synchronized Array < Throwable !>!`	`getSuppressed ()`
`synchronized Throwable !`	`initCause (p: Throwable !)`
`Unit`	`printStackTrace ()`
`Unit`	`setStackTrace (p: Array < StackTraceElement !>!)`
`String !`	`toString ()`

ثابت‌ها

خطا_آدرس_غیرقابل_دسترسی

const val ERROR_ADDRESS_UNREACHABLE = 9: Int

کد خطایی که نشان می‌دهد آدرس IP مورد نظر غیرقابل دسترس است، به این معنی که هیچ مسیری به میزبان یا شبکه مشخص شده وجود ندارد.

خطا_اتصال_بسته

const val ERROR_CONNECTION_CLOSED = 5: Int

کد خطایی که نشان می‌دهد اتصال به‌طور غیرمنتظره‌ای بسته شده است.

خطا_اتصال_رد_شد

const val ERROR_CONNECTION_REFUSED = 7: Int

کد خطایی که نشان می‌دهد تلاش برای اتصال رد شده است.

خطا_تنظیم_اتصال

const val ERROR_CONNECTION_RESET = 8: Int

کد خطایی که نشان می‌دهد اتصال به‌طور غیرمنتظره‌ای ریست شده است.

خطا_اتصال_زمان_قطع_شد

const val ERROR_CONNECTION_TIMED_OUT = 6: Int

کد خطایی که نشان می‌دهد زمان تلاش برای اتصال به پایان رسیده است.

خطا_نام_میزبان_حل_نشد

const val ERROR_HOSTNAME_NOT_RESOLVED = 1: Int

کد خطایی که نشان می‌دهد درخواست به میزبان ارسال شده است، به آدرس IP قابل ترجمه نیست.

خطا_اینترنت_قطع_شد

const val ERROR_INTERNET_DISCONNECTED = 2: Int

کد خطایی که نشان می‌دهد دستگاه به هیچ شبکه‌ای متصل نیست.

خطا_شبکه_تغییر_کرد

const val ERROR_NETWORK_CHANGED = 3: Int

کد خطایی که نشان می‌دهد پیکربندی شبکه هنگام پردازش درخواست تغییر کرده است. وقتی getErrorCode این کد را برمی‌گرداند، در صورت استفاده از پروتکل QUIC ، این استثنا می‌تواند برای اطلاعات بیشتر به QuicException تبدیل شود.

خطا_دیگر

const val ERROR_OTHER = 11: Int

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

خطا_QUIC_PROTOCOL_FAILED

const val ERROR_QUIC_PROTOCOL_FAILED = 10: Int

کد خطایی که نشان‌دهنده‌ی خطایی مربوط به پروتکل QUIC است. وقتی getErrorCode این کد را برمی‌گرداند، می‌توان این استثنا را برای اطلاعات بیشتر به QuicException تبدیل کرد.

خطا_زمان_خروج

const val ERROR_TIMED_OUT = 4: Int

کد خطایی که نشان می‌دهد مهلت زمانی منقضی شده است. مهلت‌های زمانی که هنگام تلاش برای اتصال منقضی می‌شوند، به صورت خاص‌تر ERROR_CONNECTION_TIMED_OUT گزارش می‌شوند.

سازنده‌های محافظت‌شده

استثنای شبکه

protected NetworkException(message: String!, cause: Throwable!)

یک استثنا ایجاد می‌کند که ناشی از خطای شبکه است.

پارامترها
`message: String !`	توضیح شکست.
`cause: Throwable !`	علت (که برای بازیابی بعدی توسط متد `getCause()` ذخیره می‌شود). مقدار null مجاز است و نشان می‌دهد که علت وجود ندارد یا ناشناخته است.

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

دریافت کد خطای داخلی کرونت

abstract fun getCronetInternalErrorCode(): Int

یک کد خطای داخلی Cronet برمی‌گرداند. این ممکن است تشخیص خطای دقیق‌تری نسبت به getErrorCode ارائه دهد، اما مقادیر ثابت در معرض جاوا قرار نمی‌گیرند و ممکن است با گذشت زمان تغییر کنند. برای آخرین لیست مقادیر به اینجا مراجعه کنید.

بازگشت‌ها
`Int`	کد خطای داخلی کرونت.

دریافت کد خطا

abstract fun getErrorCode(): Int

کد خطا، یکی از ERROR_* را برمی‌گرداند.

بازگشت‌ها
`Int`	کد خطا، یکی از `ERROR_*` .

بلافاصله قابل امتحان مجدد

abstract fun immediatelyRetryable(): Boolean

اگر تلاش مجدد برای این درخواست بلافاصله موفقیت‌آمیز باشد، مقدار true و در غیر این صورت false را برمی‌گرداند. برای مثال، وقتی getErrorCode مقدار ERROR_NETWORK_CHANGED را برمی‌گرداند، true را برمی‌گرداند، زیرا تلاش برای درخواست ممکن است با استفاده از پیکربندی شبکه جدید موفقیت‌آمیز باشد، اما وقتی getErrorCode() مقدار ERROR_INTERNET_DISCONNECTED را برمی‌گرداند، مقدار false برمی‌گرداند، زیرا تلاش مجدد برای درخواست بلافاصله با همان شکست مواجه خواهد شد (در عوض، تلاش مجدد باید تا زمانی که دستگاه اتصال شبکه را دوباره برقرار کند، به تعویق بیفتد).

بازگشت‌ها
`Boolean`	اگر تلاش مجدد برای این درخواست در همان لحظه ممکن است موفقیت‌آمیز باشد، `true` و در غیر این صورت `false` برمی‌گرداند.