NetworkException

abstract class NetworkException : CronetException

Известные прямые подклассы QuicException
QuicException

Подкласс NetworkException , содержащий подробный код ошибки QUIC из QuicErrorCode .


Исключение передается в UrlRequest.Callback.onFailed() , когда Cronet не может обработать сетевой запрос. В этом случае можно использовать getErrorCode и getCronetInternalErrorCode для получения дополнительной информации о конкретном типе ошибки. Если getErrorCode возвращает ERROR_QUIC_PROTOCOL_FAILED , это исключение можно преобразовать в QuicException , который может предоставить более подробную информацию.

Краткое содержание

Константы

const Int

Код ошибки указывает на недоступность IP-адреса, с которым осуществляется связь, что означает отсутствие маршрута к указанному хосту или сети.

const Int

Код ошибки, указывающий на неожиданное разрыв соединения.

const Int

Код ошибки указывает на то, что попытка подключения была отклонена.

const Int

Код ошибки, указывающий на неожиданный разрыв соединения.

const Int

Код ошибки, указывающий на истечение времени ожидания попытки подключения.

const Int

Код ошибки указывает на то, что хост, которому отправляется запрос, не может быть преобразован в IP-адрес.

const Int

Код ошибки указывает на то, что устройство не подключено ни к одной сети.

const Int

Код ошибки указывает на то, что в процессе обработки запроса изменилась конфигурация сети.

const Int

Код ошибки указывает на обнаружение ошибки другого типа.

const Int

Код ошибки, указывающий на ошибку, связанную с протоколом QUIC .

const Int

Код ошибки указывает на истечение времени ожидания.

Защищенные конструкторы

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

Создает исключение, вызванное сетевой ошибкой.

Общественные функции

abstract Int

Возвращает внутренний код ошибки Cronet.

abstract Int

Возвращает код ошибки, один из вариантов ERROR_* .

abstract Boolean

Возвращает true , если повторная попытка выполнения этого запроса может оказаться успешной, в противном случае false .

Наследуемые функции

Из java.lang.Throwable

Константы

ERROR_ADDRESS_UNREACHABLE

const val ERROR_ADDRESS_UNREACHABLE = 9: Int

Код ошибки указывает на недоступность IP-адреса, с которым осуществляется связь, что означает отсутствие маршрута к указанному хосту или сети.

ОШИБКА_СОЕДИНЕНИЕ_ЗАКРЫТО

const val ERROR_CONNECTION_CLOSED = 5: Int

Код ошибки, указывающий на неожиданное разрыв соединения.

ERROR_CONNECTION_REFUSED

const val ERROR_CONNECTION_REFUSED = 7: Int

Код ошибки указывает на то, что попытка подключения была отклонена.

ОШИБКА_СБРОСА_СОЕДИНЕНИЯ

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-адрес.

ОШИБКА_ОТКЛЮЧЕНИЕ_ИНТЕРНЕТА

const val ERROR_INTERNET_DISCONNECTED = 2: Int

Код ошибки указывает на то, что устройство не подключено ни к одной сети.

ERROR_NETWORK_CHANGED

const val ERROR_NETWORK_CHANGED = 3: Int

Код ошибки, указывающий на то, что в процессе обработки запроса изменилась конфигурация сети. Если getErrorCode возвращает этот код, исключение может быть преобразовано в QuicException для получения дополнительной информации, если используется протокол QUIC .

ОШИБКА_ДРУГА

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() ). Допускается значение null, указывающее на то, что причина отсутствует или неизвестна.

Общественные функции

getCronetInternalErrorCode

abstract fun getCronetInternalErrorCode(): Int

Возвращает внутренний код ошибки Cronet. Это может обеспечить более точную диагностику ошибки, чем getErrorCode , но постоянные значения не доступны Java и могут меняться со временем. Актуальный список значений можно посмотреть здесь .

Возвраты
Int

Внутренний код ошибки Cronet.

getErrorCode

abstract fun getErrorCode(): Int

Возвращает код ошибки, один из вариантов ERROR_* .

Возвраты
Int

Код ошибки, один из ERROR_* .

немедленноПовторяемый

abstract fun immediatelyRetryable(): Boolean

Возвращает true , если повторная попытка выполнения этого запроса сразу же может оказаться успешной, в противном случае false . Например, возвращает true , когда getErrorCode возвращает ERROR_NETWORK_CHANGED поскольку попытка выполнения запроса с использованием новой сетевой конфигурации может оказаться успешной, но false когда getErrorCode() возвращает ERROR_INTERNET_DISCONNECTED поскольку повторная попытка выполнения запроса сразу же приведет к той же ошибке (вместо этого повторную попытку следует отложить до тех пор, пока устройство не восстановит сетевое соединение).

Возвраты
Boolean

Если true попытка выполнения этого запроса может оказаться успешной, то значение равно false .