تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

NetworkException

abstract class NetworkException : CronetException

kotlin.Any
↳	kotlin.Throwable
	↳	java.lang.Exception
		↳	java.io.IOException
			↳	org.chromium.net.CronetException
				↳	org.chromium.net.NetworkException

فئات فرعية مباشرة معروفة

QuicException

QuicException

فئة فرعية من NetworkException تحتوي على رمز خطأ QUIC تفصيلي من QuicErrorCode.

يتم تمرير الاستثناء إلى UrlRequest.Callback.onFailed() عندما يتعذّر على Cronet معالجة طلب شبكة. في هذه الحالة، يمكن استخدام 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()`

الثوابت

ERROR_ADDRESS_UNREACHABLE

const val ERROR_ADDRESS_UNREACHABLE = 9: Int

رمز الخطأ الذي يشير إلى تعذّر الوصول إلى عنوان IP الذي يتم الاتصال به، ما يعني عدم توفّر مسار إلى المضيف أو الشبكة المحدّدة.

ERROR_CONNECTION_CLOSED

const val ERROR_CONNECTION_CLOSED = 5: Int

رمز الخطأ الذي يشير إلى أنّ الاتصال تم إغلاقه بشكل غير متوقع.

ERROR_CONNECTION_REFUSED

const val ERROR_CONNECTION_REFUSED = 7: Int

رمز الخطأ الذي يشير إلى أنّه تم رفض محاولة الاتصال.

ERROR_CONNECTION_RESET

const val ERROR_CONNECTION_RESET = 8: Int

رمز الخطأ الذي يشير إلى أنّه تمت إعادة ضبط الاتصال بشكل غير متوقع.

ERROR_CONNECTION_TIMED_OUT

const val ERROR_CONNECTION_TIMED_OUT = 6: Int

رمز الخطأ الذي يشير إلى انتهاء مهلة محاولة الاتصال.

ERROR_HOSTNAME_NOT_RESOLVED

const val ERROR_HOSTNAME_NOT_RESOLVED = 1: Int

رمز الخطأ الذي يشير إلى تعذُّر تحويل المضيف الذي يتم إرسال الطلب إليه إلى عنوان IP.

ERROR_INTERNET_DISCONNECTED

const val ERROR_INTERNET_DISCONNECTED = 2: Int

رمز الخطأ الذي يشير إلى أنّ الجهاز لم يكن متصلاً بأي شبكة.

ERROR_NETWORK_CHANGED

const val ERROR_NETWORK_CHANGED = 3: Int

رمز الخطأ الذي يشير إلى أنّه أثناء معالجة الطلب، تم تغيير إعدادات الشبكة. عندما تعرض getErrorCode هذا الرمز، يمكن تحويل هذا الاستثناء إلى QuicException للحصول على مزيد من المعلومات في حال استخدام بروتوكول QUIC.

ERROR_OTHER

const val ERROR_OTHER = 11: Int

رمز الخطأ الذي يشير إلى حدوث نوع آخر من الخطأ. يمكن الرجوع إلى getCronetInternalErrorCode لمعرفة السبب بشكل أكثر تحديدًا.

ERROR_QUIC_PROTOCOL_FAILED

const val ERROR_QUIC_PROTOCOL_FAILED = 10: Int

رمز الخطأ الذي يشير إلى خطأ متعلّق ببروتوكول QUIC عندما تعرض الدالة getErrorCode هذا الرمز، يمكن تحويل هذا الاستثناء إلى QuicException للحصول على مزيد من المعلومات.

ERROR_TIMED_OUT

const val ERROR_TIMED_OUT = 4: Int

رمز خطأ يشير إلى انتهاء المهلة. سيتم تسجيل انتهاء المهلة أثناء محاولة الاتصال على أنّه ERROR_CONNECTION_TIMED_OUT الأكثر تحديدًا.

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

NetworkException

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

تنشئ هذه الطريقة استثناءً ناتجًا عن خطأ في الشبكة.

المعلَمات
`message: String!`	تفسير سبب الفشل
`cause: Throwable!`	السبب (الذي يتم حفظه لاسترجاعه لاحقًا باستخدام الطريقة `getCause()`). يُسمح بالقيمة "فارغ"، وتشير إلى أنّ السبب غير موجود أو غير معروف.

الوظائف العامة

getCronetInternalErrorCode

abstract fun getCronetInternalErrorCode(): Int

تعرِض هذه السمة رمز خطأ داخليًا في Cronet. قد يوفّر ذلك تشخيصًا أكثر تحديدًا للأخطاء من getErrorCode، ولكن لا يتم عرض القيم الثابتة في Java وقد تتغيّر بمرور الوقت. اطّلِع على هنا للحصول على أحدث قائمة بالقيم.

المرتجعات
`Int`	رمز الخطأ الداخلي في Cronet.

getErrorCode

abstract fun getErrorCode(): Int

تعرِض هذه السمة رمز الخطأ، وهو أحد الرموز التالية: ERROR_*.

المرتجعات
`Int`	رمز الخطأ، وهو أحد الرموز `ERROR_*`.

immediatelyRetryable

abstract fun immediatelyRetryable(): Boolean

تعرض القيمة true إذا كان من المحتمل أن تنجح إعادة محاولة تنفيذ هذا الطلب على الفور، أو false في الحالات الأخرى. على سبيل المثال، تعرض الدالة true القيمة ERROR_NETWORK_CHANGED عندما تعرض الدالة getErrorCode القيمة ERROR_NETWORK_CHANGED لأنّ إعادة محاولة الطلب قد تنجح باستخدام إعدادات الشبكة الجديدة، ولكن تعرض الدالة true القيمة false عندما تعرض الدالة getErrorCode() القيمة ERROR_INTERNET_DISCONNECTED لأنّ إعادة محاولة الطلب على الفور ستؤدي إلى حدوث الخطأ نفسه (بدلاً من ذلك، يجب تأخير إعادة المحاولة إلى أن يستعيد الجهاز الاتصال بالشبكة).

المرتجعات
`Boolean`	`true` إذا كان من المحتمل أن تنجح إعادة محاولة تنفيذ هذا الطلب على الفور، `false` في الحالات الأخرى.