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.Callbackimplementieren, kann Ihre App Updates zum Fortschritt der Anfrage erhalten. Sie können die Callback-Methoden implementieren, um Methoden desUrlRequest-Objekts aufzurufen, die den Lebenszyklus von einem Zustand in einen anderen überführen.
In der folgenden Liste wird der Ablauf des UrlRequest-Lebenszyklus beschrieben:
- Der Lebenszyklus befindet sich im Status Gestartet, nachdem Ihre App die Methode
start()aufgerufen hat. - 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 MethodeonCanceled()weitergeleitet. Dort kann die App zusätzliche Vorgänge ausführen, bevor die Anfrage in den endgültigen Status Abgebrochen wechselt.
- Folgen Sie der Weiterleitung mit
- 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 Methoderead()aufrufen, um zu versuchen, einen Teil des Antworttexts zu lesen. Nachdem Ihre Appread()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 Methoderead()noch einmal aufrufen, um den Antworttext weiter zu lesen. Die App kann das Lesen der Anfrage auch mit der Methodecancel()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.
- Der Lesevorgang ist erfolgreich und es sind weitere Daten verfügbar. Cronet ruft die Methode
Das folgende Diagramm zeigt den Lebenszyklus eines UrlRequest-Objekts:
Lebenszyklus einer Cronet-Anfrage
| Legend | |
|---|---|
UrlRequest-Methoden |