UrlRequest.Callback

public abstract class UrlRequest.Callback

Znane podklasy bezpośrednie
ImplicitFlowControlCallback

Implementacja UrlRequest.Callback, która ułatwia zarządzanie cyklem życia żądania i automatycznie przechodzi do odczytania całej odpowiedzi.
Znane podklasy pośrednie
ByteArrayCronetCallback

Specjalizacja InMemoryTransformCronetCallback, która zwraca bajty treści w niezmienionej postaci, bez interpretacji.
InMemoryTransformCronetCallback

Abstrakcyjne wywołanie zwrotne Cronet, które odczytuje całą treść do pamięci i opcjonalnie deserializuje treść przed przekazaniem jej z powrotem do wystawcy żądania HTTP.
JsonCronetCallback

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

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

Użytkownicy Cronet rozszerzają tę klasę, aby otrzymywać wywołania zwrotne wskazujące postęp przetwarzania UrlRequest. Podczas tworzenia UrlRequest przekazywana jest instancja tej klasy do konstruktora UrlRequest.Builder.

Uwaga: wszystkie metody będą wywoływane w wątku java.util.concurrent.Executor używanego podczas tworzenia UrlRequest.

Podsumowanie

Konstruktory publiczne

Metody publiczne
void

Wywoływane, jeśli żądanie zostało anulowane za pomocą cancel.
abstract void
onFailed(
    UrlRequest request,
    UrlResponseInfo info,
    CronetException error
)

Wywoływane, jeśli żądanie nie powiodło się z jakiegokolwiek powodu po wywołaniu start.
abstract void
onReadCompleted(
    UrlRequest request,
    UrlResponseInfo info,
    ByteBuffer byteBuffer
)

Wywoływane za każdym razem, gdy odczytana zostanie część treści odpowiedzi.
abstract void
onRedirectReceived(
    UrlRequest request,
    UrlResponseInfo info,
    String newLocationUrl
)

Wywoływane za każdym razem, gdy napotkane zostanie przekierowanie.
abstract void

Wywoływane po otrzymaniu ostatecznego zestawu nagłówków po wszystkich przekierowaniach.
abstract void

Wywoływane, gdy żądanie zostanie zrealizowane.

Konstruktory publiczne

Callback

public Callback()

Metody publiczne

onCanceled

public void onCanceled(UrlRequest request, UrlResponseInfo info)

Wywoływane, jeśli żądanie zostało anulowane za pomocą cancel. Po wywołaniu tej metody nie zostaną wywołane ż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 mieć wartość null, jeśli nie otrzymano żadnej odpowiedzi.

onFailed

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

Wywoływane, jeśli żądanie nie powiodło się z jakiegokolwiek powodu po wywołaniu start. Po wywołaniu tej metody nie zostaną wywołane żadne inne metody Callback. error zawiera informacje o niepowodzeniu.

Parametry
UrlRequest request

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

Informacje o odpowiedzi. Może mieć wartość null, jeśli nie otrzymano żadnej odpowiedzi.
CronetException error

Informacje o błędzie.

onReadCompleted

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

Wywoływane za każdym razem, gdy odczytana zostanie część treści odpowiedzi. Nawet jeśli cała treść odpowiedzi nie została jeszcze wykorzystana, może być wypełniona tylko część bufora. Z wyjątkiem onCanceled() żadna inna metoda Callback nie zostanie wywołana w przypadku żądania, w tym onSucceeded() i onFailed(), dopóki nie zostanie wywołana metoda UrlRequest.read() w celu kontynuowania odczytywania treści odpowiedzi.

Parametry
UrlRequest request

Żądanie, które otrzymało dane.
UrlResponseInfo info

Informacje o odpowiedzi.
ByteBuffer byteBuffer

Bufor, który został przekazany do UrlRequest.read(), a teraz zawiera otrzymane dane. Pozycja bufora jest aktualizowana do końca otrzymanych danych. Limit bufora nie jest zmieniany.
Zgłasza
java.lang.Exception

jeśli podczas przetwarzania zakończenia odczytu wystąpi błąd. Metoda onFailed zostanie wywołana z wyjątkiem ustawionym jako przyczyna CallbackException.

onRedirectReceived

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

Wywoływane za każdym razem, gdy napotkane zostanie przekierowanie. Ta metoda będzie wywoływana tylko między wywołaniem start a onResponseStarted(). Treść odpowiedzi przekierowania, jeśli taka istnieje, zostanie zignorowana. Przekierowanie nie zostanie wykonane, dopóki nie zostanie wywołana metoda followRedirect klasy URLRequest, synchronicznie lub asynchronicznie.

Parametry
UrlRequest request

Żądanie, które jest przekierowywane.
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. Metoda onFailed zostanie wywołana z wyjątkiem ustawionym jako przyczyna CallbackException.

onResponseStarted

public abstract void onResponseStarted(UrlRequest request, UrlResponseInfo info)

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

Parametry
UrlRequest request

Żądanie, które zaczęło otrzymywać odpowiedź.
UrlResponseInfo info

Informacje o odpowiedzi.
Zgłasza
java.lang.Exception

jeśli podczas przetwarzania rozpoczęcia odpowiedzi wystąpi błąd. Metoda onFailed zostanie wywołana z wyjątkiem ustawionym jako przyczyna CallbackException.

onSucceeded

public abstract void onSucceeded(UrlRequest request, UrlResponseInfo info)

Wywoływane, gdy żądanie zostanie zrealizowane. Po wywołaniu tej metody nie zostaną wywołane żadne inne metody Callback.

Parametry
UrlRequest request

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

Informacje o odpowiedzi.