ImplicitFlowControlCallback

public abstract class ImplicitFlowControlCallback extends UrlRequest.Callback

Znane bezpośrednie podklasy
InMemoryTransformCronetCallback

Abstrakcyjne wywołanie zwrotne Croneta, które odczytuje całą treść do pamięci i opcjonalnie deserializuje ją przed przekazaniem jej z powrotem do podmiotu wysyłającego żądanie HTTP.

Znane podklasy pośrednie
ByteArrayCronetCallback

Specjalizacja InMemoryTransformCronetCallback, która zwraca bajty treści w dosłownym brzmieniu bez interpretacji.

JsonCronetCallback

Specjalizacja klasy InMemoryTransformCronetCallback, która interpretuje treść odpowiedzi jako JSON.

StringCronetCallback

Specjalizacja InMemoryTransformCronetCallback, która interpretuje treść odpowiedzi jako ciąg znaków.


Implementacja interfejsu UrlRequest.Callback, która ułatwia zarządzanie cyklem życia żądania i automatycznie odczytuje całą odpowiedź.

Podsumowanie

Konstruktory publiczne

Metody publiczne

final void

Wywoływana, jeśli żądanie zostało anulowane za pomocą cancel.

final void
onFailed(
    UrlRequest request,
    UrlResponseInfo info,
    CronetException error
)

Wywoływana, jeśli żądanie nie zostało zrealizowane z jakiegokolwiek powodu po start.

final void
onReadCompleted(
    UrlRequest request,
    UrlResponseInfo info,
    ByteBuffer byteBuffer
)

Wywoływana za każdym razem, gdy odczytana zostanie część treści odpowiedzi.

final void
onRedirectReceived(
    UrlRequest request,
    UrlResponseInfo info,
    String newLocationUrl
)

Wywoływana za każdym razem, gdy napotkane zostanie przekierowanie.

final void

Wywoływana po otrzymaniu ostatecznego zestawu nagłówków po wszystkich przekierowaniach.

final void

Wywoływana, gdy żądanie zostanie zrealizowane.

Metody chronione

abstract void

Wywoływana za każdym razem, gdy odczytana zostanie część treści odpowiedzi.

abstract void

Wywoływana, jeśli żądanie zostało anulowane za pomocą cancel.

abstract void

Wywoływana, jeśli żądanie nie zostało zrealizowane z jakiegokolwiek powodu po start.

abstract void

Wywoływana po otrzymaniu ostatecznego zestawu nagłówków po wszystkich przekierowaniach.

abstract void

Wywoływana, gdy żądanie zostanie zrealizowane.

abstract boolean

Wywoływana za każdym razem, gdy napotkane zostanie przekierowanie.

Konstruktory publiczne

ImplicitFlowControlCallback

public ImplicitFlowControlCallback()

Metody publiczne

onCanceled

public final void onCanceled(UrlRequest request, UrlResponseInfo info)

Wywoływana, jeśli żądanie zostało anulowane za pomocą cancel. Po wywołaniu tej metody nie będą wywoływane żadne inne metody Callback. Domyślna implementacja nie wykonuje żadnych działań.

Parametry
UrlRequest request

Żądanie, które zostało anulowane.

UrlResponseInfo info

Informacje o odpowiedzi. Może wynosić null, jeśli nie otrzymano odpowiedzi.

onFailed

public final void onFailed(
    UrlRequest request,
    UrlResponseInfo info,
    CronetException error
)

Wywoływana, jeśli żądanie nie zostało zrealizowane z jakiegokolwiek powodu po start. Po wywołaniu tej metody nie będą wywoływane żadne inne metody Callback. error zawiera informacje o błędzie.

Parametry
UrlRequest request

Żądanie, które się nie powiodło.

UrlResponseInfo info

Informacje o odpowiedzi. Może wynosić null, jeśli nie otrzymano odpowiedzi.

CronetException error

informacje o błędzie.

onReadCompleted

public final void onReadCompleted(
    UrlRequest request,
    UrlResponseInfo info,
    ByteBuffer byteBuffer
)

Wywoływana za każdym razem, gdy odczytana zostanie część treści odpowiedzi. Może być wypełniona tylko część bufora, nawet jeśli cała treść odpowiedzi nie została jeszcze wykorzystana. Z wyjątkiem onCanceled() żadna inna metoda Callback nie zostanie wywołana w przypadku żądania, w tym onSucceeded()onFailed(), dopóki nie zostanie wywołana funkcja UrlRequest.read(), aby spróbować kontynuować odczytywanie treści odpowiedzi.

Parametry
UrlRequest request

Prośba, która otrzymała dane.

UrlResponseInfo info

Informacje o odpowiedzi.

ByteBuffer byteBuffer

Bufor przekazany do funkcji UrlRequest.read(), który zawiera teraz odebrane dane. Pozycja bufora zostanie zaktualizowana do końca odebranych danych. Limit bufora nie ulegnie zmianie.

Zgłasza
java.lang.Exception

jeśli podczas przetwarzania zakończenia odczytu wystąpi błąd. Wywołana zostanie funkcja onFailed, a przyczyną błędu CallbackException będzie zgłoszony wyjątek.

onRedirectReceived

public final void onRedirectReceived(
    UrlRequest request,
    UrlResponseInfo info,
    String newLocationUrl
)

Wywoływana za każdym razem, gdy napotkane zostanie przekierowanie. Będzie ona wywoływana tylko między wywołaniami funkcji startonResponseStarted(). Treść odpowiedzi przekierowania (jeśli występuje) zostanie zignorowana. Przekierowanie nie zostanie wykonane, dopóki nie zostanie wywołana metoda followRedirect obiektu URLRequest, synchronicznie lub asynchronicznie.

