ImplicitFlowControlCallback

abstract class ImplicitFlowControlCallback : 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

Funkcje publiczne

Unit
onCanceled(request: UrlRequest!, info: UrlResponseInfo!)

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

Unit
onFailed(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    error: CronetException!
)

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

Unit
onReadCompleted(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    byteBuffer: ByteBuffer!
)

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

Unit
onRedirectReceived(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    newLocationUrl: String!
)

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

Unit

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

Unit
onSucceeded(request: UrlRequest!, info: UrlResponseInfo!)

Wywoływana, gdy żądanie zostanie zrealizowane.

Funkcje chronione

abstract Unit

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

abstract Unit

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

abstract Unit
onFailed(info: UrlResponseInfo?, exception: CronetException!)

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

abstract Unit

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

abstract Unit

Wywoływana, gdy żądanie zostanie zrealizowane.

abstract Boolean
shouldFollowRedirect(info: UrlResponseInfo!, newLocationUrl: String!)

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

Konstruktory publiczne

ImplicitFlowControlCallback

ImplicitFlowControlCallback()

Funkcje publiczne

onCanceled

fun onCanceled(request: UrlRequest!, info: UrlResponseInfo!): Unit

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
request: UrlRequest!

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

info: UrlResponseInfo!

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

onFailed

fun onFailed(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    error: CronetException!
): Unit

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
request: UrlRequest!

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

info: UrlResponseInfo!

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

error: CronetException!

informacje o błędzie.

onReadCompleted

fun onReadCompleted(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    byteBuffer: ByteBuffer!
): Unit

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
request: UrlRequest!

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

info: UrlResponseInfo!

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

fun onRedirectReceived(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    newLocationUrl: String!
): Unit

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
request: UrlRequest!

Poproś o przekierowanie.

info: UrlResponseInfo!

Informacje o odpowiedzi.

newLocationUrl: String!

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

fun onResponseStarted(request: UrlRequest!, info: UrlResponseInfo!): Unit

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
request: UrlRequest!

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

info: UrlResponseInfo!

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

fun onSucceeded(request: UrlRequest!, info: UrlResponseInfo!): Unit

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

Parametry
request: UrlRequest!

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

info: UrlResponseInfo!

Informacje o odpowiedzi.

Funkcje chronione

onBodyChunkRead

protected abstract fun onBodyChunkRead(info: UrlResponseInfo!, bodyChunk: ByteBuffer!): Unit

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
info: UrlResponseInfo!

Informacje o odpowiedzi.

bodyChunk: ByteBuffer!

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 fun onCanceled(info: UrlResponseInfo?): Unit

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
info: UrlResponseInfo?

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

onFailed

protected abstract fun onFailed(info: UrlResponseInfo?, exception: CronetException!): Unit

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
info: UrlResponseInfo?

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

exception: CronetException!

informacje o błędzie.

onResponseStarted

protected abstract fun onResponseStarted(info: UrlResponseInfo!): Unit

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
info: UrlResponseInfo!

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 fun onSucceeded(info: UrlResponseInfo!): Unit

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

Parametry
info: UrlResponseInfo!

Informacje o odpowiedzi.

shouldFollowRedirect

protected abstract fun shouldFollowRedirect(info: UrlResponseInfo!, newLocationUrl: String!): Boolean

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
info: UrlResponseInfo!

Informacje o odpowiedzi.

newLocationUrl: String!

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.