NetworkException

public abstract class NetworkException extends CronetException

Subclasses diretas conhecidas
QuicException

Subclasse de NetworkException que contém um código de erro QUIC detalhado de QuicErrorCode.


Exceção transmitida a UrlRequest.Callback.onFailed() quando a Cronet não consegue processar uma solicitação de rede. Nesse caso, getErrorCode e getCronetInternalErrorCode podem ser usados para mais informações sobre o tipo específico de falha. Se getErrorCode retornar ERROR_QUIC_PROTOCOL_FAILED, essa exceção poderá ser convertida em um QuicException, que pode fornecer mais detalhes.

Resumo

Constantes

static final int

Código de erro que indica que o endereço IP contatado está inacessível, ou seja, não há uma rota para o host ou a rede especificada.

static final int

Código de erro que indica que a conexão foi fechada inesperadamente.

static final int

Código de erro que indica que a tentativa de conexão foi recusada.

static final int

Código de erro que indica que a conexão foi redefinida inesperadamente.

static final int

Código de erro que indica que o tempo da tentativa de conexão expirou.

static final int

Código de erro que indica que não foi possível resolver o host para um endereço IP.

static final int

Código de erro que indica que o dispositivo não estava conectado a nenhuma rede.

static final int

Código de erro que indica que, à medida que a solicitação era processada, a configuração de rede mudou.

static final int

Código de erro que indica que outro tipo de erro foi encontrado.

static final int

Código de erro que indica um erro relacionado ao protocolo QUIC.

static final int

Código de erro que indica que um tempo limite expirou.

Construtores protegidos

NetworkException(String message, Throwable cause)

Cria uma exceção causada por um erro de rede.

Métodos públicos

abstract int

Retorna um código de erro interno do Cronet.

abstract int

Retorna o código de erro, um dos ERROR_*.

abstract boolean

Retorna true se tentar novamente essa solicitação imediatamente pode dar certo. Caso contrário, retorna false.

Métodos herdados

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

Código de erro que indica que o endereço IP contatado está inacessível, ou seja, não há uma rota para o host ou a rede especificada.

ERROR_CONNECTION_CLOSED

public static final int ERROR_CONNECTION_CLOSED = 5

Código de erro que indica que a conexão foi fechada inesperadamente.

ERROR_CONNECTION_REFUSED

public static final int ERROR_CONNECTION_REFUSED = 7

Código de erro que indica que a tentativa de conexão foi recusada.

ERROR_CONNECTION_RESET

public static final int ERROR_CONNECTION_RESET = 8

Código de erro que indica que a conexão foi redefinida inesperadamente.

ERROR_CONNECTION_TIMED_OUT

public static final int ERROR_CONNECTION_TIMED_OUT = 6

Código de erro que indica que o tempo da tentativa de conexão expirou.

ERROR_HOSTNAME_NOT_RESOLVED

public static final int ERROR_HOSTNAME_NOT_RESOLVED = 1

Código de erro que indica que não foi possível resolver o host para um endereço IP.

ERROR_INTERNET_DISCONNECTED

public static final int ERROR_INTERNET_DISCONNECTED = 2

Código de erro que indica que o dispositivo não estava conectado a nenhuma rede.

ERROR_NETWORK_CHANGED

public static final int ERROR_NETWORK_CHANGED = 3

Código de erro que indica que, à medida que a solicitação era processada, a configuração de rede mudou. Quando getErrorCode retorna esse código, a exceção pode ser transmitida para QuicException para mais informações se o protocolo QUIC for usado.

ERROR_OTHER

public static final int ERROR_OTHER = 11

Código de erro que indica que outro tipo de erro foi encontrado. Consulte getCronetInternalErrorCode para saber uma causa mais específica.

ERROR_QUIC_PROTOCOL_FAILED

public static final int ERROR_QUIC_PROTOCOL_FAILED = 10

Código de erro que indica um erro relacionado ao protocolo QUIC. Quando getErrorCode retorna esse código, a exceção pode ser convertida em QuicException para mais informações.

ERROR_TIMED_OUT

public static final int ERROR_TIMED_OUT = 4

Código de erro que indica que um tempo limite expirou. Os tempos limite que expiram ao tentar se conectar serão informados como o ERROR_CONNECTION_TIMED_OUT mais específico.

Construtores protegidos

NetworkException

protected NetworkException(String message, Throwable cause)

Cria uma exceção causada por um erro de rede.

Parâmetros
String message

explicação da falha.

Throwable cause

a causa, que é salva para ser extraída mais tarde pelo método getCause(). Um valor nulo é permitido e indica que a causa é inexistente ou desconhecida.

Métodos públicos

getCronetInternalErrorCode

public abstract int getCronetInternalErrorCode()

Retorna um código de erro interno do Cronet. Isso pode fornecer um diagnóstico de erro mais específico do que getErrorCode, mas os valores constantes não são expostos ao Java e podem mudar com o tempo. Consulte aqui para conferir a lista mais recente de valores.

Retorna
int

Código de erro interno do Cronet.

getErrorCode

public abstract int getErrorCode()

Retorna o código de erro, um dos ERROR_*.

Retorna
int

código de erro, um de ERROR_*.

immediatelyRetryable

public abstract boolean immediatelyRetryable()

Retorna true se tentar novamente essa solicitação imediatamente pode dar certo. Caso contrário, retorna false. Por exemplo, retorna true quando getErrorCode retorna ERROR_NETWORK_CHANGED porque tentar a solicitação pode ter êxito usando a nova configuração de rede, mas false quando getErrorCode() retorna ERROR_INTERNET_DISCONNECTED porque tentar a solicitação imediatamente vai encontrar a mesma falha. Em vez disso, a nova tentativa deve ser adiada até que o dispositivo recupere a conectividade de rede.

Retorna
boolean

true se tentar novamente a solicitação imediatamente pode dar certo. Caso contrário, false.