UrlRequest

public abstract class UrlRequest


Contrôle une requête HTTP (GET, PUT, POST, etc.). Créé par UrlRequest.Builder, qui peut être obtenu en appelant newUrlRequestBuilder. Remarque : Toutes les méthodes doivent être appelées sur l'Executor transmis à newUrlRequestBuilder.

Résumé

Types imbriqués

public abstract class UrlRequest.Builder

Compilateur pour les UrlRequest.

public abstract class UrlRequest.Callback

Les utilisateurs de Cronet étendent cette classe pour recevoir des rappels indiquant la progression d'une UrlRequest en cours de traitement.

Annotation pour les API qui ne sont pas encore considérées comme stables.

public class UrlRequest.Status

Valeurs d'état de la requête renvoyées par getStatus.

public abstract class UrlRequest.StatusListener

Classe d'écouteur utilisée avec getStatus pour recevoir l'état d'une UrlRequest.

Constructeurs publics

Méthodes publiques

abstract void

Annule la requête.

abstract void

Suit une redirection en attente.

abstract void

Interroge l'état de la requête.

abstract boolean

Renvoie true si la requête a démarré correctement et est maintenant terminée (terminée, annulée ou ayant échoué).

abstract void
read(ByteBuffer buffer)

Tente de lire une partie du corps de la réponse dans le tampon fourni.

abstract void

Démarre la requête. Tous les rappels sont envoyés à Callback.

Constructeurs publics

UrlRequest

public UrlRequest()

Méthodes publiques

annuler

public abstract void cancel()

Annule la requête. Peut être appelé à tout moment. onCanceled() est appelé lorsque l'annulation est terminée et qu'aucune autre méthode de rappel n'est appelée. Si la requête est terminée ou n'a pas démarré, l'appel de cancel() n'a aucun effet et onCanceled() n'est pas appelé. Si le Executor transmis lors de la construction de UrlRequest exécute des tâches sur un seul thread et que cancel() est appelé sur ce thread, aucune méthode de rappel (à l'exception de onCanceled()) n'est appelée après l'appel de cancel(). Sinon, au maximum une méthode de rappel peut être appelée une fois cancel() terminé.

followRedirect

public abstract void followRedirect()

Suit une redirection en attente. Ne doit être appelé qu'une seule fois au maximum pour chaque appel de onRedirectReceived().

getStatus

public abstract void getStatus(UrlRequest.StatusListener listener)

Interroge l'état de la requête.

Paramètres
UrlRequest.StatusListener listener

Un StatusListener qui sera appelé avec l'état actuel de la requête. listener sera rappelé sur l'Executor transmis lors de la création de la requête.

isDone

public abstract boolean isDone()

Renvoie true si la requête a démarré correctement et est maintenant terminée (terminée, annulée ou ayant échoué).

Renvoie
boolean

true si la requête a démarré correctement et est maintenant terminée (terminée, annulée ou ayant échoué).

read

public abstract void read(ByteBuffer buffer)

Tente de lire une partie du corps de la réponse dans le tampon fourni. Ne doit être appelé qu'une seule fois au maximum en réponse à chaque appel des méthodes onResponseStarted() et onReadCompleted() du Callback. Chaque appel entraîne un appel asynchrone à la méthode Callback'sonReadCompleted() si des données sont lues, à sa méthode onSucceeded() s'il n'y a plus de données à lire ou à sa méthode onFailed() en cas d'erreur.

Paramètres
ByteBuffer buffer

ByteBuffer dans lequel écrire le corps de la réponse. Doit être un ByteBuffer direct. L'intégrateur ne doit pas lire ni modifier la position, la limite ou les données du tampon entre sa position et sa limite tant que la requête n'a pas rappelé le Callback.

démarrer

public abstract void start()

Démarre la requête. Tous les rappels sont envoyés à Callback. Ne peut être appelé qu'une seule fois. Ne peut pas être appelé si cancel a été appelé.