Dowiedz się więcej o cyklu życia żądań utworzonych za pomocą Cronet i o tym, jak nimi zarządzać za pomocą metod wywołania zwrotnego udostępnianych przez bibliotekę.
Przegląd cyklu życia
Klasa UrlRequest reprezentuje żądania sieciowe utworzone za pomocą biblioteki Cronet. Aby zrozumieć cykl życia UrlRequest, musisz znać te pojęcia:
- States
- Stan to konkretny warunek, w którym żądanie znajduje się w określonym czasie.
Obiekty
UrlRequestutworzone za pomocą biblioteki Cronet przechodzą przez różne stany w swoim cyklu życia. Cykl życia żądania obejmuje stan początkowy oraz wiele stanów przejściowych i końcowych. - Metody
UrlRequest - Klienci mogą wywoływać określone metody na obiektach
UrlRequestw zależności od stanu. The methods move the request from one state to another. - Metody
Callback - Dzięki wdrożeniu metod klasy
UrlRequest.Callbackaplikacja może otrzymywać aktualizacje dotyczące postępu żądania. Możesz zaimplementować metody wywołania zwrotnego, aby wywoływać metody obiektuUrlRequest, które zmieniają stan cyklu życia.
Poniższa lista opisuje cykl życia UrlRequest:
- Cykl życia jest w stanie Rozpoczęty po wywołaniu przez aplikację metody
start(). - Serwer może wysłać odpowiedź przekierowania, która przekierowuje do metody
onRedirectReceived(). W tej metodzie możesz wykonać jedno z tych działań klienta:- Przejdź do przekierowania za pomocą
followRedirect(). Ta metoda przywraca stan Rozpoczęto. - Anuluj prośbę za pomocą
cancel(). Ta metoda przekazuje żądanie do metodyonCanceled(), w której aplikacja może wykonać dodatkowe operacje, zanim żądanie przejdzie do stanu końcowego Anulowano.
- Przejdź do przekierowania za pomocą
- Gdy aplikacja przejdzie przez wszystkie przekierowania, serwer wysyła nagłówki odpowiedzi, a Cronet wywołuje metodę
onResponseStarted(). Żądanie jest w stanie Oczekiwanie na read(). Aplikacja musi wywołać metodęread(), aby spróbować odczytać część treści odpowiedzi. Gdy aplikacja wywoła metodęread(), żądanie będzie miało stan Odczyt, który może mieć następujące wyniki:- Odczyt się powiódł i dostępnych jest więcej danych. Cronet wywołuje metodę
onReadCompleted(), a żądanie ponownie przechodzi w stan Oczekiwanie na read(). Aplikacja może ponownie wywołać metodęread(), aby kontynuować odczytywanie treści odpowiedzi. Aplikacja może też przestać odczytywać żądanie, używając metodycancel(). - Działanie odczytu zakończyło się powodzeniem i nie ma już dostępnych danych. Cronet wywołuje metodę
onSucceeded(), a żądanie jest w stanie końcowym Succeeded. - Działanie odczytu się nie powiedzie. Cronet wywołuje metodę
onFailed(), a stanem końcowym żądania jest Failed.
- Odczyt się powiódł i dostępnych jest więcej danych. Cronet wywołuje metodę
Poniższy diagram przedstawia cykl życia obiektu UrlRequest:
Cykl życia żądania Cronet
| Legenda | |
|---|---|
| Stan początkowy: |
Stan końcowy: |
| Stan przejściowy |
|
UrlRequest |