NetworkException

public abstract class NetworkException extends CronetException

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

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


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

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

Константы

static final int

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

static final int

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

static final int

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

static final int

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

static final int

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

static final int

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

static final int

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

static final int

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

static final int

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

static final int

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

static final int

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

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

NetworkException ( String message, Throwable cause)

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

Общедоступные методы

abstract int

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

abstract int

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

abstract boolean

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

Унаследованные методы

Из java.lang.Throwable
synchronized final void
synchronized Throwable
synchronized Throwable
String
String
StackTraceElement[]
synchronized final Throwable[]
synchronized Throwable
void
void
setStackTrace (StackTraceElement[] p)
String

Константы

ERROR_ADDRESS_UNREACHABLE

public static final int ERROR_ADDRESS_UNREACHABLE = 9

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

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

public static final int ERROR_CONNECTION_CLOSED = 5

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

ERROR_CONNECTION_REFUSED

public static final int ERROR_CONNECTION_REFUSED = 7

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

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

public static final int ERROR_CONNECTION_RESET = 8

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

ERROR_CONNECTION_TIMED_OUT

public static final int ERROR_CONNECTION_TIMED_OUT = 6

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

ERROR_HOSTNAME_NOT_RESOLVED

public static final int ERROR_HOSTNAME_NOT_RESOLVED = 1

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

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

public static final int ERROR_INTERNET_DISCONNECTED = 2

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

ERROR_NETWORK_CHANGED

public static final int ERROR_NETWORK_CHANGED = 3

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

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

public static final int ERROR_OTHER = 11

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

ERROR_QUIC_PROTOCOL_FAILED

public static final int ERROR_QUIC_PROTOCOL_FAILED = 10

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

ERROR_TIMED_OUT

public static final int ERROR_TIMED_OUT = 4

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

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

NetworkException

protected NetworkException(String message, Throwable cause)

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

Параметры
String message

объяснение причины сбоя.

Throwable cause

Причина (которая сохраняется для последующего извлечения методом getCause() ). Допускается значение null, указывающее на то, что причина отсутствует или неизвестна.

Общедоступные методы

getCronetInternalErrorCode

public abstract int getCronetInternalErrorCode()

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

Возвраты
int

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

getErrorCode

public abstract int getErrorCode()

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

Возвраты
int

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

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

public abstract boolean immediatelyRetryable()

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

Возвраты
boolean

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