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

استثنای شبکه

public abstract class NetworkException extends 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 تبدیل شود که می‌تواند جزئیات بیشتری را ارائه دهد.

خلاصه

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

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

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

روش‌های ارثی

از java.lang.Throwable

`synchronized final void`	`addSuppressed ( Throwable p)`
`synchronized Throwable`	`fillInStackTrace ()`
`synchronized Throwable`	`getCause ()`
`String`	`getLocalizedMessage ()`
`String`	`getMessage ()`
`StackTraceElement[]`	`getStackTrace ()`
`synchronized final Throwable[]`	`getSuppressed ()`
`synchronized Throwable`	`initCause ( Throwable p)`
`void`	`printStackTrace ()`
`void`	`setStackTrace (StackTraceElement[] p)`
`String`	`toString ()`

ثابت‌ها

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

public static final int ERROR_ADDRESS_UNREACHABLE = 9

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

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

public static final int ERROR_CONNECTION_CLOSED = 5

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

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

public static final int ERROR_CONNECTION_REFUSED = 7

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

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

public static final int ERROR_CONNECTION_RESET = 8

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

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

public static final int ERROR_CONNECTION_TIMED_OUT = 6

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

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

public static final int ERROR_HOSTNAME_NOT_RESOLVED = 1

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

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

public static final int ERROR_INTERNET_DISCONNECTED = 2

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

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

public static final int ERROR_NETWORK_CHANGED = 3

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

خطا_دیگر

public static final int ERROR_OTHER = 11

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

خطا_QUIC_PROTOCOL_FAILED

public static final int ERROR_QUIC_PROTOCOL_FAILED = 10

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

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

public static final int ERROR_TIMED_OUT = 4

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

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

استثنای شبکه

protected NetworkException(String message, Throwable cause)

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

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

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

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

public abstract int getCronetInternalErrorCode()

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

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

دریافت کد خطا

public abstract int getErrorCode()

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

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

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

public abstract boolean immediatelyRetryable()

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

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