Cykl życia żądania Cronet

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 UrlRequest utworzone 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 UrlRequest w zależności od stanu. The methods move the request from one state to another.
Metody Callback
Dzięki wdrożeniu metod klasy UrlRequest.Callback aplikacja może otrzymywać aktualizacje dotyczące postępu żądania. Możesz zaimplementować metody wywołania zwrotnego, aby wywoływać metody obiektu UrlRequest, które zmieniają stan cyklu życia.

Poniższa lista opisuje cykl życia UrlRequest:

  1. Cykl życia jest w stanie Rozpoczęty po wywołaniu przez aplikację metody start().
  2. 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 metody onCanceled(), w której aplikacja może wykonać dodatkowe operacje, zanim żądanie przejdzie do stanu końcowego Anulowano.
  3. 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 metody cancel().
    • 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.

Poniższy diagram przedstawia cykl życia obiektu UrlRequest:

Diagram cyklu życia żądania Cronet
Cykl życia żądania Cronet

Legenda
Stan początkowy: Ikona legendy stanu początkowego Cronet Stan końcowy: Ikona legendy stanu końcowego Cronet
Stan przejściowy Ikona legendy stanu przejściowego Cronet Ikona legendy metod wywołania zwrotnego Cronet metoda wywołania zwrotnego
Ikona legendy działania klienta Cronet metoda UrlRequest