Cronet-Anfragelebenszyklus

Hier erfahren Sie mehr über den Lebenszyklus von Anfragen, die mit Cronet erstellt wurden, und wie Sie sie mit den von der Bibliothek bereitgestellten Callback-Methoden verwalten.

Lebenszyklus – Übersicht

Die Klasse UrlRequest stellt Netzwerkanfragen dar, die mit der Cronet-Bibliothek erstellt wurden. Die folgenden Konzepte sind wichtig, um den Lebenszyklus von UrlRequest zu verstehen:

Bundesstaaten
Ein Status ist der Zustand, in dem sich die Anfrage zu einem bestimmten Zeitpunkt befindet. UrlRequest-Objekte, die mit der Cronet-Bibliothek erstellt wurden, durchlaufen in ihrem Lebenszyklus verschiedene Status. Der Lebenszyklus einer Anfrage umfasst einen Anfangszustand sowie mehrere Übergangs- und Endzustände.
UrlRequest-Methoden
Clients können je nach Status bestimmte Methoden für UrlRequest-Objekte aufrufen. Die Methoden verschieben die Anfrage von einem Status in einen anderen.
Callback-Methoden
Wenn Sie Methoden der Klasse UrlRequest.Callback implementieren, kann Ihre App Updates zum Fortschritt der Anfrage erhalten. Sie können die Callback-Methoden implementieren, um Methoden des UrlRequest-Objekts aufzurufen, die den Lebenszyklus von einem Zustand in einen anderen überführen.

In der folgenden Liste wird der Ablauf des UrlRequest-Lebenszyklus beschrieben:

  1. Der Lebenszyklus befindet sich im Status Gestartet, nachdem Ihre App die Methode start() aufgerufen hat.
  2. Der Server sendet möglicherweise eine Weiterleitungsantwort, die den Ablauf zur Methode onRedirectReceived() führt. Bei dieser Methode können Sie eine der folgenden Clientaktionen ausführen:
    • Folgen Sie der Weiterleitung mit followRedirect(). Mit dieser Methode wird die Anfrage wieder in den Status Gestartet versetzt.
    • Brechen Sie die Anfrage mit cancel() ab. Mit dieser Methode wird die Anfrage an die Methode onCanceled() weitergeleitet. Dort kann die App zusätzliche Vorgänge ausführen, bevor die Anfrage in den endgültigen Status Abgebrochen wechselt.
  3. Nachdem die App alle Weiterleitungen ausgeführt hat, sendet der Server die Antwortheader und Cronet ruft die Methode onResponseStarted() auf. Die Anfrage befindet sich im Status Warten auf read(). Die App muss die Methode read() aufrufen, um zu versuchen, einen Teil des Antworttexts zu lesen. Nachdem Ihre App read() aufgerufen hat, befindet sich die Anfrage im Status Lesen. Dabei sind die folgenden Ergebnisse möglich:
    • Der Lesevorgang ist erfolgreich und es sind weitere Daten verfügbar. Cronet ruft die Methode onReadCompleted() auf und die Anfrage befindet sich wieder im Status Warten auf read(). Die App kann die Methode read() noch einmal aufrufen, um den Antworttext weiter zu lesen. Die App kann das Lesen der Anfrage auch mit der Methode cancel() beenden.
    • Der Lesevorgang ist erfolgreich und es sind keine weiteren Daten verfügbar. Cronet ruft die Methode onSucceeded() auf und die Anfrage befindet sich im Endstatus Erfolgreich.
    • Die Leseaktion schlägt fehl. Cronet ruft die Methode onFailed() auf und der endgültige Status der Anfrage ist Fehlgeschlagen.

Das folgende Diagramm zeigt den Lebenszyklus eines UrlRequest-Objekts:

Diagramm des Lebenszyklus einer Cronet-Anfrage
Lebenszyklus einer Cronet-Anfrage

Legend
Cronet-Legende für Ausgangsstatus Ausgangsstatus Symbol für die Legende des Cronet-Endstatus Endgültiger Status
Symbol für die Legende des Cronet-Übergangsstatus-Übergangsstatus Symbol für die Legende der Cronet-Callback-Methoden Callback-Methoden
Symbol für die Legende der Cronet-Clientaktion UrlRequest-Methoden