NetworkException

public abstract class NetworkException extends CronetException

Sous-classes directes connues
QuicException

Sous-classe de NetworkException qui contient un code d'erreur QUIC détaillé provenant de QuicErrorCode.


Exception transmise à UrlRequest.Callback.onFailed() lorsque Cronet ne parvient pas à traiter une requête réseau. Dans ce cas, vous pouvez utiliser getErrorCode et getCronetInternalErrorCode pour obtenir plus d'informations sur le type d'échec spécifique. Si getErrorCode renvoie ERROR_QUIC_PROTOCOL_FAILED, cette exception peut être convertie en QuicException, qui peut fournir des informations supplémentaires.

Résumé

Constantes

static final int

Code d'erreur indiquant que l'adresse IP contactée est inaccessible, ce qui signifie qu'il n'existe aucun itinéraire vers l'hôte ou le réseau spécifié.

static final int

Code d'erreur indiquant que la connexion a été fermée de manière inattendue.

static final int

Code d'erreur indiquant que la tentative de connexion a été refusée.

static final int

Code d'erreur indiquant que la connexion a été réinitialisée de manière inattendue.

static final int

Code d'erreur indiquant que la tentative de connexion a expiré.

static final int

Code d'erreur indiquant que l'hôte auquel la requête est envoyée n'a pas pu être résolu en adresse IP.

static final int

Code d'erreur indiquant que l'appareil n'était connecté à aucun réseau.

static final int

Code d'erreur indiquant que la configuration réseau a changé lors du traitement de la demande.

static final int

Code d'erreur indiquant qu'un autre type d'erreur a été rencontré.

static final int

Code d'erreur indiquant un problème lié au protocole QUIC.

static final int

Code d'erreur indiquant qu'un délai a expiré.

Constructeurs protégés

NetworkException(String message, Throwable cause)

Construit une exception provoquée par une erreur réseau.

Méthodes publiques

abstract int

Renvoie un code d'erreur interne Cronet.

abstract int

Renvoie un code d'erreur (ERROR_*).

abstract boolean

Renvoie true si une nouvelle tentative immédiate de cette requête peut aboutir, ou false dans le cas contraire.

Méthodes héritées

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

Code d'erreur indiquant que l'adresse IP contactée est inaccessible, ce qui signifie qu'il n'existe aucun itinéraire vers l'hôte ou le réseau spécifié.

ERROR_CONNECTION_CLOSED

public static final int ERROR_CONNECTION_CLOSED = 5

Code d'erreur indiquant que la connexion a été fermée de manière inattendue.

ERROR_CONNECTION_REFUSED

public static final int ERROR_CONNECTION_REFUSED = 7

Code d'erreur indiquant que la tentative de connexion a été refusée.

ERROR_CONNECTION_RESET

public static final int ERROR_CONNECTION_RESET = 8

Code d'erreur indiquant que la connexion a été réinitialisée de manière inattendue.

ERROR_CONNECTION_TIMED_OUT

public static final int ERROR_CONNECTION_TIMED_OUT = 6

Code d'erreur indiquant que la tentative de connexion a expiré.

ERROR_HOSTNAME_NOT_RESOLVED

public static final int ERROR_HOSTNAME_NOT_RESOLVED = 1

Code d'erreur indiquant que l'hôte auquel la requête est envoyée n'a pas pu être résolu en adresse IP.

ERROR_INTERNET_DISCONNECTED

public static final int ERROR_INTERNET_DISCONNECTED = 2

Code d'erreur indiquant que l'appareil n'était connecté à aucun réseau.

ERROR_NETWORK_CHANGED

public static final int ERROR_NETWORK_CHANGED = 3

Code d'erreur indiquant que la configuration réseau a changé lors du traitement de la demande. Lorsque getErrorCode renvoie ce code, cette exception peut être convertie en QuicException pour obtenir plus d'informations si le protocole QUIC est utilisé.

ERROR_OTHER

public static final int ERROR_OTHER = 11

Code d'erreur indiquant qu'un autre type d'erreur a été rencontré. Vous pouvez consulter getCronetInternalErrorCode pour obtenir une cause plus spécifique.

ERROR_QUIC_PROTOCOL_FAILED

public static final int ERROR_QUIC_PROTOCOL_FAILED = 10

Code d'erreur indiquant un problème lié au protocole QUIC. Lorsque getErrorCode renvoie ce code, cette exception peut être convertie en QuicException pour plus d'informations.

ERROR_TIMED_OUT

public static final int ERROR_TIMED_OUT = 4

Code d'erreur indiquant qu'un délai a expiré. Les délais avant expiration lors de la tentative de connexion seront signalés comme ERROR_CONNECTION_TIMED_OUT, qui est plus spécifique.

Constructeurs protégés

NetworkException

protected NetworkException(String message, Throwable cause)

Construit une exception provoquée par une erreur réseau.

Paramètres
String message

une explication de l'échec.

Throwable cause

la cause (qui est enregistrée pour être récupérée ultérieurement par la méthode getCause()). Une valeur nulle est autorisée et indique que la cause est inexistante ou inconnue.

Méthodes publiques

getCronetInternalErrorCode

public abstract int getCronetInternalErrorCode()

Renvoie un code d'erreur interne Cronet. Cela peut fournir un diagnostic d'erreur plus spécifique que getErrorCode, mais les valeurs constantes ne sont pas exposées à Java et peuvent changer au fil du temps. Pour obtenir la dernière liste des valeurs, cliquez ici.

Renvoie
int

Code d'erreur interne de Cronet.

getErrorCode

public abstract int getErrorCode()

Renvoie un code d'erreur (ERROR_*).

Renvoie
int

Code d'erreur, l'un des codes suivants : ERROR_*.

immediatelyRetryable

public abstract boolean immediatelyRetryable()

Renvoie true si une nouvelle tentative immédiate de cette requête peut aboutir, ou false dans le cas contraire. Par exemple, true est renvoyé lorsque getErrorCode renvoie ERROR_NETWORK_CHANGED, car la requête peut aboutir avec la nouvelle configuration réseau, mais false est renvoyé lorsque getErrorCode() renvoie ERROR_INTERNET_DISCONNECTED, car une nouvelle tentative immédiate de la requête rencontrera le même échec (au lieu de cela, la nouvelle tentative doit être retardée jusqu'à ce que l'appareil retrouve la connectivité réseau).

Renvoie
boolean

true si une nouvelle tentative immédiate de cette requête peut aboutir, false dans le cas contraire.