NetworkException

public abstract class NetworkException extends CronetException

Subclases directas conocidas
QuicException

Subclase de NetworkException que contiene un código de error QUIC detallado de QuicErrorCode.


Excepción que se pasa a UrlRequest.Callback.onFailed() cuando Cronet no puede procesar una solicitud de red. En este caso, se pueden usar getErrorCode y getCronetInternalErrorCode para obtener más información sobre el tipo específico de falla. Si getErrorCode devuelve ERROR_QUIC_PROTOCOL_FAILED, esta excepción se puede convertir en un QuicException que puede proporcionar más detalles.

Resumen

Constantes

static final int

Es el código de error que indica que no se puede acceder a la dirección IP con la que se intenta establecer contacto, lo que significa que no hay una ruta al host o la red especificados.

static final int

Es el código de error que indica que la conexión se cerró de forma inesperada.

static final int

Es el código de error que indica que se rechazó el intento de conexión.

static final int

Código de error que indica que la conexión se restableció de forma inesperada.

static final int

Es el código de error que indica que se agotó el tiempo de espera del intento de conexión.

static final int

Es el código de error que indica que no se pudo resolver la dirección IP del host al que se envió la solicitud.

static final int

Código de error que indica que el dispositivo no estaba conectado a ninguna red.

static final int

Es el código de error que indica que, mientras se procesaba la solicitud, cambió la configuración de la red.

static final int

Código de error que indica que se produjo otro tipo de error.

static final int

Es el código de error que indica un error relacionado con el protocolo QUIC.

static final int

Es el código de error que indica que se agotó el tiempo de espera.

Constructores protegidos

NetworkException(String message, Throwable cause)

Construye una excepción causada por un error de red.

Métodos públicos

abstract int

Devuelve un código de error interno de Cronet.

abstract int

Devuelve el código de error, uno de los siguientes: ERROR_*.

abstract boolean

Devuelve true si reintentar esta solicitud de inmediato podría tener éxito y false en caso contrario.

Métodos heredados

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

Constantes

ERROR_ADDRESS_UNREACHABLE

public static final int ERROR_ADDRESS_UNREACHABLE = 9

Es el código de error que indica que no se puede acceder a la dirección IP con la que se intenta establecer contacto, lo que significa que no hay una ruta al host o la red especificados.

ERROR_CONNECTION_CLOSED

public static final int ERROR_CONNECTION_CLOSED = 5

Es el código de error que indica que la conexión se cerró de forma inesperada.

ERROR_CONNECTION_REFUSED

public static final int ERROR_CONNECTION_REFUSED = 7

Es el código de error que indica que se rechazó el intento de conexión.

ERROR_CONNECTION_RESET

public static final int ERROR_CONNECTION_RESET = 8

Código de error que indica que la conexión se restableció de forma inesperada.

ERROR_CONNECTION_TIMED_OUT

public static final int ERROR_CONNECTION_TIMED_OUT = 6

Es el código de error que indica que se agotó el tiempo de espera del intento de conexión.

ERROR_HOSTNAME_NOT_RESOLVED

public static final int ERROR_HOSTNAME_NOT_RESOLVED = 1

Es el código de error que indica que no se pudo resolver la dirección IP del host al que se envió la solicitud.

ERROR_INTERNET_DISCONNECTED

public static final int ERROR_INTERNET_DISCONNECTED = 2

Código de error que indica que el dispositivo no estaba conectado a ninguna red.

ERROR_NETWORK_CHANGED

public static final int ERROR_NETWORK_CHANGED = 3

Es el código de error que indica que, mientras se procesaba la solicitud, cambió la configuración de la red. Cuando getErrorCode devuelve este código, esta excepción se puede convertir en QuicException para obtener más información si se usa el protocolo QUIC.

ERROR_OTHER

public static final int ERROR_OTHER = 11

Código de error que indica que se produjo otro tipo de error. Se puede consultar getCronetInternalErrorCode para obtener una causa más específica.

ERROR_QUIC_PROTOCOL_FAILED

public static final int ERROR_QUIC_PROTOCOL_FAILED = 10

Es el código de error que indica un error relacionado con el protocolo QUIC. Cuando getErrorCode devuelve este código, esta excepción se puede convertir en QuicException para obtener más información.

ERROR_TIMED_OUT

public static final int ERROR_TIMED_OUT = 4

Es el código de error que indica que se agotó el tiempo de espera. Los tiempos de espera que vencen mientras se intenta conectar se informarán como el ERROR_CONNECTION_TIMED_OUT más específico.

Constructores protegidos

NetworkException

protected NetworkException(String message, Throwable cause)

Construye una excepción causada por un error de red.

Parámetros
String message

Explicación de la falla.

Throwable cause

Es la causa (que se guarda para su posterior recuperación con el método getCause()). Se permite un valor nulo, que indica que la causa no existe o es desconocida.

Métodos públicos

getCronetInternalErrorCode

public abstract int getCronetInternalErrorCode()

Devuelve un código de error interno de Cronet. Esto puede proporcionar un diagnóstico de errores más específico que getErrorCode, pero los valores constantes no se exponen a Java y pueden cambiar con el tiempo. Consulta aquí la lista de valores más reciente.

Muestra
int

Es el código de error interno de Cronet.

getErrorCode

public abstract int getErrorCode()

Devuelve el código de error, uno de los siguientes: ERROR_*.

Muestra
int

Código de error, uno de ERROR_*.

immediatelyRetryable

public abstract boolean immediatelyRetryable()

Devuelve true si reintentar esta solicitud de inmediato podría tener éxito y false en caso contrario. Por ejemplo, devuelve true cuando getErrorCode devuelve ERROR_NETWORK_CHANGED porque intentar la solicitud podría tener éxito con la nueva configuración de red, pero false cuando getErrorCode() devuelve ERROR_INTERNET_DISCONNECTED porque volver a intentar la solicitud de inmediato generará el mismo error (en cambio, se debe retrasar el reintento hasta que el dispositivo recupere la conectividad de red).

Muestra
boolean

true si reintentar esta solicitud de inmediato podría tener éxito; de lo contrario, false.