NetworkException

public abstract class NetworkException extends CronetException

Sottoclassi dirette note
QuicException

Sottoclasse di NetworkException che contiene un codice di errore QUIC dettagliato di QuicErrorCode.


Eccezione passata a UrlRequest.Callback.onFailed() quando Cronet non riesce a elaborare una richiesta di rete. In questo caso, è possibile utilizzare getErrorCode e getCronetInternalErrorCode per ottenere maggiori informazioni sul tipo specifico di errore. Se getErrorCode restituisce ERROR_QUIC_PROTOCOL_FAILED, questa eccezione può essere convertita in un QuicException che può fornire ulteriori dettagli.

Riepilogo

Costanti

static final int

Codice di errore che indica che l'indirizzo IP contattato non è raggiungibile, il che significa che non esiste una route per l'host o la rete specificati.

static final int

Codice di errore che indica che la connessione è stata chiusa in modo imprevisto.

static final int

Codice di errore che indica che il tentativo di connessione è stato rifiutato.

static final int

Codice di errore che indica che la connessione è stata reimpostata in modo imprevisto.

static final int

Codice di errore che indica che il tentativo di connessione è scaduto.

static final int

Codice di errore che indica che l'host a cui viene inviata la richiesta non è stato risolto in un indirizzo IP.

static final int

Codice di errore che indica che il dispositivo non era connesso a nessuna rete.

static final int

Codice di errore che indica che durante l'elaborazione della richiesta la configurazione di rete è cambiata.

static final int

Codice di errore che indica che si è verificato un altro tipo di errore.

static final int

Codice di errore che indica un errore relativo al protocollo QUIC.

static final int

Codice di errore che indica la scadenza di un timeout.

Scuderie protette

NetworkException(String message, Throwable cause)

Crea un'eccezione causata da un errore di rete.

Metodi pubblici

abstract int

Restituisce un codice di errore interno di Cronet.

abstract int

Restituisce il codice di errore, uno dei seguenti: ERROR_*.

abstract boolean

Restituisce true se il nuovo tentativo di invio della richiesta potrebbe riuscire, false in caso contrario.

Metodi ereditati

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

Costanti

ERROR_ADDRESS_UNREACHABLE

public static final int ERROR_ADDRESS_UNREACHABLE = 9

Codice di errore che indica che l'indirizzo IP contattato non è raggiungibile, il che significa che non esiste una route per l'host o la rete specificati.

ERROR_CONNECTION_CLOSED

public static final int ERROR_CONNECTION_CLOSED = 5

Codice di errore che indica che la connessione è stata chiusa in modo imprevisto.

ERROR_CONNECTION_REFUSED

public static final int ERROR_CONNECTION_REFUSED = 7

Codice di errore che indica che il tentativo di connessione è stato rifiutato.

ERROR_CONNECTION_RESET

public static final int ERROR_CONNECTION_RESET = 8

Codice di errore che indica che la connessione è stata reimpostata in modo imprevisto.

ERROR_CONNECTION_TIMED_OUT

public static final int ERROR_CONNECTION_TIMED_OUT = 6

Codice di errore che indica che il tentativo di connessione è scaduto.

ERROR_HOSTNAME_NOT_RESOLVED

public static final int ERROR_HOSTNAME_NOT_RESOLVED = 1

Codice di errore che indica che l'host a cui viene inviata la richiesta non è stato risolto in un indirizzo IP.

ERROR_INTERNET_DISCONNECTED

public static final int ERROR_INTERNET_DISCONNECTED = 2

Codice di errore che indica che il dispositivo non era connesso a nessuna rete.

ERROR_NETWORK_CHANGED

public static final int ERROR_NETWORK_CHANGED = 3

Codice di errore che indica che durante l'elaborazione della richiesta la configurazione di rete è cambiata. Quando getErrorCode restituisce questo codice, questa eccezione può essere eseguita il cast a QuicException per ulteriori informazioni se viene utilizzato il protocollo QUIC.

ERROR_OTHER

public static final int ERROR_OTHER = 11

Codice di errore che indica che si è verificato un altro tipo di errore. getCronetInternalErrorCode può essere consultato per ottenere una causa più specifica.

ERROR_QUIC_PROTOCOL_FAILED

public static final int ERROR_QUIC_PROTOCOL_FAILED = 10

Codice di errore che indica un errore relativo al protocollo QUIC. Quando getErrorCode restituisce questo codice, questa eccezione può essere convertita in QuicException per ulteriori informazioni.

ERROR_TIMED_OUT

public static final int ERROR_TIMED_OUT = 4

Codice di errore che indica la scadenza di un timeout. I timeout che scadono durante il tentativo di connessione verranno segnalati come ERROR_CONNECTION_TIMED_OUT più specifico.

Costruttori protetti

NetworkException

protected NetworkException(String message, Throwable cause)

Crea un'eccezione causata da un errore di rete.

Parametri
String message

spiegazione dell'errore.

Throwable cause

la causa (che viene salvata per essere recuperata in un secondo momento dal metodo getCause()). È consentito un valore nullo, che indica che la causa non esiste o è sconosciuta.

Metodi pubblici

getCronetInternalErrorCode

public abstract int getCronetInternalErrorCode()

Restituisce un codice di errore interno di Cronet. In questo modo, è possibile ottenere una diagnosi degli errori più specifica rispetto a getErrorCode, ma i valori costanti non sono esposti a Java e potrebbero cambiare nel tempo. Consulta questa pagina per l'elenco più recente dei valori.

Resi
int

Codice di errore interno di Cronet.

getErrorCode

public abstract int getErrorCode()

Restituisce il codice di errore, uno dei seguenti: ERROR_*.

Resi
int

codice di errore, uno dei seguenti: ERROR_*.

immediatelyRetryable

public abstract boolean immediatelyRetryable()

Restituisce true se il nuovo tentativo di invio della richiesta potrebbe riuscire, false in caso contrario. Ad esempio, restituisce true quando getErrorCode restituisce ERROR_NETWORK_CHANGED perché il tentativo di richiesta potrebbe riuscire utilizzando la nuova configurazione di rete, ma false quando getErrorCode() restituisce ERROR_INTERNET_DISCONNECTED perché il nuovo tentativo di richiesta immediato riscontrerà lo stesso errore (invece il nuovo tentativo dovrebbe essere ritardato fino a quando il dispositivo non riacquisisce la connettività di rete).

Resi
boolean

true se il nuovo tentativo di invio della richiesta potrebbe avere esito positivo, false altrimenti.