Parametry
UrlRequest request

Poproś o przekierowanie.

UrlResponseInfo info

Informacje o odpowiedzi.

String newLocationUrl

Lokalizacja, do której przekierowywane jest żądanie.

Zgłasza
java.lang.Exception

jeśli podczas przetwarzania przekierowania wystąpi błąd. Wywołana zostanie funkcja onFailed, a przyczyną błędu CallbackException będzie zgłoszony wyjątek.

onResponseStarted

public final void onResponseStarted(UrlRequest request, UrlResponseInfo info)

Wywoływana po otrzymaniu ostatecznego zestawu nagłówków po wszystkich przekierowaniach. Będzie wywoływana tylko raz w przypadku każdego żądania. Z wyjątkiem onCanceled() żadna inna metoda Callback nie zostanie wywołana w przypadku żądania, w tym onSucceeded()onFailed(), dopóki nie zostanie wywołana metoda UrlRequest.read(), aby spróbować rozpocząć odczytywanie treści odpowiedzi.

Parametry
UrlRequest request

Żądanie, które rozpoczęło otrzymywanie odpowiedzi.

UrlResponseInfo info

Informacje o odpowiedzi.

Zgłasza
java.lang.Exception

jeśli podczas przetwarzania odpowiedzi wystąpi błąd. Wywołana zostanie funkcja onFailed, a przyczyną błędu CallbackException będzie zgłoszony wyjątek.

onSucceeded

public final void onSucceeded(UrlRequest request, UrlResponseInfo info)

Wywoływana, gdy żądanie zostanie zrealizowane. Po wywołaniu tej metody nie będą wywoływane żadne inne metody Callback.

Parametry
UrlRequest request

Żądanie, które zostało zrealizowane.

UrlResponseInfo info

Informacje o odpowiedzi.

Metody chronione

onBodyChunkRead

protected abstract void onBodyChunkRead(UrlResponseInfo info, ByteBuffer bodyChunk)

Wywoływana za każdym razem, gdy odczytana zostanie część treści odpowiedzi. Może być wypełniona tylko część bufora, nawet jeśli cała treść odpowiedzi nie została jeszcze wykorzystana. Bufor jest gotowy do odczytu. Bufory są ponownie używane wewnętrznie, więc klasa implementująca nie powinna przechowywać bufora ani używać go w innych miejscach niż w implementacji tej metody.

Parametry
UrlResponseInfo info

Informacje o odpowiedzi.

ByteBuffer bodyChunk

Bufor zawierający odebrane dane, odwrócony do odczytu.

Zgłasza
java.lang.Exception

jeśli podczas przetwarzania zakończenia odczytu wystąpi błąd. W takim przypadku wywoływana jest funkcja onFailed, a przyczyną obiektu CallbackException jest zgłoszony wyjątek.

onCanceled

protected abstract void onCanceled(@Nullable UrlResponseInfo info)

Wywoływana, jeśli żądanie zostało anulowane za pomocą cancel. Po wywołaniu tej metody nie będą wywoływane żadne inne metody UrlRequest.Callback.

Parametry
@Nullable UrlResponseInfo info

Informacje o odpowiedzi. Może wynosić null, jeśli nie otrzymano odpowiedzi.

onFailed

protected abstract void onFailed(@Nullable UrlResponseInfo info, CronetException exception)

Wywoływana, jeśli żądanie nie zostało zrealizowane z jakiegokolwiek powodu po start. Po wywołaniu tej metody nie będą wywoływane żadne inne metody UrlRequest.Callback. error zawiera informacje o błędzie.

Parametry
@Nullable UrlResponseInfo info

Informacje o odpowiedzi. Może wynosić null, jeśli nie otrzymano odpowiedzi.

CronetException exception

informacje o błędzie.

onResponseStarted

protected abstract void onResponseStarted(UrlResponseInfo info)

Wywoływana po otrzymaniu ostatecznego zestawu nagłówków po wszystkich przekierowaniach. Będzie wywoływana tylko raz w przypadku każdego żądania. Gwarantujemy, że Cronet nie rozpocznie odczytywania treści, dopóki ta metoda nie zwróci wartości.

Parametry
UrlResponseInfo info

Informacje o odpowiedzi.

Zgłasza
java.lang.Exception

jeśli podczas przetwarzania początku odpowiedzi wystąpi błąd, wywoływana jest funkcja onFailed z wyrzuconym wyjątkiem ustawionym jako przyczyna CallbackException.

onSucceeded

protected abstract void onSucceeded(UrlResponseInfo info)

Wywoływana, gdy żądanie zostanie zrealizowane. Po wywołaniu tej metody nie będą wywoływane żadne inne metody UrlRequest.Callback.

Parametry
UrlResponseInfo info

Informacje o odpowiedzi.

shouldFollowRedirect

protected abstract boolean shouldFollowRedirect(UrlResponseInfo info, String newLocationUrl)

Wywoływana za każdym razem, gdy napotkane zostanie przekierowanie. Będzie ona wywoływana tylko między wywołaniami funkcji startonResponseStarted(). Treść odpowiedzi przekierowania (jeśli występuje) zostanie zignorowana.

Parametry
UrlResponseInfo info

Informacje o odpowiedzi.

String newLocationUrl

Lokalizacja, do której przekierowywane jest żądanie.

Zwraca
boolean

Wartość „true”, jeśli przekierowanie ma zostać wykonane, lub „false”, jeśli żądanie ma zostać anulowane.

Zgłasza
java.lang.Exception

jeśli podczas przetwarzania przekierowania wystąpi błąd. Funkcja onFailed zostanie wywołana z wyjątkiem ustawionym jako przyczyna CallbackException.