UrlRequest

public abstract class UrlRequest

---

Kontroluje żądanie HTTP (GET, PUT, POST itp.). Tworzony przez UrlRequest.Builder, który można uzyskać, wywołując newUrlRequestBuilder. Uwaga: wszystkie metody muszą być wywoływane w Executor przekazanym do newUrlRequestBuilder.

Podsumowanie

Typy zagnieżdżone
public abstract class UrlRequest.Builder Konstruktor UrlRequest.
public abstract class UrlRequest.Callback Użytkownicy Croneta rozszerzają tę klasę, aby otrzymywać wywołania zwrotne wskazujące postęp przetwarzania UrlRequest.
@RequiresOptIn public annotation UrlRequest.Experimental Adnotacja do interfejsów API, które nie są jeszcze uważane za stabilne.
public class UrlRequest.Status Wartości stanu żądania zwracane przez getStatus.
public abstract class UrlRequest.StatusListener Klasa odbiornika używana z getStatus do otrzymywania stanu UrlRequest.

Konstruktory publiczne
UrlRequest()

Metody publiczne
abstract void	cancel() Anuluje żądanie.
abstract void	followRedirect() Śledzi oczekujące przekierowanie.
abstract void	getStatus(UrlRequest.StatusListener listener) Wysyła zapytanie o stan żądania.
abstract boolean	isDone() Zwraca wartość true, jeśli żądanie zostało pomyślnie rozpoczęte i jest już zakończone (zakończone, anulowane lub nieudane).
abstract void	read(ByteBuffer buffer) Próbuje odczytać część treści odpowiedzi do podanego bufora.
abstract void	start() Uruchamia żądanie, wszystkie wywołania zwrotne trafiają do Callback.

Konstruktory publiczne

UrlRequest

public UrlRequest()

Metody publiczne

cancel

public abstract void cancel()

Anuluje żądanie. Można wywołać w dowolnym momencie. Gdy anulowanie zostanie zakończone, zostanie wywołana funkcja onCanceled(), a żadne inne metody wywołania zwrotnego nie zostaną wywołane. Jeśli żądanie zostało zakończone lub nie zostało jeszcze rozpoczęte, wywołanie cancel() nie przyniesie żadnego efektu, a onCanceled() nie zostanie wywołane. Jeśli Executor przekazany podczas tworzenia UrlRequest wykonuje zadania w jednym wątku, a cancel() jest wywoływane w tym wątku, po wywołaniu cancel() nie zostaną wywołane żadne metody wywołania zwrotnego (oprócz onCanceled()). W przeciwnym razie po zakończeniu cancel() można wywołać co najwyżej 1 metodę wywołania zwrotnego.

followRedirect

public abstract void followRedirect()

Śledzi oczekujące przekierowanie. Można wywołać co najwyżej raz na każde wywołanie onRedirectReceived().

getStatus

public abstract void getStatus(UrlRequest.StatusListener listener)

Wysyła zapytanie o stan żądania.

Parametry
UrlRequest.StatusListener listener	StatusListener, który zostanie wywołany z bieżącym stanem żądania. listener zostanie wywołany w Executor przekazanym podczas tworzenia żądania.

isDone

public abstract boolean isDone()

Zwraca wartość true, jeśli żądanie zostało pomyślnie rozpoczęte i jest już zakończone (zakończone, anulowane lub nieudane).

Zwraca
boolean	true, jeśli żądanie zostało pomyślnie rozpoczęte i jest już zakończone (zakończone, anulowane lub nieudane).

read

public abstract void read(ByteBuffer buffer)

Próbuje odczytać część treści odpowiedzi do podanego bufora. Można wywołać co najwyżej raz w odpowiedzi na każde wywołanie metod onResponseStarted() i onReadCompleted() w Callback. Każde wywołanie spowoduje asynchroniczne wywołanie metody Callback'sonReadCompleted() (jeśli dane zostaną odczytane), metody onSucceeded() (jeśli nie ma więcej danych do odczytania) lub metody onFailed() (jeśli wystąpi błąd).

Parametry
ByteBuffer buffer	ByteBuffer, do którego ma zostać zapisana treść odpowiedzi. Musi to być bezpośredni ByteBuffer. Do momentu, gdy żądanie nie wywoła Callback, osadzający nie może odczytywać ani modyfikować pozycji, limitu ani danych bufora między jego pozycją a limitem.

start

public abstract void start()

Uruchamia żądanie, wszystkie wywołania zwrotne trafiają do Callback. Można wywołać tylko raz. Nie można wywołać, jeśli wywołano cancel.